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-2022 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 1d) Other operating systems added to 1c) above are
  75
  76     os_unix_and_osx means all unices, incluing mac
  77     os_unix  means all unices except mac
  78     os_osx   means only mac
  79
  80 2a) Several "server side include" commented elements are supported:
  81
  82 <!--#include file="textfile"-->
  83
  84 The file "textfile" will be inserted into the HTML text directly.
  85 Alpine does no formatting of the text.  At some point we might want to
  86 look at the first line for <HTML> but not today.
  87
  88 2b) Various bits of Alpine's running state can be inserted into the
  89 HTML text as well using the special comment:
  90
  91 <!--#echo var="variable"-->
  92
  93 Where "variable" is one of either:
  94
  95     ALPINE_VERSION
  96     ALPINE_REVISION
  97     ALPINE_COMPILE_DATE
  98     ALPINE_TODAYS_DATE
  99     C_CLIENT_VERSION
 100     _LOCAL_FULLNAME_
 101     _LOCAL_ADDRESS_
 102     _BUGS_FULLNAME_
 103     _BUGS_ADDRESS_
 104     CURRENT_DIR
 105     HOME_DIR
 106     PASSWORD_FILE
 107     PINE_CONF_PATH
 108     PINE_CONF_FIXED_PATH
 109     PINE_INFO_PATH
 110     MAIL_SPOOL_PATH
 111     MAIL_SPOOL_LOCK_PATH
 112     VAR_<VARNAME> - where <VARNAME> is config variable name
 113     FEAT_<FEATURENAME> - where <FEATURENAME> is config feature name
 114
 115 3) The URL scheme "X-Alpine-Gripe:" is available to insert links to
 116    pine's composer such that various debugging data can be attached to the
 117    message. Aside from normal email addresses, this can be set to
 118    either "_LOCAL_ADDRESS_" for the configured local help address, or
 119    "_BUGS_ADDRESS_" for the configured local bug reporting address.
 120    Aside from the special tokens above, the default behavior only differs
 121    from "mailto:" by the insertion of a special Subject: prefix that
 122    consists of a randomly-generated token for tracking purposes.
 123    Several optional parameters can be included to control what is
 124    attached or offered for attachment to the message:
 125
 126         ?config  --  Automatically attaches the user's configuration
 127                      information to the trouble report
 128         ?keys    --  Automatically attaches the user's most recent
 129                      keystrokes
 130         ?curmsg  --  Causes the user to get an offer to attach the
 131                      current message to the trouble report
 132         ?local   --  Automatically attaches the result of the script
 133                      defined by VAR_BUGS_EXTRAS
 134
 135 For HTML-format sections, the help screen dividers  "===== xxxx ====" must
 136 contain one and only one space after the first and before the second set of
 137 equal signs.
 138
 139 Note to authors of this file: to mark sections that need further revision,
 140 please use the text string on the following line consistently so that it is
 141 easy to find those places again in this file:
 142 *revision needed*
 143
 144 NOTE: Several sections of help text which weren't being used were removed
 145 at RCS version number 4.122.  In particular, there were some placeholders
 146 with help text for the config screen and the composer that didn't have any
 147 reasonable place to be called from.
 148 Dummy change to get revision in pine.hlp
 149 ============= h_revision =================
 150 Alpine Commit 669 2022-12-13 18:51:11
 151 ============= h_news =================
 152 <HTML>
 153 <HEAD>
 154 <TITLE>RELEASE NOTES for Alpine</TITLE>
 155 </HEAD>
 156 <BODY>
 157 <H1>Alpine Release Notes</H1>
 158 <DIV ALIGN=CENTER>
 159 Version <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)
 160 <BR>
 161 <!--chtml if pinemode="running"-->
 162 (built <!--#echo var=ALPINE_COMPILE_DATE-->)
 163 <!--chtml endif-->
 164
 165 <BR>
 166 <BR>Copyright 2013-2022 Eduardo Chappa
 167 <BR>Copyright 2006-2008 University of Washington
 168 </DIV>
 169
 170 <P>
 171 Alpine is an &quot;Alternatively Licensed Program for Internet
 172 News and Email&quot; produced until 2009 by the University of Washington.
 173 It is intended to be an easy-to-use program for
 174 sending, receiving, and filing Internet electronic mail messages and
 175 bulletin board (Netnews) messages.  Alpine is designed to run on a wide
 176 variety of Unix&reg; operating systems.  A version for Microsoft Windows&reg;
 177 is available as is a world wide web based version designed to run under the
 178 Apache web server.
 179
 180 <P>
 181 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
 182 href="h_apache_license">Apache License 2.0</A>.
 183
 184 <P>
 185 Alpine's privacy policy is a living, online only, document, which can be found at
 186 <A href="h_privacy_policy">https://alpineapp.email/privacy.html</A>.
 187 By following the previous link,  Alpine
 188 will connect to an external server, and will download it and display
 189 it for you. Please take some time to read it and understand it.
 190 Since the Privacy Policy could be amended to take into consideration
 191 new additions to Alpine, please check it periodically.
 192
 193 <P> Changes since the release of version 2.26 include:
 194 <!-- Changes since the release of version <!--#echo var="ALPINE_VERSION"-->
 195 <!-- include: -->
 196 <P> New features include:
 197 <UL>
 198 <LI> Microsoft servers do not deal well with a message that is forwarded
 199      as an attachment by Alpine due to the way Alpine constructs the cookie
 200      to separate parts of the message due to the presence of a colon. To
 201      be safe, remove all non-numeric characters in the cookie. In addition,
 202      lowercase values for the charset.
 203 <LI> When selecting messages based on either a previously defined rule or
 204      based on a previously configured keyword, and when the feature
 205      <a href="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></a>
 206      is enabled, add the ability of using the TAB command to complete
 207      a partial match. Contributed by Peter Tirsek.
 208 <LI> For mailing lists, Alpine adds a description of the type of link
 209      (web or mail) for each option related to the subscription to the list.
 210      Contributed by Daniel Schwarz.
 211 </UL>
 212
 213 <P> Bugs addressed include:
 214 <UL>
 215 <LI> When a user configures a mailbox without specifying the username, PC-Alpine
 216 does not allow a user to input their password. Reported by Michelle McPeek.
 217 <LI> Crash in PC-Alpine when postponing a message. Reported by Paolo Ienne.
 218 <LI> Crash in Alpine after a user tried to repaint the screen after failing
 219      to select a rule from a menu. Reported by Peter Tirsek. Crash also
 220      reproducible when selecting by keyword or charset.
 221 </UL>
 222
 223 <P>Version 2.26 adds new features and addresses bugs found in previous
 224 releases.
 225
 226 <P> New features include:
 227 <UL>
 228 <!--chtml if pinemode="os_unix"-->
 229 <LI> Unix version of Alpine (not including OSX). Alpine is built with password
 230      file support by default. If Alpine is built with SMIME support and the
 231      password file does not exist, then Alpine will create it by default and
 232      encrypt it. For this version of Alpine, Alpine saves its passwords in the file
 233      &quot;<!--#echo var="PASSWORD_FILE"-->&quot; which is in the same directory that
 234      your .pinerc is located.
 235 <!--chtml endif-->
 236
 237 <LI> In the past Alpine did not recognize images embedded
 238      in an HTML file, so now it does and a link to open them is
 239      given. Additionally, Alpine did not pass these images to an
 240      external browser for display using the external command, and
 241      now it will.
 242
 243 <LI> Support for code_verifier and code_challenge when generating a
 244      refresh token and access token in Gmail and Outlook using the
 245      S256 method and plain method.
 246
 247 <LI> Change the redirect_uri scheme for Gmail, as Google is deprecating the use
 248      of oob. Changed to http://localhost. Users are supposed to enter the URL
 249      they see in their browser in place of the code.
 250
 251 <LI> Some servers do not allow the Drafts folder to be removed, even when
 252      it is empty. Alpine, however, assumes that if the folder exists, it
 253      must contain a draft message. This joint collaboration with Thomas
 254      Uhle modifies alpine to not to attempt to continue a draft message if
 255      the draft folder is empty.
 256
 257 <LI> Contributions by Thomas Uhle:
 258 <UL>
 259   <LI> Add support for the LDAP attribute "userCertificate";
 260   <LI> Move voiceMailTelephoneNumber from the TCL side to ldap_translate;
 261   <LI> XOAUTH2 state generator changes format specifier from %x to %02x;
 262   <LI> Web Alpine will not attempt to continue a postponed message if the
 263        postponed-msgs folder is empty.
 264 </UL>
 265
 266 <LI> Improvements to the screen that allows a user to select the client-id when
 267      a user attempts to login to a server and more than one client-id
 268      is available for that server. In this case additional information is
 269      given: The method to use (device or authorize), a user id that uses the
 270      suggested client-id or a report that the client-id has not been used.
 271
 272 <LI> To protect the privacy of a user, the message-id of a message will be
 273      generated using the domain in the From field of the message.
 274
 275 <LI> When saving to a folder in the unix format, Alpine parses the
 276      destination folder to assign uids to all messages in the folder. When
 277      the destination folder is large this could significantly slow down
 278      alpine. Fix based on a patch submitted to the alpine-info list by
 279      Chris Caputo.
 280
 281 <LI> Add the LOGOUT command to the list of commands that can be
 282      automatically interrupted in case the connection becomes unstable
 283      during that command and Alpine times out its connection to the server.
 284
 285 <LI> If new mail has arrived when a user is closing a mailbox, Alpine will
 286      also announce how many new messages have arrived. Suggested by Chime Hart.
 287
 288 <LI> When an invitation does not have a timezone in the date of the event,
 289      but the date is in GMT, adjust the date to local time.
 290 </UL>
 291
 292 <P>
 293 Bugs addressed include:
 294
 295 <UL>
 296 <LI> Crash when invoking Alpine from the command line and an attempt to authorize
 297      alpine to use XOAUTH2 is done. Alpine crashes because of a missing optional
 298      parameter -xoauth2-flow and because no screen has been configured yet. Reported
 299      by Baron Fujimoto.
 300
 301 <LI> Alpine crashes when it cannot retrieve the privacy policy due to
 302      failure connecting to the external server.
 303
 304 <LI> Alpine might delete all passwords from the password file if the
 305      password file is not unlocked by cancellation, or the authentication
 306      for an XOAUTH2 server is cancelled, or the password of an account
 307      is changed.
 308
 309 <LI> When the personal name of an address is encoded, and the personal name
 310      is surrounded by quotes, these are not removed by Alpine at the time
 311      to offer to take an address from a message to the addressbook. Reported
 312      by David Prager Branner.
 313
 314 <LI> If a user configures the sendmail-path variable, and does not use a
 315      global smtp-server, then Alpine will use the sendmail-path even when
 316      the user configured a smtp-server for a role. Reported by Gregory
 317      Heytings.
 318
 319 <LI> Crash in PC-Alpine when creating a mail collection and no username is
 320      indicated in the server path. Reported by Sandy Schuman.
 321
 322 <LI> Crash in Alpine when running a filter that moves deleted messages the
 323      INBOX in a Gmail account. Reported by Jyrki Voutilainen.
 324 </UL>
 325
 326 <P>Version 2.25 adds new features and addresses bugs found in previous
 327 releases.
 328
 329 <P>
 330 New features include:
 331 <UL>
 332 <LI> Unix Alpine: New configuration variable <a href="h_config_ssl_ciphers"><!--#echo var="VAR_ssl-ciphers"--></a> that allows
 333      users to list the ciphers to use when connecting to a SSL server.
 334      Based on a collaboration with Professor Martin Trusler.
 335
 336 <LI> New hidden feature <a href="h_config_delete_before_writing"><!--#echo var="FEAT_enable-delete-before-writing"--></a>
 337      to add support for terminals that need lines to be deleted
 338      before being written. Based on a collaboration with Professor
 339      Martin Trusler.
 340
 341 <LI> Experimental: The instruction to remove the double quotes from the processing of
 342      customized headers existed in pine, but it was removed in alpine. Restoring
 343      old Alpine behavior. See
 344      <A href="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=981781">this</A>
 345      report for more background information.
 346
 347 <LI> Add the capability to record http debug. This is necessary to debug XOAUTH2
 348      authentication, and records sensitive login information. Do not share your
 349      debug file if you use this form of debug.
 350
 351 <LI> Remove the ability to choose between the device and authorize methods
 352      to login to outlook, since the original client-id can only be used
 353      for the device method. One needs a special client-id and client-secret
 354      to use the authorize method in Outlook.
 355
 356 <LI> PC-Alpine only: Some service providers produce access tokens that are
 357      too long to save in the Windows Credentials, so the access tokens will
 358      be split and saved as several pieces. This means that old versions of
 359      Alpine will NOT be able to use saved passwords once this new version of
 360      Alpine is used.
 361
 362 <LI> PC-Alpine: Debug files used to be created with extension .txt1, .txt2, etc.
 363      Rename those files so that they have extension .txt.
 364
 365 <LI> Always follow ‘suppress-asterisks-in-password-prompt’ setting in the
 366      various password prompts. Submitted by &Eacute;tienne Deparis.
 367
 368 <LI> Use 'alpine -F' instead of 'pine -F' as the browser default pager.
 369      Submitted by &Eacute;tienne Deparis.
 370
 371 <LI> Introduction of OTHER CMDS menu for the browser/pilot to let
 372      people discover the two new commands: &quot;1&quot; is a toggle that
 373      switches between 1 column and multicolumn mode. The &quot;.&quot; command
 374      toggles between hiding or showing hidden files, and the &quot;G&quot;
 375      command to travel between directories. Contributed by &Eacute;tienne
 376      Deparis.
 377
 378 <LI> Add option -xoauth2-flow to the command line, so that users can specify the
 379      parameters to set up an xoauth2 connection through the command line.
 380
 381 <LI> Alpine deletes, from its internal memory and external cache, passwords
 382      that do not work, even if they were saved by the user.
 383
 384 <LI> New format for saving passwords in the windows credential manager
 385      for PC-Alpine. Upon starting this new version of Alpine the passwords
 386      saved in the credential manager are converted to the new format and
 387      they will not be recognized by old versions of Alpine, but only by
 388      this and newer versions of Alpine.
 389
 390 <LI> Enabled encryption protocols in PC-Alpine are based on those enabled
 391      in the system, unless one is specified directly.
 392 </UL>
 393
 394 <P>
 395 Bugs addressed include:
 396
 397 <UL>
 398 <LI> The c-client library parses information from an IMAP server during
 399      non-authenticated state which could lead to denial of service.
 400      Reported by Damian Poddebniak from M&uuml;nster University of Applied
 401      Sciences.
 402
 403 <LI> Memory corruption when alpine searches for a string that is
 404      an incomplete utf8 string in a local folder. This could happen by
 405      chopping a string to make it fit a buffer without regard to its content.
 406      We fix the string so that chopping it does not damage it. Reported
 407      by Andrew.
 408
 409 <LI> Crash in the ntlm authenticator when the user name does not include
 410      a domain. Reported and fixed by Anders Skargren.
 411
 412 <LI> When forwarding a message, replacing an attachment might make Alpine
 413      re-attach the original attachment. Reported by Michael Traxler.
 414
 415 <LI> When an attachment is deleted, the saved message with the deleted
 416      attachment contains extra null characters after the end of the
 417      attachment boundary.
 418
 419 <LI> Tcp and http debug information is not printed unless the default
 420      debug level is set to 1. Print this if requested, regardless of what
 421      the default debug level is.
 422
 423 <LI> When trying to select a folder for saving a message, one can only enter
 424      a subfolder by pressing the &quot;>&quot; command, rather than the normal
 425      navigation by pressing &quot;Return&quot;. Reported by Ulf-Dietrich Braunmann.
 426
 427 <LI> Crash when attempting to remove a configuration for a XOAUTH2 server
 428      that has no usernames configured.
 429
 430 <LI> Crash caused by saving (and resaving) XOAUTH2 refresh and access tokens
 431      in PC-Alpine. Reported by Karl Lindauer.
 432 </UL>
 433
 434 <P> Version 2.24 adds new features and addresses bugs found in previous
 435 releases.
 436
 437 <P>
 438 New features include:
 439
 440 <UL>
 441 <LI> Experimental: The instruction to remove the double quotes from the processing of
 442      customized headers existed in pine, but it was removed in alpine. Restoring
 443      old Alpine behavior. See
 444      <A href="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=981781">this</A>
 445      report for more background information.
 446 <LI> Add the capability to record http debug. This is necessary to debug XOAUTH2
 447      authentication, and records sensitive login information. Do not share your
 448      debug file if you use this form of debug.
 449 <LI> Remove the ability to choose between the device and authorize methods
 450      to login to outlook, since the original client-id can only be used
 451      for the device method. One needs a special client-id and client-secret
 452      to use the authorize method in Outlook.
 453 <LI> PC-Alpine only: Some service providers produce access tokens that are
 454      too long to save in the Windows Credentials, so the access tokens will
 455      be split and saved as several pieces. This means that old versions of
 456      Alpine will NOT be able to use saved passwords once this new version of
 457      Alpine is used.
 458 <LI> PC-Alpine: Debug files used to be created with extension .txt1, .txt2, etc.
 459      Rename those files so that they have extension .txt.
 460 <LI> Always follow ‘suppress-asterisks-in-password-prompt’ setting in the
 461      various password prompts. Submitted by &Eacute;tienne Deparis.
 462 <LI> Use 'alpine -F' instead of 'pine -F' as the browser default pager.
 463      Submitted by &Eacute;tienne Deparis.
 464 <LI> Introduction of OTHER CMDS menu for the browser/pilot to let
 465      people discover the two new commands: &quot;1&quot; is a toggle that
 466      switches between 1 column and multicolumn mode. The &quot;.&quot; command
 467      toggles between hiding or showing hidden files, and the &quot;G&quot;
 468      command to travel between directories. Contributed by &Eacute;tienne
 469      Deparis.
 470 <LI> Implementation of XOAUTH2 for Yahoo! Mail. <A href="h_yahoo_configuration">Learn More</A>
 471
 472 <LI> Expansion of the configuration screen for XOAUTH2 to include
 473      username, authorization flow, and tenant.
 474
 475 <LI> XOAUTH2: automatic renew of access token and connection to a server
 476      within 60 seconds of expiration of the access token.
 477
 478 <LI> If a user has more than one client-id for a service, Alpine
 479      asks the user which client-id to use and associates that client-id to
 480      the credentials in the XOAUTH2 configuration screen.
 481      <A HREF="h_xoauth2_config_screen">Learn more</A>.
 482
 483 <LI> Addition of Yandex.com to the list of services that Alpine can use XOAUTH2 to
 484      authenticate for reading and sending email. <A href="h_yandex_configuration">Learn More</A>
 485
 486 <LI> Addition of a link to the Apache License 2.0 (see above). This is
 487      available from the Release Notes as well as the welcome screen.
 488
 489 <LI> Modifications to protect the privacy of users:
 490 <UL>
 491 <LI> Alpine does not generate Sender or X-X-Sender by default
 492      by enabling  <a href="h_config_disable_sender"><!--#echo var="FEAT_disable-sender"--></a>
 493      as the default.
 494 <LI> Alpine does not disclose User Agent by default by enabling
 495      <A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A>
 496      by default.
 497 <LI> Alpine uses the domain in the From: header of a message
 498      to generate a message-id and suppresses all information
 499      about Alpine, version, revision, and time of generation
 500      of the message-id from this header. This information is
 501      replaced by a random string.
 502 </UL>
 503 <LI> Unix Alpine displays configure options and flags when
 504      invoked as &quot;alpine -v&quot;. Suggested by Matt Ackeret.
 505 <LI> Alpine will ding the terminal bell when asking  about quitting
 506      when new mail arrives. This is consistent with Alpine dinging the
 507      bell when new mail arrives. The bell will not ding if it is disabled
 508      for status messages. Suggested by Chime Hart.
 509
 510 <LI> When messages are selected, pressing the &quot;;&quot; command to broaden or narrow
 511      a search, now offers the possibility to completely replace the search, and
 512      is almost equivalent to being a shortcut to &quot;unselect all messages, and select
 513      again&quot;. The difference is that cancelling this command will not unselect
 514      all currently selected messages. Suggested by Holger Trapp.
 515
 516 <LI> Alpine will not write debug files unless started with the option -d,
 517      so for example &quot;alpine -d 2&quot; will generate a debug file at level 2,
 518      but just issuing the alpine command will not write any debug to a file.
 519
 520 <LI> Experimental: Attempt to implement the Encryption Range in Windows. It works
 521      in Windows 10, and it should work in Windows 8.1. It needs testing in
 522      Windows 7 and Windows Vista.
 523
 524 <LI> Addition of variables <A HREF="h_config_user_certs_path"><!--#echo var="VAR_user-certs-path"--></A>
 525      and <A HREF="h_config_user_certs_file"><!--#echo var="VAR_user-certs-file"--></A>
 526      which allow a user to specify locations for certificates that the user
 527      trusts.
 528
 529 <LI> Ignore non-empty initial challenge in the GSSAPI authenticator. Based
 530      on a patch written by Jarek Polok, but submitted by Ignacio Reguero.
 531
 532 <LI> When a server expires a refresh token, Alpine needs to cancel it
 533     internally. Alpine will attempt to get a new one when it  reopens the
 534     folder after it cancels it.
 535
 536 <LI> Set up the IMAP ID at the moment of logging in to the server, rather than
 537      as a one time option, in case we need to use a special IMAP ID.
 538 </UL>
 539
 540 <P>
 541 Bugs addressed:
 542
 543 <UL>
 544 <LI> When Alpine starts a PREAUTH connection, it might still ask the user
 545      to login. Reported by Frank Tobin.
 546
 547 <LI> Crash while resizing the screen when viewing a calendar event.
 548
 549 <LI> When Alpine opens a folder in a server whose address is given numerically
 550      it might crash due to an incorrect freeing of memory. Reported by Wang Kang.
 551
 552 <LI> Crash when Alpine frees memory on a system where LC_CTYPE is not
 553      configured, and the user calls the file browser to attach files to
 554      a message. Reported by Luis Gerardo Tejero.
 555
 556 <LI> Invalid signatures created by Alpine, when built with recent
 557      releases of the Openssl-1.1.1 series (but not in the Openssl-1.0.1 series).
 558      Fix contributed by Bernd Edlinger.
 559
 560 <LI> After returning from the directory side of a dual-folder, sometimes
 561      Alpine would return to the first folder in the parent directory or to
 562      the dual-folder. The fix is to return to the original dual-folder as
 563      intended. Reported by Holger Trapp.
 564
 565 <LI> When an attachment is deleted and the original message is saved, Alpine
 566      might write only a part of the name of the file deleted. Reported by Holger
 567      Trapp.
 568
 569 <LI> URLs that are surrounded by white space are not cleaned by Alpine before
 570      passing them to the browser, resulting in no display of the URL when Alpine
 571      tries to open it. Reported by Gregory Heytings.
 572
 573 <LI>  When Alpine is built without smime, password file functionality might
 574       fail. Reported by Andres Fehr.
 575
 576 <LI> Crash in PC-Alpine when using the eXternal command.
 577
 578 <LI> Fix in Macs that made Alpine abort a ssh connection to an imap server.
 579      Reported and assisted by Wang Kang.
 580 </UL>
 581
 582 <P>
 583 Version 2.23 has new additions and addresses bugs found in previous releases.
 584
 585 <P>
 586 Additions include:
 587
 588 <UL>
 589 <LI> Implementation of XOAUTH2 authentication support for Outlook.
 590      Based on documentation suggested by Andrew C Aitchison. <A href="h_outlook_configuration">Learn More</A>
 591
 592 <LI> Add support for the OAUTHBEARER authentication method in Gmail. Thanks to
 593      Alexander Perlis for suggesting it and explaining how the method works. <A href="h_gmail_configuration">Learn More</A>
 594
 595 <LI> Creation of Alpine's Privacy Policy. This is presented as a link to
 596     an online document from the Release Notes (Link at the top of this
 597     document.) Upon user request, Alpine downloads and displays this
 598     document. Links to the privacy policy are also displayed when a user
 599     starts Alpine for the first time, or when a user starts a new version
 600     of Alpine. There is no default exit greeting command for these
 601     screens, and to exit the user must press "E", instead of the old
 602     default, which was the RETURN command. The RETURN command will open
 603     the handle on which the cursor is on, which by default is the Privacy
 604     Policy.
 605
 606 <LI> Support for the SASL-IR IMAP extension that avoids a round trip during
 607      authentication. Similar support added for the SMTP, NNTP and POP3
 608      protocols. Thanks to Geoffrey Bodwin for a report that lead to this
 609      implementation.
 610
 611 <LI> Alpine can pass an HTML message to an external web browser, by using the
 612      &quot;External&quot; command in the <a href="h_attachment_screen">ATTACHMENT INDEX</a>
 613      screen. <A href="h_command_external_browser">Learn more</A>.
 614
 615 <LI> New configuration variable
 616      <a href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
 617      that controls if Alpine will keep the source link to all the images in the
 618      HTML message, or will only pass a link to inline images included in the message. For your
 619      privacy and security this feature is enabled by default.
 620
 621 <LI> When reading an email and a user selects an email address to which to compose
 622      a message from the message, the user will be able to select a role to compose
 623      that message.
 624
 625 <LI> New variable system-certs-path that allows users to indicate the
 626      location of the directory where certificates are located. In PC-Alpine
 627      this must be C:\\libressl\\ssl\\certs. The C: drive can be replaced
 628      by the name of the drive where the binary and DLL files are located.
 629
 630 <LI> New variable system-certs-file that allows users to configure the
 631      location of a container of certificate authority (CA) certificates
 632      to be used to validate certificates of remote servers.
 633
 634 <LI> Remove sleep of 5 seconds for mailcap programs that use the terminal
 635      to display content. Suggested by Carl Edquist. In addition, remove the
 636      configurable process table command and its corresponding sleep time.
 637 </UL>
 638
 639 <P>
 640 Bugs addressed:
 641
 642 <UL>
 643  <LI> Security Bug: Alpine can be configured to start a secure connection using /tls
 644       on an insecure connection. However, if the connection is PREAUTH, Alpine
 645       will not upgrade the connection to a secure connection, because a client
 646       must not issue a STARTTLS to a server that supports it in authenticated
 647       state. This makes Alpine continue to use an insecure connection with the
 648       server, exposing user data. Reported by Damian Poddebniak and Fabian
 649       Ising from Münster University of Applied Sciences.
 650
 651    <LI> Selecting by subject might not copy the subject of the current message
 652      to the selection text correctly. Reported by Iosif Fettich.
 653
 654    <LI> Alpine does not set the return path correctly when using a role while bouncing
 655     a message. Reported by Dr. C. Griewatsch.
 656
 657 <LI>Bug in PC-Alpine that made Alpine go into an infinite loop and
 658     consume CPU when it was iconized. Reported by Holger Schieferdecker in
 659     comp.mail.pine.
 660
 661 <LI>Crash in Alpine when attempting to reply to a multipart/alternative
 662     message that is malformed, and the option to include attachments in
 663     reply is enabled. Reported and patched by Peter Tirsek.
 664
 665 <LI>Bug that makes Alpine split encoded words in the subject of a message
 666     in the middle of a utf-8 character into two encoded words, breaking the
 667     encoding. Reported by Jean Chevalier.
 668
 669 <LI> Alpine would not redraw the screen when a check for new mail in an
 670     incoming folder failed due to a failure while validating the server
 671     certificate, and the user did not allow the connection to proceed.
 672
 673 <LI> Crash in Alpine while resizing the screen when using any of the tokens
 674     SUBJKEYTEXT, SUBJECTTEXT, or SUBJKEYINITTEXT in the index format, and
 675     the screen was resized. Reported by Iggy Mogo.
 676
 677 <LI> When Alpine is trying to authenticate to Gmail, using the XOAUTH2 method,
 678     it does not display the url the user needs to open, in order to authorize
 679     Alpine to access Gmail using XOAUTH2 when Alpine still has not created
 680     a screen. Reported by Baron Fujimoto.
 681
 682 <LI> When an html anchor does not quote the link in the href parameter,
 683     alpine does not link to it.
 684
 685 <LI> Attempt to fix a bug that breaks scrolling of a message in Alpine when
 686      the screen is resized. Reported in the Debian bug system at
 687      <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=956361">https://bugs.debian.org/cgi-bin/bugreport.cgie?bug=956361</A>.
 688 </UL>
 689
 690 <P>
 691 Version 2.22 addresses bugs found in previous releases and has several
 692 additions as well.
 693
 694 <P>
 695 Additions include:
 696
 697 <UL>
 698 <LI> Support for <A HREF="h_xoauth2">XOAUTH2</A> authentication method in Gmail.
 699      <A href="h_gmail_configuration">Learn More</A>
 700
 701 <LI> PC-Alpine builds with LibreSSL and supports S/MIME.
 702
 703 <LI> NTLM authentication support with the ntlm library, in Unix systems.
 704 Based on code provided by Maciej W. Rozycki.
 705
 706 <LI> Add /tls1_3 flag for servers that support it. Read more information
 707 in the secure protocols <A HREF="h_network_encryption_security">help</A>.
 708
 709 <LI> To increase user's privacy, remove phone-home code that would prompt
 710 users to send an email message upon starting Alpine for the first time for
 711 purposes of counting. Your use of Alpine does not disclose information about
 712 you or your use of Alpine to the developers of Alpine.
 713
 714 <LI> New variable
 715 <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A>
 716 that allows users to configure versions of the SSL/TLS protocol that Alpine is
 717 restricted to try when establishing a secure connection SSL/TLS to a remote
 718 server. The default can be set at compilation time.
 719
 720 <LI> Add -dict option to PC-Pico, which allows users to choose a dictionary
 721 when spelling. Sample usage: -dict "en_US, de_DE, fr_FR".
 722
 723 <LI> Improvements to the configure stage of compilation. Some of
 724 these contributed by Helmut Grohne. See
 725 <A href="https://bugs.debian.org/876164">Bug 876164</A> in Debian.
 726
 727 <LI> Add &quot;remove password&quot; command to the management screen for the
 728 password file encryption key. This allows users to use their password file
 729 without entering a master password.
 730
 731 <LI> Add the &quot;g&quot; option to the select command that works in IMAP
 732 servers that implement the X-GM-EXT-1 capability (such as the one offered
 733 by Gmail.) This allows users to do selection in Alpine as if they were
 734 doing a search in the web interface for Gmail.
 735
 736 <LI> New variable close-connection-timeout, which tells Alpine to close
 737 a connection that is having problems being kept alive after the number
 738 of seconds configured in this variable, if the connection has not
 739 recovered. The default is 0, which means to keep the connection alive
 740 and wait for the connection to recover.
 741
 742 <LI> When a message is of type multipart/mixed, and its first part is
 743 multipart/signed, Alpine will include the text of the original message
 744 in a reply message, instead of including a multipart attachment.
 745 Suggested by Barry Landy.
 746
 747 <LI> S/MIME: Some clients do not transform messages to canonical form when
 748 signing first and encrypting second, which makes Alpine fail to parse the
 749 signed data after encryption. Reported by Holger Trapp.
 750
 751 <LI> Add /auth=XYZ to the way to define a server. This allows users to
 752 select the method to authenticate to an IMAP, SMTP or POP3 server.
 753 Examples are /auth=plain, or /auth=gssapi, etc.
 754
 755 <LI> Add backward search in the index screen. Based on patch by Astyanax Foo,
 756 submitted in 2009, but resubmitted by Erich Eckner on 2019.
 757
 758 <LI> SMIME: When Alpine is set to validate a message using the user's store, and
 759      user agrees to save a certificate of another user, use the saved
 760      certificate immediately to verify the smime message. Reported by
 761      Stefan Mueller.
 762
 763 <LI> Do not use a delay when printing messages to screen when the initial
 764      keystroke sequence of commands is active. Based on a report from Holger
 765      Trapp.
 766
 767 <LI> In PC-Alpine, when the decoded name of an attachment does not agree
 768      with its encoded name, Alpine will offer to save the file using the
 769      UTF8 encoded name.
 770 </UL>
 771
 772 <P>
 773 Bugs that have been addressed include:
 774 <UL>
 775    <LI> Width of characters is not always determined correctly when wcwidth
 776         is used. Revert to using code for the Windows operating system.
 777         Reported by Andrew Ho.
 778
 779    <LI> The call realpath(..., NULL) gives an error in Solaris, which means that
 780         we need to allocate memory for storing the resolved path. Reported by
 781         Fabian Schmidt.
 782
 783    <LI> Crash when attempting to bounce a message due to lack of space in
 784         allocated space for key menu array. Reported by David Sewell.
 785
 786    <LI> Crash when a CA certificate failed to load, and user attempted to
 787         view certificate information of other certificate authorities.
 788
 789    <LI> Crash in the S/MIME configuration screen when a user turned off S/MIME, and
 790         then re-enabled it. Also crash when attempting to enter the S/MIME
 791         configuration screen if S/MIME was turned off.
 792
 793    <LI> Deactivate some color code from Pico (as standalone editor in the
 794         windows version) until I find a way to activate it again. This is
 795         not critical and it is not something that PC-Pico must have (some
 796         of it already exists in other ways, like color support, what does
 797         not exist is the more complex code that Unix-Pico has with color
 798         codes for specific colors.)
 799
 800    <LI> When a message is multipart, and the first part is flowed text,
 801         then forwarding the message will set the first part to be flowed,
 802         and sent that way even when the option Do Not Send Flowed Text is
 803         enabled. Reported by Holger Trapp.
 804
 805    <LI> When a message/rfc822 part of a message is encoded with
 806         Content-Transfer-Encoding: QUOTED-PRINTABLE, Alpine will stop
 807         processing that message. Later this causes Alpine to crash because
 808         when it displays messages, it assumes that both header and body
 809         parts are processed. Reported by Mark Crispin in 2010, in the
 810         Alpine-info list (message with subject "crash bug in
 811         alpine/mailpart.c:format_msg_att()") with no example, and reported
 812         now by Holger Trapp, with an example.
 813
 814    <LI> In addition to the previous report, Alpine encodes message/rfc822
 815         messages as QUOTED-PRINTABLE, in contradiction with RFC 2045,
 816         when it receives a report that its encoding is 8bit. We preserve
 817         the encoding reported by the IMAP server, and do not encode in
 818         QUOTED-PRINTABLE.
 819
 820    <LI> Update build.bat file to add /DWINVER=0x0501 so that Alpine can
 821         build when using Visual Studio 2017. Fix contributed by
 822         Ulf-Dietrich Braunmann.
 823
 824    <LI> When the locale is not set up to UTF-8, alpine might determine the
 825         width of a character incorrectly. Reported by Alexandre Fedotov.
 826
 827    <LI> In some rare cases, when attachments are deleted before saving
 828         emails, the filenames will be displayed in RFC1522 representation,
 829         instead of in decoded form. Reported and patched by Wang Kang.
 830
 831    <LI> When colors are edited from the main setup configuration screen, some
 832         color settings are not updated until Alpine is restarted. Reported by
 833         Andrew Hill.
 834
 835    <LI> If the first part of a message is multipart/alternative, and the
 836         first part of this is also a multipart type, then Alpine might
 837         fail to select the first text part when replying to a message.
 838         Reported by Lucio Chiappetti.
 839
 840    <LI> TLS 1.2 works does not work if Alpine is compiled with openssl &gt;= 1.1.0.
 841         Reported and patched by Kyle George.
 842
 843    <LI> If the directory where Alpine saves the certificates is empty,
 844         alpine would not create a self-signed certificate to encrypt the
 845         password file.
 846
 847    <LI> S/MIME: The list of public certificates is freed before it is
 848         reused when a signature fails to verify. This causes Alpine to
 849         crash. Patch submitted by Linus Torvalds.
 850
 851    <LI> S/MIME: A message could fail to verify its signature even if the
 852         certificate was saved when the message was open. Based on a report
 853         by David Woodhouse to the RedHat bugzilla system.
 854
 855    <LI> When there are time changes in the clock, Alpine might go to sleep
 856         for big amounts of time while displaying messages in the screen.
 857         Reset sleep time to 5 seconds in case it finds it needs to sleep
 858         more than 5 seconds or a negative amount of time.
 859
 860    <LI> Restore recognition of empty directories. It was deleted by mistake
 861         when added support for internationalization in folders. Based on a
 862         report by Michael Rutter.
 863
 864    <LI> Alpine stops parsing the mailcap file when it finds an invalid entry.
 865         Reported by Matt Roberds to the Debian bug system at
 866         <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370">https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370</A>.
 867
 868    <LI> Crash with error "Lock when already locked" when an attempt to check
 869         for new mail on a locked stream that is being used for a save
 870         operation. Reported by Carlos E.R.
 871
 872    <LI> Alpine removes trailing spaces from passwords, making a longin attempt
 873         fail. Reported by R. Lyons.
 874
 875    <LI> Alpine crashes when opening a remote imap folder and computing scores.
 876         Reported by Paul DeStefano.
 877
 878    <LI> When more than one server was given in the server-name configuration
 879         option of rldap servers, none of them worked. Reported by Robert Wolf.
 880 </UL>
 881
 882 <P>
 883 Version 2.21 addresses bugs found in previous releases and has several
 884 additions as well.
 885
 886 <P>
 887 Additions include:
 888 <UL>
 889   <LI> PC-Alpine: New configuration option "Aspell Dictionaries" allows a
 890        user to choose the dictionary used to spell check, in case the user
 891        communicates in more than one language. Examples of values for the
 892        variable are "en_US" or "de_DE", etc. Only the first 10
 893        dictionaries are offered.
 894
 895   <LI> Unix-Alpine: Connect securely to a LDAP server on a secure port.
 896        Based on a contribution by Wang Kang.
 897
 898   <LI> Colors configured in Alpine are inherited in the composer.
 899
 900   <LI> When Alpine is compiled with password file and SMIME support
 901        the password file is encrypted using a private key/public
 902        certificate pair. If one such pair cannot be found, one will be
 903        created. <A HREF="h_password_file_support">Learn more</A>.
 904
 905   <LI> Alpine builds with any version of OpenSSL greater than or equal
 906        to 1.0.0c. This includes version 1.1.0. Alpine also builds with
 907        LibreSSL.
 908
 909   <LI> New SHORTSUBJECT, SHORTSUBJKEY and SHORTSUBJKEYINIT token for index
 910        format, which removes text in the SUBJECT between &quot;[&quot; and
 911        &quot;]&quot;.
 912
 913   <LI> New SMARTTIME24 token for index screen. It is close to SMARTDATETIME
 914        but it differns in that it gives the time in which the message was
 915        sent for messages that are less than a week old. it uses a 24 hour
 916        format.
 917
 918   <LI> Alpine will include attachments when forwarding some
 919        multipart/alternative messages for which it did not use to include
 920        attachments.
 921
 922   <LI> New configuration option
 923        <a href="h_config_alt_reply_menu"><!--#echo var="FEAT_alternate-reply-menu"--></a>
 924        which adds more ways to control features and variables when you
 925        start to reply to a message.
 926
 927   <LI> Added support for RFC 2971 - IMAP ID extension.
 928
 929   <LI> Add configuration <A href="h_config_ignore_size"><!--#echo var="FEAT_ignore-size-changes"--></A>
 930        that allows users to ignore errors in the computation of the size
 931        of a message from defective servers.
 932
 933   <LI> SMIME: Upgrade the default signature digest from sha1 to sha-256, since
 934        clients such as Thunderbird do not validate signatures that use sha1 digest.
 935
 936   <LI> Add the configuration variable "default-directories", which is called
 937        <A href="h_config_history"><!--#echo var="VAR_default-directories"--></A>
 938        variable saves a list of directories that are readily accessible
 939        for save or export of attachments. This makes it easier to save
 940        attachments in directories that are hard to navigate to, or that
 941        are accessed frequently.
 942
 943   <LI> When a filename is attached and its name is encoded, the save
 944        attachment command will offer to save the file in the encoded form.
 945        This might work for some users, but the save command will have a
 946        subcommand ^N to decode the file name and save the file with the
 947        decoded name.
 948
 949   <LI> The TAB key allows autocomplete in the Fcc field in the composer headers,
 950        as well as autocompletes automatically when only one possibility exists
 951        for the ^J attach command.
 952
 953   <LI> Add support for the &quot;TYPE&quot; and &quot;VALUE&quot; attributes of
 954        the html OL tag.
 955
 956   <LI> Ignore message from smtp server after a successful authentication
 957        challenge.
 958
 959   <LI> When a message is saved in the Form Letter folder, add the ability
 960        to save the role being used to compose such message so that settings
 961        such as the SMTP server set in the role can be used when sending
 962        such form message. Suggested and patched by Frank Doepper.
 963
 964   <LI> If SSLDIR is defined somehow, do not disable S/MIME if the
 965        SSLCERTSDIR is not found.
 966
 967   <LI> When Alpine sends an attachment, it will set the boundary attribute
 968        in lower case, as some SMTP servers, such as those of libero.it
 969        reject messages if the boundary attribute is in uppercase.
 970
 971   <LI> Add the ability to change the private key and certificates used
 972        to encrypt a password file in the SMIME setup configuration screen.
 973        <A HREF="h_config_smime_password_file_certificates">Learn more</A>
 974
 975   <LI> SMIME: The ctrl-E command that gives information on the certificate
 976        is only available for messages that have a signed or encrypted
 977        part.
 978
 979   <LI> SMIME: If a message contains a RFC822 attachment that is
 980        signed/decrypted add the ability to view its SMIME information.
 981
 982   <LI> SMIME: Certificate information in the S/MIME screen is available
 983        for certificates stored in a container.
 984
 985   <LI> SMIME: Offer the common name of the person, instead of the name of
 986        file containing the certificate, as the name to be displayed in the
 987        certificate management screen for certificate authorities.
 988        Suggested by Matthias Rieber.
 989
 990   <LI> SMIME: Management of several alternate name (SAN) certificates is
 991        improved. When importing a SAN certificate, also import a certificate
 992        for the filename, besides for the e-mail addresses in the
 993        certificate. Suggested by Matthias Rieber.
 994
 995   <LI> SMIME: add full year when displaying information about a certificate
 996        in the certificate management screen. Suggested by Matthias Rieber.
 997
 998   <LI> SMIME: sort certificates by some type of alphabetical order in the
 999        displayed name.
1000
1001   <LI> SMIME: Alpine will ask users if they wish to save S/MIME
1002        certificates included in signatures, when the option "Validate
1003        Using Certificate Store Only" is enabled. If the user does not wish
1004        to save it, validation will fail.
1005
1006   <LI> HTML: Add support for decoding entities in hexadecimal notation.
1007        Suggested by Tulip&aacute;nt Gergely.
1008
1009   <LI> The &quot;#&quot; command, when used as part of an aggregate
1010        operation will allow users to select the role used in either
1011        replying, forwarding or replying to the group of selected messages,
1012        Suggested by Hisashi T Fujinaka.
1013
1014   <LI> If the charset of a message can not be determined, use the value set
1015        in the <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A> for its value.
1016
1017   <LI> Resizing setup screen will redraw screen.
1018
1019   <LI> Unix Alpine only. Experimental: If Alpine/Pico finds a UCS4 code
1020        in the width ambiguous zone, it will use other means to determine
1021        the width, such as call wcwidth.
1022
1023   <LI> Pico: Code reorganization in the search command to make it easier to
1024        add subcommands of the search command.
1025
1026   <LI> Pico: Search command can do a case sensitive match. Use the Ctrl-^
1027        subcommand of the search command to bring this choice into view.
1028
1029   <LI> Pico: Add the ability to search for strings in the beginning or end
1030        of a line. Use the Ctrl-^ subcommand of the search command to bring
1031        this choice into view.
1032
1033   <LI> For a multipart/alternative message, the Take Address command will
1034        work on the part that is being read.
1035
1036   <LI> When sending a message, allow for 512 characters of consecutive
1037        non-white space before folding the subject line.
1038
1039   <LI> Make sure titlebar (the line at the top of the screen) always
1040        contains the name of the folder/newsgroup that is open, if this
1041        fits in the title.
1042
1043   <LI> The feature <a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
1044        will also scramble the name, version and operating system in the
1045        message-id header. Based on a contribution by Dennis Davis, which
1046        is itself based on a contribution by Mark Hills.
1047
1048   <LI> Change in logic in imap_set_password function to make Alpine ask if
1049        a user wants to save a password before reading the password file.
1050
1051   <LI> When exporting all parts of a message, if two attachments have the same
1052        name, do not overwrite a file more than once, but instead add a counter
1053        number to the filename to make a new file that does not exist in the file
1054        system.
1055
1056   <LI> Add the Control-R subcommand to the save command for attachments.
1057        This subcommand toggles if the saving will be done in binary mode
1058        for text attachments. When a user saves an attachment using binary
1059        mode it will be saved as it was sent, otherwise the attachment will
1060        be transformed to UTF-8 for further transformation through internal
1061        and user defined filters for saving.
1062
1063   <LI> Add command line argument -smimedir, which allows users to specify
1064        the default path for a directory that contains the public, private,
1065        and ca directories. This is useful in case a user has a backup of
1066        old certificates that cannot be installed in the ~/.alpine-smime
1067        dir.
1068
1069   <LI> Reimplementation of the code that allows the .pinerc file to be a
1070        symbolic link by Kyle George from tcpsoft.com to use realpath.
1071
1072   <LI> When saving an attachment, the "^T" command leads to a screen where the
1073        "A" command can be used to add a file. A directory can be added by
1074        pressing "^X" after the "A" command. Added after a suggestion by
1075        Stefan Goessling.
1076
1077   <LI> When saving an attachment, the ^Y and ^V commands allow a user to
1078        scroll through the history of directories used to save attachments,
1079        while preserving the given name of the file. Suggested by Peter
1080        Koellner.
1081
1082   <LI> SMIME: Turn off automatic signing and encrypting of a message when
1083        bouncing. Suggested after a discussion with Matthias Rieber.
1084
1085   <LI> When messages are selected, warn the user if a message that is not
1086        selected will be bounced, or if not all selected messages will be
1087        bounced. Suggested by Ulf-Dietrich Braumann.
1088
1089   <LI> The bounce command adds a subcommand to choose a role.
1090
1091   <LI> When selecting messages by number, the &quot;.&quot; character can
1092        be used to specify the message on which the cursor is on.
1093
1094   <LI> When Alpine opens an attachment, it sometimes changes the extension
1095        of the file that is being opened and replaces it by another for the
1096        same mime type. If Alpine finds that the extension of the file
1097        corresponds with the mime type, according to the mime-types file,
1098        then it will keep it, and no substitution will be made.
1099
1100   <LI> Set no restrictions on the length of encoded subjects, but encode
1101        words in length of no more than 75 characters.
1102 </UL>
1103
1104
1105 <P>
1106 Bugs that have been addressed include:
1107 <UL>
1108   <LI> SMIME: Crash when a certificate has an invalid date of validity. Also
1109        Alpine will use the function ASN1_TIME_print to determine the date
1110        of validity. Reported by Ben Stienstra.
1111
1112   <LI> SMIME: Crash when attempting to unlock the password file and an
1113        incorrect password is entered.
1114
1115   <LI> SMIME: Crash when checking the signature of a message that contains
1116        a RFC822 attached message. Reported by Holger Trapp and Bj&ouml;rn
1117        Krellner.
1118
1119   <LI> SMIME: Cancelling entering password to unlock key will not reprompt.
1120
1121   <LI> SMIME: fix a bug that did not allow users to transfer certificates to
1122        remote containers. Reported by Matthias Rieber.
1123
1124   <LI> SMIME: certificates included in messages were not being transferred
1125        to a remote container.
1126
1127   <LI> SMIME: Crash if public certificates are located in an inaccessible
1128        remote server and the private key is not available.
1129
1130   <LI> SMIME: Alpine does not remove temporary files created when adding a
1131        CA certificate to a container. Reported by Holger Trapp.
1132
1133   <LI> SMIME: When reading a local certificate, Alpine converts the name
1134        of the certificate to lowercase, which may make Alpine not be able
1135        to read such certificate. Reported by Dennis Davis.
1136
1137   <LI> SMIME: If the option "Remember S/MIME Passphrase" is disabled, then
1138        entering a password to read an encrypted message will make Alpine
1139        forget the key and not ask the password to unlock it again in case
1140        it is necessary to unlock it again. Reported by Ulf-Dietrich
1141        Braumann.
1142
1143   <LI> Alpine would use freed memory while trying to compute the color
1144        of the titlebar. This happened when trying to continue a postponed
1145        message.
1146
1147   <LI> Alpine failed to read an encrypted password file if too many
1148        passwords were saved in the password file.
1149
1150   <LI> When selecting messages while in Threaded Index Screen, some
1151        messages other than top of threads could appear in the index, making
1152        Alpine display messages &quot;out of the screen.&quot;
1153
1154   <LI> The index format would be chopped at the position of an unrecognized
1155        token, instead of skipping the token as intended.
1156
1157   <LI> Work in progress: Avoid calling non-safe functions when Alpine
1158        receives a signal. See bug report
1159        <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=825772">here.</A>
1160
1161   <LI> Crash when attempting to read a message after a bounce command.
1162        In order to produce a crash one needed to use the ^T subcommand and
1163        do a search in a LDAP directory. The crash is produced by changes
1164        to the text in the title bar. Reported by Heinrich Mislik in the
1165        Alpine-info list.
1166
1167   <LI> HTML messages that contain UTF-8 may wrap at the wrong position,
1168        making Alpine not display the correct character at the position
1169        that wrapping is done. Reported by Wang Kang.
1170
1171   <LI> Pico: Searching for a string that is too long causes Pico to crash
1172        in the next search.
1173
1174   <LI> Fix vulnerability in regex library. This only affects those who use
1175        this library, such as the windows version of Alpine. See
1176        <A HREF="http://www.kb.cert.org/vuls/id/695940">http://www.kb.cert.org/vuls/id/695940</A>
1177        for more details.
1178
1179   <LI> Alpine would not set include and lib paths for OpenSSL if this was
1180        installed in /usr/local/ssl.
1181
1182   <LI> If the .pinerc file is a symbolic link, Alpine might not write its
1183        contents when saving its configuration.
1184
1185   <LI> The _INIT_ token does not skip over non-alphanumeric characters in
1186        the name. Reported by Andreas Fehr.
1187
1188   <LI> When opening an INBOX folder in a context different from the
1189        incoming folders collection, from the command line, Alpine would
1190        open the INBOX folder from the incoming folders collection.
1191
1192   <LI> Mismatch in size of UCS and CELL caused a corruption in the
1193        content of a pointer, which made the speller in PC-Alpine get the
1194        content of a word incorrectly.
1195
1196   <LI> Skip testing openssl compatibility version when cross-compilation
1197        is detected. Fix contributed by Antti Sepp&auml;l&auml;
1198
1199   <LI> Alpine fails to remove temporary files used during a display or sending
1200        filter. Fix contributed by Phil Brooke.
1201
1202   <LI> When the index is in zoomed state, adding new messages to the
1203        selection would not show those messages if those messages are on
1204        top of the current message in the top of the screen. Reported by
1205        Ulf-Dietrich Braumann. In addition, when the user scrolls through
1206        the index, this scroll smoothly, without jumping pages. Reported
1207        by Holger Trapp.
1208
1209   <LI> Crash when reviewing history of saving attachments.
1210
1211   <LI> Crash when canceling a goto command on a local collection that has
1212        not been expanded and attempting to expand such collection.
1213
1214   <LI> Crash in Pico when forwarding messages that contain a direction mark
1215        at the end of a line. Reported by James Mingo.
1216
1217   <LI> Solve compilation errors when Alpine is built with Visual Studio 2015.
1218 </UL>
1219
1220
1221 <P>
1222 Version 2.20 addresses bugs found in previous releases and has several
1223 additions as well.
1224
1225 <P>
1226 Additions include:
1227 <P>
1228
1229 <UL>
1230   <LI> Upgrade UW-IMAP to Panda IMAP from
1231        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
1232   <LI> S/MIME: Add screen to manage certificates.
1233   <LI> S/MIME: Signatures are validated using the user's certificates instead
1234        of the ones included in the message. Behavior can be disabled by
1235        disabling the option <A href="h_config_smime_use_cert_store">
1236         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
1237        by default.
1238   <LI> S/MIME: sign messages using intermediate certificates when needed
1239        and possible.
1240   <LI> S/MIME: validation of certificates for servers that modify signed
1241        content.
1242   <LI> S/MIME: signed and encrypted messages will be signed first and
1243        encrypted second, so that they can be decoded by other clients.
1244   <LI> S/MIME: add the sender certificate to the list of certificates in
1245        encrypted messages to make it possible for the sender to decrypt
1246        the message they sent.
1247   <LI> S/MIME: When transferring certificates to a local container, create
1248        container with default names PublicContainer, PrivateContainer and
1249        CAContainer, as appropriate for these files, unless the user has
1250        provided some other names.
1251   <LI> S/MIME: Forwarding a message will include the signed part as part
1252        of the text and not as a multipart message, just as the reply
1253        command does.
1254   <LI> HTML: Style tag in body of html message causes Alpine to not write
1255        its content until a new &lt;/style&gt;
1256   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
1257        the same inline tag; the same is valid for the &lt;HR&gt; tag.
1258   <LI> Add support to selective expunge through a subcommand of the
1259        select-apply commands. Read more in the <A
1260        HREF="h_index_cmd_expunge">help</A> for the expunge command.
1261   <LI> Pico: New subcommand of the search command, allows to reverse the
1262        direction of search.
1263   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
1264        the key and certificate used to encrypt the password file are saved
1265        in the ~/.alpine-smime/.pwd directory, or in the directory specified
1266        by the -pwdcertdir command line option.
1267        <A HREF="h_password_file_support">Learn more</A>.
1268   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
1269        server to use different ways to connect using ssl, for
1270        example {server.com/tls1} will attempt to connect to
1271        server.com at the ssl imap port (port 993) and establish a
1272        connection using TLSv1. These flags can be used in
1273        conjunction with the /ssl flag, the ssl flag is redundant.
1274        Conversely, however, the /ssl flag does not imply any of
1275        these flags; the /ssl flag means SSLv3 or, if not available,
1276        SSLv2 in the SSL port.
1277   <LI> Alpine does not attempt to automatically reopen a collection
1278        that was not opened due to cancellation by the user.
1279        Instead, the user must try to open it explicitly.
1280   <LI> Alpine searches for a certificate that matches an email address in
1281        all addresses in a certificate (instead of just the first
1282        one) but when it tries to unlock the certificate, it asks
1283        for the password for the first email address in that
1284        certificate.
1285   <LI> Style tag in body of html message causes Alpine to not write its content
1286        until a new &lt;/style&gt;
1287   <LI> Experimental: Write the content-type of a message in
1288        lowercase, as some non-compliant servers do not understand
1289        uppercase content-type, such as those of GMX.de.
1290   <LI> Experimental: Do not send the RSET command before attempting
1291        to send a message, as this causes a delay in some evily managed
1292        servers.
1293   <LI> Opening a folder updates recent count in maildrops (this
1294        already works for other types of folders)
1295   <LI> Automatically redraw screen after opening an attachment
1296        instead of simply clearing it.
1297   <LI> Pico: Justification works without need of a predefined quote
1298        string. This allows justification of blocks of text that are
1299        indented with spaces.
1300   <LI> Decode the name of attachment names, so they can be written as part
1301        of the description of the part.
1302   <LI> Check bounds and tie strings off to improve security. Contributed
1303        by James Jerkins.
1304   <LI> Replace tabs by spaces in From and Subject fields to control for
1305        size in screen of these fields. Change only in index screen display.
1306   <LI> Aggregate operations allows bouncing a list of messages using a role.
1307        Suggested by Ulf-Dietrich Braumann.
1308   <LI> Disable saving new passwords to the password file. Implemented
1309        by Louis Raphael from dpslabs.com. <A HREF="h_config_disable_password_file_saving">Learn more.</A>
1310   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
1311      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
1312      Charles M. Register.
1313 </UL>
1314
1315
1316 <P>
1317 Bugs that have been addressed include:
1318 <UL>
1319   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
1320        in personal names. Reported by Lev Gorenstein.
1321   <LI> When writing the .pinerc file, lines were truncated if they were longer
1322        than 10,000 characters. This could cause data corruption, so now lines
1323        are allowed to be of any length.
1324   <LI> S/MIME: signed messages that contained an attachment would not validate.
1325   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
1326        validate. Thanks to Andreas Schamanek for testing, debugging and
1327        advising during the process of fixing this problem.
1328   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
1329        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
1330        and Stefan Mueller.
1331   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
1332        home directory.
1333   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
1334        SMIME making it not possible to sign or encrypt messages.
1335   <LI> S/MIME: Forwarding a signed message might make the body contain mime
1336        information that is not part of the body, and hence making the body
1337        of the message seem wrong.
1338   <LI> S/MIME Alpine would compute incorrectly the signature of a message
1339        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
1340        enabled, the message contains 8bit characters and the smtp server
1341        supports 8bit sending.
1342   <LI> When replying to several messages, subject will be decoded first,
1343        and then stripped from re/fwd before they are compared to determine
1344        the subject of the replied message.
1345   <LI> Crash when tcp connection to NNTP server was lost after connection
1346        had been established, but lost immediately afterwards.
1347   <LI> Crash with message &quot;lock when already locked&quot;, when painting
1348        an index was based on scores that needed information from a remote
1349        addressbook in the same server as the folder opened. Reported by
1350        Peter Koellner.
1351   <LI> Crash in message/rfc822 attachments encoded in base64.
1352   <LI> Postponed messages whose content-type is text/html, text/enriched and
1353        text/richtext are sent with that content-type, even though, after
1354        resuming composition, Alpine had changed its type to text/plain.
1355   <LI> Alpine cannot handle correctly some characters in the Windows-1256
1356        character set, which might lead to a crash or a corruption in the
1357        screen. Work was done to contain the bug. A more complete fix will
1358        be done in a future release. Reported by Professor Robert Funnell.
1359   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
1360   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
1361   <LI> Save command did not warn of existence of a message with a deleted
1362        attachment in an aggregate save, unless cursor was positioned on a message
1363        with a deleted attachment. Reported by Florian Herzig.
1364   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
1365        in an IMAP server.
1366   <LI> DATE tokens were not internally transformed to UTF-8, which made their
1367        values not appear complete in the screen. Reported by Werner Scheinast.
1368   <LI> Fixes to configure script so that it will not require PAM for every system.
1369   <LI> Fix to configure script so that it will use CPPFLAGS instead of
1370        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
1371        during the build. Fix by Ulf-Dietrich Braumann.
1372   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
1373        needs to use tcl_getstringresult() instead. Reported by
1374        Ulf-Dietrich Braumann.
1375   <LI> Quoted string in URL Viewers configuration variable were not
1376        unquoted before passing to viewer.
1377   <LI> Fix in configure script to detect location of tcl library; add
1378        /usr/local in FreeBSD and fix a bug in configure script that used
1379        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
1380        by Werner Scheinast.
1381   <LI> Move SSL configurations from UW-IMAP to configure script, and
1382        update OpenSSL configuration for Mac OS X.
1383   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
1384   <LI> When the download of an attachment is interrumpted, Alpine stills
1385      caches what was downloaded, making the download incomplete for
1386      subsequent calls of Alpine attempting to open the attachment. In the
1387      future, Alpine will not cache any downloaded part of the attachment
1388      when it is interrupted.
1389 </UL>
1390 <P>
1391
1392
1393 <P>
1394 Version 2.11 addresses bugs found in previous releases and has a few
1395 additions as well.
1396
1397 <P>
1398 Additions include:
1399 <P>
1400
1401 <UL>
1402    <LI> Alpine requires version 1.0.0c of Openssl to build.
1403    <LI> Increase encryption of S/MIME encrypted messages.
1404    <LI> Pico: Improvements in justification of paragraphs: lines that begin
1405 with a quote string, followed by a space were considered individual paragraphs,
1406 now they are considered part of a paragraph. Based on earlier joint work
1407 with Jeff Franklin.
1408    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
1409    <LI> Experimental extended support of recognition of UTF-8 in urls based on
1410 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
1411    <LI> Added recognition of ws and wss URIs.
1412    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
1413  <A HREF="h_config_directory_color">directory names</A>,
1414  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
1415    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
1416 used in the display of the INDEX SCREEN.
1417    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
1418 that adds the ability to preserve To: and Cc: fields when replying to a
1419 message, as specified by original sender.
1420    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
1421  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
1422    <LI> Quota command includes subcommands for printing, forwarding, etc.
1423 </UL>
1424
1425 <P>
1426 Bugs that have been addressed include:
1427 <P>
1428 <UL>
1429   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
1430   <LI> Crash when resizing the screen in a configuration screen.
1431   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
1432   <LI> Do not use a shell to open a browser.
1433   <LI> Configure script did not test for crypto or pam libraries.
1434   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
1435   <LI> Change Cygwin directory separator to &quot;/&quot;.
1436   <LI> Alpine could set List- headers, contrary to RFC 2369.
1437 </UL>
1438
1439 <P>
1440 Version 2.10 addresses bugs found in previous releases and has a few
1441 additions as well.
1442
1443 <P>
1444 Additions include:
1445 <P>
1446
1447 <UL>
1448    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
1449    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
1450    <LI> Foreign characters are decoded correctly in IMAP folder names.
1451    <LI> Question about breaking connection to slow servers includes their name.
1452    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
1453    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
1454    <LI> Cygwin: Alpine builds without need of patch.
1455    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
1456    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
1457    <LI> Add support for strong encryption of password file when S/MIME is built in.
1458 </UL>
1459
1460 <P>
1461 Bugs that have been addressed include:
1462 <P>
1463
1464 <UL>
1465    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
1466    <LI> Double allocation of memory in Pico.
1467    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
1468    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
1469    <LI> Not recognition of environment variables in some options.
1470    <LI> Not display of login prompt during initial keystrokes.
1471    <LI> justification of long urls breaks them.
1472    <LI> Incorrect New Mail message when envelope is not available.
1473    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
1474    <LI> Crash when resizing the screen after display of LDAP search.
1475    <LI> Crash when redrawing screen while opening a remote folder collection.
1476    <LI> Infinite loop in scrolltool function during notification of new mail.
1477    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
1478    <LI> No display of signed and encrypted S/MIME messages.
1479    <LI> Alpine will not build with OpenSSL.
1480    <LI> Crash for double locking in calls to c-client.
1481    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
1482    <LI> Ignore the references header when threading messages
1483    <LI> No update of colors in index screen after update to addressbook.
1484 </UL>
1485
1486 <P>
1487 Version 2.01 addresses bugs found in previous releases and has a few
1488 additions as well.
1489
1490 <P>
1491 Additions include:
1492 <P>
1493
1494 <UL>
1495    <LI> Fixed non-ASCII web alpine handling
1496    <LI> Added web alpine help.
1497    <LI> Allow web alpine inbox on second IMAP server.
1498    <LI> Allow web alpine config reset after bad inbox-path gets set.
1499    <LI> Added web alpine ability to create group contact from contact list members.
1500    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
1501    <LI> Tidied up web alpine script layout.
1502    <LI> Fixed web alpine status message ordering
1503    <LI> Added web alpine Fcc setting via Contacts in Compose
1504    <LI> Fixed web alpine autodraft attachment issues
1505    <LI> Fixed web alpine problems with recent count maintenance
1506    <LI> Fixed web alpine newmail arrival display in message list
1507    <LI> Added web alpine confirmation to folder create for Move/Copy
1508    <LI> Added web alpine user-domain support
1509    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
1510 </UL>
1511
1512 <P>
1513 Bugs that have been addressed include:
1514 <P>
1515
1516 <UL>
1517    <LI> In web alpine fixed delete all selected within a search result to reorient
1518         correctly to whole-mailbox message list.
1519    <LI> Fixed web alpine delete in view page to be sensitive to sort
1520    <LI> Fixed web alpine open of folder within directory from folder manager page.
1521    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
1522    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
1523    <LI> Fixed web alpine adding contacts from message list and view
1524    <LI> Fixed web alpine create of non-existent fcc
1525    <LI> Remove mistakenly left debugger statement in web alpine javascript.
1526    <LI> Some UNIX alpine build problems fixed
1527    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
1528         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
1529         by locale charmap call on some Solaris 8 systems.
1530    <LI> MacOS Keychain logins were not working correctly with generic host names, like
1531         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
1532         new password requests when not needed
1533    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
1534         last folder in the list
1535    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
1536         looked for along with the email address
1537    <LI> Changes to configure to get spellcheck options with work with arguments.
1538    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
1539         returned by gethostname (iPhone can do this)
1540    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
1541         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
1542    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
1543         Jake Scott of marganstanley.com.
1544    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
1545         is not used in alpine.
1546    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
1547         Apparently this causes RIM Blackberry BIS service problems. This is not
1548         used in alpine.
1549    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
1550    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
1551         Fix from Ludwig Nussel of SUSE and from Crispin.
1552    <LI> Include whole filename in export filename history
1553    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
1554 </UL>
1555
1556 <P>
1557 Version 2.00
1558 addressed bugs found in previous releases and had a few additions as well.
1559 <P>
1560 Additions included:
1561 <P>
1562
1563 <UL>
1564    <LI> Redesigned Web Alpine interface
1565    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
1566         in UNIX versions of Alpine
1567    <LI> Attempt to include the attachment filename as part of the name of the
1568         temporary file used when viewing an attachment with an external program.
1569         Add some randomness to that filename to make it hard to predict the filename.
1570         Add a filename extension, usually derived from the type/subtype, to the
1571         temporary filename. This was previously done only on Windows and MacOS X.
1572    <LI> Enhance address completion in the composer (TAB command) so that it looks
1573         through nicknames, fullnames, and addresses from the address book; addresses
1574         from the message being viewed, if any; and the results from
1575         <A HREF="h_direct_config">LDAP Directory Server</A>
1576         lookups for all of the defined directory servers that have the
1577         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
1578         feature set.
1579    <LI> Make the default character set setting more liberal in what it will accept
1580         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
1581    <LI> Remove the Alpine revision number from the titlebar in released versions
1582         while leaving it there in snapshot versions
1583    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
1584         display of asterisks when you type a password for Alpine
1585    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
1586    <LI> When the
1587         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
1588         feature is turned on convert not only the dates in the index screen but also
1589         the dates in the MESSAGE VIEW
1590 </UL>
1591
1592 <P>
1593 Bugs addressed in the 2.00 release included:
1594 <P>
1595
1596 <UL>
1597    <LI> Crash when using tab-completion for selecting a Save filename
1598    <LI> Make Web Alpine help text images relative for more portability
1599    <LI> Fixed attach save of html parts in Web Alpine
1600    <LI> Viewing, printing, exporting, replying, and bouncing of message
1601         digests was broken. Replying and bouncing should not have been
1602         allowed at all for digests. It would be nice to have a more standard
1603         index-like view of a message digest but that has not been addressed
1604         with this minor bug fix.
1605    <LI> Adjust wrapping of HTML messages so that the margins specified by
1606         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
1607         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
1608         are observed correctly
1609    <LI> Interrupt of WhereIs command in index was broken
1610    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1611         option did not work correctly interpreting unknown characters in message headers
1612    <LI> Long address lines could cause blank continuation lines
1613    <LI> Save to a local default INBOX failed if the primary collection was also local,
1614         which it is by default. The save went to  ~/mail/inbox instead.
1615    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
1616         inbox, not the inbox in the primary collection
1617    <LI> Address book entries with lots of addresses would be truncated when
1618         entered in the composer with a screen size wider than 270 or so characters
1619    <LI> Some fields in the index screen were truncated when the screen width was
1620         wider than 256 characters
1621    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
1622         folder, and there is a more than 10 minute pause between typing the TAB
1623         and typing the Yes
1624 </UL>
1625
1626 <P>
1627 Version 1.10(962)
1628 addressed bugs found in previous releases and had a few additions as well.
1629 <P>
1630 Additions included:
1631 <P>
1632
1633 <UL>
1634    <LI> Add the possibility of setting a default role
1635         (see <A HREF="h_role_select">Roles Screen</A>)
1636         which may be convenient if your work flow involves acting in one
1637         role for a while then switching to another role and staying in the
1638         new role for another period of time
1639    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
1640         is encountered, ask the user if he or she wants to continue with the
1641         risky Save anyway instead of aborting. This may be helpful if your
1642         IMAP server is broken in this way but be aware that it is possible there
1643         was a real error instead of just a broken server implementation.
1644    <LI> Some configure adjustments for Kerberos detection and
1645         for SCO OpenServer 5 support
1646    <LI> Hide INBOX in a collection if it also appears as an
1647         <A HREF="h_config_enable_incoming">Incoming Folder</A>
1648    <LI> Show asterisks for feedback when the user is typing a password
1649    <LI> Performance improvement for threading of large folders
1650    <LI> Previously, the search used to find
1651         Pattern matches containing To patterns searched for both To
1652         and Resent-To headers. The relatively complicated search this
1653         produces causes problems when using some deficient IMAP servers.
1654         Now the default is to look only for To headers and ignore the
1655         presence of Resent-To. The previous behavior may be restored
1656         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
1657    <LI> Add an
1658         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1659         to help with reading malformed unlabeled messages
1660    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
1661    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
1662    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
1663 </UL>
1664
1665 <P>
1666 Bugs addressed in the 1.10(962) release included:
1667 <P>
1668
1669 <UL>
1670    <LI> Crash when encountering certain errors from an SMTP server
1671    <LI> Crash in composer caused by overflow in replace_pat()
1672    <LI> Hang when authenticating to an SMTP server that fails with a
1673         &quot;connection disconnected&quot; error
1674    <LI> Bug in handling of trailing tab character in flowed text
1675    <LI> Security enhancement for mailcap parameter substitution
1676    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
1677         did not work if the message being replied to was not flowed text
1678         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
1679         was not turned on
1680    <LI> Don't allow printer to be changed through hidden config screen
1681         if system administrator didn't want it to be allowed
1682    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
1683         should know that it won't work, causing error messages to appear
1684    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
1685         of double-quote double-quote didn't work right
1686    <LI> Quoting wasn't being done to protect special characters from the
1687         MacOS X shell when
1688         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
1689         was not defined
1690    <LI> On MacOS X message attachments should be shown internally instead of
1691         being shown using the Mail application
1692    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
1693         sometimes set the outgoing charset to X-UNKNOWN, making the result
1694         unreadable
1695    <LI> When the sending of a message failed lines with leading spaces had one
1696         additional space inserted in each of those lines when the user
1697         was returned to the composer
1698    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
1699         that contained non-ascii characters because it was truncating the
1700         line being searched so that it was shorter than what was visible on
1701         the screen
1702    <LI> When composing, an attachment with a long name that causes wrapping in
1703         just the wrong place would generate an error and cause the send
1704         of the attachment to fail
1705    <LI> After calling the file browser to attach a file in the composer, a resize
1706         of the window when back in the composer would redraw the last screen that
1707         had been shown in the browser instead of the current composer screen
1708    <LI> Possible crash in index screen when encountering unparsable addresses
1709         or when using one of the PRIORITY tokens or the HEADER token in the
1710         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
1711    <LI> Problems with Header Color editing if the configuration option
1712         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
1713         was inadvertently changed to the Empty Value in the hidden config screen
1714    <LI> When resuming the final postponed message from an Exchange server the user
1715         could get a certificate validation failure because alpine was trying
1716         to validate the canonical name of the folder instead of the name the
1717         user used
1718    <LI> Windows line endings in a mimetypes file on a Unix system cause a
1719         failure to find a match
1720    <LI> Make matching of extension names case independent in mimetypes files
1721    <LI> Windows dialog boxes for entering text were not working correctly
1722    <LI> Replying to or Forwarding multipart/alternative messages which had a
1723         single text/html part did not work well
1724    <LI> Printing the print confirmation page caused a crash
1725    <LI> A To line with a long, quoted personal name could display incorrectly
1726         if it was close to the same width as the screen
1727    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
1728         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
1729         are turned on hide (0/0) when the folder is empty
1730    <LI> Folder completion while Saving didn't work if the collection being
1731         saved to was the local home directory
1732 </UL>
1733
1734 <P>
1735 Version 1.00
1736 was an evolutionary release based on Pine, which was also
1737 developed at the University of Washington.
1738 It is upwards-compatible for existing Pine users.
1739
1740 <P>
1741 Changes included:
1742 <P>
1743 <UL>
1744    <LI> Ground-up reorganization of source code around addition
1745         of "pith/" core routine library.
1746    <LI> Fundamental improvement in Alpine's internal text handling, which
1747         is now based exclusively on Unicode. This allows displaying incoming
1748         messages and producing outgoing messages in many different languages.
1749    <LI> Ground-up reorganization of build and install procedures
1750         based on GNU Build System's autotools. NOTE, the included IMAP library
1751         build is not based on autotools, so some features will not work. However,
1752         it should get built automatically during the Alpine build process.
1753    <LI> Web-based version included built on TCL designed to run under
1754         a suitable CGI-supporting web server such as Apache.
1755 </UL>
1756
1757 <P>
1758
1759 Details on changes in previous (prerelease) versions of Alpine
1760 may be found at the following URL:
1761 <P>
1762 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1763 <P>
1764
1765 <HR WIDTH="75%"><P>
1766
1767 <H2>Getting Help</H2>
1768 <DL>
1769 <DT>Online Help</DT>
1770 <DD>
1771 Every Alpine screen and command has associated help text
1772 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
1773 </DD>
1774
1775 <DT>Web Help</DT>
1776 <DD>
1777 The most current source of information about Alpine,
1778 including new version availability, is the web page at
1779 <P>
1780 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1781 </DD>
1782 </DL>
1783
1784 <HR WIDTH="75%"><P>
1785
1786 <H2>Additional Information</H2>
1787
1788 General Alpine configuration information can be found
1789 <A HREF="h_news_config">here</A>.
1790 <P>
1791 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
1792 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
1793 access is provided by the IMAP Toolkit Environment (c-client library)
1794 version <!--#echo var="C_CLIENT_VERSION"-->.
1795 <P>
1796 Alpine was developed until 2009 by the Office of Computing
1797 &amp; Communications at the University of Washington in Seattle.
1798 Since then, the effort of developing Alpine has been continued by
1799 a community of volunteers who make good software even better!
1800
1801 <P>
1802 Alpine Copyright 2013-2021 Eduardo Chappa,
1803 <BR> Copyright 2006-2008 University of Washington.
1804
1805 <P>
1806 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
1807 or instead you can find the Apache License, version 2.0 at the web URL:
1808
1809 <P>
1810 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
1811
1812 <P>
1813 &lt;End of Release Notes&gt;
1814 </BODY>
1815 </HTML>
1816 ====== h_password_file_support ======
1817 <HTML>
1818 <HEAD>
1819 <TITLE>Encryption for Password File Support Explained</TITLE>
1820 </HEAD>
1821 <BODY>
1822 <H1>Encryption for Password File Support Explained</H1>
1823
1824 Index<BR>
1825 <OL>
1826 <LI><A HREF="#content">Explanation</A>
1827 <LI><A HREF="#example_existing_key">Example of Use of Existing Key and Certificate</A>
1828 <LI><A HREF="#example_self_signed">Example of Creating Master Password</A>
1829 </OL>
1830
1831 <P><A NAME="content">Unix Alpine Only.</A>
1832
1833 <P> If your version of Alpine has been built with password file support
1834 then you can use a special file to save your passwords, and avoid typing
1835 them every time you open a connection to a remote server.
1836
1837 <P> If, in addition, your version of Alpine was built with SMIME support, then your
1838 password file will be encrypted with a strong key. There are two ways in
1839 which this can happen: Alpine will either use a matching private key and
1840 public certificate pair that you already own, or it will create one for
1841 you, just for purposes of encrypting this file. We describe both processes
1842 below.
1843
1844 <P> Initially, Alpine will scan your public and private directories for a
1845 certificate/private key pair that works. Alpine will pick the first pair
1846 that it finds that matches.
1847
1848 <P> Once a pair has been chosen, it will be copied to the directory
1849 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
1850 that directory. The first time this process is done, this directory will
1851 be created, a key/certificate pair will be copied to it, from then on
1852 this pair will be used to encrypt and decrypt your password file.
1853
1854 <P> If you want to use a specific key and certificate pair to encrypt
1855 your password file, you can create the directory ~/.alpine-smime/.pwd
1856 manually, and then create your preferred key/certificate pair there.
1857 Alpine will use this key regardless of if it has expired, or if it is
1858 self-signed. These issues do not affect the encryption or decryption
1859 of the password file.
1860
1861 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
1862 your key/certificate pair, you can specify a different one with the
1863 -pwdcertdir command line option in Alpine. If the directory specified by
1864 this option is not found Alpine will fail to encrypt and decrypt your
1865 password file. However if it exists, Alpine will search for a
1866 key/certificate pair in that
1867 directory, and if it does not find one, it will create one and save it
1868 in that directory.
1869
1870 <P> Alpine does not care about the names of the key and certificates in
1871 this directory, but the private key must have &quot;.key&quot; extension
1872 and your public certificate must have the &quot;.crt&quot; extension. The
1873 name of the private key will be used in the prompt when you are asked
1874 to unlock your key to decrypt your password.
1875
1876 <P> If Alpine cannot find a suitable private key and public certificate
1877 pair to encrypt your password, it will create one. You will be asked to
1878 create a &quot;Master Password&quot; to protect such key. At this moment
1879 there are no restrictions on passwords, other than they have to be at
1880 least 8 characters long, but future versions of Alpine will include
1881 functionality to restrict master passwords, as set up by the administrator
1882 of the system in the pine.conf.fixed file.
1883
1884 <P><A NAME="example_existing_key"><B>Example of Use of Existing Key and Certificate</B></A>
1885
1886 <P>Assume you have a private key called peter@address.com.key in your,
1887 ~/.alpine-smime/private directory, and a public certificate called
1888 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
1889 are your only key/certificate pair.
1890
1891 <P> When Alpine starts for the first time, without command line options,
1892 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
1893 it will create it. Then it will go through your keys and certificates and
1894 find a pair that it can use, and copy the files peter@address.com.key,
1895 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
1896 you can do the same by copying these files by yourself. This can be done
1897 with the sequence of commands
1898
1899 <PRE>
1900 mkdir ~/.alpine-smime/.pwd
1901 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
1902 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
1903 </PRE>
1904
1905 <P> When Alpine starts, you will be asked the password to unlock your
1906 private key with the prompt.
1907
1908 <PRE>
1909 Enter password of key &lt;peter@address.com&gt; to unlock password file:
1910 </PRE>
1911
1912 <P> If you prefer to use different names for your private and public keys
1913 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
1914 preserve the extension of the files. For example, you can use the names
1915 private_key.key and public_cert.crt instead. In this case, the prompt you
1916 will see when you are asked to unlock your private key will read
1917
1918 <PRE>
1919 Enter password of key &lt;private_key&gt; to unlock password file:
1920 </PRE>
1921
1922 <P>Observe that you do not need to use an existing key/certificate pair,
1923 and that you can create a new private key/public certificate pair to
1924 encrypt and decrypt your password file. Alpine provides a mechanism to
1925 change the encryption key for this file in the S/MIME configuration
1926 screen.
1927
1928 <P><A NAME="example_self_signed"><B>Example of Creating Master Password</B></A>
1929
1930 <P> If Alpine cannot find a suitable private key and public certificate pair
1931 to encrypt your password file, it will create one. When doing so, it will
1932 start the process with the following warning:
1933
1934 <PRE>
1935 Creating a Master Password for your Password file.
1936 </PRE>
1937
1938 <P> Then Alpine will ask you to enter your Master Password:
1939
1940 <PRE>
1941 Create master password (attempt 1 of 3):
1942 </PRE>
1943
1944 <P> Once you enter this password, and it validates according to system policy,
1945 you will be asked to confirm this password.
1946
1947 <PRE>
1948 Confirm master password (attempt 1 of 3):
1949 </PRE>
1950
1951 <P> If you input the same password, then Alpine will set that as your
1952 Master Password, and you will use this password to unlock your key in the
1953 future.
1954
1955 <P> If you would like to switch your Master Password in the future, you can
1956 do so by creating a new public key and public certificate pair. You can do
1957 so in the S/MIME configuration screen, in the &quot;Manage Key and
1958 Certificate for Password File&quot; section, simply enter your current
1959 password to unlock your current key and then press &quot;C&quot; to create
1960 a new key.
1961
1962 <P>
1963 &lt;End of help&gt;
1964 </BODY>
1965 </HTML>
1966 ====== h_network_encryption_security ======
1967 <HTML>
1968 <HEAD>
1969 <TITLE>Network Encryption Security Explained</TITLE>
1970 </HEAD>
1971 <BODY>
1972 <H1>Network Encryption Security Explained</H1>
1973
1974 You can specify which encryption protocol you would like to try when
1975 creating a secure connection to a server. Alpine will attempt to use
1976 that encryption protocol, but in practice the protocol being used will
1977 default to the most secure protocol that both Alpine and the server
1978 support.
1979
1980 <P> If you use the latest version of OpenSSL, the /ssl modifier to the
1981 server definition will use the most secure version of the TLS encryption
1982 protocol. The same will be true if you try /tls1_1 or /tls1_2, but in an
1983 old version of OpenSSL (pre 1.1.0 series) /tls1_1 might mean to use
1984 version 1.1 of the TLS protocol.
1985
1986 <P> You will never go wrong by using the /ssl modifier. At the time of
1987 this writing OpenSSL had released version 1.1.1, with support for
1988 TLS version 1.3. If your version of OpenSSL does not support this version
1989 of the TLS protocol, then the /tls1_3 modifier will only mean to use
1990 the most secure version of the TLS protocol that OpenSSL and the
1991 server can negotiate. In future versions of OpenSSL, /tls1_3 might mean
1992 to try to negotiate a higher version of the TLS protocol.
1993
1994 <P> In order to avoid confusion, the /ssl flag is the best way to guarantee
1995 the highest encryption protocol available, and it is the recommended
1996 modifier to the server definition to create a secure encrypted connection.
1997
1998 <P>
1999 &lt;End of help&gt;
2000 </BODY>
2001 </HTML>
2002 ====== h_gmail_configuration ======
2003 <HTML>
2004 <HEAD>
2005 <TITLE>Configuring Access to Gmail Using XOAUTH2</TITLE>
2006 </HEAD>
2007 <BODY>
2008 <H1>Configuring Access to Gmail Using XOAUTH2</H1>
2009
2010 Gmail allows you to access their IMAP and SMTP server using either the XOAUTH2
2011 or OAUTHBEARER authentication method. You can choose any of them. A sample configuration for reading
2012 incoming mail is
2013
2014 <P>
2015 inbox-path = {imap.gmail.com/ssl/user=YourId@gmail.com/auth=xoauth2}INBOX<BR>
2016 smtp-server = smtp.gmail.com/ssl/user=YourId@gmail.com/auth=xoauth2
2017
2018 <P>
2019 Note that you can substitute /auth=xoauth2 by /auth=oauthbearer.
2020
2021 <P>
2022 Gmail implements the authorize method. This means that in order to use xoauth2, you must
2023 open a URL, login to your Gmail account, and authorize Alpine to access your email. As a
2024 result of this process, you will get a <B>code</B>, which you must input back into Alpine.
2025 Once you have done that, Alpine will be able to get a refresh and access token, which
2026 Alpine will use later to read and send email.
2027
2028 <P>
2029 &lt;End of help&gt;
2030 </BODY>
2031 </HTML>
2032 ====== h_outlook_configuration ======
2033 <HTML>
2034 <HEAD>
2035 <TITLE>Configuring Access to Outlook Using XOAUTH2</TITLE>
2036 </HEAD>
2037 <BODY>
2038 <H1>Configuring Access to Outlook Using XOAUTH2</H1>
2039
2040 Outlook allows you to access their IMAP and SMTP server using the XOAUTH2
2041 authentication method. A sample configuration for reading incoming mail is
2042
2043 <P>
2044 inbox-path = {outlook.office365.com/ssl/user=YourId@outlook.com/auth=xoauth2}INBOX<BR>
2045 smtp-server = smtp.office365.com/submit/user=YourId@outlook.com/auth=xoauth2
2046
2047 <P>
2048 Outlook implements the authorize and device methods to get your authorization to access
2049 your account. Alpine uses by default the device method, so try that one first.
2050
2051 <P>
2052 &lt;End of help&gt;
2053 </BODY>
2054 </HTML>
2055 ====== h_yahoo_configuration ======
2056 <HTML>
2057 <HEAD>
2058 <TITLE>Configuring Access to Yahoo! Using XOAUTH2</TITLE>
2059 </HEAD>
2060 <BODY>
2061 <H1>Configuring Access to Yahoo! Using XOAUTH2</H1>
2062
2063 Yahoo! allows you to access their IMAP and SMTP server using either the XOAUTH2 or
2064 OAUTHBEARER authentication method. You can choose any of them. A sample configuration for
2065 reading incoming mail is
2066
2067 <P>
2068 inbox-path = {imap.mail.yahoo.com/ssl/user=YourId@yahoo.com/auth=xoauth2}INBOX<BR>
2069 smtp-server = smtp.mail.yahoo.com/ssl/user=YourId@yahoo.com/auth=xoauth2
2070
2071 <P>
2072 Note that you can substitute /auth=xoauth2 by /auth=oauthbearer.
2073
2074 <P>
2075 Yahoo! implements the authorize method. This means that in order to use xoauth2, you must
2076 open a URL, login to your Yahoo! account, and authorize Alpine to access your email. As a
2077 result of this process, you will get a <B>code</B>, which you must input back into Alpine.
2078 Once you have done that, Alpine will be able to get a refresh and access token, which
2079 Alpine will use later to read and send email.
2080
2081 <P>
2082 &lt;End of help&gt;
2083 </BODY>
2084 </HTML>
2085 ====== h_yandex_configuration ======
2086 <HTML>
2087 <HEAD>
2088 <TITLE>Configuring Access to Yandex Using XOAUTH2</TITLE>
2089 </HEAD>
2090 <BODY>
2091 <H1>Configuring Access to Yandex Using XOAUTH2</H1>
2092
2093 Yandex allows you to access their IMAP and SMTP server using the XOAUTH2
2094 authentication method. A sample configuration for reading incoming mail is
2095
2096 <P>
2097 inbox-path = {imap.yandex.com/ssl/user=YourId@yandex.com/auth=xoauth2}INBOX<BR>
2098 smtp-server = smtp.yandex.com/ssl/user=YourId@yandex.com/auth=xoauth2
2099
2100 <P>
2101 Yandex implements the authorize method. This means that in order to use xoauth2, you must
2102 open a URL, login to your Yandex account, and authorize Alpine to access your email. As a
2103 result of this process, you will get a <B>code</B>, which you must input back into Alpine.
2104 Once you have done that, Alpine will be able to get a refresh and access token, which
2105 Alpine will use later to read and send email.
2106
2107 <P>
2108 &lt;End of help&gt;
2109 </BODY>
2110 </HTML>
2111 ====== h_xoauth2 ======
2112 <HTML>
2113 <HEAD>
2114 <TITLE>XOAUTH2 Authenticator Explained</TITLE>
2115 </HEAD>
2116 <BODY>
2117 <H1>XOAUTH2 Authenticator Explained</H1>
2118
2119 The XOAUTH2 authenticator method is a way in which you can sign in to your
2120 account to read and send email. This method is different from the traditional
2121 username/password that users are accustomed to, and it needs to be set up
2122 by the user. This text will help you understand this authentication method.
2123
2124 <P> A quick list of services supported by Alpine are (follow each link for
2125 specific configuration instructions)
2126
2127 <UL>
2128 <LI> <A href="h_gmail_configuration">Gmail</A>
2129 <LI> <A href="h_outlook_configuration">Outlook</A>
2130 <LI> <A href="h_yahoo_configuration">Yahoo!</A>
2131 <LI> <A href="h_yandex_configuration">Yandex</A>
2132 </UL>
2133
2134 <P>
2135 The most important difference between this method and other authentication
2136 methods is what happens if someone steals your credentials. This method is
2137 attached to three components: Your username, your password and your email
2138 program.
2139
2140 <P>
2141 At the beginning of this process, the developer of the email program
2142 registers the email program with the email service provider (Gmail,
2143 Outlook, etc.) In return, the email service provider creates a client-id.
2144 In addition, some services provide a client-secret.
2145 Since Alpine is an open source program, these values are part
2146 of the source code, and are known to everyone, and cannot be obfuscated.
2147
2148 <P>
2149 After a program has been registered with an email service provider, the
2150 user must authorize the email program access to their email account in
2151 that service. Alpine helps you do that, but it cannot do all the process
2152 for you, and you will need to use an external web browser to authorize
2153 Alpine to read and send email.
2154
2155 <P>
2156 This part of the process is simple. Alpine creates a URL based on the id
2157 and secret created by the email service, which the user opens. Once the
2158 URL has been opened, the user signs in to the server, and once signed into
2159 the account, the user is asked to authorize Alpine access to the email
2160 account. If the user agrees, an &quot;<I>Access Code</I>&quot; will be
2161 generated.
2162
2163 <P>
2164 An Access Code is a very long string, and so the recommendation is to copy
2165 and paste this code back into Alpine, at the time Alpine is helping you
2166 set up this authenticator. This part of the process is done only once per
2167 email program (If you run Alpine in several computers, you would do this
2168 once per computer. Each computer gets its own Access Code.)
2169
2170 <P>
2171 Once Alpine has an Access Code, it goes back internally to the email
2172 service and asks it to generate two strings, called the &quot;<I>Refresh
2173 Token</I>&quot; and the &quot;<I>Access Token</I>&quot;. This part is
2174 invisible to the user, and they will never see it, but in order for you to
2175 understand what to do in case you lose them, you need to understand their
2176 use.
2177
2178 <P>
2179 The <I>Access Token</I> is the equivalent of a temporary password. It
2180 allows the user to access (and reaccess as many times as they would like)
2181 their email account for a limited amount of time, typically 1 hour after
2182 it was issued. After that time expires, users need a new Access Token.
2183
2184 <P>
2185 The <I>Refresh Token</I> is the equivalent of a password generator. With
2186 this token, Alpine can go to the email service provider and request a new
2187 Access Token. This part of the process does not need user intervention,
2188 anyone can do this, as long as they have the Refresh Token, program id and
2189 program secret, so it is important that users keep their Refresh Token as
2190 secure as they can.
2191
2192 <P>
2193 Given that the Refresh Token and the Access Token are long strings, users
2194 are not supposed to be able to memorize them and recall them later. Alpine
2195 will store them in the password file, should a user have one. Otherwise,
2196 the user will have to create one each time they run Alpine, starting by
2197 creating the Access Code all over each time they try to sign in to their
2198 email account. When Alpine is compiled with SSL and password file support,
2199 it will default to saving this information using encryption and under a
2200 master password, so unless they have made changes to this process, their
2201 Refresh and Access Tokens are saved securely and persist from one session
2202 to the next.
2203
2204 <P>
2205 Should any person steal your Refresh Token, you must login to your account
2206 with your username and password and revoke Alpine authorization to your
2207 account. This is enough to stop the person who stole your Refresh Token
2208 from accessing your email service. In the case of Gmail, changing your
2209 password will invalidate your Refresh Token, and this will be enough to
2210 prevent others from using a stolen Refresh Token. Consult with your email
2211 service provider to learn what you can do if someone steals your Refresh
2212 Token.
2213
2214 <P>
2215 If, for any reason, Alpine cannot sign in to your email service for two
2216 consecutive times with Access Codes generated by your Refresh Token, it
2217 will remove the Refresh Token from your password file, forcing you to get
2218 a new one, by getting an Access Code first, and granting authorization to
2219 Alpine to access your email once again.
2220
2221 <P>
2222 This implementation of XOAUTH2 knows the list of servers that it can
2223 access using the same credentials, so Alpine will be able to read and send
2224 emails using the same Access Token. You will not have to create
2225 Access and Refresh Tokens for the IMAP and SMTP servers separately.
2226
2227 <P>
2228 &lt;End of help&gt;
2229 </BODY>
2230 </HTML>
2231 ====== h_xoauth2_config_screen ======
2232 <HTML>
2233 <HEAD>
2234 <TITLE>XOAUTH2 Configuration Screen</TITLE>
2235 </HEAD>
2236 <BODY>
2237 <H1>XOAUTH2 Configuration Screen</H1>
2238
2239 The XOAUTH2 configuration screen helps you connect your client-id and
2240 other configuration information about the service you want to use with
2241 Alpine.
2242
2243 <P> Alpine provides a default configuration for you. For some providers
2244 this configuration does not work, and requires you to get your own
2245 Client-ID for Alpine. Depending on the service, you might need extra information,
2246 such as a Client-Secret or a Tenant.
2247
2248 <P> If the default configuration of Alpine does not work for you, you can simply
2249 replace the default configuration of Alpine by your new configuration. If for
2250 any reason you need to have a second client-id, you can use the ^A command to
2251 add a new configuration for one of the supported services by Alpine.
2252
2253 <P> If you wish to delete a configuration for a service, place the cursor
2254 on the configuration you want to delete and press ^D.
2255
2256 <P> When you have more than one client-id for the same service, is is convenient
2257 to fill up the username field. This will tell Alpine that that specific configuration
2258 is to be used with the username(s) specified in that variable. If Alpine cannot
2259 determine which configuration to use, it will ask you to select the correct
2260 Client-ID for your connection. This could happen when you are trying to login to
2261 your account. The client-id you select will be used by Alpine for that and future
2262 connections to that server.
2263
2264
2265 <P>
2266 &lt;End of help&gt;
2267 </BODY>
2268 </HTML>
2269 ====== h_tls_failure_details ======
2270 <HTML>
2271 <HEAD>
2272 <TITLE>Certificate Validation Details</TITLE>
2273 </HEAD>
2274 <BODY>
2275 <H1>Certificate Validation Details</H1>
2276
2277 This screen gives details as to why the certificate validation failed: the
2278 name of the desired server system; the reason for failure; and the name on
2279 the certificate.  This is primarily of interest to experts.
2280
2281 <P>
2282 &lt;End of help&gt;
2283 </BODY>
2284 </HTML>
2285 ====== h_tls_failure ======
2286 <HTML>
2287 <HEAD>
2288 <TITLE>TLS or SSL Failure</TITLE>
2289 </HEAD>
2290 <BODY>
2291 <H1>TLS or SSL Failure</H1>
2292
2293 An attempt was made to establish a secure, encrypted connection to the
2294 server system using either Transport Layer Security (TLS) or the older
2295 Secure Sockets Layer (SSL).  This attempt failed.
2296
2297 <P>
2298 You should contact your server system management for more assistance.
2299 The problem is probably at the server system and not in Alpine or your local
2300 system.  The text in this screen may be helpful for the server system
2301 management in debugging the problem,
2302
2303 <P>
2304 &lt;End of help&gt;
2305 </BODY>
2306 </HTML>
2307 ====== h_tls_validation_failure ======
2308 <HTML>
2309 <HEAD>
2310 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
2311 </HEAD>
2312 <BODY>
2313 <H1>TLS and SSL Certificate Validation Failures</H1>
2314
2315 An attempt was made to establish a secure, encrypted connection to the
2316 server system using either Transport Layer Security (TLS) or the older
2317 Secure Sockets Layer (SSL).
2318
2319 <P>
2320 An important part of this procedure is server certificate validation.  A
2321 server certificate is an &quot;electronic identification card&quot; for the server
2322 system that is signed by a well-known certificate authority (CA).  Alpine
2323 compares the server system identity in the server certificate with the
2324 name of the server system to which it is trying to connect.  Alpine also
2325 verifies that the CA signature is authentic.
2326
2327 <P>
2328 Some common failure conditions are:
2329 <P>
2330
2331 <UL>
2332   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
2333 signed its own certificate.  This does not necessarily indicate anything
2334 bad; the server operators may simply have elected to not purchase a
2335 signed certificate from a certificate authority.
2336
2337   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
2338 the signature on the server system is from an unknown certificate authority.
2339 It can also mean that no certificate authority certificates have been
2340 installed on the local UNIX system.
2341
2342   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
2343 the same as either of the above two conditions in UNIX Alpine.  Note that
2344 Windows systems typically have a full set of certificate authority
2345 certificates installed, so it is more likely to be a self-signed
2346 certificate than an unknown certificate authority.
2347
2348   <LI> Server name does not match certificate.  This means that the server
2349 presented a proper signed certificate for a name other than the desired
2350 name.
2351 </UL>
2352
2353 <P>
2354 Any of these conditions can indicate that you are being attacked and have
2355 been directed to an imposter server that will record your password and
2356 your private mail messages.  It can also mean something innocuous.
2357
2358 <P>
2359 If you are certain that the problem is innocuous, you can append the
2360 option
2361
2362 <P>
2363 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
2364 <P>
2365
2366 to the server system name where it appears in your configuration (e.g. the
2367 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
2368 a folder-collection, or a news or SMTP server).  This will
2369 disable certificate validation.  On the other hand, if you are attacked,
2370 you will get no warning if you do this.
2371
2372 <P> When you get an error indicating a self-signed certificate from the
2373 remote server, you can download and install the certificate for that
2374 server. Avoid using the /NoValidate-Cert modifier. Alpine cannot help you
2375 with this process because certificates are part of the system and are not
2376 under the control of the user. Find directions on how to download and
2377 install certificates for your system using your favorite search engine.
2378
2379 <P>
2380 &lt;End of Cert Validation Failures help&gt;
2381 </BODY>
2382 </HTML>
2383 ====== h_oauth2_start ======
2384 <HTML>
2385 <HEAD>
2386 <TITLE>Setting up XOAUTH2 Authentication</TITLE>
2387 </HEAD>
2388 <BODY>
2389 <H1>Setting up XOAUTH2 Authentication</H1>
2390
2391 You are trying to connect to a server that uses the XOAUTH2 method of
2392 authentication.
2393
2394 <P>
2395 In order to complete this process use a browser in the same computer
2396 that you are using Alpine to open the given URL.
2397
2398 <P>
2399 You will be sent to authenticate and later to authorize Alpine access to
2400 your email. Once you have completed the authorization process you will get
2401 a code. Input this code into Alpine by pressing 'C'. If you do not see a
2402 code, but see an error message in your browser, copy and paste the URL of
2403 the error page and paste into alpine after pressing the 'C' key.
2404
2405 <P>
2406 After you have input the code, Alpine will conclude logging you into your
2407 account.
2408
2409 <P>
2410 If your version of Alpine was compiled to save passwords, then Alpine will save
2411 the refresh and access tokens securely, otherwise you will have to repeat this
2412 process every time you login to this server.
2413
2414 <P>
2415 &lt;End of setting up XOAUTH2 Authentication help&gt;
2416 </BODY>
2417 </HTML>
2418 ====== h_oauth2_start_device ======
2419 <HTML>
2420 <HEAD>
2421 <TITLE>Setting up XOAUTH2 Authentication Using the Device Flow</TITLE>
2422 </HEAD>
2423 <BODY>
2424 <H1>Setting up XOAUTH2 Authentication Using the Device Flow</H1>
2425
2426 You are trying to connect to a server that uses the XOAUTH2 method of
2427 authentication.
2428
2429 <P>
2430 In order to complete this process use a browser in the same computer
2431 that you are using Alpine to open the given URL and enter the code that you
2432 were given by Alpine in that screen.
2433
2434 <P>
2435 You will be sent to authenticate and later to authorize Alpine access to
2436 your email. Once you have completed the authorization process Alpine will
2437 get the refresh and access tokens from the service servers and the authentication
2438 process will be completed by Alpine.
2439
2440 <P>
2441 If your version of Alpine was compiled to save passwords, then Alpine will save
2442 the refresh and access tokens securely, otherwise you will have to repeat this
2443 process every time you login to this server.
2444
2445 <P>
2446 &lt;End of setting up XOAUTH2 Authentication help&gt;
2447 </BODY>
2448 </HTML>
2449 ====== h_release_tlscerts ======
2450 <HTML>
2451 <HEAD>
2452 <TITLE>TLS and SSL usage note</TITLE>
2453 </HEAD>
2454 <BODY>
2455 <H1>TLS and SSL usage note</H1>
2456
2457 <P>
2458 When using Alpine from Unix or Windows 2000,
2459 server certificates must be signed by a trusted certificate authority.
2460 You may relax this requirement (at the cost of some security) by using
2461 the
2462 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
2463 modifier in the mailbox name.
2464
2465 <P>
2466 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
2467 <P>
2468
2469 The fully-qualified host name of the server should be used
2470 so that it matches the host name in the server certificate.
2471 <P>
2472 Here is an example of a host specification that directs Alpine to use
2473 the SSL port (993) and an encrypted data stream.
2474 <P>
2475 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
2476 <P>
2477 &lt;End of TLS usage help&gt;
2478 </BODY>
2479 </HTML>
2480 ====== h_news_config ======
2481 <HTML>
2482 <HEAD>
2483 <TITLE>Alpine Configuration</TITLE>
2484 </HEAD>
2485 <BODY>
2486 <H1>Alpine Configuration</H1>
2487
2488 <H2>Using Environment Variables</H2>
2489
2490 The values of Alpine configuration options may include environment variables
2491 that are replaced by the value of the variable at the time Alpine is run
2492 (and also at the time the config option is changed).
2493 The syntax to use environment variables is a subset of the common Unix
2494 shell dollar-syntax.
2495 For example, if
2496
2497 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
2498
2499 appears in the value of an Alpine configuration option it is looked up in the
2500 envirom ent (using getenv(&quot;VAR&quot;)) and its
2501 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
2502 To include a literal dollar sign you may precede the dollar sign with another
2503 dollar sign.
2504 In other words, if the text
2505
2506 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
2507
2508 is the value of a configuration option, it will be expanded to
2509
2510 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
2511
2512 and no environment lookup will be done.
2513 For Unix Alpine it will also work to use a backslash character to
2514 escape the special meaning of the dollar sign, but $$ is preferable since
2515 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
2516 to be in a shared configuration file.
2517 <P>
2518
2519 This all sounds more complicated than it actually is.
2520 An example may make it clearer.
2521 Unfortunately, the way in which environment variables are set is OS-dependent
2522 and command shell-dependent.
2523 In some Unix command shells you may use
2524
2525 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
2526    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
2527
2528 Now, if you use Alpine's Setup/Config screen to set
2529
2530 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
2531
2532 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
2533 so that this would be equivalent to
2534
2535 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
2536
2537 Note, environment variable substitution happens after configuration
2538 options that are lists are split into the separate elements of the list,
2539 so a single environment variable can't contain a list of values.
2540
2541 <P>
2542 The environment variable doesn't have to be the only thing
2543 after the equal sign.
2544 However, if the name of the variable is not at the end of the line or
2545 followed by a space (so that you can tell where the variable name ends),
2546 it must be enclosed in curly braces like
2547
2548 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
2549
2550 It is always ok to use the braces even if you don't need to.
2551 <P>
2552 It is also possible to set a default value for an environment variable.
2553 This default value will be used if the environment variable is not
2554 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
2555 The syntax used to set a default value is
2556
2557 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
2558
2559 If the config file contains
2560
2561 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
2562
2563 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
2564 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
2565 the value that <SAMP>VAR</SAMP> was set to, otherwise,
2566 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
2567 the default value.
2568 (Note that the variable is called &quot;personal-name&quot; in the config
2569 file but is displayed in the config screen as
2570 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
2571 In general, the value that goes into a config file is never exactly the
2572 same as the value you see on the screen.)
2573
2574 <P>
2575 An example where an environment variable might be useful is the
2576 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
2577 Suppose most users used the server
2578
2579 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
2580
2581 but that there were some exceptions who used
2582
2583 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
2584
2585 In this case, the system manager might include the following line in
2586 the systemwide default Alpine configuration file
2587
2588 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
2589
2590 For the exceptional users adding
2591
2592 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
2593
2594 to their environment should work.
2595 <P>
2596 Another example might be the case where a user has to use a different
2597 SMTP server from work and from home.
2598 The setup might be something as simple as
2599
2600 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
2601
2602 or perhaps a default value could be given.
2603 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
2604 a list of SMTP servers.
2605 <P>
2606
2607 <H2>Configuration precedence</H2>
2608
2609 There are several levels of Alpine configuration.  Configuration values at
2610 a given level override corresponding values at lower levels.  In order of
2611 increasing precedence:
2612 <P>
2613 <UL>
2614  <LI> built-in defaults
2615  <LI> system-wide
2616 <!--chtml if pinemode="os_windows"-->
2617       config file from command line or provided
2618       by "PINECONF" environment variable
2619 <!--chtml else-->
2620       pine.conf file
2621 <!--chtml endif-->
2622  <LI> personal configuration file
2623  <LI> personal exceptions configuration file
2624  <LI> command-line options
2625  <!--chtml if pinemode="os_windows"--><!--chtml else-->
2626  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
2627 </UL>
2628 <P>
2629 The values in both the personal configuration file and the
2630 <A HREF="h_config_exceptions">exceptions</A>
2631 configuration file may be set using the Setup command.
2632 Setup/Config is the command to change most of the personal configuration
2633 options.
2634 The other Setup subcommands are also used to change the configuration,
2635 for example, Setup/AddressBook, Setup/Rules, and so on.
2636 Changing the personal exceptions configuration is very similar.
2637 To change a value in the Config screen you would use the command
2638 Setup/eXceptions/Config.
2639 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
2640 <P>
2641 There are a couple exceptions to the rule that configuration values are replaced
2642 by the value of the same option in a higher-precedence file.
2643 The Feature-List variable has values that are additive, but can be
2644 negated by prepending &quot;no-&quot; in front of an individual feature name.
2645 So for features, each individual feature's value is replaced by the value
2646 of the same feature in a higher-precedence file.
2647 Note that this is done automatically for you when you change these values via
2648 the Setup/Config command.
2649 The other exception to the <EM>replace</EM> semantics happens when you
2650 use <A HREF="h_config_inheritance">configuration inheritance</A>
2651 for option lists.
2652 <P>
2653
2654 <H2>File name defaults</H2>
2655
2656 Notes:<P>
2657
2658 <BR> &lt;exe dir&gt; = directory where pine.exe found.
2659 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
2660 <BR> # = default file name is overridable in pinerc.
2661 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
2662 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
2663 <BR> + between the mailcap paths implies that the two files are combined.
2664 <BR> ; between other default paths implies that the first one found is used.
2665 </P>
2666 Alpine looks for most support files in the same directory it finds its
2667 personal configuration file (pinerc).  The -p command-line flag may be
2668 used to specify a particular path name for the pinerc file.  If a
2669 pinerc file does not exist, it will be created (if directory permissions
2670 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
2671 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
2672 file does not exist in either one, it will create one in the first of those
2673 two directories that is writable.  In detail:
2674 <PRE>
2675
2676 PC-Alpine:
2677
2678  executable     &lt;DOS search path&gt;&#92;pine.exe
2679  help index     &lt;exe dir&gt;&#92;pine.ndx
2680  help text      &lt;exe dir&gt;&#92;pine.hlp
2681
2682  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
2683  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
2684  global cfg     $PINECONF
2685
2686  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
2687  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
2688  signature#     &lt;pinerc dir&gt;&#92;pine.sig
2689  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
2690  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
2691  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
2692  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
2693  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
2694  postponed#     $HOME&#92;mail&#92;postpond.mtx
2695  interrupted    $HOME&#92;mail&#92;intruptd
2696
2697 Unix Alpine:
2698
2699  executable     &lt;Unix search path&gt;/pine
2700  persnl cfg     ~/.pinerc
2701  except cfg     ~/.pinercex
2702  global cfg     <!--#echo var="PINE_CONF_PATH"-->
2703  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
2704  local help     <!--#echo var="PINE_INFO_PATH"-->
2705
2706  interrupted    ~/.pine-interrupted-mail
2707  debug          ~/.pine-debugN
2708  crash          ~/.pine-crash
2709  newsrc#        ~/.newsrc
2710  signature#     &lt;pinerc dir&gt;/.signature
2711  addressbook#   &lt;pinerc dir&gt;/.addressbook
2712  postponed#     ~/mail/postponed-msgs
2713  sentmail#      ~/mail/sent-mail
2714  mailcap#       ~/.mailcap + /etc/mailcap
2715                            + /usr/etc/mailcap + /usr/local/etc/mailcap
2716  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
2717
2718  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
2719  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
2720  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
2721  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
2722  password       /etc/passwd
2723
2724 Unix Alpine and PC-Alpine:
2725
2726  .ab*           remote addressbook support files
2727  a[1-9]*        temporary (while Alpine is running) addressbook files
2728
2729 </PRE>
2730 <P>
2731
2732 <H2>Mailcap files</H2>
2733
2734 Alpine honors the mailcap configuration system for specifying external
2735 programs for handling attachments.  The mailcap file maps MIME attachment
2736 types to the external programs loaded on your system that can display
2737 and/or print the file.  A sample mailcap file comes bundled with the Alpine
2738 distribution.  It includes comments that explain the syntax you need to
2739 use for mailcap.  With the mailcap file, any program (mail readers,
2740 newsreaders, WWW clients) can use the same configuration for handling
2741 MIME-encoded data.
2742 <P>
2743
2744 <H2>MIME-Types files</H2>
2745
2746 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
2747 what Content-Type to use for labeling an attached file, based on
2748 the file extension.  That is, this file provides a mapping between
2749 filename extensions and MIME content-types.
2750 <P>
2751
2752 <H2>Environment variables</H2>
2753
2754 PC-Alpine uses the following environment variables:
2755 <DL>
2756 <DT>PINERC</DT>
2757 <DD>Optional path to pinerc file.</DD>
2758 <DT>PINERCEX</DT>
2759 <DD>Optional path to personal exceptions configuration file.</DD>
2760 <DT>PINECONF</DT>
2761 <DD>Optional path to global pine config file.</DD>
2762 <DT>HOME</DT>
2763 <DT>TMPDIR, TMP, or TEMP</DT>
2764 <DT>COMSPEC</DT>
2765 <DT>MAILCAPS</DT>
2766 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
2767 <DT>USER_DICTIONARY</DT>
2768 <DD>Used to specify the file to contain the user's spell check
2769 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
2770 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
2771 </DL>
2772
2773 Unix Alpine uses the following environment variables:
2774 <DL>
2775 <DT>TERM</DT>
2776 <DD>Tells Alpine what kind of terminal is being used.</DD>
2777 <DT>DISPLAY</DT>
2778 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
2779 <DT>SHELL</DT>
2780 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
2781 <DT>TMPDIR, TMP, or TEMP</DT>
2782 <DT>MAILCAPS</DT>
2783 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
2784 </DL>
2785 <!--chtml if pinemode="os_windows"-->
2786 <P>
2787 <H2>Common PC-Alpine Configuration Problems</H2>
2788
2789 <H3>Configuration settings aren't being saved</H3>
2790
2791 <P>This problem can happen if you run pine from one directory and
2792 then decide to move your pine directory to another location.  PC-Alpine
2793 stores certain variables, including the configuration location, in the
2794 Windows Registry (which you shouldn't ever need to manually edit).  There
2795 are a couple of ways to go about removing or resetting the values in the
2796 registry.
2797
2798 <P>
2799 1) Run PC-Alpine's registry value deletion command.  This can be done by
2800 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
2801 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
2802 value to the above command.
2803
2804 <P>
2805 2) Tell PC-Alpine where to look for the configuration file.  Configuration
2806 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
2807 option, you can tell PC-Alpine the location of your pinerc.  An example of
2808 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;.
2809 Again, you can use the DOS prompt or the shortcut method explained in (1).
2810
2811 <P>
2812 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
2813 set registry values to the current setting, and is therefore useful with
2814 the &quot;-p&nbsp;PINERC&quot; option.
2815
2816 <!--chtml endif-->
2817 <P>
2818 &lt;End of Configuration Notes&gt;
2819 </BODY>
2820 </HTML>
2821 ====== h_news_legal ======
2822 <html>
2823 <head>
2824 <TITLE>Alpine Legal Notices</TITLE>
2825 </head>
2826 <body>
2827
2828 <H1>Alpine Legal Notices</H1>
2829
2830 Alpine and its constituent programs are covered by the Apache License Version 2.0.
2831
2832
2833 <P>
2834 &lt;End of Alpine Legal Notices&gt;
2835 </BODY>
2836 </HTML>
2837 ===== h_info_on_mbox =====
2838 <HTML>
2839 <HEAD>
2840 <TITLE>Information on mbox driver</TITLE>
2841 </HEAD>
2842 <BODY>
2843 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
2844
2845 Beginning with Pine 4.00 (Pine came before Alpine)
2846 a new INBOX access method is
2847 available as part of the standard configuration.  It is called the
2848 &quot;mbox&quot; driver and it works like this:<P>
2849
2850 <P>
2851 <BLOCKQUOTE>
2852 If the file &quot;mbox&quot; exists in the user's home directory, and
2853 is in Unix mailbox format, then when INBOX is opened this file will be
2854 selected as INBOX instead of the mail spool file.  Messages will be
2855 automatically transferred from the mail spool file into the mbox
2856 file.
2857 </BLOCKQUOTE>
2858
2859 <P>
2860 The advantage of this method is that, after new mail has been copied
2861 from the system mail spool, all subsequent access is confined to the
2862 user's home directory, which is desirable on some systems.  However, a
2863 possible disadvantage is that mail tools other than those from the
2864 University of Washington will not know to look for mail in the user's
2865 mbox file.  For example, POP or IMAP servers other than those from the
2866 University of Washington, and many &quot;new mail notification&quot;
2867 programs may not work as expected with this driver enabled.<P>
2868
2869 To disable this behavior, either remove/rename the &quot;mbox&quot;
2870 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
2871 option in Setup/Config
2872 and add &quot;mbox&quot; to it:
2873 <P>
2874 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
2875 <P>
2876 &lt;End of help on this topic&gt;
2877 </BODY>
2878 </HTML>
2879 ===== h_info_on_locking =====
2880 <HTML>
2881 <HEAD>
2882 <TITLE>FAQs on Alpine Locking</TITLE>
2883 </HEAD>
2884 <BODY>
2885 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
2886
2887 There is an extensive section on locking in the Alpine technical notes;
2888 this information is intended to provide answers to some common questions:<P>
2889 <OL>
2890 <LI> Why did locking change in Pine 4.00?<BR>
2891 The actual locking mechanisms did not change in 4.00.
2892 What changed is that when one particular locking mechanism used by Alpine
2893 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
2894 failure would occur, but no warning was issued.<P>
2895
2896 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
2897 Yes.  It means that Alpine was unable to create a lockfile in the
2898 spool directory, generally because of overly restrictive protections on the
2899 spool directory.  The correct permissions on the spool directory for
2900 running Alpine are 1777, i.e. read-write-execute permission for everyone,
2901 with the sticky-bit set, so only owners of a file can delete them.<P>
2902
2903 <LI> Why does Alpine require that the mail spool directory have 1777
2904    protections?<BR>
2905 Alpine was designed to run without special privileges.  This means that in
2906 order to create a lockfile in the spool directory, it is necessary to have
2907 the spool directory permissions be world-writable.<P>
2908
2909 <LI> Can't you create the lockfile somewhere else?<BR>
2910 No.  The lockfile in question must be in the mail spool directory, because
2911 that's where the mail delivery program expects to find it, and the purpose
2912 of the file is to coordinate access between the mail client (Alpine) and the
2913 mail delivery program.<P>
2914
2915 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
2916 No.  Remember that the individual mail files in the spool directory are
2917 NOT world-writable, only the containing directory.  Setting the &quot;sticky
2918 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
2919 -- means that only the owner of the file (or root) can delete files in the
2920 directory.  So the only bad behavior that is invited by the 1777 mode is that
2921 anyone could
2922 create a random file in the spool directory.  If the spool directory is
2923 under quota control along with home directories, there is little incentive
2924 for anyone to do this, and even without quotas a periodic scan for
2925 non-mail files usually takes care of the problem.  <P>
2926
2927 <LI> Why not run Alpine as setgid mail?<BR>
2928 Alpine was never designed to run with privileges, and to do so introduces a
2929 significant security vulnerability.  For example, if a user suspends Alpine,
2930 the resulting shell will have group privileges.  This is one example of
2931 why we strongly recommend against running Alpine as a privileged program.
2932 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
2933 users
2934 could not test Alpine versions or other mailers that had not been installed
2935 by the system administrators.<P>
2936
2937
2938 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
2939 There are, but they all have different sets of tradeoffs, and not all will
2940 work on all systems.  Some examples:<UL>
2941  <LI> Use lock system calls.  Works fine on a few systems, provided mail
2942    spool is local.   Doesn't work reliably if NFS is used.
2943    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
2944    use the same calls.
2945  <LI> Deliver mail to user's home directory.  An excellent solution, highly
2946    recommended -- but one which is incompatible with some &quot;legacy&quot;
2947 mail tools that always look in the spool directory for the mail.
2948 </UL><P>
2949
2950 <LI> Are these spool directory lock files the only kinds of locks used by
2951    Alpine?<BR>
2952 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
2953 mailbox format folders, these are used to coordinate access between
2954 multiple Alpine sessions.  <P>
2955
2956 <LI> What about the
2957 <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>
2958 This is for people who are content to live dangerously, or who have
2959 specific knowledge that the spool directory lockfiles are superfluous on
2960 their system (because both Alpine and the mail delivery program are using
2961 system call file locking in a context that works reliably, e.g. not NFS.)<P>
2962
2963 <LI> Where can I find more details on how Alpine locking works?<BR>
2964 See the Alpine Technical Notes.<P>
2965
2966 </OL>
2967 <P>
2968 &lt;End of help on this topic&gt;
2969 </BODY>
2970 </HTML>
2971 ===== h_finding_help ====
2972 <HTML>
2973 <HEAD>
2974 <TITLE>Finding more information and requesting help</TITLE>
2975 </HEAD>
2976 <BODY>
2977 <H1>Places to Look for More Answers</H1>
2978 If you have questions about or problems with Alpine that you cannot resolve
2979 after consulting the program's internal, context-sensitive help screens, here
2980 are additional information resources that you may find helpful:
2981 <P>
2982 <UL>
2983   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
2984
2985   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
2986
2987   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
2988 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
2989   since the last version, which may be useful for you to be aware of,
2990 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
2991 a change in the way an aspect of Alpine works.  There, you will also find notes
2992 on Alpine configuration.<P>
2993   <LI> The main site for Alpine contains information on configuring and solving problems
2994        with Alpine, it can be found at
2995
2996 <CENTER><A HREF="https://alpineapp.email">https://alpineapp.email</A></CENTER>
2997
2998   <LI> Archives of the Alpine-info mailing list, at <A
2999 href="http://mailman13.u.washington.edu/pipermail/alpine-info/">http://mailman13.u.washington.edu/pipermail/alpine-info/</A>
3000
3001   <LI>The newsgroup comp.mail.pine.
3002
3003 </UL>
3004 <P><HR WIDTH="75%">
3005 <H1>Requesting help</H1>
3006 If the internal help, the Release Notes, and your
3007 local online and print resources do not help you resolve a problem, please
3008 start by contacting your local computer support staff and asking for help.
3009 <p>
3010 This is especially true if:
3011 <ul>
3012   <li>You suddenly have trouble sending or receiving mail.
3013   <li>You receive a "disk quota exceeded" message.
3014   <li>You have forgotten your password.
3015   <li>You think your account may have been compromised.
3016   <li>You need help viewing an attachment.
3017   <li>You need to know how to configure your:
3018       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
3019       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
3020       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
3021       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
3022   <li>You want to know what alternative editors or spellcheckers you may be able to use.
3023   <li>You want to block email from a particular person.
3024   <li>You're going on vacation and need to autorespond to incoming mail.
3025   <li>You want to automatically file or filter incoming messages.
3026 </ul>
3027
3028 In all of these cases,
3029 you should contact <B>your</B> support staff, because <B>only they</B>
3030 will be able to assist you effectively. Your support staff may be, depending on who
3031 provides you with the email account you use Alpine with, for example:<UL>
3032 <LI> the computing help desk of (a department of) your university, school,
3033 employer, ... ; or
3034 <LI> the customer service center of your Internet Service Provider; or
3035 <LI> the friendly volunteer helpers of your Freenet; or
3036 <LI> the person who setup your computer and internet connection.
3037 </UL>
3038
3039 <P>
3040 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
3041 newsgroup can be a valuable source of information and assistance for Alpine
3042 user issues.
3043 <P>
3044 For systems/email administrators, developers, trainers, user support
3045 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
3046 level, the mailing list alpine-info is available; for information on
3047 subscribing and posting to it, see
3048 <P>
3049 <CENTER><A HREF="https://mailman13.u.washington.edu/mailman/listinfo/alpine-info">https://mailman13.u.washington.edu/mailman/listinfo/alpine-info</A></CENTER>
3050 <P>
3051
3052 Regardless of whom you are asking for help with Alpine, remember
3053 to provide as much detail as you can about the
3054 nature of any problem you are encountering, such as
3055 <UL>
3056 <LI>when it first occurred;
3057 <LI>what, if anything, happened that might have brought it about;
3058 <LI>whether it still persists;
3059 <LI>whether it is reproducible, and if so, how;
3060 <LI>what, if anything, you already tried to solve it.
3061 </UL>
3062 It may also be helpful if you specify what version of Alpine you are using
3063 <!--chtml if pinemode="running"-->
3064 -- this is <!--#echo var="ALPINE_VERSION"--> --
3065 <!--chtml endif-->
3066 and on what system, and when the copy of Alpine you are using was created
3067 <!--chtml if pinemode="running"-->
3068 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
3069 <!--chtml endif-->
3070
3071 <!--chtml if pinemode="running"-->
3072 <P>
3073 When the Alpine program you are currently using was installed, a support
3074 contact email address may have been set up; in that case, you can simply select
3075 this link now to send a message to it:<BR>
3076 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
3077 <!--chtml endif-->
3078 <!--chtml if [ -r PINE_INFO_PATH ]-->
3079 <HR WIDTH="75%">Local Support Contacts:<P>
3080 <!--#include file="PINE_INFO_PATH"-->
3081 <HR WIDTH="75%">
3082 <!--chtml endif-->
3083 <P>
3084 &lt;End of help on this topic&gt;
3085 </BODY>
3086 </HTML>
3087 ===== new_user_greeting ======
3088 <HTML>
3089 <HEAD>
3090 <TITLE>NEW USER GREETING</TITLE>
3091 </HEAD>
3092 <BODY>
3093 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
3094 <BR>
3095 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
3096 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
3097 select Setup/Config to see many of the options available to you. Also note
3098 that all screens have context-sensitive help text available.
3099
3100 <P>
3101 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
3102 href="h_apache_license">Apache License 2.0</A>.
3103
3104 <P>
3105 Alpine's privacy policy is a living, online only, document, which can be found at
3106 <A href="h_privacy_policy">https://alpineapp.email/privacy.html</A>.
3107 By following the previous link,  Alpine
3108 will connect to an external server, and will download it and display
3109 it for you. Please take some time to read it and understand it.
3110 Since the Privacy Policy could be amended to take into consideration
3111 new additions to Alpine, please check it periodically. You can always
3112 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
3113
3114 <P>
3115 To Exit this screen and continue your Alpine session press "E".
3116 </BODY>
3117 </HTML>
3118 ===== new_alpine_user_greeting ======
3119 <HTML>
3120 <HEAD>
3121 <TITLE>NEW ALPINE USER GREETING</TITLE>
3122 </HEAD>
3123 <BODY>
3124 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
3125 <BR>
3126 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
3127 Your Alpine configuration file indicates that you may have used Pine before
3128 but not Alpine.
3129 If you are familiar with the way Pine works, you should be comfortable
3130 using Alpine.
3131 Your Pine configuration file is automatically used for Alpine.
3132 The Release Notes may be viewed by pressing
3133 &quot;R&quot; now or while in the MAIN MENU.
3134
3135 <P>
3136 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
3137 href="h_apache_license">Apache License 2.0</A>.
3138
3139 <P>
3140 Alpine's privacy policy is a living, online only, document, which can be found at
3141 <A href="h_privacy_policy">https://alpineapp.email/privacy.html</A>.
3142 By following the previous link,  Alpine
3143 will connect to an external server, and will download it and display
3144 it for you. Please take some time to read it and understand it.
3145 Since the Privacy Policy could be amended to take into consideration
3146 new additions to Alpine, please check it periodically. You can always
3147 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
3148
3149 <P>
3150 To Exit this screen and continue your Alpine session press "E".
3151 </BODY>
3152 </HTML>
3153 ===== new_version_greeting ======
3154 <HTML>
3155 <HEAD>
3156 <TITLE>NEW VERSION GREETING</TITLE>
3157 </HEAD>
3158 <BODY>
3159 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
3160 <BR>
3161 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
3162 Your Alpine configuration file indicates that you may not have used
3163 this version of Alpine before.  This version's significant changes are
3164 documented in the Release Notes, which may be viewed by pressing
3165 &quot;R&quot; now or while in the MAIN MENU.
3166 <P>
3167
3168 <P>
3169 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
3170 href="h_apache_license">Apache License 2.0</A>.
3171
3172 <P>
3173 Alpine's privacy policy is a living, online only, document, which can be found at
3174 <A href="h_privacy_policy">https://alpineapp.email/privacy.html</A>.
3175 By following the previous link,  Alpine
3176 will connect to an external server, and will download it and display
3177 it for you. Please take some time to read it and understand it.
3178 Since the Privacy Policy could be amended to take into consideration
3179 new additions to Alpine, please check it periodically. You can always
3180 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
3181
3182 <P>
3183 To Exit this screen and continue your Alpine session press "E".
3184 </BODY>
3185 </HTML>
3186
3187 ===== main_menu_tx ======
3188 <HTML>
3189 <HEAD>
3190 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
3191 </HEAD>
3192 <BODY>
3193 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
3194 <DIV ALIGN=CENTER>
3195 Version <!--#echo var="ALPINE_VERSION"-->
3196 <!--chtml if pinemode="running"-->
3197 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
3198 <!--chtml endif-->
3199 </DIV>
3200 <CENTER>Copyright 2013-2021 Eduardo Chappa,
3201 <BR>Copyright 2006-2008 University of Washington.
3202 </CENTER>
3203
3204 <P>
3205 When you are viewing a help screen, there may be links to
3206 other topics highlighted (in Reverse video) in the text.
3207 Here is an example.
3208 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
3209 highlighted.
3210 If you type carriage return (or V for View Link, see the commands at the
3211 bottom of the screen) you will be taken to a new help screen to view the
3212 Introduction.
3213 The commands at the bottom of the screen should then include
3214 &quot;P Prev Help&quot;.
3215 If you type &quot;P&quot; you will end up back here.
3216 If you type &quot;E&quot; for Exit, you will be back out of help and returned
3217 to the place you were in Alpine when you entered Help.
3218 In this case, you would go back to the MAIN MENU.
3219 There are also other links that are highlighted in bold (or the color used
3220 by your terminal to display bold).
3221 The items after the Introduction in the TABLE OF CONTENTS are all examples
3222 of such links.
3223 In order to view those links, you first have to make the link you want
3224 to view the current link.
3225 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
3226 (see bottom of screen) can do that for you.
3227 <P>
3228
3229 <H2>TABLE OF CONTENTS</H2>
3230 <OL>
3231   <LI> The Basics of Alpine
3232   <UL>
3233      <LI> <A HREF="h_mainhelp_intro">Introduction</A>
3234      <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
3235      <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
3236      <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
3237      <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
3238      <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
3239      <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
3240      <!--chtml if [ -r PINE_INFO_PATH ]-->
3241      <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
3242      <!--chtml endif-->
3243      <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
3244   </UL>
3245
3246   <LI> Description of Alpine Screens
3247   <UL>
3248       <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
3249       <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
3250       <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
3251       <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
3252       <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
3253       <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
3254   </UL>
3255
3256   <LI> Email Processing
3257   <UL>
3258       <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
3259       <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
3260       <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
3261   </UL>
3262
3263   <LI> Configuring Additional Accounts
3264   <UL>
3265       <LI> <A HREF="h_mainhelp_folders">Folders</A>
3266       <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
3267       <LI> <A href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
3268       <LI> <A HREF="h_mainhelp_roles">Incoming and Outgoing Settings for other Accounts</A> (a.k.a Roles)
3269   </UL>
3270
3271   <LI> Finding and Saving your Contacts
3272   <UL>
3273        <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
3274        <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
3275   </UL>
3276
3277   <LI> Security
3278   <UL>
3279       <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
3280       <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
3281   </UL>
3282
3283   <LI> Miscelaneous Configurations
3284   <UL>
3285       <LI> <A HREF="h_mainhelp_color">Color Setup</A>
3286       <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
3287       <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
3288   </UL>
3289 </OL>
3290
3291 <P>
3292 &lt;End of help on this topic&gt;
3293 </BODY>
3294 </HTML>
3295 ===== h_mainhelp_intro ======
3296 <HTML>
3297 <HEAD>
3298 <TITLE>Introduction</TITLE>
3299 </HEAD>
3300 <BODY>
3301 <H1>Introduction</H1>
3302
3303 Alpine is an &quot;Alternatively Licensed Program for Internet
3304 News and Email&quot; produced until 2009 by the University of Washington.
3305 It is intended to be an easy-to-use program for
3306 sending, receiving, and filing Internet electronic mail messages and
3307 bulletin board (Netnews/Usenet) messages. Alpine supports the following
3308 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
3309 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
3310 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
3311 Directory Access Protocol).<p>
3312
3313 Although originally designed for inexperienced email users, Alpine has
3314 evolved to support many advanced features.  There are an ever-growing
3315 number of configuration and personal-preference options, though which of
3316 them are available to you is determined by your local system managers.
3317
3318 <H2>WHAT ALPINE DOES...</H2>
3319
3320 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
3321 allows you to
3322 compose and read messages using Internet mail standards.  (Whether you
3323 can correspond with others on the Internet depends on whether or not your
3324 computer is connected to the Internet.)  Alpine also allows reading and
3325 posting messages on the Internet &quot;net news&quot; system, provided
3326 that your site operates a suitable news server.
3327
3328 <H2>WHAT ALPINE DOES NOT DO...</H2>
3329
3330 A &quot;mail user agent&quot; such as Alpine is just one part of a
3331 messaging system. Here are some things that are <B>not</B> done by Alpine,
3332 but require other programs:<P>
3333 <UL>
3334  <LI> Actual relaying of email... which is done by &quot;message transfer
3335 agents&quot;.
3336  <LI> Vacation messages... automatically responding to incoming messages
3337  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
3338 email.
3339  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
3340  <LI> List processing... resending one message to a list of recipients.
3341 </UL>
3342
3343 <P>
3344 &lt;End of help on this topic&gt;
3345 </BODY>
3346 </HTML>
3347
3348 ===== h_mainhelp_pinehelp ======
3349 <HTML>
3350 <HEAD>
3351 <TITLE>Alpine Help</TITLE>
3352 </HEAD>
3353 <BODY>
3354 <H1>Alpine Help</H1>
3355
3356 Alpine help is generally context-sensitive. In other words, each Alpine screen you
3357 use will have its own help text, explaining the choices available for that
3358 screen. This general help section, on the other hand, attempts to give an
3359 overall picture of what Alpine is capable of doing, as well as pointers to
3360 additional help sections about specific topics.<p>
3361
3362 Much of the help text contains links to further help topics, similar to
3363 how the World Wide Web works.
3364 You may choose a link to view using the &quot;NextLink&quot; and
3365 &quot;PrevLink&quot; commands to change the link that is highlighted.
3366 The &quot;View Link&quot; command will then show you the highlighted link.
3367 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
3368 will return you to where you were before viewing the link, and &quot;Exit Help&quot
3369 will return you to the location in Alpine before you asked for help.
3370 For example, if you are reading this text in Alpine you may return to the
3371 help table of contents with the &quot;Prev Help&quot; command or you may view the
3372 Release notes link in the next paragraph and then return here with
3373 &quot;Prev Help&quot;.
3374 <P>
3375
3376 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
3377 on the current Alpine version are also available from the MAIN MENU: Press
3378 <!--chtml if pinemode="function_key"-->
3379 &quot;F9&quot;
3380 <!--chtml else-->
3381 &quot;R&quot;
3382 <!--chtml endif-->
3383 to browse the release notes.  These include changes since the last release,
3384 configuration information, the history of the Alpine
3385 project, credits, and legal notices.
3386
3387 Alpine releases are available via the world wide web at
3388 <P>
3389 <CENTER><SAMP><A
3390 HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP
3391 ></CENTER>
3392 <P>
3393
3394 If you would like to print <EM>all</EM> of Alpine's internal help text
3395 (not recommended) for a little light bedtime reading, then press
3396 <!--chtml if pinemode="function_key"-->
3397 &quot;F12&quot;
3398 <!--chtml else-->
3399 &quot;Z&quot;
3400 <!--chtml endif-->
3401 now.  (This assumes that the
3402 copy of Alpine you are using has been properly configured for printing
3403 at your site.)
3404 <P>
3405 &lt;End of help on this topic&gt;
3406 </BODY>
3407 </HTML>
3408 ===== h_mainhelp_localsupport ======
3409 <HTML>
3410 <HEAD>
3411 <TITLE>Local Support Contacts</TITLE>
3412 </HEAD>
3413 <BODY>
3414 <H1>Local Support Contacts</H1>
3415
3416 <!--chtml if [ -r PINE_INFO_PATH ]-->
3417 <!--#include file="PINE_INFO_PATH"-->
3418 <!--chtml else-->
3419 No Local Support Contacts configured.
3420 <!--chtml endif-->
3421
3422 <P>
3423 &lt;End of help on this topic&gt;
3424 </BODY>
3425 </HTML>
3426
3427 ===== h_mainhelp_cmds ======
3428 <HTML>
3429 <HEAD>
3430 <TITLE>Giving Commands in Alpine</TITLE>
3431 </HEAD>
3432 <BODY>
3433 <H1>Giving Commands in Alpine</H1>
3434
3435 Unless configured otherwise
3436 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
3437 the bottom two lines of the screen are always used to list the
3438 commands you can give.  You press the keys that are highlighted to give
3439 the command.  The commands for getting help and going back to the main
3440 menu are always present (except when viewing help as you are now).
3441 <!--chtml if pinemode="function_key"-->
3442 <!--chtml else-->
3443 <p>
3444 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
3445 you see at the bottom of any screen. In some cases there are 3 or
3446 even 4 different
3447 sets of keys that can be seen by using the O key. <EM>All commands are
3448 active</EM>, even if they are not currently showing at the bottom of your
3449 screen. In other words, you <EM>never</EM> need to press the O key, except to
3450 remind yourself of the proper key to press to perform an operation.
3451
3452 <H2>Control Key Commands</H2>
3453 When composing mail, and in a few other places, in Alpine you
3454 have to use Control keys. This means pressing the Control key (usually labeled
3455 &quot;Ctrl&quot;) and the
3456 letter indicated at the same time.  Usually, this is shown with a
3457 &quot;^&quot; in front of the letter.  On some systems, certain control
3458 characters are intercepted before they get to Alpine.  As a work-around,
3459 you can press the ESCAPE key twice followed by the desired key.  For
3460 example, if Ctrl-O (^O) does not work on your system, try typing
3461 &quot;ESC ESC O&quot;.
3462 <!--chtml endif-->
3463 <H2>Paging Up and Down</H2>
3464 The &quot;+&quot; and &quot;-&quot; keys are used for
3465 moving to the next or previous page.  The space bar is a synonym for
3466 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
3467 up as you do in the message composer.  On screens with a WhereIs (search)
3468 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
3469 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
3470 of the message or list.
3471
3472 <H2>Return Key</H2>
3473 The return key is usually a synonym for a frequently used
3474 command.  When viewing a message, there is currently not a default
3475 command, so RETURN does nothing; when in the index, it is synonymous with
3476 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
3477 enclosed in square brackets [] is the same as the return key.
3478
3479 <H2>Control Keys Not Used By Alpine</H2>
3480 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
3481 value, but in places where Alpine is expecting text input, e.g. in the composer or
3482 at prompts for file/folder names, control keys must be used for editing and
3483 navigation functions.
3484 <P>
3485
3486 Alpine has used nearly all the control keys available.  There are, however,
3487 certain control keys that are reserved by other programs or for technical
3488 reasons.  Alpine does not use any of these keys:
3489 <DL>
3490  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
3491  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
3492  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
3493 </DL>
3494 <P>
3495 Note: Ctrl-S and Ctrl-Q can be subject to
3496 <A HREF="h_special_xon_xoff">special handling</A>.
3497 <P>
3498 In addition, while the ESC key alone is not used for command input,
3499 Alpine will recognize two consecutive ESC key presses followed by a letter
3500 key as a substitute for control key input.  For example, the control key
3501 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
3502 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
3503 This is useful if the communication program you are using
3504 (e.g. Telnet) has its own, conflicting, idea of what certain control
3505 characters mean.
3506
3507
3508 <H2>Repainting the Screen</H2>
3509 Sometimes what is displayed on the screen will be
3510 incorrect due to noise on the phone line or other causes and you will want
3511 to repaint the whole screen to make it correct.  You can use the Ctrl-L
3512 command to do this.  It never hurts to do it when in doubt.
3513
3514 <P>
3515 &lt;End of help on this topic&gt;
3516 </BODY>
3517 </HTML>
3518 ===== h_mainhelp_status ======
3519 <HTML>
3520 <HEAD>
3521 <TITLE>Titlebar Line</TITLE>
3522 </HEAD>
3523 <BODY>
3524 <H1>Titlebar Line</H1>
3525
3526 The top line of the screen is Alpine's titlebar line.  It will always display
3527 the current version of Alpine and will also convey information about the
3528 status of the program.  This is where you look to find out what
3529 collection, folder and message number is active and where you are in Alpine.
3530 <P>
3531
3532 If the titlebar line says &quot;READONLY&quot; it means that the open folder
3533 (typically your INBOX) is &quot;locked&quot; by another mail session --
3534 most likely a more recent session of Alpine has taken the INBOX lock.
3535 <P>
3536
3537 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
3538 access a
3539 folder on a remote mail server, and for some reason, communication with
3540 the mail server has either been lost, or never successfully established.
3541 This can be a result of trying to open a non-existent folder, or one
3542 stored on an invalid or non-operational server, or it can mean that Alpine
3543 has been suspended for more that 30 minutes while accessing a remote mail
3544 server.
3545
3546 <P>
3547 &lt;End of help on this topic&gt;
3548 </BODY>
3549 </HTML>
3550 ===== h_mainhelp_mainmenu ======
3551 <HTML>
3552 <HEAD>
3553 <TITLE>Main Menu</TITLE>
3554 </HEAD>
3555 <BODY>
3556 <H1>Main Menu</H1>
3557
3558 The Main Menu lists Alpine's main options.
3559 The key or keys you must type to enter your
3560 choice are to the left of each option or command name.
3561 You can type either uppercase or lowercase letters,
3562 and you should not press &lt;Return&gt; after typing the
3563 letter (unless you are specifically asking for the default,
3564 highlighted command).
3565 <P>
3566
3567 From the Main Menu you can choose to read online help, write (compose) and
3568 send a message, look at an index of your mail messages, open or maintain
3569 your mail folders, update your address book, configure Alpine, and quit Alpine.
3570 There are additional options listed at
3571 the bottom of the screen as well.
3572
3573 <P>
3574 The Help command usually returns context-sensitive help information.
3575 However, in the Main Menu you get the most general help, which includes
3576 a Table of Contents.
3577 The last entry in the Table of Contents is an Index of help topics,
3578 so this is a good place to go if you are having trouble finding how
3579 to do something.
3580
3581 <H2>Main Menu Commands</H2>
3582 The Alpine main menu lists the most common Alpine functions. A <a
3583 href="h_main_menu_commands">full list of these
3584 commands</a> and what they do is available.
3585 <P>
3586 &lt;End of help on this topic&gt;
3587 </BODY>
3588 </HTML>
3589 ===== h_mainhelp_abooks ======
3590 <HTML>
3591 <HEAD>
3592 <TITLE>Address Books</TITLE>
3593 </HEAD>
3594 <BODY>
3595 <H1>Address Books</H1>
3596
3597
3598 As you use email, you can build a list of your regular email correspondents
3599 in your Alpine
3600 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
3601 screen. Your
3602 personal address book will be highlighted. Press &lt;Return&gt; to view it.
3603 You can use the address book to store email addresses for individuals or
3604 groups, to create easily
3605 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
3606 address when you are composing a message.
3607 <P>
3608 There are two ways to add addresses to your address book: you can add them
3609 manually or take them from messages (by pressing T to access the Take command).
3610 With either method, you specify nicknames for your correspondents. A single
3611 address book entry (or nickname) can point to just one email address, or, it can
3612 point to more than one. When it points to more than one, it is called a
3613 distribution list. Each distribution list has a nickname, a full name, and a
3614 list of addresses. These
3615 addresses may be actual addresses, other nicknames in your address book, or
3616 other
3617 distribution lists.
3618
3619 <P>
3620 Additional information is available in Alpine's online help:
3621 <ul>
3622   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
3623 </ul>
3624 <P>
3625 &lt;End of help on this topic&gt;
3626 </BODY>
3627 </HTML>
3628 ===== h_mainhelp_ldap ======
3629 <HTML>
3630 <HEAD>
3631 <TITLE>LDAP</TITLE>
3632 </HEAD>
3633 <BODY>
3634 <H1>LDAP</H1>
3635
3636 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
3637 an organization's shared
3638 directories. Essentially, using LDAP, Alpine is able to find email addresses in
3639 large address
3640 books, rather like the White Pages provided by the phone company. As an Alpine
3641 user, it is not
3642 necessary to know much about how this works, only how to use it and how to
3643 configure
3644 it.
3645 <P>
3646 More information on configuring LDAP is available in Alpine's online help:
3647 <ul>
3648   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
3649 </ul>
3650 <P>
3651 Additional help on using LDAP in Alpine is also available:
3652 <ul>
3653   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
3654 </ul>
3655 <P>
3656 &lt;End of help on this topic&gt;
3657 </BODY>
3658 </HTML>
3659 ===== h_mainhelp_index ======
3660 <HTML>
3661 <HEAD>
3662 <TITLE>Index of Messages</TITLE>
3663 </HEAD>
3664 <BODY>
3665 <H1>Index of Messages</H1>
3666
3667 In Alpine's message index, the selected message is highlighted. The first
3668 column on the left is blank, shows a &quot;+&quot; if the message was
3669 sent directly to you (i.e., it is not a
3670 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
3671 <P>
3672 The second column may be blank, or it may contain:
3673 <ul>
3674   <li>"N" if the message is new (unread), </li>
3675   <li>"A" if you have answered the message (using the Reply command), </li>
3676   <li>"D" if you have marked the message for deletion.</li>
3677 </ul>
3678
3679 <P>
3680 Note: If you answer a message as well as mark it deleted (in either order),
3681 you will only see the &quot;D&quot;.
3682
3683 <P>
3684 The rest of the columns in the message line show you the message
3685 number, date sent, sender, size, and subject. For details, press ? (Help).
3686 The behavior and appearance of the Index screen is highly configurable.
3687 In the Setup/Config screen search (with the WhereIs command) for options
3688 that contain the words &quot;index&quot; or &quot;thread&quot; to see
3689 many of the configuration possibilities.
3690 In particular, the
3691 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
3692 option may be used to configure the look of the standard MESSAGE INDEX lines
3693 in many different ways.
3694 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
3695 read the help text there for more information.
3696 <P>
3697 Most of the commands you need to handle your messages are visible at the
3698 bottom of the screen, and you can press O (OTHER CMDS) to see additional
3699 commands that are available.
3700 You do not need to see these &quot;other commands&quot;
3701 on the screen to use them. That is, you never need to press O as a prefix
3702 for any other command.
3703
3704 <P>
3705 Additional information is available in Alpine's online help:
3706 <ul>
3707   <li><a href="h_mail_index">Message Index Commands</a></li>
3708 </ul>
3709 <P>
3710 &lt;End of help on this topic&gt;
3711 </BODY>
3712 </HTML>
3713 ===== h_mainhelp_reading ======
3714 <HTML>
3715 <HEAD>
3716 <TITLE>Reading Messages</TITLE>
3717 </HEAD>
3718 <BODY>
3719 <H1>Reading Messages</H1>
3720
3721 The message text screen shows you the text of the message along with
3722 its header. If a message has attachments, those will be listed (but not
3723 displayed) also.  The titlebar line displays information about the currently
3724 open message, folder and collection.  You see the name of the collection
3725 (if there is one) in angle brackets, then the name of the folder, then the
3726 message number and finally the position within the current message (in
3727 percent). If the message is marked for deletion
3728 &quot;DEL&quot; will appear in the
3729 upper right as well.
3730
3731 <P>
3732 As with every Alpine screen, the bottom two lines show you the commands
3733 available.
3734
3735 <P>Additional information is available in Alpine's online help:
3736 <ul>
3737   <li><a href="h_mail_view">Message Text Screen</a></li>
3738   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
3739   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
3740 </ul>
3741 <P>
3742 &lt;End of help on this topic&gt;
3743 </BODY>
3744 </HTML>
3745 ===== h_mainhelp_composing ======
3746 <HTML>
3747 <HEAD>
3748 <TITLE>Composing Messages</TITLE>
3749 </HEAD>
3750 <BODY>
3751 <H1>Composing Messages</H1>
3752
3753 To write a message, press C (Compose). You see the Compose Message
3754 screen, which is divided into two parts: the header area and the message
3755 text area. The header area is where information on the recipient (the To:
3756 field) and the subject line go, while the message text area contains the
3757 actual text of the email message. Different commands are available to you
3758 when your cursor is in different areas on this screen. To see additional
3759 help on commands in either the message text or header area, type
3760 <Control>G (Get help).
3761
3762 <P>
3763 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
3764 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
3765
3766 <P>The following information from Alpine's online help may prove useful:
3767 <ul>
3768   <li><a href="h_composer_to">Message Header Commands</a></li>
3769   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
3770   <li><a href="h_composer">Composer Commands</a></li>
3771   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
3772   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
3773   <li><a href="h_compose_send">Send Command</a></li>
3774   <li><a href="h_compose_spell">Spell Check Command</a></li>
3775 </ul>
3776 <P>
3777 &lt;End of help on this topic&gt;
3778 </BODY>
3779 </HTML>
3780 ===== h_mainhelp_collections ======
3781 <HTML>
3782 <HEAD>
3783 <TITLE>Collection Lists</TITLE>
3784 </HEAD>
3785 <BODY>
3786 <H1>Collection Lists</H1>
3787
3788 Collection lists are Alpine's way of organizing groups of folders. Each
3789 "collection" can reside on a different server, for example, and contain a
3790 different group of mail folders.
3791
3792 <P>
3793 For more information on this, see:
3794 <ul>
3795   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
3796 </ul>
3797 <P>
3798 Additional information relating to collection lists is also available in
3799 Alpine's online
3800 help:
3801 <ul>
3802   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
3803   <li><a href="h_collection_screen">Collection List Screen</a></li>
3804 </ul>
3805 <P>
3806 &lt;End of help on this topic&gt;
3807 </BODY>
3808 </HTML>
3809 ===== h_mainhelp_folders ======
3810 <HTML>
3811 <HEAD>
3812 <TITLE>Folders</TITLE>
3813 </HEAD>
3814 <BODY>
3815 <H1>Folders</H1>
3816
3817 Messages can quickly accumulate in your INBOX folder. If you use email
3818 often, you soon could have hundreds. You need to delete messages you do
3819 not want, and you can use folders to organize messages you wish to save. A
3820 folder is a collection of one or more messages that are stored (just like
3821 the messages in your INBOX) so you can access and manage them.
3822
3823 <P>
3824 You can organize your email messages into different folders by topic,
3825 correspondent, date, or any other category that is meaningful to you. You
3826 can create your own folders, and Alpine automatically provides three:
3827 <ul>
3828   <li>The INBOX folder: messages sent to you are listed in this folder.
3829       When you first start Alpine and go to the Message Index screen, you are
3830 looking at the list of messages in your INBOX folder. Every incoming
3831 message remains in your INBOX until you delete it or save it in another
3832 folder. </li>
3833   <li>The sent-mail folder: copies of messages you send are stored in this
3834 folder. This is
3835 convenient if you cannot remember whether you actually sent a message and want
3836 to check, or
3837 if you want to send a message again.</li>
3838   <li>The saved-messages folder: copies of messages you save are stored in this
3839 folder
3840 unless you choose to save them to other folders you create yourself.</li>
3841 </ul>
3842
3843 <P>
3844 More information about folders is available in Alpine's online help:
3845 <ul>
3846   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
3847   <li><a href="h_folder_maint">Help for Folder List</a></li>
3848   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
3849   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
3850 Explained</a></li>
3851   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
3852 </ul>
3853 <P>
3854 &lt;End of help on this topic&gt;
3855 </BODY>
3856 </HTML>
3857 ===== h_mainhelp_color ======
3858 <HTML>
3859 <HEAD>
3860 <TITLE>Color</TITLE>
3861 </HEAD>
3862 <BODY>
3863 <H1>Color</H1>
3864
3865 If the terminal emulator you are using is capable of displaying color or if
3866 you are using PC-Alpine, then it is possible to set up Alpine so that various
3867 parts of the display will be shown in colors you configure. This is done
3868 using the Setup Color screen, available from the MAIN MENU by selecting
3869 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
3870 stands for Config in this context).
3871
3872 <P>
3873 For example, you may color things like the titlebar, the current item,
3874 the keymenu, and the status messages.
3875 You may also color lines in the index, and headers and quoted text in the
3876 MESSAGE TEXT screen.
3877 You use the Color Setup screen for configuring most of this, but you must
3878 use the IndexColor setup for coloring whole index lines.
3879 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
3880
3881 <P>
3882 The following entries in Alpine's online help provide additional information
3883 about how to use color:
3884 <UL>
3885   <LI> <A HREF="h_color_setup">Color Setup screen</A>
3886   <LI> <A HREF="h_rules_incols">Index Line Color</A>
3887   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
3888   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
3889 </UL>
3890 <P>
3891 &lt;End of help on this topic&gt;
3892 </BODY>
3893 </HTML>
3894 ===== h_mainhelp_mouse ======
3895 <HTML>
3896 <HEAD>
3897 <TITLE>Using a Mouse</TITLE>
3898 </HEAD>
3899 <BODY>
3900 <H1>Using a Mouse</H1>
3901
3902 If you are using PC-Alpine mouse support is turned on automatically.
3903 If you are using UNIX Alpine within an X terminal window or within
3904 a terminal emulator that supports an xterm-style mouse, then you may
3905 turn on support for the mouse with the feature
3906 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
3907 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
3908 <P>
3909 PC-Alpine offers considerable mouse support.  You can view what is
3910 &quot;clickable&quot; by dragging your mouse over any screen; when the
3911 arrow cursor changes into a hand, you found something. Mouse-click
3912 possibilities include navigating between screens and folders and
3913 double-clicking on hyperlinks to open your Web browser.
3914 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
3915 screen.  Examples of right-click options include &quot;copy&quot; after
3916 selecting text to copy and &quot;View in New Window&quot; when you click
3917 on a particular message in the Message Index. The menu choices available
3918 to you will vary based upon what screen is open, where on the screen your
3919 cursor is located, and even what action you have already taken.
3920 Within a folder, you may set the &quot;Important&quot; flag on any
3921 message.
3922 <P>
3923 X terminal mouse support is more limited but still quite powerful.
3924 As with PC-Alpine, clicking on any of the commands in the keymenu at
3925 the bottom of the screen will execute that command as if you typed it.
3926 Double-clicking on a link, for example the link to the
3927 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
3928 will take you to that link.
3929 Double-clicking on an index line will view the message, and so on.
3930 <P>
3931 &lt;End of help on this topic&gt;
3932 </BODY>
3933 </HTML>
3934 ===== h_mainhelp_keywords ======
3935 <HTML>
3936 <HEAD>
3937 <TITLE>Keywords</TITLE>
3938 </HEAD>
3939 <BODY>
3940 <H1>Keywords</H1>
3941
3942 Within a folder, you may set the &quot;Important&quot; flag on any
3943 message.
3944 This doesn't have any system-defined meaning and is only called
3945 the Important flag because many users use it to signify that a message
3946 is important to them in some way.
3947 <P>
3948 You may also define your own set of keywords.
3949 You might know these as user defined flags or as labels.
3950 These are similar to the Important flag but you choose the names for yourself.
3951 <P>
3952 Alpine will only display keywords that
3953 have been added by you in the Flag Details screen or
3954 that have been configured by you using the Setup/Config option
3955 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
3956 Keywords set by other means (for example, by another email client) will not
3957 show up in Alpine unless you configure Alpine to know about them.
3958 They will show up in the Flag Details screen, but will not show up, for example,
3959 in the index line.
3960
3961 <P>
3962 The following entries in Alpine's online help provide additional information
3963 about how to use keywords:
3964 <ul>
3965   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
3966   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
3967 </ul>
3968 <P>
3969 &lt;End of help on this topic&gt;
3970 </BODY>
3971 </HTML>
3972 ===== h_mainhelp_roles ======
3973 <HTML>
3974 <HEAD>
3975 <TITLE>Roles</TITLE>
3976 </HEAD>
3977 <BODY>
3978 <H1>Roles</H1>
3979
3980 You may play different roles depending on who you are replying to. For
3981 example, if you are replying to a message addressed to help-desk you may
3982 be acting as a Help Desk Worker. That role may require that you use a
3983 different return address and/or a different signature.
3984
3985 <P>
3986 To configure roles, go to the MAIN MENU and use the Setup command
3987 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
3988 The following entries in Alpine's online help provide additional information
3989 about how to
3990 use roles:
3991 <ul>
3992   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
3993   <li><a href="h_role_select">Roles Screen</a></li>
3994 </ul>
3995 <P>
3996 &lt;End of help on this topic&gt;
3997 </BODY>
3998 </HTML>
3999 ===== h_mainhelp_filtering ======
4000 <HTML>
4001 <HEAD>
4002 <TITLE>Filtering</TITLE>
4003 </HEAD>
4004 <BODY>
4005 <H1>Filtering</H1>
4006
4007 The software that actually delivers mail (the stuff that happens
4008 before Alpine is involved) for you is in a better position to do mail filtering
4009 than Alpine itself.
4010 If possible, you may want to look into using that sort of mail filtering to
4011 deliver mail to different folders, delete it, or forward it.
4012 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
4013
4014 <P>
4015 Filtering is a way to automatically move certain messages from one folder
4016 to another or to automatically delete messages.
4017 You may also automatically set the state (Important, New, Deleted, Answered) of messages
4018 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
4019 Alpine doesn't have the ability to forward mail to another address or
4020 to deliver vacation messages.
4021
4022 <P>
4023 To configure filtering, go to the MAIN MENU and use the Setup command
4024 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
4025 The following entries in Alpine's online help provide additional information
4026 about how to use filtering:
4027 <UL>
4028   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
4029 </UL>
4030 <P>
4031 &lt;End of help on this topic&gt;
4032 </BODY>
4033 </HTML>
4034 ===== h_mainhelp_patterns ======
4035 <HTML>
4036 <HEAD>
4037 <TITLE>Patterns</TITLE>
4038 </HEAD>
4039 <BODY>
4040 <H1>Patterns</H1>
4041
4042 Patterns are used with Roles, Filtering, Index Coloring,
4043 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
4044 The following entries in Alpine's online help provide information
4045 about using Patterns:
4046 <UL>
4047   <LI> <A HREF="h_rule_patterns">Patterns</A>
4048 </UL>
4049 <P>
4050 &lt;End of help on this topic&gt;
4051 </BODY>
4052 </HTML>
4053 ===== h_mainhelp_cmdlineopts ======
4054 <HTML>
4055 <HEAD>
4056 <TITLE>Command Line Options</TITLE>
4057 </HEAD>
4058 <BODY>
4059 <H1>Command Line Options</H1>
4060
4061 Alpine accepts a number of command line arguments, allowing you, for
4062 example, to start Alpine and immediately access a particular folder.
4063 Many of these arguments overlap with options in the Alpine configuration file.
4064 If there is a difference, then an option set on the command line takes
4065 precedence.
4066 Alpine expects command line arguments (other than addresses) to be
4067 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
4068 A <a href="h_command_line_options">full list</a> of command line
4069 possibilities is available.
4070 <P>
4071 &lt;End of help on this topic&gt;
4072 </BODY>
4073 </HTML>
4074 ===== h_mainhelp_config ======
4075 <HTML>
4076 <HEAD>
4077 <TITLE>Alpine Configuration</TITLE>
4078 </HEAD>
4079 <BODY>
4080 <H1>Alpine Configuration</H1>
4081
4082 Unless it has been administratively disabled, the Setup command on the
4083 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
4084 The possible subcommands are for general Configuration settings,
4085 Printer settings, Changing your Password, Signature setup,
4086 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
4087 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
4088 and Color configuration.
4089 In particular, the &quot;Config&quot; subcommand has many features you may
4090 set or unset and many other configuration variables that may be set to change
4091 the way Alpine works.
4092 Every one of the hundreds of options available in that configuration settings
4093 screen has help text associated with it.
4094 You may read that text by moving the cursor to highlight the option and then
4095 typing the Help command.
4096 <P>
4097 These settings are stored in your personal
4098 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
4099 <A HREF="h_config_remote_config">remotely</A>),
4100 but on shared systems these settings
4101 may be over-ridden by a system-wide control file (due to local site
4102 security or support policies).  A global pine configuration file can also
4103 be used to set default values for all Alpine users on a particular system.
4104 Power users may be interested in splitting their personal configuration
4105 data into two pieces, a generic piece and
4106 <A HREF="h_config_exceptions">exceptions</A> which apply to
4107 a particular platform.
4108 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
4109 General Alpine configuration information can be found
4110 <A HREF="h_news_config">here</A>.
4111 <P>
4112 &lt;End of help on this topic&gt;
4113 </BODY>
4114 </HTML>
4115 ===== h_mainhelp_aggops ======
4116 <HTML>
4117 <HEAD>
4118 <TITLE>Aggregate Operations</TITLE>
4119 </HEAD>
4120 <BODY>
4121 <H1>Aggregate Operations</H1>
4122
4123 When you are in the MESSAGE INDEX, the available commands
4124 (for example, Delete, Undelete, Save, Reply, and so on)
4125 normally act on a single message.
4126 So, for example, if you press the Delete command, the currently highlighted
4127 message is marked Deleted.
4128 These commands that normally act on a single message may be applied to
4129 several messages at once instead.
4130 <P>
4131 By default this feature is turned on, but it could be administratively turned
4132 off to reduce complexity.
4133 The feature
4134 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
4135 in the Setup/Config screen is used to turn it off or on.
4136 When this feature is turned on, the four commands &quot;Select&quot;,
4137 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
4138 are available.
4139 The two selection commands allow you to mark a set of
4140 messages as being &quot;selected&quot;.
4141 The &quot;ZoomMode&quot; command will toggle between
4142 displaying only the selected messages and displaying all the messages.
4143 The &quot;Apply&quot; command allows you to
4144 apply one of the regular MESSAGE INDEX commands to all of the selected
4145 messages instead of to only the highlighted message.
4146 <P>
4147 An example aggregate operation would be to catch up when reading
4148 a news group.
4149 That is, get rid of all the messages in the news group so that you can
4150 start fresh.
4151 The easiest way to do this in Alpine is to use aggregate operations.
4152 You want to Delete all of the messages in the group.
4153 You could start at the top and type &quot;D&quot; once for every message.
4154 A much faster method is to first Select all of the messages in the group,
4155 and then Delete all of them.
4156 This would take four keystrokes:
4157 <P>
4158 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
4159 <BR>
4160 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
4161 <P>
4162 Another use of Select is to use it for searching for a particular message
4163 or set of messages in a large folder.
4164 You may know that the message was From a certain user.
4165 You could select all messages from that user to start, and use Zoom to
4166 look at only those messages.
4167 If there were still too many messages to look at you could Narrow the
4168 set of messages further by selecting from all of those messages only
4169 the ones that were after a certain date, or contained a particular phrase
4170 in the Subject, or were too a particular address, and so on.
4171 That may be the end of what you are doing, or you may want to use Apply to
4172 Save or Forward or Print all of the selected messages.
4173 <P>
4174 Some related help topics are
4175 <UL>
4176 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
4177 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
4178 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
4179 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
4180 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
4181 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
4182 </UL>
4183 <P>
4184 &lt;End of help on this topic&gt;
4185 </BODY>
4186 </HTML>
4187 ===== h_mainhelp_readingnews ======
4188 <HTML>
4189 <HEAD>
4190 <TITLE>Reading News</TITLE>
4191 </HEAD>
4192 <BODY>
4193 <H1>Reading News</H1>
4194
4195 <H2>Background</H2>
4196 Alpine can read and post to Internet (or USENET) newsgroups, using the same
4197 commands as for mail. Similar to mailing lists but existing on a larger scale,
4198 Usenet newsgroups allow groups of people with common interests to discuss
4199 particular topics. You might find newsgroups related to your career, or you
4200 might wish to check out the online discussion among the fans of your favorite
4201 television show.
4202
4203 <H2>Configuring Alpine for Reading News</H2>
4204 Alpine often arrives
4205 pre-configured by your system administrator to automatically access the
4206 newsgroups offered by your organization, Internet Service Provider, or
4207 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
4208 need additional details on <a href="h_configuring_news">how to
4209 configure Alpine to read news</a>.
4210
4211 <H2>Accessing Newsgroups</H2>
4212 The first step in reading news is to access the newsgroups collections
4213 screen from Alpine. If everything is configured properly, you should be able
4214 to do this by first typing L (folder List), then selecting the folder
4215 collection listed as "News." The actual name of this collection may differ
4216 from system to system.
4217
4218 <H2>Subscribing to Newsgroups</H2>
4219
4220 Once you have accessed the news collection, you need to subscribe to a
4221 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
4222 will keep a record of the newsgroups in which you are interested and which
4223 articles in those newsgroups have been read.
4224
4225 <H2>Using Newsgroups</H2>
4226 Alpine uses the similar commands to read news as to read mail. For example,
4227 the D command marks messages as Deleted (or "Dismissed," if you prefer),
4228 and the R command Replies to a news posting. Basically, Alpine allows you to
4229 read news as if it were mail, so you don't need to change the way you
4230 interact with Alpine.
4231 <P>
4232 There is also additional Alpine help available on
4233 <A HREF="h_reading_news">how to use Alpine to read news</A>.
4234 <P>
4235 &lt;End of help on this topic&gt;
4236 </BODY>
4237 </HTML>
4238 ===== h_mainhelp_securing ======
4239 <HTML>
4240 <HEAD>
4241 <TITLE>Securing your Alpine Session</TITLE>
4242 </HEAD>
4243 <BODY>
4244 <H1>Securing your Alpine Session</H1>
4245
4246 By default, Alpine will attempt to connect to an IMAP server on the normal
4247 IMAP service port (143).
4248 If the Alpine you are using has been built to
4249 support &quot;Transport Layer Security&quot; (TLS)
4250 and &quot;Secure Sockets Layer&quot; (SSL)
4251 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
4252 and the server offers the STARTTLS capability, then a secure (encrypted)
4253 session will be established.
4254 <P>
4255 When you are connected to a remote folder the titlebar will contain a plus sign
4256 in the far right column if the connection is encrypted using TLS or SSL.
4257 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
4258 if the connection is encrypted.
4259
4260 <H2>More Information on Alpine with SSL and TLS</H2>
4261 <UL>
4262 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
4263 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
4264 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
4265 <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>
4266 </UL>
4267 <H2>Here are some other security-related features and options</H2>
4268 <P>
4269 <UL>
4270 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
4271 <LI> <A HREF="h_config_disable_password_file_saving"><!--#echo var="FEAT_disable-password-file-saving"--></A> Disable password file saving</LI>
4272 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
4273 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
4274 <LI> <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A> option </LI>
4275 </UL>
4276 <P>
4277 &lt;End of help on this topic&gt;
4278 </BODY>
4279 </HTML>
4280 ===== h_mainhelp_problems ======
4281 <HTML>
4282 <HEAD>
4283 <TITLE>Reporting Problems</TITLE>
4284 </HEAD>
4285 <BODY>
4286 <H1>Reporting Problems</H1>
4287
4288 We ask that you first read the relevant help screens and then seek
4289 assistance from your own local support staff.  Once you are sure that your
4290 difficulty is not a local configuration problem, you might look at the
4291 help section explaining where to look for
4292 <A HREF="h_finding_help">more information</A> and where to
4293 get assistance.
4294 <P>
4295
4296 <ADDRESS>
4297    Eduardo Chappa &lt;chappa@washington.edu&gt;
4298 </ADDRESS>
4299
4300 <P>
4301 &lt;End of help on this topic&gt;
4302 </BODY>
4303 </HTML>
4304 ===== h_main_menu_commands ======
4305 <HTML>
4306 <HEAD>
4307 <TITLE>MAIN MENU COMMANDS</TITLE>
4308 </HEAD>
4309 <BODY>
4310 <H1>MAIN MENU COMMANDS</H1>
4311
4312 <!--chtml if pinemode="function_key"-->
4313 &nbsp;Available&nbsp;Commands&nbsp;--
4314 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
4315 &nbsp;------------------------------
4316 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
4317 ----------<BR>
4318 &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>
4319 &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>
4320 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
4321 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
4322 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
4323 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
4324 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
4325 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
4326 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
4327 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4328 &nbsp;F7&nbsp;&nbsp;<A
4329 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
4330 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4331 &nbsp;F8&nbsp;&nbsp;<A
4332 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
4333 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
4334 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
4335 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
4336 &nbsp;F10&nbsp;<A
4337 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
4338 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
4339 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4340 &nbsp;F11&nbsp;<A
4341 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
4342 <!--chtml else-->
4343 &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>
4344 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
4345 &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>
4346 &nbsp;C&nbsp;&nbsp;<A
4347 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>
4348 &nbsp;I&nbsp;&nbsp;<A
4349 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>
4350 &nbsp;L&nbsp;&nbsp;<A
4351 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>
4352 &nbsp;A&nbsp;&nbsp;<A
4353 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
4354 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
4355 &nbsp;S&nbsp;&nbsp;<A
4356 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
4357 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
4358 &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>
4359 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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
4360 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
4361 <!--chtml endif-->
4362
4363 <P>
4364 NOTE:
4365 <OL>
4366  <LI>For help on a particular command, highlight the bold text associated
4367 with it above and hit Return.
4368  <LI> The availability of certain commands (e.g. some of the options under
4369 SETUP) is determined by Alpine configuration files and system capabilities.
4370 At some sites, certain commands may not be available due to security or
4371 support concerns.
4372 </OL>
4373 <P>
4374 &lt;End of help on this topic&gt;
4375 </BODY>
4376 </HTML>
4377
4378 ===== h_command_line_options ======
4379 <HTML>
4380 <HEAD>
4381 <TITLE>COMMAND LINE OPTIONS</TITLE>
4382 </HEAD>
4383 <BODY>
4384 <H1>COMMAND LINE OPTIONS</H1>
4385 Possible starting arguments for Alpine:
4386
4387 <DL COMPACT>
4388
4389 <DT> <EM>[addresses]</EM>
4390
4391 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
4392 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
4393 <EM>Alpine</EM> will startup in
4394 the composer with a message started to the addresses specified.
4395 Once the message is sent, the <EM>Alpine</EM> session closes.
4396 Standard input redirection is allowed.
4397 Separate multiple addresses with a space between them.
4398 Addresses are placed in the &quot;To&quot; field only.
4399 <P>
4400
4401 <DT> &lt; <EM>file</EM>
4402
4403 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
4404 into the body of the message.
4405 Once the message is sent, the <EM>Alpine</EM> session closes.
4406 <P>
4407
4408 <DT> -attach <EM>file</EM>
4409
4410 <DD> Go directly into composer with given file attached.
4411 <P>
4412
4413 <DT> -attachlist <EM>file-list</EM>
4414
4415 <DD> Go directly into composer with given files attached.
4416 This must be the last option on the command line.
4417 <P>
4418
4419 <DT> -attach_and_delete <EM>file</EM>
4420
4421 <DD> Go directly into composer with given file attached, delete when finished.
4422 <P>
4423
4424 <DT> -aux <EM>local_directory</EM>
4425
4426 <DD> <EM>PC-Alpine</EM> only.
4427 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
4428 files, like debug files, address books, and signature files.  The pinerc may
4429 be local or remote.
4430 <P>
4431
4432 <DT> -bail
4433
4434 <DD> If the personal configuration file doesn't already exist, exit.
4435 This might be useful if the configuration file is accessed using some
4436 remote filesystem protocol. If the remote mount is missing this will cause
4437 <EM>Alpine</EM> to quit instead of creating a new pinerc.
4438 <P>
4439
4440 <DT> -c <EM>n</EM>
4441
4442 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
4443 This is used when there are multiple folder collections (contexts) and you
4444 want to open a folder not in the primary collection.
4445 <P>
4446
4447 <DT> -conf
4448
4449 <DD> Configuration: Prints a sample system configuration file to the
4450 screen or standard output. To generate an initial system configuration
4451 file, execute
4452
4453 <PRE><CODE>
4454                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
4455 </CODE></PRE>
4456 <P>
4457
4458 To generate a system configuration file using settings from an old
4459 system configuration file, execute
4460
4461 <PRE><CODE>
4462                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
4463 </CODE></PRE>
4464 <P>
4465 A system configuration file is not required.
4466 <P>
4467
4468 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
4469
4470 <DD> Copy an address book file to a remote address book folder.
4471 If the remote folder doesn't exist, it will be created.
4472 If it exists but the first message in the folder isn't a remote address
4473 book header message, the copy will be aborted.
4474 This flag will not usually be used by a user.
4475 Instead, the user will create a remote address book from within <EM>Alpine</EM>
4476 and copy entries from the local address book by using aggregate Save in
4477 the address book screen.
4478 <P>
4479
4480 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
4481
4482 <DD> Copy a pinerc configuration file to a remote pinerc folder.
4483 If the remote folder doesn't exist, it will be created.
4484 If it exists but the first message in the folder isn't a remote pinerc
4485 header message, the copy will be aborted.
4486 This flag may be useful to users who already have a local pinerc file and
4487 would like to convert it to a remote pinerc folder and use that instead.
4488 This gives a way to bootstrap that conversion without having to manually
4489 reset all of the variables in the remote pinerc folder.
4490 <P>
4491
4492 <DT> -d <EM>debug-level</EM>
4493
4494 <DD> Debug Level:  Sets the level of debugging information written by
4495 <EM>Alpine</EM>.
4496 <EM>debug-level</EM> can be set to any integer 0-9.
4497 A debug level of 0 turns off debugging for the session.
4498 (Actually there are some levels higher than 9, but you probably don't
4499 want to see them.)
4500 <P>
4501
4502 <DT> -d <EM>keywords</EM>
4503
4504 <DD> You may use a more detailed version of the debugging flag to set
4505 the debug level in separate parts of <EM>Alpine</EM>.
4506 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
4507 verbose=0..9.
4508 <EM>Flush</EM> causes debugging information to be flushed immediately to
4509 the debug file as it is written.
4510 <EM>Verbose</EM> is the general debugging verbosity level.
4511 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
4512 is useful when you are trying to figure out what is responsible for delays.
4513 <EM>Numfiles</EM> sets the number of debug files saved.
4514 <EM>Imap</EM> sets the debug level for the debugging statements related
4515 to the conversation with the IMAP server, and more generally, for the
4516 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
4517 <EM>Tcp</EM> turns on some TCP/IP debugging.
4518 <P>
4519
4520 <DT> -f <EM>folder</EM>
4521
4522 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
4523 of the standard INBOX.
4524 <P>
4525
4526 <DT> -F <EM>file</EM>
4527
4528 <DD> Open named text file for viewing and forwarding.
4529 <P>
4530
4531 <DT> -h
4532
4533 <DD> Help:  Prints the list of available command-line arguments to the
4534 screen.
4535 <P>
4536
4537 <DT> -i
4538
4539 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
4540 screen instead of the MAIN MENU.
4541 <P>
4542
4543 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
4544 <P>
4545
4546 <DT> -I <EM>a,b,c,...</EM>
4547
4548 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
4549 sequence of commands upon startup.
4550 This allows users to get <EM>Alpine</EM> to start in any
4551 of its menus/screens.
4552 You cannot include any input to the composer in the initial keystrokes.
4553 The key &lt;Return&gt; is represented by a ``CR'' in
4554 the keystroke list; the spacebar is designated by the letters ``SPACE''.
4555 Control keys are two character sequences beginning with ``^'', such as
4556 ``^I''.
4557 A tab character is ``TAB''.
4558 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
4559 ``DOWN'', ``LEFT'', and ``RIGHT''.
4560 A restriction is that you can't mix function keys and character keys in this
4561 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
4562 A user can always use only <EM>character</EM> keys in the startup list even
4563 if he or she is using <EM>function</EM> keys normally, or vice versa.
4564 If an element in this list is a string of characters surrounded by double
4565 quotes (&quot;) then it will be expanded into the individual characters in
4566 the string, excluding the double quotes.
4567 <P>
4568
4569 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
4570 <P>
4571
4572 <DT> -install
4573
4574 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
4575 some basic information to help with getting properly set up.
4576 <P>
4577
4578 <DT> -k
4579
4580 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
4581 the input of commands to be function-keys.
4582 Otherwise, commands are linked to the regular character keys.
4583 <P>
4584
4585 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
4586 <EM>Feature-List</EM>.
4587 <P>
4588
4589 <DT> -n <EM>n</EM>
4590
4591 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
4592 FOLDER INDEX screen with the current message being the specified
4593 message number.
4594 <P>
4595
4596 <DT> -nosplash
4597
4598 <DD> <EM>PC-Alpine</EM> only.
4599 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
4600 This may be helpful for certain troubleshooting or terminal server scenarios.
4601 <P>
4602
4603 <DT> -o <EM>folder</EM>
4604
4605 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
4606 <P>
4607
4608 <DT> -p <EM>pinerc</EM>
4609
4610 <DD> Uses the named file as the personal configuration file instead of
4611 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
4612 Alpinerc may be either a local file or a remote configuration folder.
4613 <P>
4614
4615 <DT> -P <EM>pinerc</EM>
4616
4617 <DD> Uses the named file as the system wide configuration file instead of
4618 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
4619 Alpinerc may be either a local file or a remote configuration folder.
4620 <P>
4621
4622 <DT> -passfile <EM>passfile</EM>
4623
4624 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
4625 This should be a fully-qualified filename.
4626 <P>
4627
4628 <DT> -pinerc <EM>file</EM>
4629
4630 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
4631 settings of variables that the user has made.
4632 Use <EM>file</EM> set to ``-'' to make output go to standard out.
4633 <P>
4634
4635 <DT> -r
4636
4637 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
4638 <EM>Alpine</EM> in restricted mode can only send email to itself.
4639 Save and export are limited.
4640 <P>
4641
4642 <DT> -registry <EM>cmd</EM>
4643
4644 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
4645 <EM>Alpine</EM>'s registry entries.
4646 Possible values for <EM>cmd</EM> are set, clear, and dump.
4647 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
4648 entries according to its current settings.
4649 <EM>Clear</EM> will clear the registry values.
4650 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
4651 <EM>Dump</EM> will display the values of current registry settings.
4652 Note that the dump command is currently disabled.
4653 Without the -registry option, <EM>PC-Alpine</EM> will write values into
4654 the registry only if there currently aren't any values set.
4655 <P>
4656
4657 <DT> -sort <EM>key</EM>
4658
4659 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
4660 FOLDER INDEX screen.
4661 <EM>Key</EM> can have the following values:
4662 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
4663 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
4664 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
4665 The default value is &quot;arrival&quot;.
4666 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
4667 <P>
4668
4669 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
4670 <P>
4671
4672 <DT> -uninstall
4673
4674 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
4675 in Windows settings.  The registry settings are removed and
4676 the password cache is cleared.
4677 <P>
4678
4679 <DT> -url <EM>url</EM>
4680
4681 <DD> Open the given URL.
4682 <P>
4683
4684 <DT> -v
4685
4686 <DD> Version:  Print version information to the screen.
4687 <P>
4688
4689 <DT> -x <EM>exceptions_config</EM>
4690
4691 <DD> Configuration settings in the exceptions configuration override your normal
4692 default settings.
4693 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
4694 <P>
4695
4696 <DT> -z
4697
4698 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
4699 will suspend the <EM>Alpine</EM> session.
4700 <P>
4701
4702 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
4703 <EM>Feature-List</EM>.
4704 <P>
4705
4706 <DT> -<EM>option</EM>=<EM>value</EM>
4707
4708 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
4709 For example, <EM>-signature-file=sig1</EM> or
4710 <EM>-Feature-List=signature-at-bottom</EM>.
4711 Note:  Feature-List values are
4712 additive and features may be preceded with no- to turn them off.
4713 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
4714 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
4715 <EM>-Feature-List=signature-at-bottom</EM>.
4716 <P>
4717
4718 </DL>
4719 <P>
4720 &lt;End of help on this topic&gt;
4721 </BODY>
4722 </HTML>
4723 ===== h_configuring_news ======
4724 <HTML>
4725 <HEAD>
4726 <TITLE>CONFIGURING NEWS</TITLE>
4727 </HEAD>
4728 <BODY>
4729 <H1>CONFIGURING NEWS</H1>
4730 Alpine can access news folders in any one of three different ways:
4731 <DL>
4732 <DT>REMOTE NNTP</DT>
4733 <DD>Using the Network News Transport Protocol (NNTP) to
4734 access news on a remote news server.  In this case the newsrc file is
4735 stored on the machine where Alpine is running.
4736
4737 <P>
4738 To specify a remote news-collection accessed via NNTP use the
4739 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4740 Server: value to the NNTP server's hostname appended with the
4741 communication method &quot;/service=NNTP&quot;, and set the Path:
4742 value to the &quot;#news.&quot; namespace (without the quotes).  See
4743 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
4744 help text for a more complete explanation of access method, and the
4745 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4746 text for a more complete explanation of &quot;namespace&quot;.
4747 <P>
4748 Instead of specifying a news-collection, you may simply set the
4749 <A HREF="h_config_nntp_server">NNTP Server</A>
4750 option, which will cause Alpine to create a default news-collection for you.
4751 Another NNTP option that may be of interest is
4752 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
4753
4754 <DT>REMOTE IMAP</DT>
4755 <DD>Using the Internet Message Access Protocol (IMAP) to
4756 access news on a remote news server.  In this case, your newsrc file is
4757 stored on the news server, in your home directory, so you must have an
4758 account on the news server, but you would be running Alpine on a different
4759 machine.  The news server must be running an IMAPd server process.
4760
4761 <P>
4762 To specify a remote news-collection accessed via IMAP use the
4763 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4764 Server: value to the IMAP server's hostname, and set the Path: value
4765 to the &quot;#news.&quot; namespace (without the quotes).  See the
4766 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4767 text for a more complete explanation of &quot;namespace&quot;.
4768
4769 </DD>
4770
4771 <DT>LOCAL</DT>
4772 <DD>Using local file access to the news database.  In this
4773 case, your newsrc file is stored on the news server, in your home
4774 directory, so you must have an account on the news server, and you would
4775 be running Alpine on the same machine.
4776
4777 <P>
4778 To specify a local news-collection use the SETUP/collectionList
4779 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
4780 set the Path: value to the &quot;#news.&quot; namespace (without the
4781 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
4782 field's help text for a more complete explanation of &quot;namespace&quot;.
4783
4784 </DD>
4785 </DL>
4786
4787 <P>
4788
4789 NOTE: Should no news-collection be defined as above, Alpine will
4790 automatically create one using the Setup/Config screen's
4791 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
4792 will be created as a &quot;Remote NNTP&quot; as described above.
4793
4794 <P>
4795
4796 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
4797 possible.  If you don't have an account on the news server, or if the news
4798 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
4799 sure, ask your service provider, university, or company for help.)  In
4800 this case, your Unix .newsrc file can be transferred to your PC.  A good
4801 place to put it would be in the same directory as your PINERC file, under
4802 the name NEWSRC, but you can
4803 <A HREF="h_config_newsrc_path">specify a different location</A>
4804 via Alpine's Setup/Config screen.
4805
4806 <P>
4807 Other configuration features related to news are
4808 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
4809 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
4810 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
4811 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
4812 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
4813 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
4814 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
4815 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
4816
4817 <P>
4818 &lt;End of help on this topic&gt;
4819 </BODY>
4820 </HTML>
4821 ===== h_reading_news ======
4822 <HTML>
4823 <HEAD>
4824 <TITLE>READING NEWS</TITLE>
4825 </HEAD>
4826 <BODY>
4827 <H1>READING NEWS</H1>
4828
4829 Alpine uses almost the same commands for manipulating news folders as for
4830 mail folders.  This means, for example, that when you are done with a
4831 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
4832 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
4833 most newsreaders, wherein a message is implicitly dismissed after you have
4834 looked at it once. We strongly believe that Alpine should offer as much
4835 consistency as possible between mail and news, so the mail paradigm --
4836 wherein a message does not magically disappear without explicit action by
4837 the user -- is used for news as well. <P>
4838
4839 If you answer a message in a news folder, the index view will show the
4840 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
4841 keep track of what news as been read has no way of storing this flag, so
4842 it will not be preserved across sessions.  The Deleted flag is the only
4843 one that is preserved when you leave and then return to a newsgroup.  As an
4844 additional note on replies, when you Reply to a newsgroup message and say
4845 you want to reply to all recipients, Alpine will ask if you want to post the
4846 message to all the newsgroups listed in the original message. <P>
4847
4848 If you would like Alpine to mark more-or-less recent news messages as
4849 &quot;New&quot;, then set the
4850 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
4851 feature (which is set by default).  This will cause messages after the last one you have marked as
4852 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
4853 &quot;N&quot; status often makes it easier to distinguish later news
4854 articles from those you've previously seen, but not yet disposed of via
4855 the &quot;D&quot; key.  Note that this is an approximation, not an exact
4856 record of which messages you have not seen.
4857 <P>
4858
4859 A frequent operation in news-reading is &quot;catching up&quot; -- that
4860 is, getting rid of all the messages in the newsgroup so that you can
4861 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
4862 Select command.  You would enter the following four keystrokes:
4863 <tt>;aad</tt> to select all messaged, and then apply the delete (or
4864 dismiss) command to all of them.
4865
4866 <P>
4867 There are also additional details on
4868 <A HREF="h_configuring_news">configuring news</a>.
4869
4870 <P>
4871 &lt;End of help on this topic&gt;
4872 </BODY>
4873 </HTML>
4874 ====== h_help_index ======
4875 <HTML>
4876 <HEAD>
4877 <TITLE>Help Index</TITLE>
4878 </HEAD>
4879 <BODY>
4880 <H1>Help Index</H1>
4881 <ul>
4882 <li><a href="h_mainhelp_abooks">Address Books</a></li>
4883 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
4884 <li><a href="h_main_addrbook">Address Book Command</a>
4885 <li><a href="h_abook_view">Address Book View Explained</a>
4886 <li><a href="h_compose_addrcomplete">Address Completion</a>
4887 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
4888 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
4889 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
4890 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
4891 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
4892 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
4893 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
4894 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
4895 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
4896 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
4897 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
4898 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
4899 <li><a href="h_mainhelp_config">Alpine Configuration</a>
4900 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
4901 <li><a href="h_news_legal">Alpine Legal Notices</a>
4902 <li><a href="h_compose_alted">Alt Editor Command</a>
4903 <li><a href="h_index_cmd_apply">Apply Command</a>
4904 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
4905 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
4906 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
4907 <li><a href="h_composer_browse">BROWSER</a>
4908 <li><a href="h_common_bounce">Bounce Command</a>
4909 <li><a href="h_compose_cancel">Cancel Command</a>
4910 <li><a href="h_config_change_your_from">Changing your From Address</a>
4911 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
4912 <li><a href="h_mainhelp_color">Color</a>
4913 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
4914 <li><a href="h_composer">COMPOSER COMMANDS</a>
4915 <li><a href="h_mainhelp_composing">Composing Messages</a>
4916 <li><a href="h_mainhelp_collections">Collection Lists</a>
4917 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
4918 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
4919 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
4920 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
4921 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
4922 <li><a href="h_common_compose">Compose Command</a>
4923 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
4924 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
4925 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
4926 <li><a href="h_mainhelp_config">Configuration</a>
4927 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
4928 <li><a href="h_config_dflt_color">Default Color</a>
4929 <li><a href="h_common_delete">Delete and Undelete Commands</a>
4930 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
4931 <li><a href="h_special_list_commands">Email List Commands Explained</a>
4932 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
4933 <li><a href="h_folder_open">Explanation of Folder Selection</a>
4934 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
4935 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
4936 <li><a href="h_ge_export">Export File Selection</a>
4937 <li><a href="h_ge_allparts">Export Message File Selection</a>
4938 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
4939 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
4940 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
4941 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
4942 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
4943 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
4944 <li><a href="h_config_alt_reply_menu">FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></a>
4945 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
4946 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
4947 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
4948 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
4949 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
4950 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
4951 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
4952 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
4953 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
4954 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
4955 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
4956 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
4957 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
4958 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
4959 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
4960 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
4961 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
4962 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
4963 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
4964 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
4965 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
4966 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
4967 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
4968 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
4969 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
4970 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
4971 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
4972 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
4973 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
4974 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
4975 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
4976 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
4977 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
4978 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
4979 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
4980 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
4981 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
4982 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
4983 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
4984 <li><a href="h_config_delete_before_writing">FEATURE: <!--#echo var="FEAT_enable-delete-before-writing"--></a>
4985 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
4986 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
4987 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
4988 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
4989 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
4990 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
4991 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
4992 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
4993 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
4994 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
4995 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
4996 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
4997 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
4998 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
4999 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
5000 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
5001 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
5002 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
5003 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
5004 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
5005 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
5006 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
5007 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
5008 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
5009 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
5010 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
5011 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
5012 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
5013 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
5014 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
5015 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
5016 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
5017 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
5018 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
5019 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
5020 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
5021 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
5022 <li><a href="h_external_loads_inline_images_only">FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
5023 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
5024 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
5025 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
5026 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
5027 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
5028 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
5029 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
5030 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
5031 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
5032 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
5033 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
5034 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
5035 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
5036 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
5037 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
5038 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
5039 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
5040 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
5041 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
5042 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
5043 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
5044 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
5045 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
5046 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
5047 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
5048 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
5049 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
5050 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
5051 <li><a href="h_config_ignore_size">FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></a>
5052 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
5053 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
5054 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
5055 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
5056 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
5057 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
5058 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
5059 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
5060 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
5061 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
5062 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
5063 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
5064 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
5065 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
5066 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
5067 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
5068 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
5069 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
5070 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
5071 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
5072 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
5073 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
5074 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
5075 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
5076 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
5077 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
5078 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
5079 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
5080 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
5081 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
5082 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
5083 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
5084 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
5085 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
5086 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
5087 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
5088 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
5089 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
5090 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
5091 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
5092 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
5093 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
5094 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
5095 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
5096 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
5097 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
5098 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
5099 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
5100 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
5101 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
5102 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
5103 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
5104 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
5105 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
5106 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
5107 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
5108 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
5109 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
5110 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
5111 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
5112 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
5113 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
5114 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
5115 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
5116 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
5117 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
5118 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
5119 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
5120 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
5121 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
5122 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
5123 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
5124 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
5125 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
5126 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
5127 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
5128 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
5129 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
5130 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
5131 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
5132 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
5133 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
5134 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
5135 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
5136 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
5137 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
5138 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
5139 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
5140 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
5141 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
5142 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
5143 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
5144 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
5145 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
5146 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
5147 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
5148 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
5149 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
5150 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
5151 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
5152 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
5153 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
5154 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
5155 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
5156 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
5157 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
5158 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
5159 <li><a href="h_mainhelp_filtering">Filtering</a>
5160 <li><a href="h_finding_help">Finding more information and requesting help</a>
5161 <li><a href="h_common_flag">Flag Command</a>
5162 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
5163 <li><a href="h_mainhelp_folders">Folders</a>
5164 <li><a href="h_what_are_collections">Folder Collections Explained</a>
5165 <li><a href="h_common_folders">Folder List Command</a>
5166 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
5167 <li><a href="h_folder_save">Folder Select for Save Explained</a>
5168 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
5169 <li><a href="h_config_change_your_from">From Address, Changing</a>
5170 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
5171 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
5172 <li><a href="h_common_goto">Goto Command</a>
5173 <li><a href="h_common_hdrmode">HdrMode Command</a>
5174 <li><a href="h_mainhelp_pinehelp">Help</a>
5175 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
5176 <li><a href="h_folder_maint">Help for Folder List</a>
5177 <li><a href="h_valid_folder_names">IMAP</a>
5178 <li><a href="h_ge_import">Import File Selection</a>
5179 <li><a href="h_mainhelp_index">Index of Messages</a>
5180 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
5181 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
5182 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
5183 <li><a href="h_info_on_mbox">Information on mbox driver</a>
5184 <li><a href="h_mainhelp_intro">Introduction</a>
5185 <li><a href="h_main_journal">Journal Command</a>
5186 <li><a href="h_common_jump">Jump Command</a>
5187 <li><a href="h_compose_justify">Justify Command</a>
5188 <li><a href="h_main_kblock">Keyboard Lock Command</a>
5189 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
5190 <li><a href="h_mainhelp_ldap">LDAP</a>
5191 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
5192 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
5193 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
5194 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
5195 <li><a href="h_config_ldap_opts_ldaps">LDAP FEATURE: Require-LDAPS-On-Connection</a>
5196 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
5197 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
5198 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
5199 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
5200 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
5201 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
5202 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
5203 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
5204 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
5205 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
5206 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
5207 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
5208 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
5209 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
5210 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
5211 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
5212 <li><a href="h_ldap_view">LDAP Response View Explained</a>
5213 <li><a href="h_maildrop">Mail Drop: What is it?</a>
5214 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
5215 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
5216 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
5217 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
5218 <li><a href="h_common_index">Message Index Command</a>
5219 <li><a href="h_mainhelp_mouse">Mouse</a>
5220 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
5221 <li><a href="new_user_greeting">NEW USER GREETING</a>
5222 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
5223 <li><a href="h_mainhelp_readingnews">News Reading</a>
5224 <li><a href="h_folder_subscribe">Newsgroup Subscribe Screen explained</a>
5225 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
5226 <li><a href="h_common_nextnew">NextNew Command</a>
5227 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
5228 <li><a href="h_mainhelp_readingnews">NNTP</a>
5229 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
5230 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
5231 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
5232 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
5233 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
5234 <li><a href="h_config_color_style">OPTION: Color Style</a>
5235 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
5236 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
5237 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
5238 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
5239 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
5240 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
5241 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
5242 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
5243 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
5244 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
5245 <li><a href="h_config_encryption_range">OPTION: <!--#echo var="VAR_encryption-protocol-range"--></a>
5246 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
5247 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
5248 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
5249 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
5250 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
5251 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
5252 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
5253 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
5254 <li><a href="h_config_file_dir">OPTION: File Directory</a>
5255 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
5256 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
5257 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
5258 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
5259 <li><a href="h_config_font_name">OPTION: Font Name</a>
5260 <li><a href="h_config_font_size">OPTION: Font Size</a>
5261 <li><a href="h_config_font_style">OPTION: Font Style</a>
5262 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
5263 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
5264 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
5265 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
5266 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
5267 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
5268 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
5269 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
5270 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
5271 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
5272 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
5273 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
5274 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
5275 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
5276 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
5277 <li><a href="h_config_index_color">OPTION: Index Colors</a>
5278 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
5279 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
5280 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
5281 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
5282 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
5283 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
5284 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
5285 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
5286 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
5287 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
5288 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
5289 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
5290 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
5291 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
5292 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
5293 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
5294 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
5295 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
5296 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
5297 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
5298 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
5299 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
5300 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
5301 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
5302 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
5303 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
5304 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
5305 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
5306 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
5307 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
5308 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
5309 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
5310 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
5311 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
5312 <li><a href="h_config_pat_old">OPTION: Patterns</a>
5313 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
5314 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
5315 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
5316 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
5317 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
5318 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
5319 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
5320 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
5321 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
5322 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
5323 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
5324 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
5325 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
5326 <li><a href="h_config_printer">OPTION: Printer</a>
5327 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
5328 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
5329 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
5330 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
5331 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
5332 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
5333 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
5334 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
5335 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
5336 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
5337 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
5338 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
5339 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
5340 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
5341 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
5342 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
5343 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
5344 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
5345 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
5346 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
5347 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
5348 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
5349 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
5350 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
5351 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
5352 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
5353 <li><a href="h_config_aspell_dictionary">OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></a>
5354 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
5355 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
5356 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
5357 <li><a href="h_config_status_color">OPTION: Status Color</a>
5358 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
5359 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
5360 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
5361 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
5362 <li><a href="h_config_quit_query_timeo">OPTION: <!--#echo var="VAR_close-connection-timeout"--></a>
5363 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
5364 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
5365 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
5366 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
5367 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
5368 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
5369 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
5370 <li><a href="h_config_title_color">OPTION: Title Color</a>
5371 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
5372 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
5373 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
5374 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
5375 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
5376 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
5377 <li><a href="h_config_history">OPTION: <!--#echo var="VAR_default-directories"--></a>
5378 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
5379 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
5380 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
5381 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
5382 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
5383 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
5384 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
5385 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
5386 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
5387 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
5388 <li><a href="h_config_window_position">OPTION: Window-Position</a>
5389 <li><a href="h_mainhelp_patterns">Patterns</a>
5390 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
5391 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
5392 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
5393 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
5394 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
5395 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
5396 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
5397 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
5398 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
5399 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
5400 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
5401 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
5402 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
5403 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
5404 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
5405 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
5406 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
5407 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
5408 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
5409 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
5410 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
5411 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
5412 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
5413 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
5414 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
5415 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
5416 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
5417 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
5418 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
5419 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
5420 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
5421 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
5422 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
5423 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
5424 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
5425 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
5426 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
5427 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
5428 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
5429 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
5430 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
5431 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
5432 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
5433 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
5434 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
5435 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
5436 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
5437 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
5438 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
5439 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
5440 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
5441 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
5442 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
5443 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
5444 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
5445 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
5446 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
5447 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
5448 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
5449 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
5450 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
5451 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
5452 <li><a href="h_common_pipe">Pipe Command</a>
5453 <li><a href="h_valid_folder_names">POP</a>
5454 <li><a href="h_common_postpone">Postpone Command</a>
5455 <li><a href="h_common_print">Print Command</a>
5456 <li><a href="h_mainhelp_readingnews">Reading News</a>
5457 <li><a href="h_news">RELEASE NOTES for Alpine</a>
5458 <li><a href="h_mainhelp_roles">Roles</a>
5459 <li><a href="h_role_select">ROLES SCREEN</a>
5460 <li><a href="h_compose_readfile">Read File Command</a>
5461 <li><a href="h_mainhelp_reading">Reading Messages</a>
5462 <li><a href="h_main_release_notes">Release Notes Command</a>
5463 <li><a href="h_common_reply">Reply and Forward Commands</a>
5464 <li><a href="h_compose_richhdr">Rich Header Command</a>
5465 <li><a href="h_common_role">Role Command</a>
5466 <li><a href="h_mainhelp_smime">S/MIME</a>
5467 <li><a href="h_index_cmd_select">Searching for Messages</a>
5468 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
5469 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
5470 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
5471 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
5472 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
5473 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
5474 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
5475 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
5476 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
5477 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
5478 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
5479 <li><a href="h_common_save">Save and Export Commands</a>
5480 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
5481 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
5482 <li><a href="h_compose_send">Send Command</a>
5483 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
5484 <li><a href="h_main_setup">Setup Command</a>
5485 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
5486 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
5487 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
5488 <li><a href="h_mainhelp_smime">S/MIME</a>
5489 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
5490 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
5491 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
5492 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
5493 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
5494 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
5495 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
5496 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
5497 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
5498 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
5499 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
5500 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
5501 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
5502 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
5503 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
5504 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
5505 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
5506 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
5507 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
5508 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
5509 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
5510 <li><a href="h_index_cmd_sort">Sort Command</a>
5511 <li><a href="h_compose_spell">Spell Check Command</a>
5512 <li><a href="h_common_suspend">Suspend Command</a>
5513 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
5514 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
5515 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
5516 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
5517 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
5518 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
5519 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
5520 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
5521 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
5522 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
5523 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
5524 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
5525 <li><a href="h_common_take">TakeAddr Command</a>
5526 <li><a href="h_mainhelp_status">Titlebar Line</a>
5527 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
5528 <li><a href="h_config_usenone_color">Use None Color</a>
5529 <li><a href="h_config_usenormal_color">Use Normal Color</a>
5530 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
5531 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
5532 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
5533 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
5534 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
5535 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
5536 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
5537 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
5538 </UL>
5539
5540 <P>
5541 &lt;End of Help Index&gt;
5542 </BODY>
5543 </HTML>
5544
5545
5546 ============== h_config_remote_config =============
5547 <HTML>
5548 <HEAD>
5549 <TITLE>Remote Configuration</TITLE>
5550 </HEAD>
5551 <BODY>
5552 <H1>Remote Configuration</H1>
5553
5554 You may use the command line argument &quot;-p pinerc&quot; to tell
5555 Alpine to use a non-default configuration file.
5556 There are two types of storage for configuration information.
5557 <EM>Local</EM> configuration files are used by default.
5558 These are just regular files on the UNIX system or on the PC.
5559 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
5560 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
5561 <EM>Remote</EM> configuration folders are stored on an IMAP server.
5562 The advantage of using a remote configuration is that the same information
5563 may be accessed from multiple platforms.
5564 For example, if you use one computer at work and another at home, the same
5565 configuration could be used from both places.
5566 A configuration change from one place would be seen in both places.
5567 To use a remote configuration you simply give a
5568 <A HREF="h_valid_folder_names">remote folder name</A>
5569 as the argument to the &quot;-p&quot; command line option.
5570 The command line might look something like:
5571 <P>
5572 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
5573 <P>
5574 If there are special characters in the command shell you use, you may need to
5575 quote the last argument (to protect the curly braces from the shell).
5576 The command might look like:
5577 <P>
5578 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
5579 <P>
5580 You should choose a folder name for a folder that does not yet exist.
5581 It will be created containing an empty configuration.
5582 Do not use a folder that you wish to store regular mail messages in.
5583 <P>
5584 The Setup/RemoteConfigSetup command will help you convert from a local
5585 configuration to a remote configuration.
5586 It will create a remote configuration for you and copy your current local
5587 configuration to it.
5588 It will also help you convert local address books into remote address books
5589 and local signature files into literal signatures contained in the
5590 remote configuration file.
5591 <P>
5592 If the Setup/RemoteConfigSetup command doesn't do what you want, you
5593 may copy a local pinerc file to a remote configuration folder by hand
5594 by using the command line option &quot;-copy_pinerc&quot;.
5595 <P>
5596 Another command line option, which is somewhat related to remote
5597 configuration, is the option &quot;-x exceptions_config&quot;.
5598 The configuration settings in the exceptions configuration override
5599 your default settings.
5600 It may be useful to store the default configuration (the -p argument) remotely
5601 and to have the exceptions configuration stored in a local file.
5602 You might put generic configuration information in the remote configuration
5603 and platform-specific configuration on each platform in the exceptions
5604 configuration.
5605 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
5606 can be either remote folders or local files.
5607 <P>
5608 There is another command line argument that works only with PC-Alpine and
5609 which may prove useful when using a remote configuration.
5610 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
5611 to store your local auxiliary files.
5612 This only has an effect if your configuration file is remote.
5613 Some examples of auxiliary files are debug files, address book files, and
5614 signature files.
5615 <P>
5616 &lt;End of help on this topic&gt;
5617 </BODY>
5618 </HTML>
5619 ============== h_config_exceptions =============
5620 <HTML>
5621 <HEAD>
5622 <TITLE>Generic and Exceptional Configuration</TITLE>
5623 </HEAD>
5624 <BODY>
5625 <H1>Generic and Exceptional Configuration</H1>
5626
5627 If you use Alpine from more than one platform it may be convenient
5628 to split your configuration information into two pieces, a generic piece
5629 and exceptions that apply to a particular platform.
5630 For example, suppose you use Alpine from home and from work.
5631 Most of your configuration settings are probably the
5632 same in both locations, so those settings belong in the generic settings
5633 configuration.
5634 However, you may use a different SMTP server and INBOX
5635 from home than you do from work.
5636 The
5637 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
5638 and
5639 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
5640 options could be
5641 part of your exceptional configuration so that they could be different in the
5642 two places.
5643 <P>
5644 The command line option &quot;-x exceptions_config&quot;
5645 may be used to split your configuration into generic and exceptional pieces.
5646 &quot;Exceptions_config&quot; may be either local or remote.
5647 The regular Alpine configuration file will contain the generic data, and
5648 &quot;exceptions_config&quot; will contain the exceptional data.
5649 <P>
5650 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
5651 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
5652 in the same local directory that the regular config file is located in (usually
5653 the Unix home directory).
5654 If the regular config file is remote (because the command line option
5655 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
5656 directory for &quot;<CODE>.pinercex</CODE>&quot;.
5657 If the file does not already exist then no exceptions will be used.
5658 You can force exceptions to be used by using the &quot;-x&quot; option or
5659 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
5660 <P>
5661 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
5662 PC-Alpine will use the value of the
5663 environment variable <CODE>$PINERCEX</CODE>.
5664 If that is not set, PC-Alpine will look for
5665 the local file &quot;<CODE>PINERCEX</CODE>&quot;
5666 in the same local directory that the regular config file is located in.
5667 If the regular config file is remote (because the command line option
5668 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
5669 local directory specified by the &quot;-aux local_directory&quot; command
5670 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
5671 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
5672 <P>
5673 When you have an exception configuration there is a new command
5674 in the Alpine Setup screen, Setup/eXceptions.
5675 It toggles between exceptions and the regular configuration.
5676 This is the usual way to make changes in your exceptional configuration data.
5677 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
5678 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
5679 for Config or &quot;K&quot; for Kolor.
5680 <P>
5681 For most people, splitting the configuration information into two pieces is
5682 going to be most useful if the generic information is accessed
5683 <A HREF="h_config_remote_config">remotely</A>).
5684 That data will be the same no matter where you access it from and if you
5685 change it that change will show up everywhere.
5686 The exceptional data will most commonly be in a local file, so that the
5687 contents may easily be different on each computing platform used.
5688 <P>
5689 If you already have a local configuration file with settings you like
5690 you may find that the command Setup/RemoteConfigSetup is useful
5691 in helping you convert to a remote configuration.
5692 The command line flag &quot;-copy_pinerc&quot;
5693 may also be useful.
5694 <P>
5695 &lt;End of help on this topic&gt;
5696 </BODY>
5697 </HTML>
5698 ============== h_config_inheritance =============
5699 <HTML>
5700 <HEAD>
5701 <TITLE>Configuration Inheritance</TITLE>
5702 </HEAD>
5703 <BODY>
5704 <H1>Configuration Inheritance</H1>
5705
5706 Configuration inheritance is a power user feature.
5707 It is confusing and not completely supported by the configuration
5708 user interface.
5709 We start with an explanation of how configuration works in hopes of making
5710 it easier to describe how inheritance works.
5711 <P>
5712 Alpine uses a hierarchy of configuration values from different locations.
5713 There are five ways in which each configuration option (configuration
5714 variable) can be set.
5715 In increasing order of precedence they are:
5716 <P>
5717 <OL>
5718 <LI> the system-wide configuration file.
5719
5720 <LI> the personal configuration file
5721
5722 <LI> the personal exceptions file
5723
5724 <LI> a command line argument
5725
5726 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
5727 </OL>
5728 <P>
5729 The fixed configuration file is normally
5730 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
5731 <P>
5732 The system-wide configuration file is normally
5733 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
5734 set for PC-Alpine.
5735 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
5736 is used for the system-wide configuration.
5737 This location can be set or changed on the command line with the -P flag.
5738 The system-wide configuration file can be either a local file or a
5739 remote configuration folder.
5740 <P>
5741 For Unix Alpine, the personal configuration file is normally the file
5742 <CODE>.pinerc</CODE> in the user's home directory.
5743 This can be changed with the -p command line flag.
5744 For PC-Alpine, the personal configuration file is in
5745 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
5746 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
5747 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
5748 This can be changed with the -p command line flag.
5749 If -p is used, the configuration data may be in a local file or a remote config
5750 folder.
5751 <P>
5752 For Unix Alpine, the personal exceptions configuration file is named
5753 <CODE>.pinercex</CODE> and is in the same directory as the personal
5754 configuration file, if that configuration file is not remote, and is in
5755 the home directory if the personal configuration file is remote.
5756 If the file exists, then exceptions are turned on.
5757 If it doesn't, then you are not using exceptions.
5758 Alternatively, you may change the location of the exceptions configuration
5759 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5760 Like the personal configuration data, exceptions_config may be
5761 either local or remote.
5762 <P>
5763 For PC-Alpine, the personal exceptions configuration file is named
5764 <CODE>PINERCEX</CODE> and is in the same directory as the personal
5765 configuration file unless the personal configuration file is remote.
5766 In that case, it is in the local directory specified by the
5767 &quot;-aux local_directory&quot; command line argument.
5768 (In the case that the personal configuration is remote and there is no
5769 &quot;-aux&quot; command line argument, Alpine searches for
5770 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
5771 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
5772 If the file exists, then exceptions are turned on.
5773 If it doesn't, then you are not using exceptions.
5774 You may change the location of the exceptions configuration
5775 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5776 or with the
5777 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
5778 option).
5779 <P>
5780 To reiterate, the value of a configuration option is taken from the
5781 last location in the list above in which it is set.
5782 Or, thinking about it slightly differently, a default value for an option
5783 is established in the system-wide configuration file (or internally by Alpine
5784 if there is no value in the system-wide file).
5785 That default remains in effect until and unless it is overridden by a value in a
5786 location further down the list, in which case a new &quot;default&quot;
5787 value is established.
5788 As we continue down the list of locations we either retain the
5789 value at each step or establish a new value.
5790 The value that is still set after going through the whole list of
5791 configuration locations is the one that is used.
5792 <P>
5793 So, for example, if an option is set in the system-wide configuration
5794 file and in the personal configuration file, but is not set in the
5795 exceptions, on the command line, or in the fixed file; then the value
5796 from the personal configuration file is the one that is used.
5797 Or, if it is set in the system-wide config, in the personal config, not
5798 in the exceptions, but is set on the command line; then the value
5799 on the command line is used.
5800 <P>
5801 Finally we get to inheritance.
5802 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
5803 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
5804 the inheritance mechanism makes it possible to <EM>combine</EM>
5805 the values from different locations instead of <EM>replacing</EM> the value.
5806 This is true of all configuration lists other than the &quot;Feature-List&quot;,
5807 for which you may already set whatever you want at
5808 any configuration location (by using the &quot;no-&quot; prefix if
5809 necessary).
5810 <P>
5811 To use inheritance, set the first item in a configuration list to the
5812 token &quot;INHERIT&quot;, without the quotes.
5813 If the first item is &quot;INHERIT&quot;,
5814 then instead of replacing the default value established so far, the rest of
5815 the list is appended to the default value established so far and that is
5816 the new value.
5817 <P>
5818 Here is an example which may make it clearer. Suppose we have:
5819 <P>
5820 <PRE>
5821  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5822  Personal config    :   smtp-server = INHERIT, mysmtp.home
5823  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
5824  Command line       :   smtp-server = &lt;No Value Set&gt;
5825  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5826 </PRE>
5827 <P>
5828
5829 This would result in an effective smtp-server option of
5830 <P>
5831 <PRE>
5832  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
5833 </PRE>
5834 <P>
5835 The &quot;INHERIT&quot; token can be used in any of the configuration files
5836 and the effect cascades.
5837 For example, if we change the above example to:
5838 <P>
5839 <PRE>
5840  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5841  Personal config    :   smtp-server = INHERIT, mysmtp.home
5842  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5843  Command line       :   smtp-server = &lt;No Value Set&gt;
5844  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5845 </PRE>
5846 <P>
5847
5848 This would result in:
5849 <P>
5850 <PRE>
5851  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
5852 </PRE>
5853 <P>
5854 Unset variables are skipped over (the default value is carried forward) so
5855 that, for example:
5856 <P>
5857 <PRE>
5858  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5859  Personal config    :   smtp-server = &lt;No Value Set&gt;
5860  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5861  Command line       :   smtp-server = &lt;No Value Set&gt;
5862  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5863 </PRE>
5864 <P>
5865
5866 produces:
5867 <P>
5868 <PRE>
5869  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
5870 </PRE>
5871 <P>
5872
5873 If any later configuration location has a value set (for a particular list
5874 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
5875 then that value replaces whatever value has been defined up to that point.
5876 In other words, that cancels out any previous inheritance.
5877 <P>
5878 <PRE>
5879  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5880  Personal config    :   smtp-server = INHERIT, mysmtp.org
5881  Exceptions config  :   smtp-server = yoursmtp.org
5882  Command line       :   smtp-server = &lt;No Value Set&gt;
5883  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5884 </PRE>
5885 <P>
5886
5887 results in:
5888 <P>
5889 <PRE>
5890  smtp-server = yoursmtp.org
5891 </PRE>
5892 <P>
5893
5894 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
5895 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
5896 difficult to insert the value &quot;INHERIT&quot; into the list of values
5897 for the option using the normal Setup tools.
5898 In other words, the color setting screen (for example) does not
5899 provide a way to input the text &quot;INHERIT&quot; as the first
5900 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
5901 The way to do this is to either edit the pinerc file directly and manually
5902 insert it, or turn
5903 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
5904 feature and insert it using the Setup/Config screen.
5905 <P>
5906 &lt;End of help on this topic&gt;
5907 </BODY>
5908 </HTML>
5909 ============== h_special_xon_xoff =============
5910 <HTML>
5911 <HEAD>
5912 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
5913 </HEAD>
5914 <BODY>
5915 <H1>XOFF/XON Handling within Alpine</H1>
5916
5917 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
5918 and XON) as normal characters, even though Alpine does not use them.
5919 However, the printer, modem, or communication software you are using may
5920 be configured for &quot;software flow control,&quot; which means that
5921 XON/XOFF must be treated as special characters by the operating system.
5922 If you see messages such as &quot;^S not defined for this screen&quot;,
5923 then your system is probably using software flow control. In this case
5924 you will need to set the
5925 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
5926 feature.
5927 <P>
5928 If you <EM>do</EM> set this
5929 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
5930 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
5931 and see if that puts things right.  Printing via the
5932 &quot;attached-to-ansi&quot; or
5933 &quot;attached-to-wyse&quot;
5934 option will automatically enable software
5935 flow-control handling for the duration of the printing.
5936 <P>
5937 &lt;End of help on this topic&gt;
5938 </BODY>
5939 </HTML>
5940 ============= h_special_help_nav =============
5941 <HTML>
5942 <HEAD>
5943 <TITLE>Help Text Navigation Explained</TITLE>
5944 </HEAD>
5945 <BODY>
5946 <H1>Help Text Navigation Explained</H1>
5947
5948 Alpine contains extensive context-sensitive help text.   At any point,
5949 pressing the &quot;?&quot; key will bring up a page of help text
5950 explaining the options available to you.  You can leave the help
5951 text screen and return to normal Alpine operation by pressing
5952 the
5953 <!--chtml if pinemode="function_key"-->
5954 F3 function
5955 <!--chtml else-->
5956 &quot;E&quot;
5957 <!--chtml endif-->
5958 key to Exit Help at any time.
5959
5960 <P>
5961 Within the help screen you might find a word or phrase displayed in
5962 inverse text and others displayed in bold typeface.  Such words and
5963 phrases are used to tell you Alpine has more information available on
5964 the topic they describe.
5965 The inverted text is the &quot;selected&quot; topic.
5966 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
5967 displayed in bold type
5968 is &quot;selected&quot;.
5969 Hit the Return key to display the information Alpine has available on that
5970 topic.  While viewing such additional information, the
5971 <!--chtml if pinemode="function_key"-->
5972 F3 function
5973 <!--chtml else-->
5974 &quot;P&quot;
5975 <!--chtml endif-->
5976 key will return you to the previous help screen, and the
5977 <!--chtml if pinemode="function_key"-->
5978 F2 function
5979 <!--chtml else-->
5980 &quot;E&quot;
5981 <!--chtml endif-->
5982 key will Exit the Help system altogether.
5983
5984 <P>
5985 The "N" command will tell you the internal name of the help text you are
5986 reading each time, so that you can send this name in the text of a message
5987 and create a direct link to that internal help using the x-pine-help URL
5988 scheme. For example, the direct link to this item is
5989 x-pine-help:h_special_help_nav. If you add this text to a message, then
5990 a person using Pine to read such message would have a direct link to this
5991 help text.
5992
5993 <P>
5994 When you are finished reading this help text, you can press the
5995 <!--chtml if pinemode="function_key"-->
5996 F3 function
5997 <!--chtml else-->
5998 &quot;P&quot;
5999 <!--chtml endif-->
6000 key to return to the previously displayed help text.
6001
6002 <P>
6003 &lt;End of help on this topic&gt;
6004 </BODY>
6005 </HTML>
6006 ============= h_special_list_commands =============
6007 <HTML>
6008 <HEAD>
6009 <TITLE>Email List Commands Explained</TITLE>
6010 </HEAD>
6011 <BODY>
6012 <H1>Email List Commands Explained</H1>
6013
6014 Electonic mail lists provide a way for like-minded users to join in
6015 discussions on topics of interest.  The email list itself is
6016 represented by a
6017 single address that participants send messages to when they have
6018 something of interest to share with other members of the list.  The
6019 receiving computer then, either automatically or after review by the
6020 list's owner (or moderator), sends a copy of that message to each
6021 member of the list.
6022
6023 <P>
6024 Usually, subscribing and unsubscribing is done by sending requests in
6025 an email message to a special address setup to handle managing list
6026 membership.  Often this is the name of the list followed by
6027 <I>-request</I>.  This address is almost <EM>never</EM> the same as
6028 the address used to send messages to the list.
6029
6030 <P>
6031 Unfortunately, email list participation commands are more a matter
6032 of convention than standard, and thus may vary from list to list.
6033 Increasingly, list management software is adding information to
6034 the copy of the postings as they're copied to the list members that
6035 explains how to do the various list management functions.
6036
6037 <P>
6038 Alpine will recognize this information and offer the management commands
6039 they represent in a simple display. One or more of the following
6040 operations will be made available:
6041
6042 <DL>
6043 <DT>Help</DT>
6044 <DD>
6045 A method to get help on subscribing, unsubscribing,
6046 an explanation of what the list is about, or special instructions
6047 for participation.  This may be in the form of a reply in response
6048 to an email message, or instructions on how to connect to a Web site.
6049 </DD>
6050
6051 <DT>Unsubscribe</DT>
6052 <DD>
6053 A method to get your email addressed removed from the list of
6054 recipients of the email list.
6055 </DD>
6056
6057 <DT>Subscribe</DT>
6058 <DD>
6059 A method to get your email address added to the list of recipients
6060 of the email list.  It may be in the form of a message sent to
6061 a special address or you may be connected to a web site.
6062 <DD>
6063 </DD>
6064
6065 <DT>Post</DT>
6066 <DD>
6067 A method used to post to the email list.  However, it might also
6068 indicate that no posting is allowed directly to the list.
6069 </DD>
6070
6071 <DT>Owner</DT>
6072 <DD>
6073 A method to contact the list owner for special questions you might
6074 have regarding the list.
6075 </DD>
6076
6077 <DT>Archive</DT>
6078 <DD>
6079 A method to view an archive of previous messages posted to the list.
6080 This may be in the form of a mail folder on a remote computer, an
6081 IMAP mailbox or even a Web site.
6082 </DD>
6083 </DL>
6084
6085 <P>
6086 &lt;End of help on this topic&gt;
6087 </BODY>
6088 </HTML>
6089 ============= h_quota_command =============
6090 <HTML>
6091 <HEAD>
6092 <TITLE>Quota Screen Explained</TITLE>
6093 </HEAD>
6094 <BODY>
6095 <H1>Quota Screen Explained</H1>
6096
6097 <P> This screen summarizes the quota report for this mailbox in the
6098 IMAP server. For each resource that you have a quota, this reports summarizes
6099 its use and limit.
6100
6101 <P> Your IMAP server administrator may have set a quota based either on
6102 the total size of your mailbox (STORAGE), or the number of messages in
6103 your mailbox (MESSAGES), or some other criteria. This will be reported
6104 to you indicating the type of quota, its total use and its limit.
6105
6106 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
6107 1024 bytes. Each of the characters that you see in this help text is one
6108 byte, and this help text is about 1 kibibyte in size. Small messages sent
6109 by Alpine are normally less than 4 kibibytes in size (which includes
6110 headers and text). Other email programs may send messages with bigger
6111 sizes when they send messages, since they send plain text and an
6112 alternative part in HTML.
6113
6114 <P> A convenient way to save space for the STORAGE type of quota is by
6115 deleting attachments. This is done on each individual message by pressing
6116 the &quot;V&quot; command while reading the message text, then moving the cursor
6117 to the position of the attachment that is to be deleted, then pressing
6118 &quot;D&quot; to delete such attachment, going back to reading the
6119 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
6120 save the message in the same folder you are reading from. The saved
6121 message will not have the attachment that was marked deleted. Now you
6122 can delete and expunge the message with the unwanted attachment.
6123
6124 <P>
6125 &lt;End of help on this topic&gt;
6126 </BODY>
6127 </HTML>
6128 ============= h_mail_thread_index =============
6129 <HTML>
6130 <HEAD>
6131 <TITLE>THREAD INDEX COMMANDS</TITLE>
6132 </HEAD>
6133 <BODY>
6134 <H1>THREAD INDEX COMMANDS</H1>
6135 <!--chtml if pinemode="function_key"-->
6136 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>
6137 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
6138 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>
6139 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>
6140 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>
6141 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>
6142 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>
6143 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>
6144 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>
6145 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>
6146 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>
6147 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>
6148 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>
6149 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>
6150 <BR>
6151 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
6152 -----------------------------<BR>
6153 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>
6154 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>
6155 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>
6156 <BR>
6157 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
6158 -----------------------------<BR>
6159 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
6160 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
6161 <BR>
6162 <!--chtml else-->
6163 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>
6164 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
6165 &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>
6166 &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>
6167 &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>
6168 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>
6169 &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>
6170 &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>
6171 &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>
6172 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>
6173 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
6174 <BR>
6175 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
6176 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
6177 &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>
6178 &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>
6179 &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>
6180 &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>
6181 &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>
6182 &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>
6183 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
6184 <!--chtml endif-->
6185 <P>
6186
6187 NOTE:
6188 <OL>
6189  <LI>For help on a particular command, highlight the bold text associated
6190 with it above and hit Return.
6191  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
6192 </OL>
6193
6194 <H2>Description of the THREAD INDEX Screen</H2>
6195
6196 The THREAD INDEX displays summary information from each
6197 thread (conversation) in the current folder.
6198 This is useful if you want to quickly
6199 scan new threads, or find a particular thread without having to go
6200 through the text of each message, or to quickly get rid of junk
6201 threads, etc.
6202 The current thread is always highlighted.
6203 Each line of the THREAD INDEX contains the following columns: <P>
6204 <DL>
6205  <DT>STATUS:</DT>
6206  <DD> The markings on the left side of the thread tell you about its
6207 status.  You may see one or more of the following codes on any given
6208 thread:
6209 <UL>
6210   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
6211   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
6212   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
6213   <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.
6214   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
6215         message in the thread was sent to you as a cc:. This symbol will only show up if
6216         the feature
6217         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
6218   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
6219         &quot;select&quot; command.  (Some systems may optionally allow selected
6220         messages to be denoted by the index line being displayed in bold
6221         type instead.)
6222   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
6223       to mark at least one message in this thread as &quot;important&quot;.
6224 </UL></DD><P>
6225
6226  <DT>THREAD NUMBER:</DT>
6227  <DD>Threads in a folder are numbered, from one through the number
6228 of threads in the folder, to help you know where you are in the folder.
6229 </DD><P>
6230
6231  <DT>DATE STARTED:</DT>
6232  <DD>The date the thread was started. This is actually from the Date header
6233 of the first message in the thread. It doesn't take different time zones
6234 into account.</DD><P>
6235
6236  <DT>WHO STARTED THE THREAD:</DT>
6237  <DD>This is usually the name of the sender of the first message in the thread, taken from
6238 the From header of the message.
6239 If there is no personal name given in that
6240 address, then the email address is used instead.
6241 If the message is from you (or from one of your
6242 <A HREF="h_config_alt_addresses">alternate addresses</A>),
6243 then the recipient's name is shown here instead, with the characters
6244 &quot;To: &quot; inserted before the name.
6245 (The idea of this is that if you started the thread you would rather see who
6246 the mail was sent to instead of that the mail was from you.)
6247 In Newsgroups, if you are
6248 the sender and there are no email recipients, the newsgroup name will be
6249 listed after the &quot;To: &quot;.
6250 </DD><P>
6251
6252  <DT>SIZE:</DT>
6253  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
6254
6255  <DT>SUBJECT:</DT>
6256  <DD>As much of the thread's subject line as will fit on the screen.
6257 This is the subject of the first message in the thread.</DD>
6258 </DL>
6259
6260 <P><UL>
6261 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6262 </UL>
6263 <P>
6264 &lt;End of help on this topic&gt;
6265 </BODY>
6266 </HTML>
6267 ============= h_mail_index =============
6268 <HTML>
6269 <HEAD>
6270 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
6271 </HEAD>
6272 <BODY>
6273 <H1>MESSAGE INDEX COMMANDS</H1>
6274 <!--chtml if pinemode="function_key"-->
6275 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>
6276 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
6277 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>
6278 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>
6279 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>
6280 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>
6281 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>
6282 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>
6283 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>
6284 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>
6285 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>
6286 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>
6287 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>
6288 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>
6289 <BR>
6290 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
6291 -----------------------------<BR>
6292 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>
6293 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>
6294 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>
6295 <BR>
6296 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
6297 -----------------------------<BR>
6298 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
6299 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>
6300 <BR>
6301 <!--chtml else-->
6302 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>
6303 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
6304 &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>
6305 &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>
6306 &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>
6307 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>
6308 &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>
6309 &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>
6310 &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>
6311 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>
6312 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
6313 Miscellaneous&nbsp;Operations<BR>
6314 ------------------------<BR>
6315 &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>
6316 &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>
6317 &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>
6318 &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>
6319 &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>
6320 &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>
6321 &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>
6322 &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>
6323 <!--chtml endif-->
6324 <P>
6325
6326 NOTE:
6327 <OL>
6328  <LI>For help on a particular command, highlight the bold text associated
6329 with it above and hit Return.
6330  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
6331 </OL>
6332
6333 <H2>Description of the MESSAGE INDEX Screen</H2>
6334
6335 The MESSAGE INDEX displays summary information from each
6336 message in the current folder.
6337 This is useful if you want to quickly
6338 scan new messages, or find a particular message without having to go
6339 through the text of each message, or to quickly get rid of junk
6340 messages, etc.
6341 <P>
6342 The current message is always highlighted
6343 and many commands operate on the current message.
6344 For example, the Delete command will delete the current message.
6345 If the folder is sorted by either Threads or OrderedSubject, then, depending
6346 on some of your configuration settings, a single line in the index may
6347 refer to an entire thread or to a subthread.
6348 If that is the case, then the commands that normally operate on the current
6349 message will operate on the thread or subthread instead.
6350 For example, the Delete command will delete the whole collapsed thread
6351 instead of just a single message.
6352 <P>
6353 Each line of the MESSAGE INDEX contains the following columns (by default --
6354 you can change this with the
6355 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
6356 in the SETUP CONFIGURATION screen): <P>
6357 <DL>
6358  <DT>STATUS:</DT>
6359  <DD> The markings on the left side of the message tell you about its
6360 status.  You may see one or more of the following codes on any given
6361 message:
6362 <UL>
6363   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
6364          yet eXpunged the folder.
6365   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
6366   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
6367          to be answered.
6368   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
6369          forward a message.
6370   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
6371         directly to your account, your copy is not part of a cc: or a
6372         mailing list.
6373   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
6374         message was sent to you as a cc:. This symbol will only show up if
6375         the feature
6376         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
6377   <LI> &quot;X&quot; for selected.  You have selected the message by using the
6378         &quot;select&quot; command.  (Some systems may optionally allow selected
6379         messages to be denoted by the index line being displayed in bold
6380         type.)
6381   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
6382       to mark this message as &quot;important&quot;.
6383 </UL></DD><P>
6384
6385  <DT>MESSAGE NUMBER:</DT>
6386  <DD>Messages in a folder are numbered, from one through the number
6387 of messages in the folder, to help you know where you are in the folder.
6388 These numbers are always in increasing order, even if you sort the folder
6389 in a different way.</DD><P>
6390
6391  <DT>DATE SENT:</DT>
6392  <DD>The date the message was sent.  By default, messages are
6393 ordered by arrival time, not by date sent.  Most of the time, arrival time
6394 and date sent (effectively departure time) are similar.  Sometimes,
6395 however, the index will appear to be out of order because a message took a
6396 long time in delivery or because the sender is in a different time
6397 zone than you are. This date is just the date from the Date header
6398 field in the message.</DD><P>
6399
6400  <DT>WHO SENT THE MESSAGE:</DT>
6401  <DD>This is usually the name of the sender of the message, taken from
6402 the From header of the message.
6403 If there is no personal name given in that
6404 address, then the email address is used instead.
6405 If the message is from you (or from one of your
6406 <A HREF="h_config_alt_addresses">alternate addresses</A>),
6407 then the recipient's name is shown here instead, with the characters
6408 &quot;To: &quot; inserted before the name.
6409 (The idea of this is that if you sent the mail you would rather see who
6410 the mail was sent to instead of that the mail was from you.
6411 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
6412 above.
6413 In particular, use the FROM token or the FROMORTONOTNEWS token
6414 in place of the FROMORTO token.)
6415 In Newsgroups, if you are
6416 the sender and there are no email recipients, the newsgroup name will be
6417 listed after the &quot;To: &quot;. </DD><P>
6418
6419  <DT>SIZE:</DT>
6420  <DD>The number in parentheses is the number of characters in the message.
6421 It may have a suffix of K, M, or G which means the number should be
6422 multiplied by one thousand, one million, or one billion to get the
6423 size of the message.</DD><P>
6424
6425  <DT>SUBJECT:</DT>
6426  <DD>As much of the message's subject line as will fit on the screen.</DD>
6427 </DL>
6428
6429 <P><UL>
6430 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6431 </UL>
6432 <P>
6433 &lt;End of help on this topic&gt;
6434 </BODY>
6435 </HTML>
6436 ============= h_mail_view ========================
6437 <HTML>
6438 <HEAD>
6439 <TITLE>MESSAGE TEXT SCREEN</TITLE>
6440 </HEAD>
6441 <BODY>
6442 <H1>MESSAGE TEXT SCREEN</H1>
6443 <!--chtml if pinemode="function_key"-->
6444 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>
6445 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
6446 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>
6447 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>
6448 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>
6449 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>
6450 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>
6451 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>
6452 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>
6453 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>
6454 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>
6455 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>
6456 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>
6457 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>
6458 <BR>
6459 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
6460 ------------------------------<BR>
6461 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
6462 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
6463 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
6464 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
6465 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
6466 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
6467 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
6468 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
6469 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
6470 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
6471 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
6472 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
6473 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
6474 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
6475 <!--chtml else-->
6476 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
6477 ---------------------------------<BR>
6478 <BR>
6479 &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>
6480 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>
6481 &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>
6482 &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>
6483 &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>
6484 &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>
6485 &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>
6486 &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>
6487 &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>
6488 <BR>
6489 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
6490 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
6491 &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>
6492 &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>
6493 &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>
6494 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>
6495 <BR>
6496 General&nbsp;Alpine&nbsp;Commands<BR>
6497 ---------------------<BR>
6498 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
6499 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
6500 &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>
6501 &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>
6502 &nbsp;&nbsp;&nbsp;&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>
6503 <!--chtml endif-->
6504 <P>
6505
6506 NOTE:
6507 <OL>
6508  <LI>For help on a particular command, highlight the bold text associated
6509 with it above and hit Return.
6510  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
6511 </OL>
6512
6513 <H2>Description of the MESSAGE TEXT Screen</H2>
6514
6515 The top line of the view message screen displays status
6516 information about the currently open collection and folder and about the
6517 current message.  It shows the name of the collection in angle brackets
6518 and then the name of the folder.  The line also displays the number
6519 of messages in the folder, the number of the current message and the
6520 percentage of the current message that has been displayed on the screen.
6521 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
6522 right corner.
6523 If the message has been answered (but not deleted) &quot;ANS&quot; will show
6524 in the corner.
6525 <P>
6526
6527 NOTE: to rapidly move to the end of a message, hit the
6528 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6529 (or Ctrl-W) key followed
6530 by Ctrl-V.  Similarly,
6531 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6532 followed by Ctrl-Y will take you to the beginning of
6533 a message.
6534
6535 <H2>Explanation of Alternate Character Sets</H2>
6536
6537 Alpine attempts to stay out of the way so that it won't prevent you from
6538 viewing mail in any character set.  It will simply send the message to
6539 your display device.  If the device is capable of displaying the
6540 message as it was written it will do so.  If not, the display may be
6541 partially or totally incorrect.
6542 If the message contains characters that are not representable in your
6543 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
6544 variable in your configuration, then a warning message will be printed
6545 to your screen at the beginning of the message display.
6546 It is probably best to use UNIX Alpine in a terminal emulator
6547 capable of displaying UTF-8 characters.
6548 See <A HREF="h_config_char_set">Display Character Set</A> for a little
6549 more information about character set settings.
6550
6551 <P><UL>
6552 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6553 </UL>
6554 <P>
6555 &lt;End of help on this topic&gt;
6556 </BODY>
6557 </HTML>
6558 ======= h_index_cmd_select =======
6559 <HTML>
6560 <HEAD>
6561 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
6562 </HEAD>
6563 <BODY>
6564 <H1>Selecting: Select and WhereIs/Select</H1>
6565
6566 Aggregate operations give you the ability to process a group of messages
6567 at once.  Acting on multiple messages requires two steps: (1) selecting a
6568 set of messages and then; (2) applying a command to that set. The first
6569 part is handled by the select command.  Select allows you to
6570 select messages based on their status (read, answered, etc.), contents,
6571 date, size, or keywords.
6572 You may also select based on one of your Rules or based on threads,
6573 and there are quick options to select a specific message or range of messages,
6574 to select the current message, or to select all messages.
6575 <P>
6576
6577 We describe the various selection criteria briefly:
6578 <P>
6579
6580 <DL>
6581 <DT>select All</DT>
6582 <DD> Marks all the messages in the folder as selected.
6583 </DD>
6584
6585 <DT>select Cur</DT>
6586 <DD> Selects the currently highlighted message or currently highlighted
6587 set of messages if in a threaded view.
6588 </DD>
6589
6590 <DT>select by Number</DT>
6591 <DD> Select by message number. This may be a comma-separated list instead or
6592 a single entry.
6593 Each element in the list may be either a single message number or a range
6594 of numbers with a dash between the lowest and highest member of the range.
6595 Some examples are 7 to select only message number 7; 2-5 to select messages
6596 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
6597 The word &quot;end&quot; or the character &quot;$&quot; may be used as a
6598 substitute for the highest numbered message in the folder, while the
6599 character &quot;.&quot; represents the message number holding the position
6600 of the cursor in the folder.
6601 If in a separate thread index where the numbers refer to threads instead of
6602 to messages, then you will be selecting all of the messages in the
6603 referenced threads instead of selecting by message number.
6604 </DD>
6605
6606 <DT>select by Date</DT>
6607 <DD> Select by either the date stored in the Date headers of each message,
6608 or by the date when the messages arrived.
6609 This does not adjust for different time zones, but just checks to see what
6610 day the message was sent on.
6611 You may type in a date. If you do, the date should be in the form
6612 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
6613 For example,
6614 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
6615 or
6616 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
6617 If the date you want is close to the current date, it is probably
6618 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
6619 is displayed, instead of typing in the date yourself.
6620 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
6621 the date of the currently highlighted message.
6622 <P>
6623 There are six possible settings that are selected using the
6624 &quot;^W&nbsp;Toggle When&quot; command.
6625 Three of them select messages based on the Date headers.
6626 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
6627 and &quot;SENT ON&quot;.
6628 SINCE is all messages with the selected date or later.
6629 BEFORE is all messages earlier than the selected date (not including the day
6630 itself).
6631 ON is all messages sent on the selected date.
6632 The other three select messages in the same way but they use the arrival
6633 times of the messages instead of the Date headers included in the messages.
6634 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
6635 and &quot;ARRIVED ON&quot;.
6636 When you save a message from one folder to another the arrival time is
6637 preserved.
6638 </DD>
6639
6640 <DT>select by Text</DT>
6641 <DD> Selects messages based on the message contents.
6642 This allows you to select a set of messages based on whether or not the
6643 message headers or message body contain specified text.
6644 You may look for text in the Subject, the From header,
6645 the To header, or the Cc header.
6646 You may also choose Recipient, which searches for the text in
6647 either the To or the Cc header;
6648 or Participant, which means To or Cc or From.
6649 Besides those specific header searches, you may also search the entire
6650 header and text of the message with &quot;All Text&quot;, or just the
6651 body of the message.
6652 <P>
6653 To search for the absence of text, first type the &quot;! Not&quot; command
6654 before typing the specific type of text search.
6655 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6656 search for all messages that do not contain a particular word in their
6657 Subjects.
6658 <P>
6659 If you choose a Subject search, you may use the subject from the current
6660 message by typing the &quot;^X Cur Subject&quot; command.
6661 You may then edit it further if you wish.
6662 For example, you might select the subject of a reply and edit the
6663 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6664 the original message being replied to.
6665 All of the other header searches allow you to use addresses from the
6666 headers of the current message if you want to.
6667 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6668 &quot;^W Cur Cc&quot;.
6669 In each case, if there is more than one address, only the first is offered.
6670 </DD>
6671
6672 <DT>select by Status</DT>
6673 <DD> Selects messages based on their status.
6674 You may select all New, Important, Deleted, Answered, Recent, or Unseen
6675 messages.
6676 Or, if you first type the &quot;! Not&quot; command, you get not New,
6677 or not Important, and so on.
6678 If you select Deleted messages, you will get all messages with their
6679 Deleted flag set.
6680 Likewise for Important messages, all messages that you have flagged as
6681 being Important with the
6682 <A HREF="h_common_flag">Flag</A> command.
6683 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6684 because they try to match what you see on the screen by default.
6685 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6686 and Unanswered.
6687 If you have looked at the message, or deleted it, or answered it; then it
6688 is not considered &quot;New &quot;.
6689 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6690 <P>
6691 &quot;Answered&quot; is another one that is a little different.
6692 It means that the message has been Answered <EM>and</EM> is not deleted.
6693 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6694 the opposite of &quot;Answered&quot;!
6695 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6696 both Unanswered <EM>and</EM> not deleted.
6697 <P>
6698 The other two types were added later because the special nature of the
6699 New flag was not what was wanted by all users.
6700 New does match what you see in the index by default, but if you use
6701 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6702 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6703 be exactly what you want.
6704 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6705 they are deleted or answered, and
6706 &quot;Recent&quot; selects all of the messages that have been added to
6707 the folder since you started this Alpine session.
6708 (That's not technically quite true. If there are multiple mail clients
6709 reading an IMAP mailbox, each message will be marked as Recent in only
6710 one of the client's sessions.)
6711 </DD>
6712
6713 <DT>select by siZe</DT>
6714 <DD> Selects messages based on their size being smaller than or larger
6715 than the size you specify.
6716 The size is the number of bytes.
6717 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
6718 the number.
6719 For example, 7K is the same as 7000.
6720 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
6721 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
6722 Use the &quot;^W&quot; command to toggle back and forth between Smaller
6723 and Larger.
6724 </DD>
6725
6726 <DT>select by Keyword</DT>
6727 <DD> Selects messages that either have or do not have
6728 (using the &quot;!&nbsp;Not&quot; command)
6729 a particular <A HREF="h_config_keywords">Keyword</A> set.
6730 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
6731 command to select one from your list of keywords.
6732 The
6733 <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.
6734 </DD>
6735
6736 <DT>select by Rule</DT>
6737 <DD> Selects messages that either match or don't match
6738 (using the &quot;!&nbsp;Not&quot; command)
6739 one of the Rules you have defined.
6740 The most likely method of filling in the Rule is to use the
6741 &quot;^T&nbsp;To&nbsp;List&quot;
6742 command to select one of your Rules.
6743 All of the Rules you have defined will be in the list, including
6744 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
6745 They may not all make sense for this purpose, but they are all there for
6746 flexibility.
6747 You might find it useful to define some rules solely for the purpose
6748 of being used by the Select command.
6749 There is a special category for such Rules. They are called Search Rules.
6750 <P>
6751 Unfortunately, Alpine does not allow all possible Rules to be defined.
6752 For example, there is no logical OR operation.
6753 OR is accomplished in the Filter Rules or the other types of Rules by
6754 simply defining two rules, one that matches the first part of the OR
6755 and another that matches the second part.
6756 But you can't do that here, since you only have a single Rule to work with.
6757 Likewise, the order of Rules is usually important.
6758 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6759 a message, then that stops the search for a further match.
6760 This means that you may be confused if you try to use Select by Rule to
6761 check your Filter rules because the order is important when filtering but
6762 is not considered here.
6763 </DD>
6764
6765 <DT>select by tHread</DT>
6766 <DD> Selects all of the messages in the current thread.
6767 </DD>
6768 </DL>
6769
6770 After you have an initial selection, the next and subsequent selection
6771 commands modify the selection.
6772 The select command changes. It first gives
6773 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
6774 &quot;unselect Current&quot;,
6775 &quot;Broaden selection&quot; (implements a logical OR), and
6776 &quot;Narrow selection&quot; (implements a logical AND).
6777 After you choose either Broaden or Narrow, you then choose one of the
6778 selection criteria listed above (by Text or Number or ...).
6779 You may use select as many times as you wish to get the selected set right.
6780 <P>
6781
6782 The WhereIs command has a feature (Ctrl-X) to
6783 select all the messages that match the WhereIs search. WhereIs searches
6784 through just the text that appears on the MESSAGE INDEX screen.
6785 This method is often slower than using the select command itself, unless the
6786 line you are looking for is not too far away in the index.
6787 <P>
6788
6789 The availability of the aggregate operations commands is determined by the
6790 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6791 Feature-List option in your Alpine
6792 configuration, which defaults to set.
6793 The features
6794 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
6795 and
6796 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
6797 affect the behavior of the Select command.
6798
6799 <P>
6800 &lt;End of help on this topic&gt;
6801 </BODY>
6802 </HTML>
6803 ======= h_select_rule =======
6804 <HTML>
6805 <HEAD>
6806 <TITLE>Select: Rule</TITLE>
6807 </HEAD>
6808 <BODY>
6809 <H1>Select: Rule</H1>
6810
6811 You are selecting messages that either match or don't match
6812 one of the Rules you have defined.
6813 You may either type the nickname of the Rule at the prompt, or use the
6814 &quot;^T&nbsp;To&nbsp;List&quot;
6815 command to select one of your Rules.
6816 All of the Rules you have defined will be in the list, including
6817 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
6818 They may not all make sense for this purpose, but they are all there for
6819 flexibility.
6820 Rules may be added by using the Setup/Rules screen off of the main Alpine
6821 menu.
6822 <P>
6823 Unfortunately, Alpine does not allow all possible Rules to be defined.
6824 For example, there is no logical OR operation.
6825 OR is accomplished in the Filter Rules or the other types of Rules by
6826 simply defining two rules, one that matches the first part of the OR
6827 and another that matches the second part.
6828 But you can't do that here, since you only have a single Rule to work with.
6829 Likewise, the order of Rules is usually important.
6830 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6831 a message, then that stops the search for a further match.
6832 This means that you may be confused if you try to use Select by Rule to
6833 check your Filter rules because the order is important when filtering but
6834 is not considered here.
6835
6836 <P>
6837 &lt;End of help on this topic&gt;
6838 </BODY>
6839 </HTML>
6840 ======= h_select_text =======
6841 <HTML>
6842 <HEAD>
6843 <TITLE>Select: Text</TITLE>
6844 </HEAD>
6845 <BODY>
6846 <H1>Select: Text</H1>
6847
6848 You are selecting messages based on the contents of the message.
6849 This allows you to select a set of messages based on whether or not the
6850 message headers or message body contain specified text.
6851 You may look for text in the Subject, the From header,
6852 the To header, or the Cc header.
6853 You may also choose Recipient, which searches for the text in
6854 either the To or the Cc header;
6855 or Participant, which means either the To header, or the Cc header,
6856 or the From header.
6857 Besides those specific header searches, you may also search the entire
6858 header and text of the message with &quot;All Text&quot;, or just the
6859 body of the message with &quot;Body&quot;.
6860 <P>
6861 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
6862 before typing the specific type of text search.
6863 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6864 search for all messages that do not contain a particular word in their
6865 Subjects.
6866 <P>
6867 If you choose a Subject search, you may use the subject from the current
6868 message by typing the &quot;^X Cur Subject&quot; command.
6869 You may then edit it further if you wish.
6870 For example, you might select the subject of a reply and edit the
6871 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6872 the original message being replied to.
6873 All of the other header searches allow you to use addresses from the
6874 headers of the current message if you want to.
6875 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6876 &quot;^W Cur Cc&quot;.
6877 In each case, if there is more than one address, only the first is offered.
6878
6879 <P>
6880 &lt;End of help on this topic&gt;
6881 </BODY>
6882 </HTML>
6883 ======= h_select_status =======
6884 <HTML>
6885 <HEAD>
6886 <TITLE>Select: Status</TITLE>
6887 </HEAD>
6888 <BODY>
6889 <H1>Select: Status</H1>
6890
6891 You are selecting messages based on the status of the message.
6892 For example, whether or not the message has been marked Deleted or Important,
6893 or whether or not it has been Answered or is New.
6894 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
6895 opposite: not Deleted, not Important, and so on.
6896 <P>
6897 If you select Deleted messages, you will get all messages with their
6898 Deleted flag set.
6899 Likewise for Important messages, all messages that you have flagged as
6900 being Important with the
6901 <A HREF="h_common_flag">Flag</A> command.
6902 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6903 because they try to match what you see on the screen by default.
6904 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6905 and Unanswered.
6906 If you have looked at the message, or deleted it, or answered it; then it
6907 is not considered &quot;New &quot;.
6908 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6909 <P>
6910 &quot;Answered&quot; is another one that is a little different.
6911 It means that the message has been Answered <EM>and</EM> is not deleted.
6912 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6913 the opposite of &quot;Answered&quot;!
6914 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6915 both Unanswered <EM>and</EM> not deleted.
6916 <P>
6917 (The New and Answered options may seem counter-intuitive.
6918 The reason it is done this way is
6919 because, by default, a Deleted message will show up with the &quot;D&quot;
6920 symbol in the MAIL INDEX screen even if it is New or Answered.
6921 The Delete symbol overrides the New and Answered symbols, because you
6922 usually don't care about the message anymore once you've deleted it.
6923 Similarly, you usually only care about whether a message is Answered or
6924 not if it is not Deleted.
6925 Once it is Deleted you've put it out of your mind.)
6926 <P>
6927 The other two options were added later because the special nature of the
6928 New flag was not what was wanted by all users.
6929 New does match what you see in the index by default, but if you use
6930 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6931 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6932 be exactly what you expect.
6933 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6934 they are deleted or answered, and
6935 &quot;Recent&quot; selects all of the messages that have been added to
6936 the folder since you started this Alpine session.
6937 (That's not technically quite true. If there are multiple mail clients
6938 reading an IMAP mailbox, each message will be marked as Recent in only
6939 one of the client's sessions.
6940 That behavior can be convenienent for some purposes, like filtering, but
6941 it isn't usually what you expect when selecting.)
6942
6943 <P>
6944 &lt;End of help on this topic&gt;
6945 </BODY>
6946 </HTML>
6947 ======= h_index_cmd_apply =======
6948 <HTML>
6949 <HEAD>
6950 <TITLE>Apply Command</TITLE>
6951 </HEAD>
6952 <BODY>
6953 <H1>Apply Command</H1>
6954
6955 Apply
6956 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
6957 is the second step of most aggregate operations.  Apply
6958 becomes active any time there is a defined set of selected messages.  The
6959 following commands can be applied to a selected message set: delete,
6960 undelete, reply, forward,
6961 <!--chtml if pinemode="os_windows"-->
6962 <!--chtml else-->
6963 pipe,
6964 <!--chtml endif-->
6965 print, take address, save, export, bounce, and flag.
6966 <P>
6967
6968 The behavior of some of these commands in an aggregate sense is not easy to
6969 explain.  Try them out to see what they do.
6970 The feature
6971 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
6972 affects the behavior of the Apply command, as does the feature
6973 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
6974
6975 <P>
6976 &lt;End of help on this topic&gt;
6977 </BODY>
6978 </HTML>
6979 ======= h_index_cmd_zoom =======
6980 <HTML>
6981 <HEAD>
6982 <TITLE>ZoomMode Command</TITLE>
6983 </HEAD>
6984 <BODY>
6985 <H1>ZoomMode Command</H1>
6986
6987 Another action you might want to take on a set of selected messages is to
6988 zoom in on them.  Like apply, zoom only becomes active when messages have
6989 been selected.
6990 ZoomMode
6991 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
6992 is a toggle command that allows you to
6993 zoom-in (and only see the selected messages) and zoom-out (to see all
6994 messages in the folder).  Neither apply nor zoom removes the markings that
6995 define the selected set; you need to use a select command in order
6996 to do that.
6997
6998 <P>
6999 &lt;End of help on this topic&gt;
7000 </BODY>
7001 </HTML>
7002 ======= h_index_collapse_expand =======
7003 <HTML>
7004 <HEAD>
7005 <TITLE>Collapse/Expand Command</TITLE>
7006 </HEAD>
7007 <BODY>
7008 <H1>Collapse/Expand Command</H1>
7009
7010 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
7011 the folder is sorted by either Threads or OrderedSubject, and the
7012 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
7013 is set to something other than &quot;none&quot;.
7014 By default, this command collapses or expands the subthread that starts at
7015 the currently highlighted message, if any.
7016 If the subthread is already collapsed, then this command expands it.
7017 If the subthread is expanded, then this command collapses it.
7018 If there are no more messages below the current message in the
7019 thread tree (that is, there are no replies to the current message) then
7020 this command does nothing.
7021
7022 <P>
7023 The behavior of this command is affected by the option
7024 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
7025 Normally, this command Collapses or Expands the subthread that
7026 starts at the currently highlighted message.
7027 If the above option is set, then this command Collapses or Expands the
7028 entire current thread instead of just the subthread.
7029 The current thread is simply the top-level thread that contains the
7030 current message.
7031
7032 <P>
7033 &lt;End of help on this topic&gt;
7034 </BODY>
7035 </HTML>
7036 ======= h_index_cmd_sort =======
7037 <HTML>
7038 <HEAD>
7039 <TITLE>Sort Command</TITLE>
7040 </HEAD>
7041 <BODY>
7042 <H1>Sort Command</H1>
7043
7044 In Alpine's generic configuration, messages are presented in the order in
7045 which they arrive.  This default can be changed in the SETUP CONFIGURATION
7046 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
7047 You can also re-sort the folder on demand with the sort
7048 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
7049 command.
7050 Your sorting options are:
7051 <P>
7052 <UL>
7053  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
7054  <LI> <A HREF="h_index_sort_date">D</A>ate
7055  <LI> <A HREF="h_index_sort_subj">S</A>ubject
7056  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
7057  <LI> t<A HREF="h_index_sort_thread">H</A>read
7058  <LI> <A HREF="h_index_sort_from">F</A>rom
7059  <LI> si<A HREF="h_index_sort_size">Z</A>e
7060  <LI> scor<A HREF="h_index_sort_score">E</A>,
7061  <LI> <A HREF="h_index_sort_to">T</A>o
7062  <LI> <A HREF="h_index_sort_cc">C</A>c
7063 </UL>
7064
7065 <P>
7066 The Reverse option will toggle the order the index is currently
7067 sorted by, but will not change the relative sort order.
7068
7069 <P>
7070 Sorting a folder does not actually rearrange the way the folder is saved,
7071 it just re-arranges how the messages are presented to you.  This means
7072 that Alpine has to do the work of sorting every time you change sort order.
7073 Sometimes, especially with PC-Alpine or with large folders, this could take
7074 a while.
7075
7076 <P>
7077 &lt;End of help on this topic&gt;
7078 </BODY>
7079 </HTML>
7080 ======= h_index_sort_default =======
7081 <HTML>
7082 <HEAD>
7083 <TITLE>SORT OPTION: Default</TITLE>
7084 </HEAD>
7085 <BODY>
7086 <H1>SORT OPTION: Default</H1>
7087
7088 The <EM>Default</EM> sort option just means to use the default sort order
7089 set in the
7090 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
7091 option in Setup/Config.
7092
7093 <P>
7094 &lt;End of help on this topic&gt;
7095 </BODY>
7096 </HTML>
7097 ======= h_index_sort_arrival =======
7098 <HTML>
7099 <HEAD>
7100 <TITLE>SORT OPTION: Arrival</TITLE>
7101 </HEAD>
7102 <BODY>
7103 <H1>SORT OPTION: Arrival</H1>
7104
7105 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7106 in the order that they exist in the folder.  This is usually the same as the
7107 order in which they arrived.  This option is comparable to not sorting
7108 the messages at all.
7109
7110 <P>
7111 &lt;End of help on this topic&gt;
7112 </BODY>
7113 </HTML>
7114 ======= h_index_sort_date =======
7115 <HTML>
7116 <HEAD>
7117 <TITLE>SORT OPTION: Date</TITLE>
7118 </HEAD>
7119 <BODY>
7120 <H1>SORT OPTION: Date</H1>
7121
7122 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7123 according to the date and time they were
7124 sent.
7125
7126 <P>
7127 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
7128 identical to sorting by &quot;Arrival&quot;.
7129
7130 <P>
7131 &lt;End of help on this topic&gt;
7132 </BODY>
7133 </HTML>
7134 ======= h_index_sort_subj =======
7135 <HTML>
7136 <HEAD>
7137 <TITLE>SORT OPTION: Subject</TITLE>
7138 </HEAD>
7139 <BODY>
7140 <H1>SORT OPTION: Subject</H1>
7141
7142 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7143 by subject.
7144
7145 <P>
7146 Messages with the same subject are
7147 first grouped together, and then the groups of like-subject messages
7148 are arranged alphabetically.
7149
7150 <P>
7151 Alpine ignores leading &quot;Re:&quot; and
7152 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
7153 likeness and alphabetical order of subject lines.
7154
7155 <P>
7156 &lt;End of help on this topic&gt;
7157 </BODY>
7158 </HTML>
7159 ======= h_index_sort_ordsubj =======
7160 <HTML>
7161 <HEAD>
7162 <TITLE>SORT OPTION: OrderedSubject</TITLE>
7163 </HEAD>
7164 <BODY>
7165 <H1>SORT OPTION: OrderedSubject</H1>
7166
7167 The <EM>OrderedSubject</EM> sort option arranges messages in the
7168 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
7169 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
7170
7171 <P>
7172 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
7173 messages by the date of the oldest message in the group.
7174
7175 <P>
7176 This sort method provides for pseudo threading of conversations within
7177 a folder.
7178 You may want to try sorting by Thread instead.
7179
7180 <P>
7181 &lt;End of help on this topic&gt;
7182 </BODY>
7183 </HTML>
7184 ======= h_index_sort_thread =======
7185 <HTML>
7186 <HEAD>
7187 <TITLE>SORT OPTION: Thread</TITLE>
7188 </HEAD>
7189 <BODY>
7190 <H1>SORT OPTION: Thread</H1>
7191
7192 The <EM>Thread</EM> sort option arranges messages in the
7193 MESSAGE&nbsp;INDEX by grouping all messages that indicate
7194 they are part of a conversation (discussion thread) taking
7195 place within a mailbox or newsgroup.  This indication is
7196 based on information in the message's header -- specifically
7197 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
7198
7199 <P>
7200 &lt;End of help on this topic&gt;
7201 </BODY>
7202 </HTML>
7203 ======= h_index_sort_from =======
7204 <HTML>
7205 <HEAD>
7206 <TITLE>SORT OPTION: From</TITLE>
7207 </HEAD>
7208 <BODY>
7209 <H1>SORT OPTION: From</H1>
7210
7211 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7212 by the name of the author of the message.
7213
7214 <P>
7215 Messages with the same author are grouped together. Groups of
7216 messages are then put into alphabetical order according to message
7217 author.
7218
7219 <P>
7220 &lt;End of help on this topic&gt;
7221 </BODY>
7222 </HTML>
7223 ======= h_index_sort_size =======
7224 <HTML>
7225 <HEAD>
7226 <TITLE>SORT OPTION: Size</TITLE>
7227 </HEAD>
7228 <BODY>
7229 <H1>SORT OPTION: Size</H1>
7230
7231 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7232 by their relative sizes.
7233
7234 <P>
7235 &lt;End of help on this topic&gt;
7236 </BODY>
7237 </HTML>
7238 ======= h_index_sort_score =======
7239 <HTML>
7240 <HEAD>
7241 <TITLE>SORT OPTION: Score</TITLE>
7242 </HEAD>
7243 <BODY>
7244 <H1>SORT OPTION: Score</H1>
7245
7246 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7247 by their scores.
7248
7249 <P>
7250 Messages with the same score are sorted in arrival order.
7251 Scores are something you create using the
7252 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
7253
7254 <P>
7255 &lt;End of help on this topic&gt;
7256 </BODY>
7257 </HTML>
7258 ======= h_index_sort_to =======
7259 <HTML>
7260 <HEAD>
7261 <TITLE>SORT OPTION: To</TITLE>
7262 </HEAD>
7263 <BODY>
7264 <H1>SORT OPTION: To</H1>
7265
7266 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
7267 by the names of the recipients of the message.
7268
7269 <P>
7270 Messages with the same recipients are grouped together. Groups of
7271 messages are then put into alphabetical order according to message
7272 recipients.
7273
7274 <P>
7275 &lt;End of help on this topic&gt;
7276 </BODY>
7277 </HTML>
7278 ======= h_index_sort_cc =======
7279 <HTML>
7280 <HEAD>
7281 <TITLE>SORT OPTION: Cc</TITLE>
7282 </HEAD>
7283 <BODY>
7284 <H1>SORT OPTION: Cc</H1>
7285
7286 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
7287 the names of the carbon copy addresses of the message.
7288
7289 <P>
7290 &lt;End of help on this topic&gt;
7291 </BODY>
7292 </HTML>
7293 ======= h_index_cmd_whereis =======
7294 <HTML>
7295 <HEAD>
7296 <TITLE>WhereIs Command</TITLE>
7297 </HEAD>
7298 <BODY>
7299 <H1>WhereIs Command</H1>
7300
7301 The WhereIs
7302 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
7303 command lets you search the MESSAGE INDEX for a word.
7304 It scans through whatever you see, usually the name of the author
7305 and the Subject line.
7306 WhereIs has special subcommands to let you find the beginning of the
7307 index (Ctrl-Y -- first message)
7308 or the end of the index (Ctrl-V -- last message).
7309 <P>
7310 Note that WhereIs only searches through the visible text on the screen.
7311 For example, if only part of the Subject of a message is shown because it
7312 is long, then only the visible portion of the Subject is searched.
7313 Also note that WhereIs does not &quot;see&quot; the
7314 &quot;X&quot; in column one of Index entries for selected messages
7315 so it can't be used to search for
7316 selected messages (use &quot;Zoom&quot; instead).
7317 <P>
7318 If the feature
7319 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
7320 is turned on,
7321 WhereIs can also be used as a quick way to select messages that match the
7322 string being searched for.
7323 Instead of typing carriage return to search for the next match, type
7324 Ctrl-X to select all matches.
7325 Once again, this only selects matches that are (or would be if the right
7326 index line was on the screen) visible.
7327 Truncated From lines or Subjects will cause matches to be missed.
7328 Although WhereIs is sometimes convenient for quick matching, the Select
7329 command is usually more powerful and usually faster.
7330
7331 <P>
7332 &lt;End of help on this topic&gt;
7333 </BODY>
7334 </HTML>
7335 ======= h_view_cmd_whereis =======
7336 <HTML>
7337 <HEAD>
7338 <TITLE>WhereIs Command</TITLE>
7339 </HEAD>
7340 <BODY>
7341 <H1>WhereIs Command</H1>
7342
7343 The WhereIs
7344 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
7345 command does a &quot;find in current message&quot; operation.  You
7346 type in text and Alpine will try to find it in the message you are
7347 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
7348 or end (Ctrl-V) of the message.
7349 That is, to rapidly move to the end of a message, hit the
7350 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
7351 (or Ctrl-W) key followed
7352 by Ctrl-V.  Similarly,
7353 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
7354 followed by Ctrl-Y will take you to the beginning of a message.
7355
7356 <P>
7357 &lt;End of help on this topic&gt;
7358 </BODY>
7359 </HTML>
7360 ======= h_view_cmd_hilite =======
7361 <HTML>
7362 <HEAD>
7363 <TITLE>View Hilite and Next item/Previous item</TITLE>
7364 </HEAD>
7365 <BODY>
7366 <H1>View Hilite and Next item/Previous item</H1>
7367
7368 Sometimes messages may be in the form of formatted HTML text
7369 or they may contain URLs or Web server hostnames.
7370 When any of the features
7371 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
7372 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
7373 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
7374 or
7375 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
7376 are enabled, Alpine will represent such selectable items in the text
7377 in bold typeface.  One of the selectable items will be displayed in
7378 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
7379 Press the Return key to view the currently selected item.
7380 <P>
7381
7382 The Up and Down Arrows keys can be used to change the selected item
7383 (also see the feature
7384 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
7385 If there are no selectable items in the direction of the arrow you
7386 pressed, Alpine will scroll the display in that direction until one
7387 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
7388 items in the message text, use the Previous and Next item commands,
7389 <!--chtml if pinemode="function_key"-->F5 and F6
7390 <!--chtml else-->^B and ^F<!--chtml endif-->.
7391
7392 <P>
7393 &lt;End of help on this topic&gt;
7394 </BODY>
7395 </HTML>
7396 ======= h_view_cmd_viewattch =======
7397 <HTML>
7398 <HEAD>
7399 <TITLE>ViewAttch Command</TITLE>
7400 </HEAD>
7401 <BODY>
7402 <H1>ViewAttch Command</H1>
7403
7404
7405 The View/Save Attachment
7406 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
7407 command allows you to handle MIME attachments to a message you have
7408 received.  Alpine shows you a list of the message attachments -- you just
7409 choose the attachment you want.  You may either view or save the
7410 selected attachment.
7411
7412 <P>
7413 Because many attachments require external programs for display, there
7414 is some system configuration that has to happen before you can
7415 actually display attachments.  Hopefully much of that will have been
7416 done already by your system administrator.  MIME configuration is
7417 handled with the &quot;mailcap&quot; configuration file.  (See the section
7418 on configuration in the
7419 <A HREF="h_news">release notes</A> for more information.)
7420
7421 <P>
7422 &lt;End of help on this topic&gt;
7423 </BODY>
7424 </HTML>
7425 ======= h_index_cmd_expunge =======
7426 <HTML>
7427 <HEAD>
7428 <TITLE>Expunge/Exclude Command</TITLE>
7429 </HEAD>
7430 <BODY>
7431 <H1>Expunge/Exclude Command</H1>
7432
7433 Expunge/Exclude
7434 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
7435 is the command Alpine uses to actually remove all messages
7436 marked for deletion.  With regular email files, expunge literally deletes
7437 the text from the current folder.  With newsgroups or shared mailboxes,
7438 you don't have permission to actually remove the message, so it is an
7439 exclude -- Alpine removes the message from your view of the folder even
7440 though it is not technically gone.
7441
7442 <P> A selective expunge command is available in IMAP folders that support
7443 the UID EXPUNGE extension in <A
7444 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
7445 other folders (local folders in all formats, POP3 inbox, and newsgroups)
7446 as a subcommand of the apply command. If some selected messages are marked
7447 deleted, then the apply command will offer the eXpunge command, which when
7448 executed will only expunge those messages that are selected and deleted.
7449
7450 <P>
7451 Observe that the expunge command (when not used from the apply command)
7452 will expunge/exclude all deleted messages from the folder, and so all
7453 messages marked deleted will be expunged, regardless of if they are
7454 selected or not. In other words, there is no protection against
7455 potentially expunging more messages than only those that have been
7456 selected and deleted.
7457 <P>
7458
7459 The configuration features
7460 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
7461 and
7462 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
7463 affect the behavior of the Expunge command.
7464
7465 <P>
7466 &lt;End of help on this topic&gt;
7467 </BODY>
7468 </HTML>
7469 ======= h_common_compose =======
7470 <HTML>
7471 <HEAD>
7472 <TITLE>Compose Command</TITLE>
7473 </HEAD>
7474 <BODY>
7475 <H1>Compose Command</H1>
7476
7477 The Compose command takes you into the Alpine message composer where you
7478 can start a new message for sending.  This is where you type in the
7479 message's text and specify its recipient list (the &quot;To:&quot;
7480 address), where copies should be directed (e.g., &quot;Fcc&quot;,
7481 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
7482 be attached to the message.
7483
7484 <P>
7485 When you type this command, Alpine will also automatically check for any
7486 interrupted (i.e., a message that was being composed when your modem
7487 or network connection was broken) or previously postponed messages and
7488 offer you a chance to continue working on those.
7489
7490 <P>
7491 <UL>
7492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7493 </UL><P>
7494 &lt;End of help on this topic&gt;
7495 </BODY>
7496 </HTML>
7497 ======= h_common_index =======
7498 <HTML>
7499 <HEAD>
7500 <TITLE>Message Index Command</TITLE>
7501 </HEAD>
7502 <BODY>
7503 <H1>Message Index Command</H1>
7504
7505 The Index command takes you to the MESSAGE INDEX screen that displays a
7506 summary caption for each message in the currently-open folder. One
7507 message will be highlighted; this is the &quot;Current&quot; message.
7508 The message commands available from this screen (e.g. View, Reply,
7509 Forward, Delete, Print, Save, etc) apply to the current message.
7510
7511 <P>
7512 &lt;End of help on this topic&gt;
7513 </BODY>
7514 </HTML>
7515 ======= h_common_folders =======
7516 <HTML>
7517 <HEAD>
7518 <TITLE>Folder List Command</TITLE>
7519 </HEAD>
7520 <BODY>
7521 <H1>Folder List Command</H1>
7522
7523 This Folder List command takes you to the FOLDER LIST screen that displays
7524 the names of all your message folders and allows you to view, rename,
7525 delete, and add folders.  You can open (view) a different folder than the
7526 one currently open by highlighting the desired one (using the arrow keys
7527 or their control-key equivalents) and pressing RETURN.
7528
7529 <P>
7530 If you have multiple folder collections defined (see the Help text for
7531 the FOLDER LIST screen to learn more about Collections), you may need
7532 to press Return to expand the collection and display all of the
7533 folders in it.
7534
7535 <P>
7536 &lt;End of help on this topic&gt;
7537 </BODY>
7538 </HTML>
7539 ======= h_main_addrbook =======
7540 <HTML>
7541 <HEAD>
7542 <TITLE>Address Book Command</TITLE>
7543 </HEAD>
7544 <BODY>
7545 <H1>Address Book Command</H1>
7546
7547 This command, available only from the MAIN MENU, takes you
7548 to the ADDRESS BOOK management screen.  From here, your personal address
7549 book(s) may be updated.
7550
7551 <P>
7552 &lt;End of help on this topic&gt;
7553 </BODY>
7554 </HTML>
7555 ======= h_main_setup =======
7556 <HTML>
7557 <HEAD>
7558 <TITLE>Setup Command</TITLE>
7559 </HEAD>
7560 <BODY>
7561 <H1>Setup Command</H1>
7562
7563 The Setup command, available only from the MAIN MENU, prompts you for
7564 one of several configuration screens, including the SETUP CONFIGURATION
7565 screen, by which you may activate optional Alpine features.
7566
7567 <P>
7568 &lt;End of help on this topic&gt;
7569 </BODY>
7570 </HTML>
7571 ======= h_main_release_notes =======
7572 <HTML>
7573 <HEAD>
7574 <TITLE>Release Notes Command</TITLE>
7575 </HEAD>
7576 <BODY>
7577 <H1>Release Notes Command</H1>
7578
7579 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
7580 as well as pointers to further information such as history and legal notes.
7581
7582 <P>
7583 &lt;End of help on this topic&gt;
7584 </BODY>
7585 </HTML>
7586 ======= h_main_kblock =======
7587 <HTML>
7588 <HEAD>
7589 <TITLE>Keyboard Lock Command</TITLE>
7590 </HEAD>
7591 <BODY>
7592 <H1>Keyboard Lock Command</H1>
7593
7594 This command allows your Alpine session to be protected
7595 during a temporary absence from your terminal.
7596
7597 <P>
7598 &lt;End of help on this topic&gt;
7599 </BODY>
7600 </HTML>
7601 ======= h_main_journal =======
7602 <HTML>
7603 <HEAD>
7604 <TITLE>Journal Command</TITLE>
7605 </HEAD>
7606 <BODY>
7607 <H1>Journal Command</H1>
7608
7609 This command displays a list of all the status messages Alpine has
7610 displayed (on the third line from the bottom of the screen). This may
7611 be useful if a message disappeared before you had a chance to read it.
7612
7613 <P>
7614 &lt;End of help on this topic&gt;
7615 </BODY>
7616 </HTML>
7617 ======= h_common_role =======
7618 <HTML>
7619 <HEAD>
7620 <TITLE>Role Command</TITLE>
7621 </HEAD>
7622 <BODY>
7623 <H1>Role Command</H1>
7624
7625 The Role command is similar to the Compose command except that it starts
7626 off by letting you select a <A HREF="h_rules_roles">role</A>
7627 to be used for the composition.
7628 You may set up alternate roles by using Setup/Rules/Roles.
7629
7630 <P>
7631 &lt;End of help on this topic&gt;
7632 </BODY>
7633 </HTML>
7634 ======= h_common_conditional_cmds =======
7635 <HTML>
7636 <HEAD>
7637 <TITLE>Conditional Commands</TITLE>
7638 </HEAD>
7639 <BODY>
7640 <H1>Conditional Commands</H1>
7641
7642 The presence or absence of certain commands, particularly in the
7643 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
7644 whether or not specific features are set in your Alpine configuration.
7645 (You can access the SETUP CONFIGURATION screen, where they are found, from
7646 Alpine's MAIN MENU.)  To see if a desired command's availability is
7647 conditioned on a feature setting, see the command's help text (highlight
7648 the phrase associated with the command and hit Return).
7649
7650 <P>
7651 Also note that some
7652 commands may be administratively disabled by your system manager;
7653 if they don't work, please check with your local help desk.
7654
7655 <P>
7656 <UL>
7657 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7658 </UL><P>
7659 &lt;End of help on this topic&gt;
7660 </BODY>
7661 </HTML>
7662 ======= h_common_pipe =======
7663 <HTML>
7664 <HEAD>
7665 <TITLE>Pipe Command</TITLE>
7666 </HEAD>
7667 <BODY>
7668 <H1>Pipe Command</H1>
7669
7670 Pipe
7671 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
7672 allows you to send a message to a specified Unix command for external
7673 processing.
7674 This command's availability is controlled by the
7675 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
7676 feature.
7677 By default, the processed text of the message is sent to the command
7678 you specify and the output is captured by Alpine and shown to you.
7679 When you run the pipe command, there are some sub-commands which may be
7680 used to alter this behavior.
7681 These sub-commands are described <A HREF="h_pipe_command">here</A>.
7682
7683 <P>
7684 &lt;End of help on this topic&gt;
7685 </BODY>
7686 </HTML>
7687 ======= h_common_goto =======
7688 <HTML>
7689 <HEAD>
7690 <TITLE>Goto Command</TITLE>
7691 </HEAD>
7692 <BODY>
7693 <H1>Goto Command</H1>
7694
7695 Goto
7696 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
7697 is the command that lets you bypass Alpine's folder selection screens
7698 and jump directly to a new folder.  You can select any folder in the
7699 world: one in your current collection, one in a different collection or
7700 one in a collection you've never even used before.
7701 <P>
7702
7703 Alpine will help you as much as possible to narrow in on the folder you want.
7704 However, if the folder is outside of your defined collections, you are
7705 going to have to enter the exact folder location using the correct
7706 <A HREF="h_valid_folder_names">syntax</A>
7707 for a remote folder and/or fully-qualified path name.
7708
7709 <P>
7710 &lt;End of help on this topic&gt;
7711 </BODY>
7712 </HTML>
7713 ======= h_common_nextnew =======
7714 <HTML>
7715 <HEAD>
7716 <TITLE>NextNew Command</TITLE>
7717 </HEAD>
7718 <BODY>
7719 <H1>NextNew Command</H1>
7720
7721 When you press the TAB key, Alpine advances to the next
7722 &quot;interesting&quot; message.
7723 This will be the next message you have not seen before, or the next message
7724 you have flagged Important, whichever comes first.
7725 Unread messages that have been deleted are not considered interesting.
7726 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
7727 articles after you have read them if you want to remove them from future
7728 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
7729 more information.)
7730
7731 <P>
7732 The NextNew command is affected by the feature
7733 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
7734 which causes Alpine to only consider Unread messages interesting, not messages
7735 flagged Important.
7736
7737 <P>
7738 This command behaves a little differently when it finds there are no more
7739 interesting messages left in the current folder.
7740 If the current folder is one of your Incoming Message Folders
7741 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
7742 or it is a newsgroup, then Alpine will try to find the next folder or
7743 newsgroup that contains <EM>Recent</EM> messages and will ask you
7744 if you want to open that folder.
7745 This behavior may be modified by using the
7746 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
7747 feature that causes Alpine to look for Unseen messages instead of Recent
7748 messages.
7749 The NextNew command's behavior is also affected by the configuration features
7750 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
7751 and
7752 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
7753
7754 <P>
7755 &lt;End of help on this topic&gt;
7756 </BODY>
7757 </HTML>
7758 ======= h_common_jump =======
7759 <HTML>
7760 <HEAD>
7761 <TITLE>Jump Command</TITLE>
7762 </HEAD>
7763 <BODY>
7764 <H1>Jump Command</H1>
7765
7766 This is Alpine's way of allowing you to go straight to a specific message.
7767 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
7768 configured such that typing in any number automatically jumps you to that
7769 message
7770 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
7771 in the SETUP CONFIGURATION).
7772
7773 <P>
7774 &lt;End of help on this topic&gt;
7775 </BODY>
7776 </HTML>
7777 ======= h_common_flag =======
7778 <HTML>
7779 <HEAD>
7780 <TITLE>Flag Command</TITLE>
7781 </HEAD>
7782 <BODY>
7783 <H1>Flag Command</H1>
7784
7785 Flag
7786 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7787 is the command that allows users to manipulate the status flags that
7788 appear on the left side of the MESSAGE INDEX screen.  The most common
7789 use of this is to mark a message as important. This is something of a
7790 note to yourself to get back to that message.  You may also use the
7791 flag command to set (or unset) the flags that indicate that a message
7792 is new, answered, deleted, or forwarded.<P>
7793
7794 Provided the mail server supports it,
7795 you may also manipulate user-defined keywords
7796 for a message using the flag command.
7797 These keywords will be available if you use the Flag Details screen that you
7798 can get to after typing the
7799 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7800 command.
7801 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
7802 which are always present.
7803 You may add new keywords by using the Add KW command from the Flag Details screen
7804 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
7805
7806 The availability of the flag command is determined by the
7807 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
7808 feature in your Alpine configuration. Also, it is possible that Flag could be
7809 administratively disabled by your system manager; if it doesn't work,
7810 please check with your local help desk before reporting a bug.
7811 The behavior of the flag command may be modified by the
7812 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
7813 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
7814
7815 <P>
7816 &lt;End of help on this topic&gt;
7817 </BODY>
7818 </HTML>
7819 ======= h_common_hdrmode =======
7820 <HTML>
7821 <HEAD>
7822 <TITLE>HdrMode Command</TITLE>
7823 </HEAD>
7824 <BODY>
7825 <H1>HdrMode Command</H1>
7826
7827 Every email message comes with some header lines that you normally
7828 don't see (and don't want to see).
7829 These include anywhere from 3-20 lines (or more) added by the
7830 Internet mail transport system to record the route your message took,
7831 for diagnostic purposes.
7832 These are normally of no import and simply
7833 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
7834 This also includes other non-standard headers the message may contain.
7835 If you want to see these headers, there is a way to reveal them.
7836 <P>
7837
7838 The Header Mode
7839 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7840 command is a toggle that controls Alpine's handling of these header
7841 lines.  Normally, full headers is &quot;off&quot; and you only see a
7842 few lines about who a message is to and who it is from.  When you
7843 press
7844 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7845 to turn full headers on, Alpine will show you
7846 the normal header lines as well as delivery headers, comment headers,
7847 MIME headers, and any other headers present.
7848 <P>
7849
7850 Several different Alpine commands honor the header mode -- it affects how
7851 messages are displayed, how they appear in forward and reply email, how
7852 they are printed, how they are saved, and how they are exported.
7853 <!--chtml if pinemode="os_windows"-->
7854 <!--chtml else-->
7855 The pipe command is also affected.
7856 <!--chtml endif-->
7857 <P>
7858
7859 The presence or absence of the Header Mode command is determined by the
7860 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7861 Feature-List option in your Alpine configuration.
7862
7863 <P>
7864 If you have also turned on the
7865 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
7866 option then the HdrMode command actually rotates through three states
7867 instead of just two.
7868 The first is the normal view with long quotes suppressed.
7869 The second is the normal view but with the long quotes included.
7870 The last enables the display of all headers in the message.
7871 When using Export, Pipe, Print, Forward, or Reply the quotes are
7872 never suppressed, so the first two states are identical.
7873
7874 <P>
7875 The behavior of the Header Mode command may be altered slightly by
7876 turning on the
7877 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
7878 Feature-List option in your Alpine configuration.
7879 In particular, it will cause the Header Mode to be persistent when moving
7880 from message to message instead of resetting to the default for each message.
7881
7882 <P>
7883 <UL>
7884 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7885 </UL><P>
7886 &lt;End of help on this topic&gt;
7887 </BODY>
7888 </HTML>
7889 ======= h_common_print =======
7890 <HTML>
7891 <HEAD>
7892 <TITLE>Print Command</TITLE>
7893 </HEAD>
7894 <BODY>
7895 <H1>Print Command</H1>
7896
7897 The Print
7898 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
7899 command allows you to print a copy of a message.
7900 There are many SETUP CONFIGURATION features that affect the
7901 Print command, including
7902 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
7903 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
7904 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
7905 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
7906 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
7907 You set up for printing by using the Printer option of the Setup command
7908 on the MAIN MENU.
7909 <P>
7910
7911 <P>
7912 &lt;End of help on this topic&gt;
7913 </BODY>
7914 </HTML>
7915 ======= h_common_take =======
7916 <HTML>
7917 <HEAD>
7918 <TITLE>TakeAddr Command</TITLE>
7919 </HEAD>
7920 <BODY>
7921 <H1>TakeAddr Command</H1>
7922
7923
7924 With the Take Address
7925 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
7926 command, you can extract email addresses from an
7927 incoming message and save them in an address book.  This is an easy way
7928 to add to your address book and avoid having to remember the email
7929 addresses of the people who write to you.
7930 <P>
7931
7932 If the message is just to you individually, then you will only need to
7933 provide a nickname.  If the message contains more than one email address,
7934 then you will see an address
7935 selection screen that lets you choose the address you want to save into
7936 your address book, or lets you choose several of them add to a
7937 personal distribution list.
7938 <P>
7939
7940 Once you've added an entry to your address book, you can use it from the
7941 message composer by typing the nickname of the entry into one of the
7942 header fields (for example, into the To: field), or you can use ^T from
7943 the header field to select the entry from your address book.
7944 <P>
7945
7946 If the configuration feature
7947 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
7948 is set, the behavior of the Take command is altered slightly.
7949
7950 <P>
7951 &lt;End of help on this topic&gt;
7952 </BODY>
7953 </HTML>
7954 ======= h_ge_import =======
7955 <HTML>
7956 <HEAD>
7957 <TITLE>Import File Selection</TITLE>
7958 </HEAD>
7959 <BODY>
7960 <H1>Import File Selection</H1>
7961
7962 You are importing a file that you previously
7963 exported from Alpine.
7964 You are now being asked for the name of that file.
7965 The easiest way to select a file is probably with the &quot;^T&quot;
7966 &quot;To Files&quot; command.
7967 Alternatively, you may type in a file name.
7968 It may be an absolute pathname.
7969 Otherwise, it is a file located in your home directory
7970 or current working directory
7971 <!--chtml if pinemode="running"-->
7972 (which, at least for your current Alpine &quot;session,&quot;
7973 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7974 <!--chtml endif-->, depending on the
7975 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7976 In any case, you finish by typing a carriage return to accept the
7977 file name that is displayed.
7978 When the feature
7979 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7980 is turned on you may use TAB to complete partially typed in names.
7981 <P>
7982 You may cancel the import operation by typing &quot;^C&quot; after exiting
7983 this help.
7984 <P>
7985 &lt;End of help on this topic&gt;
7986 </BODY>
7987 </HTML>
7988 ======= h_ge_allparts =======
7989 <HTML>
7990 <HEAD>
7991 <TITLE>Export Message File Selection</TITLE>
7992 </HEAD>
7993 <BODY>
7994 <H1>Export Message File Selection</H1>
7995
7996 You are Exporting a message from an Alpine mail folder
7997 to a plain text file.
7998 You also have the option of exporting all of the attachments associated
7999 with the message.
8000 You are now being asked for the name of the file to export <EM>to</EM>.
8001 The easiest way to select a file is probably with the &quot;^T&quot;
8002 &quot;To Files&quot; subcommand.
8003 After returning from that subcommand you will still be allowed to
8004 edit the name you have selected.
8005 Alternatively, you may type in a file name.
8006 It may be an absolute pathname.
8007 Otherwise, it is a file located in your home directory
8008 or current working directory
8009 <!--chtml if pinemode="running"-->
8010 (which, at least for your current Alpine &quot;session,&quot;
8011 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8012 <!--chtml endif-->, depending on the
8013 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
8014 In any case, you finish by typing a carriage return to accept the
8015 file name that is displayed.
8016 When the feature
8017 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
8018 is turned on you may use TAB to complete partially typed in names.
8019 <P>
8020 The message you are exporting appears to have some attachments.
8021 If you wish to save <EM>all</EM> of the attachments at once,
8022 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
8023 saving of the attachments.
8024 You may turn it back off by typing &quot;^P&quot; again, which will now
8025 be labeled &quot;NoAllParts&quot; instead.
8026 If you want to save the parts the command displayed should be
8027 &quot;NoAllParts&quot;!
8028 When you choose to save attachments like this, the attachments will be saved
8029 in a newly created directory.
8030 That directory will have the same name as the file name you choose here,
8031 with the letters &quot;.d&quot; appended.
8032 If that directory already exists, then the letters &quot;.d_1&quot; will
8033 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
8034 is found.
8035 For example, if you select the file name
8036 <P>
8037 <CENTER><SAMP>filename</SAMP></CENTER>
8038 <P>
8039 to export the message to, then the directory used for the attachments will be
8040 <P>
8041 <CENTER><SAMP>filename.d</SAMP></CENTER>
8042 <P>
8043 or perhaps
8044 <P>
8045 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
8046 <P>
8047 The attachments will then be put into files inside that directory.
8048 The names for the attachment files will be derived from the attachments
8049 if possible.
8050 This is done in the same way as the default values are derived if you
8051 save them one at a time.
8052 (The &quot;filename&quot; parameter from the Content-Disposition header
8053 is the first choice. If that doesn't exist, the &quot;name&quot;
8054 parameter from the Content-Type header is used.)
8055 If a name for a particular attachment is not available, then the
8056 part number of the attachment is used, with the characters &quot;part_&quot;
8057 prepended.
8058 An example of that would be
8059 <P>
8060 <CENTER><SAMP>part_2.1</SAMP></CENTER>
8061 <P>
8062 If you want to save only some of the attachments or if you want more control
8063 over the directory and filename where an attachment is saved you may
8064 cancel out of this command and View the attachment list.
8065 From there you can save each attachment individually.
8066 <P>
8067 You may cancel the Export operation by typing &quot;^C&quot; after exiting
8068 this help.
8069 <P>
8070 &lt;End of help on this topic&gt;
8071 </BODY>
8072 </HTML>
8073 ======= h_ge_export =======
8074 <HTML>
8075 <HEAD>
8076 <TITLE>Export File Selection</TITLE>
8077 </HEAD>
8078 <BODY>
8079 <H1>Export File Selection</H1>
8080
8081 You are Exporting or Saving something from within the Alpine world
8082 (a message, an attachment, etc.)
8083 to a plain text file.
8084 You are now being asked for the name of the file to export <EM>to</EM>.
8085 The easiest way to select a file is probably with the &quot;^T&quot;
8086 &quot;To Files&quot; subcommand.
8087 After returning from that subcommand you will still be allowed to
8088 edit the name you have selected.
8089 Alternatively, you may type in a file name.
8090 It may be an absolute pathname.
8091 Otherwise, it is a file located in your home directory
8092 or current working directory
8093 <!--chtml if pinemode="running"-->
8094 (which, at least for your current Alpine &quot;session,&quot;
8095 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8096 <!--chtml endif-->, depending on the
8097 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
8098 In any case, you finish by typing a carriage return to accept the
8099 file name that is displayed.
8100 When the feature
8101 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
8102 is turned on you may use TAB to complete partially typed in names.
8103 <P>
8104 If the object you are exporting is a message with some attachments,
8105 you may wish to save all of the attachments by typing the &quot;^P&quot;
8106 &quot;AllParts&quot; command to turn on saving of the attachments.
8107 This subcommand will only be visible if the message actually has attachments.
8108 You may also View the attachment list and save individual attachments from
8109 there.
8110 <P>
8111 If you are SAVING a text part (text/plain, text/html, etc.) you can use
8112 the Control-R subcommand to toggle if saving will be done in binary mode,
8113 meaning that the attachment will be decoded, but will not be transformed
8114 to UTF-8 for further processing (either in internal filters, or user
8115 supplied filters.) This is useful in case you either want to preserve
8116 the text as it was encoded originally to you, or the attachment was
8117 incorrectly attached (the attachment is not of text type) and you need
8118 the original text to process the attachment.
8119 <P>
8120 You may cancel the Export operation by typing &quot;^C&quot; after exiting
8121 this help.
8122 <P>
8123 &lt;End of help on this topic&gt;
8124 </BODY>
8125 </HTML>
8126 ======= h_common_save =======
8127 <HTML>
8128 <HEAD>
8129 <TITLE>Save and Export Commands</TITLE>
8130 </HEAD>
8131 <BODY>
8132 <H1>Save and Export Commands</H1>
8133
8134 Save
8135 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
8136 and Export
8137 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
8138 are the two alternatives Alpine gives you to keep a copy of the message
8139 you are reading. If you want to keep the message within Alpine's email
8140 world, use &quot;Save&quot;; if you want to use the message in another
8141 program, use &quot;Export&quot;.
8142 <P>
8143
8144 When you Save a message, it is put into an existing folder or into a new
8145 folder in one of your existing folder collections.  The message stays in
8146 email format and can be read by Alpine again.  Alpine may use a special format
8147 for its mail folders -- never edit an Alpine folder by hand or with any
8148 program other than Alpine.  The exact behavior of the Save command can be
8149 configured with the
8150 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
8151 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
8152 and
8153 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
8154 feature list settings.
8155 The name of the folder offered as a default is controlled by the option
8156 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
8157 <P>
8158
8159 When you use Export, the message is placed in a plain text file in your
8160 home directory
8161 <!--chtml if pinemode="running"-->
8162 (which, in the present configuration of your system, is
8163  &quot;<!--#echo var="HOME_DIR"-->&quot;)
8164 <!--chtml endif-->
8165 or current working directory
8166 <!--chtml if pinemode="running"-->
8167 (which, at least for your current Alpine &quot;session,&quot;
8168 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8169 <!--chtml endif-->, depending on the
8170 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
8171 configuration setting.  In the normal case, only minimal
8172 headers are exported with the message; however, if the full header mode
8173 (whose availability may be disabled  by setting the feature
8174 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
8175 in SETUP CONFIGURATION) is
8176 toggled on, then complete headers are exported along with the message
8177 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
8178 defined, they may affect the contents of the exported file.)
8179
8180 <P>
8181 &lt;End of help on this topic&gt;
8182 </BODY>
8183 </HTML>
8184 ======= h_common_bounce =======
8185 <HTML>
8186 <HEAD>
8187 <TITLE>Bounce Command</TITLE>
8188 </HEAD>
8189 <BODY>
8190 <H1>Bounce Command</H1>
8191
8192 The Bounce
8193 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
8194 command allows you to re-send, or &quot;remail&quot;, a
8195 message, as if you were never in the loop.  It is analogous to crossing
8196 out your address on a postal letter, writing a different address on the
8197 envelope, and putting it into the mailbox. Bounce is used primarily to
8198 redirect email that was sent to you in error.
8199 Also, some owners of email
8200 lists need the bounce command to handle list traffic.
8201 Bounce is not anonymous.
8202 A ReSent-From header is added to the message so that the recipient may
8203 tell that you Bounced it to them.
8204 <P>
8205
8206 The presence or absence of the Bounce command is determined by the
8207 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
8208 feature in your Alpine configuration.
8209 The feature
8210 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
8211 affects the behavior of the Bounce command.
8212 Also, it is possible that Bounce could be
8213 administratively disabled by your system manager; if it doesn't work,
8214 please check with your local help desk before reporting a bug.
8215
8216 <P>
8217 &lt;End of help on this topic&gt;
8218 </BODY>
8219 </HTML>
8220 ======= h_common_reply =======
8221 <HTML>
8222 <HEAD>
8223 <TITLE>Reply and Forward Commands</TITLE>
8224 </HEAD>
8225 <BODY>
8226
8227 <H1>Reply and Forward Commands</H1>
8228
8229 Replying
8230 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
8231 and Forwarding
8232 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
8233 are your two alternatives for following up on the
8234 message you are reading.  You would use reply if you want to get email
8235 back to the author of the message and/or the other people who have
8236 already seen it.  You use forward if you want somebody new to see the
8237 message.
8238 <P>
8239
8240 In the normal case, the only thing that you must supply when forwarding a
8241 message is the name/email address of the new recipient.
8242 Alpine will include the text of the forwarded message.
8243 Alpine will also include any attachments to the message.
8244 There is space above the forwarded text for you to include additional comments.
8245 <P>
8246
8247 When replying, you usually have to answer some questions.
8248 If the message is to multiple people and/or specified with a Reply-To: header,
8249 then you will have to decide who should get the reply.
8250 You also need to decide whether or not to include the previous
8251 message in your reply.
8252 Some of this is configurable.
8253 Specifically, see the
8254 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
8255 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
8256 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
8257 and
8258 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
8259 configuration features.
8260 <P>
8261
8262 Both the Reply and Forward commands react to the full header mode toggle.
8263 If the full header mode is on, then all the header and delivery lines are
8264 included with the text of the message in your reply/forward.
8265 <P>
8266
8267 Other configuration features that affect the Reply command are
8268 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
8269 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
8270 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
8271
8272 <P>
8273 &lt;End of help on this topic&gt;
8274 </BODY>
8275 </HTML>
8276 ======= h_common_delete =======
8277 <HTML>
8278 <HEAD>
8279 <TITLE>Delete and Undelete Commands</TITLE>
8280 </HEAD>
8281 <BODY>
8282 <H1>Delete and Undelete Commands</H1>
8283
8284 Delete
8285 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
8286 and Undelete
8287 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
8288 allow you to change the Deleted flag for the current message.
8289 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
8290 removes the mark.
8291 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
8292 at the left hand edge of the index line.
8293 When viewing a deleted message, the letters &quot;DEL&quot; will be present
8294 in the upper right hand corner of the screen.
8295 Delete simply <EM>marks</EM> a message Deleted, it does not actually
8296 get rid of the message.
8297 The eXpunge command (available from the MESSAGE INDEX screen) actually
8298 removes all of the deleted messages in a folder.
8299 Once a message is eXpunged, it can't be retrieved.
8300 <P>
8301
8302 The Delete command is affected by the setting of the configuration feature
8303 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
8304
8305 <P>
8306 &lt;End of help on this topic&gt;
8307 </BODY>
8308 </HTML>
8309 ======= h_common_postpone =======
8310 <HTML>
8311 <HEAD>
8312 <TITLE>Postpone Command</TITLE>
8313 </HEAD>
8314 <BODY>
8315 <H1>Postpone Command</H1>
8316
8317 The postpone
8318 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
8319 command allows you to temporarily stop working on the current
8320 message so you may read
8321 other messages or compose another message.  When you want to resume a
8322 message later, start to compose and answer &quot;yes&quot; to the
8323 &quot;Continue postponed composition?&quot; question.  You may
8324 postpone as many messages as you like.
8325
8326 <P>
8327 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
8328 in the Setup/Config screen, then the Postpone command will prompt you for
8329 the folder in which to store your outgoing message.
8330
8331 <P>
8332 &lt;End of help on this topic&gt;
8333 </BODY>
8334 </HTML>
8335 ======= h_compose_cancel =======
8336 <HTML>
8337 <HEAD>
8338 <TITLE>Cancel Command</TITLE>
8339 </HEAD>
8340 <BODY>
8341 <H1>Cancel Command</H1>
8342
8343 Cancel
8344 <!--chtml if pinemode="function_key"-->
8345 (F2)
8346 <!--chtml else-->
8347 (^C)
8348 <!--chtml endif-->
8349
8350 The Cancel command returns you to Alpine's normal mail processing and
8351 causes the message currently under composition to be thrown out.
8352 The message text <EM>will be lost</EM>.
8353
8354 <P>
8355 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
8356 will be preserved in the file named
8357 <!--chtml if pinemode="os_windows"-->
8358 &quot;DEADLETR&quot;.
8359 <!--chtml else-->
8360 &quot;dead.letter&quot; in your home directory.
8361 <!--chtml endif-->
8362 If you unintentionally cancel a message, look there for its text.
8363
8364 <P>
8365 &lt;End of help on this topic&gt;
8366 </BODY>
8367 </HTML>
8368 ======= h_compose_addrcomplete =======
8369 <HTML>
8370 <HEAD>
8371 <TITLE>Address Completion</TITLE>
8372 </HEAD>
8373 <BODY>
8374 <H1>Address Completion</H1>
8375
8376 When entering addresses in the address fields of the composer (To, Cc, etc.)
8377 the TAB key may be used to help complete the address.
8378 Type a partial nickname and tap the TAB key to complete the typing.
8379 The unambiguous part of the name will be filled in automatically.
8380 Typing TAB twice in succession will bring up a selection list of possibilities,
8381 making it easy to find and choose the correct address.
8382
8383 <P>
8384 The matching algorithm is rather ad hoc.
8385 The search starts with a search of your address book.
8386 It counts as a match if the nickname, address, or fullname field of an
8387 entry begins with the text typed in so far. It is also a match if
8388 a later word in the fullname (for example, the middle name or last name)
8389 begins with the entered text.
8390 <P>
8391 Next comes an LDAP search.
8392 The search will happen for any servers that have the
8393 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
8394 feature set. You can set or unset the feature for each server independently
8395 in the Setup/Directory screen.
8396 <P>
8397 Finally, if you are replying to or forwarding a message, that message is
8398 searched for likely candidate addresses that match the typed-in text.
8399
8400 <P>
8401 &lt;End of help on this topic&gt;
8402 </BODY>
8403 </HTML>
8404 ======= h_compose_richhdr =======
8405 <HTML>
8406 <HEAD>
8407 <TITLE>Rich Header Command</TITLE>
8408 </HEAD>
8409 <BODY>
8410 <H1>Rich Header Command</H1>
8411
8412 The Rich Header command allows you to toggle between the list of
8413 all message headers available for editing and those that are most
8414 common.
8415
8416 <P>
8417 Use this toggle to expose headers that are not normally visible by
8418 default.
8419 This set usually includes the
8420 &quot;Bcc:&quot;,
8421 &quot;Fcc:&quot;,
8422 &quot;Lcc:&quot;,
8423 and &quot;Newsgroups&quot;
8424 headers.
8425 If you are posting to a newsgroup the set of defaults is a little different.
8426 Obviously, in that case, the Newsgroups header is of interest so is not
8427 hidden.
8428 For news posting the hidden set includes the
8429 &quot;To:&quot;,
8430 &quot;Cc:&quot;,
8431 &quot;Bcc:&quot;,
8432 &quot;Fcc:&quot;,
8433 and &quot;Lcc:&quot;
8434 headers.
8435 You won't normally want to edit these, which is why they are hidden,
8436 but it is sometimes useful to be able to set them manually.
8437
8438 <P>
8439 The default sets of headers listed above can be altered.
8440 Any header that you have added to the
8441 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
8442 option, but not to the
8443 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
8444 option will appear when you use the Rich Headers command to
8445 make the Rich Headers visible.
8446 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
8447 even without toggling the Rich Headers command.)
8448
8449 <P>
8450 &lt;End of help on this topic&gt;
8451 </BODY>
8452 </HTML>
8453 ======= h_compose_send =======
8454 <HTML>
8455 <HEAD>
8456 <TITLE>Send Command</TITLE>
8457 </HEAD>
8458 <BODY>
8459 <H1>Send Command</H1>
8460
8461 The Send command
8462 <!--chtml if pinemode="function_key"-->
8463 (F3)
8464 <!--chtml else-->
8465 (^X)
8466 <!--chtml endif-->
8467 tells Alpine you are finished composing.
8468 Before actually sending it, though, Alpine will ask you to confirm
8469 your intention, and, at the same time, redisplayed the message text
8470 with the recipients at the top of the screen to give you the opportunity
8471 to review and verify that the message is addressed to the people
8472 you intended.
8473 <P>
8474 If the feature
8475 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
8476 then this confirmation prompt and any options it allows are skipped.
8477
8478 <P>
8479 This confirmation prompt may also offer, depending
8480 on your particular Setup/Config, options allowing you to set
8481 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
8482 include attachments in the &quot;Fcc&quot; (if you had previously
8483 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
8484 observe details of the
8485 <A HREF="h_config_verbose_post">message submission process</A>,
8486 choose the filter through which the
8487 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
8488 or turn of flowed text generation.
8489
8490 <P>
8491 &lt;End of help on this topic&gt;
8492 </BODY>
8493 </HTML>
8494 ======= h_compose_markcutpaste =======
8495 <HTML>
8496 <HEAD>
8497 <TITLE>Mark, Cut and Paste Commands</TITLE>
8498 </HEAD>
8499 <BODY>
8500 <H1>Mark, Cut and Paste Commands</H1>
8501
8502 You can define a &quot;block&quot; of text, which can subsequently
8503  be deleted or
8504 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
8505 then moving the cursor to the end of the desired text block.  You can then
8506 &quot;cut&quot; the block out
8507 <!--chtml if pinemode="function_key"-->
8508 &quot;F9&quot;,
8509 <!--chtml else-->
8510 &quot;Ctrl-K&quot;,
8511 <!--chtml endif-->
8512 move the cursor, and &quot;paste&quot; it
8513 <!--chtml if pinemode="function_key"-->
8514 &quot;F10&quot;,
8515 <!--chtml else-->
8516 &quot;Ctrl-U&quot;,
8517 <!--chtml endif-->
8518 in the new location.  Also, you can paste more than once, allowing you
8519 to use this feature to copy a block of text.<P>
8520
8521 If you press
8522 <!--chtml if pinemode="function_key"-->
8523 &quot;F9&quot;
8524 <!--chtml else-->
8525 &quot;^K&quot;
8526 <!--chtml endif-->
8527 without having marked anything, Alpine will delete
8528 a single line.  If you delete a group of lines together, Alpine keeps them
8529 in the same buffer, so
8530 <!--chtml if pinemode="function_key"-->
8531 F10
8532 <!--chtml else-->
8533 ^U
8534 <!--chtml endif-->
8535 will restore them as a block.  About
8536 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
8537 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
8538 &quot;type the character ^&quot;.
8539
8540 <P>
8541 &lt;End of help on this topic&gt;
8542 </BODY>
8543 </HTML>
8544 ======= h_compose_justify =======
8545 <HTML>
8546 <HEAD>
8547 <TITLE>Justify Command</TITLE>
8548 </HEAD>
8549 <BODY>
8550 <H1>Justify Command</H1>
8551
8552 The Justify
8553 <!--chtml if pinemode="function_key"-->
8554 (F4)
8555 <!--chtml else-->
8556 (^J)
8557 <!--chtml endif-->
8558 command reformats the text in the paragraph the cursor is in.
8559 Paragraphs are separated by one blank line or a line beginning with a space.
8560 This is useful when you have been editing a paragraph and the lines become
8561 uneven.  The text is left aligned or justified and the right is ragged.  If
8562 the text is already justified as typed with auto-wrap, no justification will
8563 be done.
8564
8565 <P>
8566 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
8567 block of text, the Justify command is modified.
8568 Instead of automatically justifying the current paragraph you will be
8569 asked if you want to justify the paragraph, justify the selected region,
8570 or adjust the quote level of the selected region.
8571 Adjusting the quote level only works if you are using standard
8572 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
8573 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
8574
8575 <P>
8576 When composing a reply containing included text, the justify command
8577 will reformat text to the right of the
8578 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
8579 adding or removing indented lines as needed.  Paragraphs are separated
8580 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
8581 line containing the indent string and one or more blank spaces.
8582 Included text that was previously indented (or &quot;quoted&quot;) is
8583 not preserved.
8584
8585 <P>
8586 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
8587 in 1999 and its wide-spread adoption since then, you will usually be better off if you
8588 use the standard
8589 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
8590
8591 <P>
8592 &lt;End of help on this topic&gt;
8593 </BODY>
8594 </HTML>
8595 ======= h_compose_spell =======
8596 <HTML>
8597 <HEAD>
8598 <TITLE>Spell Check Command</TITLE>
8599 </HEAD>
8600 <BODY>
8601 <H1>Spell Check Command</H1>
8602
8603 The &quot;To Spell&quot;
8604 <!--chtml if pinemode="function_key"-->
8605 (F12)
8606 <!--chtml else-->
8607 (^T)
8608 <!--chtml endif-->
8609 command calls an external spell checking program to look over the
8610 message you are composing.  By default, Alpine uses
8611 <P>
8612 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
8613 <P>
8614 if it knows where to find &quot;aspell&quot;.
8615 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
8616 then the command used is
8617 <P>
8618 <CENTER><SAMP>ispell -l</SAMP></CENTER>
8619 <P>
8620 Otherwise, the ancient &quot;spell&quot; command is used.
8621 <P>
8622 For PC-Alpine, you must install the aspell library code that you
8623 may get from
8624 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
8625
8626 <P>
8627 &lt;End of help on this topic&gt;
8628 </BODY>
8629 </HTML>
8630 ======= h_compose_alted =======
8631 <HTML>
8632 <HEAD>
8633 <TITLE>Alt Editor Command</TITLE>
8634 </HEAD>
8635 <BODY>
8636 <H1>Alt Editor Command</H1>
8637
8638 The &quot;Alt Editor&quot; command's availability depends on the
8639 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
8640
8641 <P>
8642 When the variable specifies a valid editor on your system, this
8643 command will launch it with the current text of your message
8644 already filled in.
8645
8646 <P>
8647 &lt;End of help on this topic&gt;
8648 </BODY>
8649 </HTML>
8650 ======= h_compose_readfile =======
8651 <HTML>
8652 <HEAD>
8653 <TITLE>Read File Command</TITLE>
8654 </HEAD>
8655 <BODY>
8656 <H1>Read File Command</H1>
8657
8658 The &quot;Read File&quot;
8659 <!--chtml if pinemode="function_key"-->
8660 (F5)
8661 <!--chtml else-->
8662 (^R)
8663 <!--chtml endif-->
8664 command allows you to copy in text from an existing file. You will be
8665 prompted for the name of a file to be inserted into the message.  The file
8666 name is relative to your home directory
8667 <!--chtml if pinemode="running"-->
8668 (which, in the present configuration of your system, is
8669  &quot;<!--#echo var="HOME_DIR"-->&quot;)
8670 <!--chtml endif-->
8671 or current working directory
8672 <!--chtml if pinemode="running"-->
8673 (which, at least for your current Alpine &quot;session,&quot;
8674 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8675 <!--chtml endif-->, depending on the
8676 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
8677 configuration setting; or, the file name must be specified as a full path name
8678 <!--chtml if pinemode="os_windows"-->
8679 -- for example: &quot;A:&#92;PAPER.TXT&quot;
8680 <!--chtml else-->
8681 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
8682 <!--chtml endif-->
8683 (without the quotation marks).
8684
8685 <P>
8686 The file will be inserted where the cursor is located.  <B>The
8687 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
8688 Unix machine but have files on a PC or Mac, the files must be transferred
8689 to the system Alpine is running on before they can be read.  Please ask your
8690 local computer support people about the correct way to transfer a file to
8691 your Alpine system.
8692
8693 <P>
8694 &lt;End of help on this topic&gt;
8695 </BODY>
8696 </HTML>
8697 ======= h_config_tray_icon =======
8698 <HTML>
8699 <HEAD>
8700 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
8701 </HEAD>
8702 <BODY>
8703 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
8704
8705 PC-Alpine only.
8706 <P>
8707 This option restores a behavior of previous versions of PC-Alpine.
8708 These
8709 versions, when started, installed a PC-Alpine icon in the notification
8710 tray of Window's Taskbar.  The primary use of this icon was to indicate
8711 new mail arrival by turning red (while the Taskbar icon remained green).
8712 Additionally, the icon now changes to yellow to signify that a mail folder
8713 has been closed unexpectedly.
8714
8715 <P>
8716 Rather than add another icon to the Taskbar, this version of PC-Alpine will
8717 color its Taskbar entry's icon red (as well as the icon in the Window
8718 Title).  This feature is only provided for backwards compatibility.
8719
8720 <P>
8721 &lt;End of help on this topic&gt;
8722 </BODY>
8723 </HTML>
8724 ======= h_common_suspend =======
8725 <HTML>
8726 <HEAD>
8727 <TITLE>Suspend Command</TITLE>
8728 </HEAD>
8729 <BODY>
8730 <H1>Suspend Command</H1>
8731
8732 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
8733 enabled, you can, at almost any time, temporarily halt your Alpine session,
8734 <!--chtml if pinemode="os_windows"-->
8735 minimizing it into an icon.
8736 <!--chtml else-->
8737 and return to your system prompt.
8738 <!--chtml endif-->
8739
8740 <P>
8741 &lt;End of help on this topic&gt;
8742 </BODY>
8743 </HTML>
8744 ======= h_pipe_command =======
8745 <HTML>
8746 <HEAD>
8747 <TITLE>Pipe Command SubOptions</TITLE>
8748 </HEAD>
8749 <BODY>
8750 <H1>Pipe Command SubOptions</H1>
8751
8752 By default, when you use the Pipe command, the processed text of the
8753 message is sent to the Unix command
8754 you specify and the output is captured by Alpine and shown to you.
8755 (This command is available in PC-Alpine, as well, but there aren't many
8756 Windows commands that work well with piping.)
8757 There are some sub-commands that may be used to alter this behavior.
8758 These are toggles that switch the behavior between two possibilities.
8759 They can be combined in any way you wish.
8760 <P>
8761 By default, the prompt at the bottom of the screen looks like
8762 <P>
8763 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
8764 <P>
8765 or
8766 <P>
8767 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
8768 <P>
8769 if you are piping more than one message.
8770 <P>
8771 The sub-command options are:
8772 <DL>
8773    <DT>Shown Text or Raw Text</DT>
8774    <DD>This option toggles between sending the shown (processed) text
8775 of the message to the Unix command, and sending the
8776 raw (unprocessed) text of the message to the Unix command.
8777 The default is to send the shown text.
8778 The raw version of the message will contain all of the headers and any
8779 MIME encoding that the message contains.
8780 If you've selected the Raw Text then the prompt will have the additional word
8781 &quot;RAW&quot; in it, like
8782 <P>
8783 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
8784 <P>
8785 You can experiment with this option by piping to something simple like the
8786 Unix &quot;cat&quot; command.
8787    </DD>
8788    <DT>Captured Output or Free Output</DT>
8789    <DD>This option toggles between having Alpine capture the output of
8790 the Unix pipe command for display, and not capturing it.
8791 If the command you are piping to is a filter that will produce output
8792 you want to view, then you want to capture that output
8793 for display (the default).
8794 If the Unix command doesn't produce output or handles the display itself,
8795 then you want free output.
8796 When you've selected the Free Output option the prompt will change to
8797 <P>
8798 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
8799 <P>
8800    </DD>
8801    <DT>No Delimiter or With Delimiter</DT>
8802    <DD>This option controls whether or not a Unix mailbox style delimiter
8803 will come before the text of the message.
8804 This is the delimiter used in the common Unix mailbox format.
8805 It's the single line that begins with the five characters
8806 &quot;From&quot; followed by a &lt;SPACE&gt; character.
8807 You'll usually only want to include this if the Unix command requires
8808 input in the format of a traditional Unix mailbox file.
8809 When you've selected the With Delimiter option the prompt will change to
8810 <P>
8811 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
8812 <P>
8813    </DD>
8814    <DT>To Same Pipe or To Individual Pipes</DT>
8815    <DD>This option only shows up if you are running an aggregate
8816 pipe command.
8817 That is, the command was Apply Pipe, not just Pipe.
8818 You have the option of piping all of the selected messages through a
8819 single pipe to a single instance of the Unix command,
8820 or piping each individual message through a separate pipe to separate
8821 instances of the Unix command.
8822 The default is that all of the output will go through a single pipe
8823 to a single instance of the command.
8824 You can try this option with a command like &quot;less&quot;, with Free
8825 Output enabled.
8826 When you've selected the Individual Pipes option the prompt will change to
8827 <P>
8828 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
8829 <P>
8830    </DD>
8831 </DL>
8832
8833 <P>
8834 As mentioned earlier, the options can be combined in any way you wish.
8835 You may leave them all off, turn them all on, or turn some of them on
8836 and some of them off.
8837 If you use the pipe command a second time in the same session the default
8838 options will be what you used the last time.
8839
8840 <P>
8841 &lt;End of help on this topic&gt;
8842 </BODY>
8843 </HTML>
8844 ========== h_emptydir_subfolder_name =========
8845 <HTML>
8846 <HEAD>
8847 <TITLE>ENTER SUBFOLDER NAME</TITLE>
8848 </HEAD>
8849 <BODY>
8850 <H1>Enter Subfolder Name</H1>
8851
8852 <P>
8853 This is the name of a new subfolder in the directory you are creating.
8854 Because empty directories are hidden and therefore not useful, you must also
8855 create a subfolder in the directory you are creating in order that the
8856 directory remains visible.
8857 <P>
8858 Alternatively, you may turn off the configuration feature
8859 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
8860 so that empty directories remain visible.
8861 If you do that, you will not be required to create the subfolder when you
8862 create a directory.
8863
8864 <P>
8865 &lt;End of help on this topic&gt;
8866 </BODY>
8867 </HTML>
8868 ========== h_incoming_add_folder_name =========
8869 <HTML>
8870 <HEAD>
8871 <TITLE>ENTER FOLDER NAME</TITLE>
8872 </HEAD>
8873 <BODY>
8874 <H1>Enter Folder Name</H1>
8875
8876 <P>
8877 This is the name of the folder on the previously specified server.
8878 By default the folder name is interpreted as defining a section of your personal
8879 folder area.  This area and how you specify it are defined by the
8880 server, if one is specified.
8881
8882 <P>
8883 To define a folder outside the default area, prefix
8884 the path with the namespace to use when interpreting the
8885 given path.  If a namespace is specified, the folder name begins with the
8886 sharp (#) character followed by the name of the namespace
8887 and then the namespace's path-element-delimiter.  Aside from the
8888 name's format, namespaces can also imply access rights, content
8889 policy, audience, location, and, occasionally, access methods.
8890
8891 <P>
8892 Each server exports its own set (possibly of size one) of
8893 namespaces.
8894 For a more detailed explanation read about
8895 <A HREF="h_folder_name_namespaces">Namespaces</A>.
8896
8897 <P>
8898 To specify the default for INBOX on the server you can usually just enter
8899 &quot;INBOX&quot;, and the server will understand the special meaning of
8900 that word.
8901
8902 <P>
8903 &lt;End of help on this topic&gt;
8904 </BODY>
8905 </HTML>
8906 ========== h_incoming_add_folder_host =========
8907 <HTML>
8908 <HEAD>
8909 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
8910 </HEAD>
8911 <BODY>
8912 <H1>Enter Incoming Folder Server</H1>
8913
8914 You are being asked for the name of the server for use with this incoming
8915 folder.
8916 If the folder is on the machine where Alpine is running, then just enter
8917 RETURN without typing a server name.
8918
8919 <P>
8920 If the folder is on an IMAP server then type the server's name followed
8921 by RETURN.
8922 You may use the ^X command if the server is the same as the server that
8923 the INBOX is on.
8924
8925 <P>
8926 You may have to add optional extra information to the server name.
8927 For example, if the IMAP server is using a non-standard port number you
8928 would specify that by appending a colon (:) followed by the port number
8929 to the server name
8930
8931 <P>
8932 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8933 <P>
8934
8935 or you may need to specify a different protocol if the server is not an
8936 IMAP server. For example:
8937
8938 <P>
8939 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8940 <P>
8941
8942 for a POP server or
8943
8944 <P>
8945 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8946 <P>
8947
8948 for an NNTP news server.
8949 For an explanation of all of the possibilities, see
8950 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8951 for folders.
8952
8953 <P>
8954 There is a special command (^W) if you want to set up a folder that gets its
8955 mail from a
8956 <A HREF="h_maildrop">Mail Drop</A>.
8957 If you type that command, you will be prompted for the information for
8958 both the Mail Drop folder and the destination folder.
8959
8960 <P>
8961 &lt;End of help on this topic&gt;
8962 </BODY>
8963 </HTML>
8964 ========== h_incoming_add_inbox =========
8965 <HTML>
8966 <HEAD>
8967 <TITLE>ENTER INBOX SERVER</TITLE>
8968 </HEAD>
8969 <BODY>
8970 <H1>Enter INBOX Server</H1>
8971
8972 You are being asked for the name of the server for use with
8973 the INBOX folder.
8974 Type the server's name followed by RETURN.
8975
8976 <P>
8977 You may have to add optional extra information to the server name.
8978 For example, if the server is using a non-standard port number you
8979 would specify that by appending a colon (:) followed by the port number
8980 to the server name
8981
8982 <P>
8983 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8984 <P>
8985
8986 or you may need to specify a different protocol if the server is not an
8987 IMAP server. For example:
8988
8989 <P>
8990 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8991 <P>
8992
8993 for a POP server.
8994 <P>
8995
8996 For an explanation of all of the possibilities, see
8997 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8998 for folders.
8999
9000 <P>
9001 If the INBOX folder is on the machine where Alpine is running, then just enter
9002 RETURN without typing a server name.
9003
9004 <P>
9005 There is a special command (^W) if you want to set up a folder that gets its
9006 mail from a
9007 <A HREF="h_maildrop">Mail Drop</A>.
9008 If you type that command, you will be prompted for the information for
9009 both the Mail Drop folder and the destination folder, which will be used
9010 as your INBOX folder.
9011
9012 <P>
9013 &lt;End of help on this topic&gt;
9014 </BODY>
9015 </HTML>
9016 ========== h_incoming_add_maildrop_destn =========
9017 <HTML>
9018 <HEAD>
9019 <TITLE>ENTER DESTINATION SERVER</TITLE>
9020 </HEAD>
9021 <BODY>
9022 <H1>Enter Destination Server</H1>
9023
9024 You are being asked for the name of the server where the destination
9025 folder is for use with this Mail Drop incoming folder.
9026 That is, you are using a Mail Drop for this incoming folder and
9027 you've already entered
9028 the server and folder name for the Mail Drop.
9029 Now you need to enter the server for the destination folder
9030 where the mail should be copied to.
9031 Mail will come from the Mail Drop and be copied to the destination folder.
9032
9033 <P>
9034 Type the server's name followed by RETURN.
9035 If the folder is local to this computer, just type RETURN without entering
9036 a server name.
9037
9038 <P>
9039 You may have to add optional extra information to the server name.
9040 For example, if the server is using a non-standard port number you
9041 would specify that by appending a colon (:) followed by the port number
9042 to the server name
9043
9044 <P>
9045 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
9046 <P>
9047
9048 For an explanation of all of the possibilities, see
9049 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
9050 for folders.
9051
9052 <P>
9053 &lt;End of help on this topic&gt;
9054 </BODY>
9055 </HTML>
9056 ========== h_inbox_add_maildrop_destn =========
9057 <HTML>
9058 <HEAD>
9059 <TITLE>ENTER DESTINATION SERVER</TITLE>
9060 </HEAD>
9061 <BODY>
9062 <H1>Enter Destination Server</H1>
9063
9064 You are being asked for the name of the server where the destination
9065 folder is for use with your Mail Drop INBOX.
9066 That is, you are using a Mail Drop for your INBOX and you've already entered
9067 the server and folder name for the Mail Drop.
9068 Now you need to enter the server for the destination folder
9069 where the mail should be copied to.
9070 Mail will come from the Mail Drop and be copied to the destination folder.
9071
9072 <P>
9073 Type the server's name followed by RETURN.
9074 If the folder is local to this computer, just type RETURN without entering
9075 a server name.
9076
9077 <P>
9078 You may have to add optional extra information to the server name.
9079 For example, if the server is using a non-standard port number you
9080 would specify that by appending a colon (:) followed by the port number
9081 to the server name
9082
9083 <P>
9084 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
9085 <P>
9086
9087 For an explanation of all of the possibilities, see
9088 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
9089 for folders.
9090
9091 <P>
9092 &lt;End of help on this topic&gt;
9093 </BODY>
9094 </HTML>
9095 ========== h_inbox_add_maildrop =========
9096 <HTML>
9097 <HEAD>
9098 <TITLE>ENTER MAILDROP SERVER</TITLE>
9099 </HEAD>
9100 <BODY>
9101 <H1>Enter Mail Drop Server</H1>
9102
9103 You are being asked for the name of the Mail Drop server for use with
9104 your INBOX.
9105
9106 <P>
9107 Type the server's name followed by RETURN.
9108
9109 <P>
9110 You may have to add optional extra information to the server name.
9111 For example, if the server is using a non-standard port number you
9112 would specify that by appending a colon (:) followed by the port number
9113 to the server name
9114
9115 <P>
9116 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
9117 <P>
9118
9119 or you may need to specify a different protocol if the server is not an
9120 IMAP server. For example:
9121
9122 <P>
9123 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
9124 <P>
9125
9126 for a POP server or
9127
9128 <P>
9129 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
9130 <P>
9131
9132 for an NNTP news server.
9133 For an explanation of all of the possibilities, see
9134 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
9135 for folders.
9136
9137 <P>
9138 &lt;End of help on this topic&gt;
9139 </BODY>
9140 </HTML>
9141 ========== h_incoming_add_maildrop =========
9142 <HTML>
9143 <HEAD>
9144 <TITLE>ENTER MAILDROP SERVER</TITLE>
9145 </HEAD>
9146 <BODY>
9147 <H1>Enter Mail Drop Server</H1>
9148
9149 You are being asked for the name of the Mail Drop server for use with
9150 this incoming folder.
9151
9152 <P>
9153 Type the server's name followed by RETURN.
9154 You may use the ^X command if the server is the same as the server that
9155 the INBOX is on.
9156
9157 <P>
9158 You may have to add optional extra information to the server name.
9159 For example, if the server is using a non-standard port number you
9160 would specify that by appending a colon (:) followed by the port number
9161 to the server name
9162
9163 <P>
9164 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
9165 <P>
9166
9167 or you may need to specify a different protocol if the server is not an
9168 IMAP server. For example:
9169
9170 <P>
9171 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
9172 <P>
9173
9174 for a POP server or
9175
9176 <P>
9177 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
9178 <P>
9179
9180 for an NNTP news server.
9181 For an explanation of all of the possibilities, see
9182 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
9183 for folders.
9184
9185 <P>
9186 If the Mail Drop folder is on the machine where Alpine is running, then just enter
9187 RETURN without typing a server name.
9188
9189 <P>
9190 &lt;End of help on this topic&gt;
9191 </BODY>
9192 </HTML>
9193 ========== h_maildrop =========
9194 <HTML>
9195 <HEAD>
9196 <TITLE>WHAT IS A MAIL DROP?</TITLE>
9197 </HEAD>
9198 <BODY>
9199 <H1>What is a Mail Drop?</H1>
9200
9201 In some situaions it may make sense to have your mail delivered to one
9202 folder (the Mail Drop) and then when you want to read mail that has been
9203 delivered to the Mail Drop folder Alpine will move it to another
9204 destination folder.
9205 Often the Mail Drop will be a remote folder and messages will be moved from
9206 there to a local destination folder.
9207
9208 <P>
9209 One example where this might make sense is if the Mail Drop folder is accessible
9210 only with the POP protocol.
9211 You could designate your POP inbox as the Mail Drop folder and have Alpine move
9212 mail from there to a local (on the same machine Alpine is running on)
9213 destination folder, where you'll read it.
9214
9215 <P>
9216 A Mail Drop may only be used as your Inbox or as an
9217 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
9218
9219 <P>
9220 There is no attempt to synchronize the contents of the destination folder
9221 with the contents of the Mail Drop folder.
9222 All that happens is that all of the messages in the Mail Drop folder are
9223 copied to the destination folder and then they are deleted and expunged (if possible)
9224 from the Mail Drop folder.
9225 The next time a check for new mail is made, any messages in the Mail
9226 Drop folder are once again copied to the destination folder and deleted
9227 and expunged from the Mail Drop folder.
9228 (If the Mail Drop folder is a news group, then the messages can't be
9229 expunged from the newsgroup. Instead, only Recent messages are copied from
9230 the newsgroup to the destination folder.)
9231
9232 <P>
9233 Configuration of a Mail Drop is a little different from configuration of
9234 a folder that does not use a Mail Drop because you have to specify two
9235 folder names instead of one.
9236 The two folders may be any types of folders that Alpine can normally use.
9237 They don't have to be a remote folder and a local folder, that is
9238 simply the most common usage.
9239 When you use a Mail Drop folder Alpine will periodically re-open the Mail
9240 Drop to check for new mail.
9241 The new-mail checks will happen at the frequency set with the
9242 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
9243 but with a minimum time
9244 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
9245 between checks.
9246 Because of this minimum you may notice that new mail does not
9247 appear promptly when you expect it.
9248 The reason for this is to protect the server from over-zealous opening and
9249 closing of the Mail Drop folder.
9250 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
9251 the end of the folder index, then the check will happen, regardless of how
9252 long it has been since the previous check.
9253 <P>
9254 If there is new mail, that mail will be copied to the destination folder
9255 and then will be deleted from the Mail Drop.
9256 Note that using a Mail Drop with a local destination folder does not make
9257 sense if you read mail from more than one machine, because the mail is
9258 downloaded to the destination folder (which is accessible from only one
9259 machine) and deleted from the Mail Drop.
9260 <P>
9261 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
9262
9263 <P>
9264 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
9265
9266 <P>
9267 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
9268 <P>
9269 The brackets are not literal.
9270 <P>
9271 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
9272 <P>
9273 is a single character that does not appear in the MailDropFolder name.
9274 If the name doesn't contain spaces then it can be a space character.
9275 The two folder names are full technical
9276 <A HREF="h_valid_folder_names">folder names</A>
9277 as used by Alpine.
9278 Here are a couple examples to give you an idea what is being talked about:
9279
9280 <P>
9281 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
9282 <P>
9283 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
9284 <P>
9285
9286 A #move folder may only be used as an
9287 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
9288 an Inbox.
9289 When you are in the FOLDER LIST of Incoming Message Folders (after turning
9290 on the
9291 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
9292 option)
9293 the Add command has a subcommand &quot;Use Mail Drop&quot;
9294 which may be helpful for defining the folder in your Alpine configuration.
9295 The same is true when you edit the
9296 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
9297 option in Setup/Config.
9298 Each of these configuration methods will also create the DestinationFolder
9299 if it doesn't already exist.
9300 If you are having problems, make sure the DestinationFolder exists.
9301
9302 <P>
9303 &lt;End of help on this topic&gt;
9304 </BODY>
9305 </HTML>
9306 ========== h_save =========
9307 <HTML>
9308 <HEAD>
9309 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
9310 </HEAD>
9311 <BODY>
9312 <H1>Choose a Folder to Save Into</H1>
9313
9314 After Exiting from this help text,
9315 type the name of the folder you want to save into and press RETURN.
9316 <P>
9317 Press ^T to get a list of your folders to choose from.
9318 Press ^C to cancel the Save.
9319 <P>
9320 If you have Folder Collections defined you may use
9321 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
9322 the collection being saved to.
9323 <P>
9324 If Tab Completion is enabled (it is enabled by default)
9325 you may type a Tab character to have Alpine complete the folder name for you.
9326 <P>
9327 If Partial Match Lists is enabled (it is enabled by default) you may type
9328 Ctrl-X to get a list of matches to the prefix you've typed in so far.
9329 <P>
9330 If the Ctrl-R subcommand is present that means you can decide to Delete or
9331 not Delete the message you are saving after you save it.
9332 The label on that key gives the action to switch to.
9333 If it says Delete and you type Ctrl-R the label displayed will change to
9334 No Delete and the source message will be deleted after the save. If it
9335 says No Delete and you type Ctrl-R the label displayed will change to
9336 Delete and the message will not be deleted.
9337 You can control the default for the Delete parameter with the
9338 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
9339 <P>
9340 Similarly, if the Ctrl-W subcommand is present that means you can decide
9341 to Preserve the order of the messages being saved or not.
9342 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
9343 will be in the same order as you see them in the source folder now.
9344 The opposite action (which is usually the default) is that you don't care
9345 about the order.
9346 The Saved messages may or may not be in the same order in the destination folder.
9347 There may be a performance penalty for choosing to save the messages in order.
9348 You can control the default for the Preserve Order parameter with the
9349 configuration feature
9350 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
9351
9352 <P>
9353 If you haven't disabled the Save Input History and you've already done a
9354 Save earlier in this session then you may use the Up and Down arrows to retrieve
9355 a folder name used in a previous Save.
9356
9357 <P>
9358 &lt;End of help on this topic&gt;
9359 </BODY>
9360 </HTML>
9361 ============= h_simple_index ========================
9362 <HTML>
9363 <HEAD>
9364 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
9365 </HEAD>
9366 <BODY>
9367 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
9368 <!--chtml if pinemode="function_key"-->
9369 <PRE>
9370 Navigating the List of Messages               General Alpine Commands
9371 -------------------------------               -----------------------
9372  F5   Move to previous message                 F1   Show this help text
9373  F6   Move to next message
9374  F7   Show previous screen of messages
9375  F8   Show next screen of messages
9376
9377 Message Selection Commands
9378 --------------------------
9379  F3   Exit the Message Select menu (canceling Send command)
9380  F4   Select the currently highlighted message
9381  F9   Mark the currently highlighted message as deleted
9382  F10  Undelete (remove deletion mark from) the highlighted message
9383 </PRE>
9384 <!--chtml else-->
9385 <PRE>
9386 Navigating the List of Messages               General Alpine Commands
9387 -------------------------------               -----------------------
9388   P  Move to previous message                  ?  Show this help text
9389   N  Move to next message
9390   -  Show previous screen of messages
9391  Spc (space bar) Show next screen of messages
9392
9393 Message Selection Commands
9394 --------------------------
9395   E  Exit the Message Select menu (canceling Send command)
9396   S  Select the currently highlighted message
9397   D  Mark the currently highlighted message as deleted
9398   U  Undelete (remove deletion mark from) the highlighted message
9399 </PRE>
9400 <!--chtml endif-->
9401 <P>
9402 <H2>Description of the Select Postponed Message Screen</H2>
9403
9404 This screen allows you to select one of several previously postponed
9405 messages in order to continue composition.  Your options are very limited
9406 -- the screen is not meant to let you manipulate these messages.  However,
9407 you may now delete messages from this list.  Once you choose a message,
9408 Alpine reads it in and puts you into the regular message composer.
9409 <P>
9410
9411 Messages do not stay in this postponed state automatically.  If you select
9412 a message and then want to postpone it again, use the normal postpone
9413 (Ctrl-O) command in the composer.
9414 <P>
9415
9416 If you exit this screen without selecting a message, the Compose command
9417 that got you here is canceled.  Other than messages explicitly marked
9418 &quot;Deleted&quot;, no messages will be removed.
9419
9420 <P>
9421 &lt;End of help on this topic&gt;
9422 </BODY>
9423 </HTML>
9424 ============= h_collection_screen ========================
9425 <HTML>
9426 <HEAD>
9427 <TITLE>COLLECTION LIST screen</TITLE>
9428 </HEAD>
9429 <BODY>
9430 <H1>COLLECTION LIST screen</H1>
9431
9432 The COLLECTION LIST screen is used to select one of your
9433 collection definitions to display the folders they contain.  See
9434 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
9435 detailed explanation of collections.<P>
9436
9437 To manage your collection definitions (Add, Change, Delete, etc.), use
9438 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
9439 MAIN MENU.
9440
9441 <P>
9442 &lt;End of help on this topic&gt;
9443 </BODY>
9444 </HTML>
9445 ============= h_collection_maint ========================
9446 <HTML>
9447 <HEAD>
9448 <TITLE>SETUP COLLECTION LIST screen</TITLE>
9449 </HEAD>
9450 <BODY>
9451 <H1>SETUP COLLECTION LIST screen</H1>
9452
9453 The SETUP COLLECTION LIST screen lets you manage your collection
9454 definitions.  See
9455 <A HREF="h_what_are_collections">Folder Collections Explained</A>
9456 for detailed explanation of collections.<P>
9457
9458 Maintenance commands include:
9459 <DL>
9460 <DT>Change
9461 <!--chtml if pinemode="function_key"-->
9462 (F4)
9463 <!--chtml else-->
9464 (C)
9465 <!--chtml endif-->
9466 </DT>
9467
9468 <DD>Modify attributes of the selected collection definition.
9469
9470 <DT>Add Cltn
9471 <!--chtml if pinemode="function_key"-->
9472 (F9)
9473 <!--chtml else-->
9474 (A)
9475 <!--chtml endif-->
9476 </DT>
9477
9478 <DD>Create a new collection definition.
9479 </DD>
9480
9481 <DT>Del Cltn
9482 <!--chtml if pinemode="function_key"-->
9483 (F10)
9484 <!--chtml else-->
9485 (D)
9486 <!--chtml endif-->
9487 </DT>
9488
9489 <DD>Delete the selected collection definition.<BR>
9490 NOTE: The folders and directories referred to by the
9491 collection definition are <EM>NOT</EM> deleted.  Folders must
9492 be deleted, if that's what you wish to do, from the
9493 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
9494 individual folders in a collection.
9495 </DD>
9496
9497 <DT>Shuffle
9498 <!--chtml if pinemode="function_key"-->
9499 (F11)
9500 <!--chtml else-->
9501 ($)
9502 <!--chtml endif-->
9503 </DT>
9504
9505 <DD>Change the order of the displayed collections.  Alpine will offer
9506 to move the currently selected collection one position UP
9507 or DOWN.
9508 </DD>
9509 </DL>
9510
9511 <P>
9512 &lt;End of help on this topic&gt;
9513 </BODY>
9514 </HTML>
9515 ============ h_what_are_collections ==========
9516 <HTML>
9517 <HEAD>
9518 <TITLE>Folder Collections Explained</TITLE>
9519 </HEAD>
9520 <BODY>
9521 <H1>Folder Collections Explained</H1>
9522
9523
9524 Those of you with simple mail configurations will just see a list of all the
9525 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
9526 The special folders for INBOX, sent mail and saved messages
9527 will appear at the top of the list.  All others are in alphabetical order.
9528 <P>
9529 If you
9530 or your system administrator have defined more than one collection or if
9531 you have a collection (for newsgroups or email folders) defined on your
9532 system, then you will see the COLLECTION LIST screen first when choosing
9533 FOLDER LIST from Alpine's MAIN MENU.
9534 <P>
9535 <H2>Why have multiple folder collections?</H2>
9536 <P>
9537 For Alpine users who only maintain email folders (and not too many) on one host,
9538 a single folder collection is probably sufficient.<P>
9539
9540 However, people who have more than one email account - for example, one
9541 at their university, and one with their personal Internet Service Provider -
9542 will have different sets of folders on different hosts, and they may want to
9543 access them all from the same installation of Alpine, rather than use different
9544 software and/or log into other hosts to manipulate messages in different
9545 accounts.  (If in doubt whether one of your email accounts can be accessed
9546 with Alpine, contact the technical support people for that account.)  Even people
9547 who have only one email account on one host, but have dozens or
9548 hundreds of email folders, may want to arrange these folders together in a
9549 meaningful way.<BR>
9550 That is where multiple collections come in.
9551
9552 <H2>Types of Collections</H2>
9553 <DL>
9554 <DT>INCOMING FOLDERS</DT>
9555 <DD>&quot;Incoming Message Folders&quot;
9556 is a special collection typically used to supplement your single INBOX.
9557 All the folders here are meant to be ones that receive incoming messages,
9558 which you intend to check more or less frequently.
9559 You may have multiple folders like this because you or your systems
9560 administrator have set up an external program or you may have set up
9561 Alpine to filter incoming
9562 messages into different folders, based on certain criteria such as
9563 sender, recipient, or subject; or because you have multiple accounts and
9564 wish to check their INBOXes easily.  This collection is established by
9565 setting the
9566 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
9567 feature in the SETUP CONFIGURATION screen, which is accessed from the
9568 MAIN MENU.
9569 </DD>
9570
9571 <DT>NEWS</DT>
9572 <DD>You can also define a collection specifically for
9573 newsgroups.  Alpine does this for you implicitly when you
9574 <A HREF="h_config_nntp_server">define an NNTP Server</A>
9575 in your Alpine configuration.  The news collection appears last in the
9576 COLLECTION LIST (though you can shuffle it up in the order of presentation),
9577 and Alpine knows not to save messages there.
9578 </DD>
9579
9580 <DT>DEFAULT COLLECTION</DT>
9581 <DD>This is the default collection for your saved and sent messages folders.
9582 </DD>
9583 </DL>
9584
9585 <P>
9586
9587 <H2>Defining Collections</H2>
9588 <P>
9589 In the absence of any folder-collection definitions, Alpine will assume a
9590 single default folder collection.
9591 <!--chtml if pinemode="os_windows"-->
9592 <!--chtml else-->
9593 If necessary, Alpine will create the directory
9594 &quot;mail&quot; in your Unix home directory
9595 to hold your folders.
9596 <!--chtml endif-->
9597 <P>
9598 You can use the
9599 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
9600 the MAIN MENU, to manage your collection list.
9601 <P>
9602 &lt;End of help on this topic&gt;
9603 </BODY>
9604 </HTML>
9605 ===== h_select_address_screen =====
9606 <HTML>
9607 <HEAD>
9608 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
9609 </HEAD>
9610 <BODY>
9611 <H1>SELECT AN ADDRESS SCREEN</H1>
9612 <H2>COMMANDS</H2>
9613 <!--chtml if pinemode="function_key"-->
9614 <PRE>
9615 Available  Commands
9616 -------------------------------
9617 F1  Show Help Text
9618 F3  Exit without selecting anything
9619 F4  Select the highlighted address
9620 F5  Move highlight to previous address
9621 F6  Move highlight to next address
9622 F7  Previous page of addresses
9623 F8  Next page of addresses
9624 F11 Print
9625 F12 WhereIs
9626 </PRE>
9627 <!--chtml else-->
9628 <PRE>
9629 Navigation                     General Alpine Commands
9630 -------------------------      -----------------------
9631  P  Prev Address                ?  Display this help text
9632  N  Next Address                E  Exit without selecting anything
9633  -  Previous page               %  Print
9634 Spc (space bar) Next page
9635  W  WhereIs
9636
9637 Select Command
9638 ------------------------------------------------
9639  S  Select the highlighted address
9640 </PRE>
9641 <!--chtml endif-->
9642
9643 <H2>Description of the Select Address Screen</H2>
9644
9645 This screen gives you an easy way to select an address from all of
9646 the address book entries that match the prefix typed so far.
9647
9648 <P><UL>
9649 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9650 </UL>
9651 <P>
9652 &lt;End of help on this topic&gt;
9653 </BODY>
9654 </HTML>
9655 ===== h_select_rule_screen =====
9656 <HTML>
9657 <HEAD>
9658 <TITLE>SELECT A RULE SCREEN</TITLE>
9659 </HEAD>
9660 <BODY>
9661 <H1>SELECT A RULE SCREEN</H1>
9662 <H2>COMMANDS</H2>
9663 <!--chtml if pinemode="function_key"-->
9664 <PRE>
9665 Available  Commands
9666 -------------------------------
9667 F1  Show Help Text
9668 F3  Exit without selecting anything
9669 F4  Select the highlighted rule
9670 F5  Move highlight to previous rule
9671 F6  Move highlight to next rule
9672 F7  Previous page of rules
9673 F8  Next page of rules
9674 F11 Print
9675 F12 WhereIs
9676 </PRE>
9677 <!--chtml else-->
9678 <PRE>
9679 Navigation                     General Alpine Commands
9680 -------------------------      -----------------------
9681  P  Prev Rule                   ?  Display this help text
9682  N  Next Rule                   E  Exit without selecting anything
9683  -  Previous page               %  Print
9684 Spc (space bar) Next page
9685  W  WhereIs
9686
9687 Select Command
9688 ------------------------------------------------
9689  S  Select the highlighted rule
9690 </PRE>
9691 <!--chtml endif-->
9692
9693 <H2>Description of the Select Rule Screen</H2>
9694
9695 This screen just gives you an easy way to select a rule from all of your
9696 defined rules.
9697 The list of rules presented is the list of nicknames of all of the rules
9698 defined using Setup/Rules.
9699 For selecting messages, it is likely that the Indexcolor rules and possibly
9700 the Roles rules will be most useful.
9701 The others are there also, in case you find a use for them.
9702 <P>
9703 In order for this to be useful for selecting messages, the nicknames of
9704 the rules have to be different.
9705 Alpine actually just gets the nickname of the rule that you select and then
9706 looks up that rule using the nickname.
9707 So if there are duplicate nicknames, the first rule that has that
9708 nickname will be used.
9709
9710 <P><UL>
9711 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9712 </UL>
9713 <P>
9714 &lt;End of help on this topic&gt;
9715 </BODY>
9716 </HTML>
9717 ===== h_select_priority_screen =====
9718 <HTML>
9719 <HEAD>
9720 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
9721 </HEAD>
9722 <BODY>
9723 <H1>SELECT A PRIORITY SCREEN</H1>
9724 <H2>COMMANDS</H2>
9725 <!--chtml if pinemode="function_key"-->
9726 <PRE>
9727 Available  Commands
9728 -------------------------------
9729 F1  Show Help Text
9730 F3  Exit without selecting anything
9731 F4  Select the highlighted priority
9732 F5  Move highlight to previous priority
9733 F6  Move highlight to next priority
9734 F7  Previous page of priorities
9735 F8  Next page of priorities
9736 F11 Print
9737 F12 WhereIs
9738 </PRE>
9739 <!--chtml else-->
9740 <PRE>
9741 Navigation                     General Alpine Commands
9742 -------------------------      -----------------------
9743  P  Prev Priority               ?  Display this help text
9744  N  Next Priority               E  Exit without selecting anything
9745  -  Previous page               %  Print
9746 Spc (space bar) Next page
9747  W  WhereIs
9748
9749 Select Command
9750 ------------------------------------------------
9751  S  Select the highlighted priority
9752 </PRE>
9753 <!--chtml endif-->
9754
9755 <H2>Description of the Select Priority Screen</H2>
9756
9757 This screen gives you a way to select a priority for the message you are sending.
9758 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
9759 Some mail programs will display an indication of the priority level to
9760 the recipient of the message, some will ignore it.
9761 Even in cases where the mail programs of both the sender and the recipient
9762 agree on the meaning of this header, keep in mind that it is
9763 something that the sender sets so it is only an indication
9764 of the priority that the sender attaches to the mail.
9765 Alpine can be made to display an indication of this priority in incoming
9766 messages by use of one of the tokens
9767 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
9768 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
9769 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
9770
9771 <P><UL>
9772 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9773 </UL>
9774 <P>
9775 &lt;End of help on this topic&gt;
9776 </BODY>
9777 </HTML>
9778 ===== h_select_keyword_screen =====
9779 <HTML>
9780 <HEAD>
9781 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
9782 </HEAD>
9783 <BODY>
9784 <H1>SELECT A KEYWORD SCREEN</H1>
9785 <H2>COMMANDS</H2>
9786 <!--chtml if pinemode="function_key"-->
9787 <PRE>
9788 Available  Commands
9789 -------------------------------
9790 F1  Show Help Text
9791 F3  Exit without selecting anything
9792 F4  Select the highlighted keyword
9793 F5  Move highlight to previous keyword
9794 F6  Move highlight to next keyword
9795 F7  Previous page of keywords
9796 F8  Next page of keywords
9797 F11 Print
9798 F12 WhereIs
9799 </PRE>
9800 <!--chtml else-->
9801 <PRE>
9802 Navigation                     General Alpine Commands
9803 -------------------------      -----------------------
9804  P  Prev Keyword                ?  Display this help text
9805  N  Next Keyword                E  Exit without selecting anything
9806  -  Previous page               %  Print
9807 Spc (space bar) Next page
9808  W  WhereIs
9809
9810 Select Command
9811 ------------------------------------------------
9812  S  Select the highlighted keyword
9813 </PRE>
9814 <!--chtml endif-->
9815
9816 <H2>Description of the Select Keyword Screen</H2>
9817
9818 This screen just gives you an easy way to select a keyword.
9819 The list of keywords presented is the list of all keywords defined in your
9820 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9821 If you have given a keyword a nickname, that nickname is displayed
9822 instead of the actual keyword.
9823
9824 <P><UL>
9825 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9826 </UL>
9827 <P>
9828 &lt;End of help on this topic&gt;
9829 </BODY>
9830 </HTML>
9831 ===== h_select_charset_screen =====
9832 <HTML>
9833 <HEAD>
9834 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
9835 </HEAD>
9836 <BODY>
9837 <H1>SELECT A CHARACTER SET SCREEN</H1>
9838 <H2>COMMANDS</H2>
9839 <!--chtml if pinemode="function_key"-->
9840 <PRE>
9841 Available  Commands
9842 -------------------------------
9843 F1  Show Help Text
9844 F3  Exit without selecting anything
9845 F4  Select the highlighted character set
9846 F5  Move highlight to previous character set
9847 F6  Move highlight to next character set
9848 F7  Previous page of character sets
9849 F8  Next page of character sets
9850 F11 Print
9851 F12 WhereIs
9852 </PRE>
9853 <!--chtml else-->
9854 <PRE>
9855 Navigation                     General Alpine Commands
9856 -------------------------      -----------------------
9857  P  Prev Character Set          ?  Display this help text
9858  N  Next Character Set          E  Exit without selecting anything
9859  -  Previous page               %  Print
9860 Spc (space bar) Next page
9861  W  WhereIs
9862
9863 Select Command
9864 ------------------------------------------------
9865  S  Select the highlighted character set
9866 </PRE>
9867 <!--chtml endif-->
9868
9869 <H2>Description of the Select A Character Set Screen</H2>
9870
9871 This screen just gives you an easy way to select a character set from the
9872 set of character sets Alpine knows about.
9873 The list presented will vary slightly depending on what option you are
9874 selecting the character set for.
9875
9876 <P><UL>
9877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9878 </UL>
9879 <P>
9880 &lt;End of help on this topic&gt;
9881 </BODY>
9882 </HTML>
9883 ===== h_select_multcharsets_screen =====
9884 <HTML>
9885 <HEAD>
9886 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
9887 </HEAD>
9888 <BODY>
9889 <H1>SELECT CHARACTER SETS SCREEN</H1>
9890 <H2>COMMANDS</H2>
9891 <!--chtml if pinemode="function_key"-->
9892 <PRE>
9893 Available  Commands
9894 -------------------------------
9895 F1  Show Help Text
9896 F3  Exit without selecting anything
9897 F4  Select the highlighted charset (or chosen charsets in ListMode)
9898 F5  Move highlight to previous charset
9899 F6  Move highlight to next charset
9900 F7  Previous page of charsets
9901 F8  Next page of charsets
9902 F9  Toggle choices when using ListMode
9903 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
9904 F11 Print
9905 F12 WhereIs
9906 </PRE>
9907 <!--chtml else-->
9908 <PRE>
9909 Navigation                     General Alpine Commands
9910 -------------------------      -----------------------
9911  P  Prev Charset                ?  Display this help text
9912  N  Next Charset                E  Exit without selecting anything
9913  -  Previous page               %  Print
9914 Spc (space bar) Next page
9915  W  WhereIs
9916
9917 Select Command
9918 ------------------------------------------------
9919  S  Select the highlighted charset (or chosen charsets in ListMode)
9920  L  Turn on ListMode (makes it easy to choose multiple charsets)
9921  1  Turn off ListMode
9922  X  Toggle choices when using ListMode
9923 </PRE>
9924 <!--chtml endif-->
9925
9926 <H2>Description of the Select Character Set Screen</H2>
9927
9928 This screen just gives you an easy way to select a character set or a list of
9929 character sets.
9930 The list of character sets presented is the list of all character sets known to
9931 Alpine.
9932 You may select other character sets by typing them in directly.
9933
9934 <P><UL>
9935 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9936 </UL>
9937 <P>
9938 &lt;End of help on this topic&gt;
9939 </BODY>
9940 </HTML>
9941 ===== h_select_multkeyword_screen =====
9942 <HTML>
9943 <HEAD>
9944 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
9945 </HEAD>
9946 <BODY>
9947 <H1>SELECT KEYWORDS SCREEN</H1>
9948 <H2>COMMANDS</H2>
9949 <!--chtml if pinemode="function_key"-->
9950 <PRE>
9951 Available  Commands
9952 -------------------------------
9953 F1  Show Help Text
9954 F3  Exit without selecting anything
9955 F4  Select the highlighted keyword (or chosen keywords in ListMode)
9956 F5  Move highlight to previous keyword
9957 F6  Move highlight to next keyword
9958 F7  Previous page of keywords
9959 F8  Next page of keywords
9960 F9  Toggle choices when using ListMode
9961 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
9962 F11 Print
9963 F12 WhereIs
9964 </PRE>
9965 <!--chtml else-->
9966 <PRE>
9967 Navigation                     General Alpine Commands
9968 -------------------------      -----------------------
9969  P  Prev Keyword                ?  Display this help text
9970  N  Next Keyword                E  Exit without selecting anything
9971  -  Previous page               %  Print
9972 Spc (space bar) Next page
9973  W  WhereIs
9974
9975 Select Command
9976 ------------------------------------------------
9977  S  Select the highlighted keyword (or chosen keywords in ListMode)
9978  L  Turn on ListMode (makes it easy to choose multiple keywords)
9979  1  Turn off ListMode
9980  X  Toggle choices when using ListMode
9981 </PRE>
9982 <!--chtml endif-->
9983
9984 <H2>Description of the Select Keyword Screen</H2>
9985
9986 This screen just gives you an easy way to select a keyword or a list of
9987 keywords.
9988 The list of keywords presented is the list of all keywords defined in your
9989 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9990 If you have given a keyword a nickname, that nickname is displayed
9991 instead of the actual keyword.
9992
9993 <P><UL>
9994 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9995 </UL>
9996 <P>
9997 &lt;End of help on this topic&gt;
9998 </BODY>
9999 </HTML>
10000 ===== h_select_incoming_to_monitor =====
10001 <HTML>
10002 <HEAD>
10003 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
10004 </HEAD>
10005 <BODY>
10006 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
10007 <H2>COMMANDS</H2>
10008 <!--chtml if pinemode="function_key"-->
10009 <PRE>
10010 Available  Commands
10011 -------------------------------
10012 F1  Show Help Text
10013 F3  Exit without selecting anything
10014 F4  Select the marked folders
10015 F5  Move highlight to previous folder
10016 F6  Move highlight to next folder
10017 F7  Previous page of folders
10018 F8  Next page of folders
10019 F9  Toggle choices on or off
10020 F11 Print
10021 F12 WhereIs
10022 </PRE>
10023 <!--chtml else-->
10024 <PRE>
10025 Navigation                     General Alpine Commands
10026 -------------------------      -----------------------
10027  P  Prev Folder                 ?  Display this help text
10028  N  Next Folder                ^C  exit without changing anything
10029  -  Previous page               %  Print
10030 Spc (space bar) Next page
10031  W  WhereIs
10032
10033 Select Command
10034 ------------------------------------------------
10035  S  Select the marked folders
10036  X  Toggle choices on or off
10037 </PRE>
10038 <!--chtml endif-->
10039
10040 <H2>Description of the Select Folders to Check Screen</H2>
10041
10042 This screen is only useful if the feature
10043 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
10044 is set.
10045 By default, when you set that feature all of your incoming folders
10046 will be checked periodically for Unseen messages.
10047 By using this screen, you may restrict the set of monitored folders to
10048 a subset of all of the incoming folders.
10049 <P>
10050 Mark the folders you want to monitor for Unseen messages with
10051 an &quot;X&quot;.
10052 When you've finished marking all your selections use the Select
10053 command to register your choices.
10054 To return to the default of checking all incoming folders
10055 delete all folders or unmark all folders.
10056
10057 <P><UL>
10058 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10059 </UL>
10060 <P>
10061 &lt;End of help on this topic&gt;
10062 </BODY>
10063 </HTML>
10064 ===== h_role_select =====
10065 <HTML>
10066 <HEAD>
10067 <TITLE>ROLES SCREEN</TITLE>
10068 </HEAD>
10069 <BODY>
10070 <H1>ROLES SCREEN</H1>
10071 <H2>ROLES COMMANDS</H2>
10072 <!--chtml if pinemode="function_key"-->
10073 <PRE>
10074 Available  Commands
10075 -------------------------------
10076 F1  Show Help Text
10077 F3  Exit without a selection
10078 F4  Select a role to use in composition
10079 F5  Move to previous role
10080 F6  Move to next role
10081 F7  Previous page of roles
10082 F8  Next page of roles
10083 F11 Change Default Role
10084 F12 Whereis (search role nicknames)
10085 </PRE>
10086 <!--chtml else-->
10087 <PRE>
10088 Navigation                     General Alpine Commands
10089 -------------------------      -----------------------
10090  P  Prev Role                     ?  Display this help text
10091  N  Next Role                     E  Exit without a selection
10092  -  Previous page
10093 Spc (space bar) Next page
10094  W  WhereIs (search for word in role nicknames)
10095
10096 Select Role Commands
10097 ------------------------------------------------
10098  [Return]  Select highlighted role
10099  D         Change Default Role
10100 </PRE>
10101 <!--chtml endif-->
10102
10103 <H2>Description of the Roles Screen</H2>
10104
10105 With this screen you select a role to be used in the composition of a
10106 message.
10107 Use the Previous and Next commands to highlight the role you wish to
10108 use.
10109 When you type carriage return you will be placed in the composer using the highlighted role.
10110 <P>
10111 You don't have any non-default <A HREF="h_rules_roles">roles</A>
10112 available unless you set them up.
10113 You may do so by using the Setup/Rules command on the MAIN MENU.
10114 <P>
10115 By using the D command, you may set a default role that will persist until
10116 you change it or until you exit Alpine.
10117 The D command toggles through three states: set the default role, unset the
10118 default role, and leave the default role as it is.
10119 <P><UL>
10120 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10121 </UL>
10122 <P>
10123 &lt;End of help on this topic&gt;
10124 </BODY>
10125 </HTML>
10126 ===== h_role_abook_select =====
10127 <HTML>
10128 <HEAD>
10129 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
10130 </HEAD>
10131 <BODY>
10132 <H1>SELECT ADDRESS BOOK SCREEN</H1>
10133 <H2>COMMANDS</H2>
10134 <!--chtml if pinemode="function_key"-->
10135 <PRE>
10136 Available  Commands
10137 -------------------------------
10138 F1  Show Help Text
10139 F3  Exit screen without selecting anything
10140 F4  Select highlighted address book
10141 F5  Move to previous address book
10142 F6  Move to next address book
10143 F7  Previous page of address books
10144 F8  Next page of address books
10145 F12 Whereis
10146 </PRE>
10147 <!--chtml else-->
10148 <PRE>
10149 Navigation                     General Alpine Commands
10150 -------------------------      -----------------------
10151  P  Previous addrbook          ?  Display this help text
10152  N  Next addrbook
10153  -  Previous page
10154 Spc (space bar) Next page
10155  W  WhereIs
10156
10157 Select Role Commands
10158 ------------------------------------------------
10159  S  Select highlighted address book
10160  E  Exit screen without selecting anything
10161 </PRE>
10162 <!--chtml endif-->
10163
10164 <H2>Description of the Select Address Book Screen</H2>
10165
10166 This screen helps you select one of your address books.
10167 Use the Previous and Next commands to highlight the address book you wish to
10168 select.
10169 <P><UL>
10170 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10171 </UL>
10172 <P>
10173 &lt;End of help on this topic&gt;
10174 </BODY>
10175 </HTML>
10176 ======== h_rule_patterns =============
10177 <HTML>
10178 <HEAD>
10179 <TITLE>PATTERNS</TITLE>
10180 </HEAD>
10181 <BODY>
10182 <H1>PATTERNS</H1>
10183 Patterns are used with Roles, Filtering, Index Coloring,
10184 Scoring, Other Rules, and Search Rules.
10185 Patterns are compared with a message to see if there is a match.
10186 For Filtering, the messages being checked are all the messages in the
10187 folder, one at a time.
10188 For Index Line Coloring, each message that is visible on the screen is
10189 checked for matches with the Index Coloring Patterns.
10190 Roles are used with the Reply, Forward, and Compose commands.
10191 For Reply, the message used to compare the Pattern with is the message
10192 being replied to;
10193 for Forward, the message used to compare the Pattern with is the message
10194 being forwarded;
10195 and for Compose, there is no message, so the parts of the Pattern that depend
10196 on a message (everything other than Current Folder Type and the
10197 Beginning of Month and Year)
10198 are not used.
10199 Only the Current Folder Type matters for Compose (plus the Beginning of
10200 Month or Year, which you wouldn't usually use for a Role).
10201 For Scoring, the message being scored is compared with all of the Score
10202 Patterns, and the Score Values from the ones that match are added together to
10203 get the message's score.
10204 For Other Rules, there is no message. Only the Current Folder Type is checked
10205 for Other Rules.
10206 <P>
10207 Each Pattern has several possible parts, all of which are optional.
10208 In order for there to be a match, <EM>ALL</EM> of the
10209 <EM>defined</EM> parts of the Pattern must match the message.
10210 If a part is not defined it is considered a match, but note that a filtering
10211 Pattern must have at least one defined part or it will be ignored.
10212 For example, if the To pattern is not defined it will be
10213 displayed as
10214 <P>
10215 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
10216 <P>
10217 That is considered a match because it is not defined.
10218 This means that the Pattern with nothing defined is a match if the
10219 Current Folder Type matches, but there is an exception that was mentioned
10220 in the previous paragraph.
10221 Because filtering is a potentially destructive action, filtering Patterns
10222 with nothing other than Current Folder Type defined are ignored.
10223 If you really want a filtering Pattern to match all messages (subject to
10224 Current Folder Type) the best way to do it is to define a Score interval
10225 that includes all possible scores.
10226 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
10227 This can be used even if you haven't defined any rules to Set Scores.
10228 <P>
10229 There are six predefined header patterns called the To, From, Sender, Cc, News,
10230 and Subject patterns.
10231 Besides those six predefined header patterns, you may add
10232 additional header patterns with header fieldnames of your choosing.
10233 You add an extra header pattern by placing the cursor on one of the
10234 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
10235 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
10236 and the Partic pattern is a header pattern that stands for
10237 Participant (From OR To OR Cc).
10238 (Defining the Recip pattern does not have the same effect as defining both
10239 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
10240 Similar to the header patterns are the AllText pattern and the BodyText pattern.
10241 Instead of comparing this pattern's text against only the contents of
10242 a particular header field, the text for the AllText pattern is compared
10243 with text anywhere in the message's header or body, and the text for the
10244 BodyText pattern is compared with text anywhere in the message's body.
10245 <P>
10246 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
10247 &quot;!&quot; &quot;toggle NOT&quot; command.
10248 You can tell that <EM>NOT</EM> has been turned on by looking for the character
10249 &quot;!&quot; at the beginning of the pattern line.
10250 When the &quot;!&quot; is present, it reverses the meaning of the match.
10251 That is, if the pattern matches then it is considered to NOT be a match, and
10252 if it does not match it is considered to be a match.
10253 <P>
10254 Don't make the mistake of putting the &quot;!&quot; in the data field for
10255 a pattern.
10256 For example, if you type the characters &quot;!urgent&quot; into the Subject
10257 pattern, the pattern will look like:
10258 <P>
10259 <PRE>
10260  Subject pattern = !urgent
10261 </PRE>
10262 <P>
10263 This means you want to match the 7 character sequence &quot;!urgent&quot;.
10264 In order to match messages that do not have &quot;urgent&quot; in
10265 their Subject field, first type the characters &quot;urgent&quot; followed
10266 by carriage return for the value of the Subject pattern, then negate it
10267 by typing the &quot;!&quot; command.
10268 It should look like
10269 <P>
10270 <PRE>
10271  ! Subject pattern = urgent
10272 </PRE>
10273 <P>
10274 The contents of each of these header patterns (or the AllText or BodyText patterns) may
10275 be a complete email address, part of an address, or a random set of
10276 characters to match against.
10277 It may also be a list of such patterns, which means you
10278 are looking for a match against the first pattern in the list <EM>OR</EM>
10279 the second pattern <EM>OR</EM> the third and so on.
10280 For example, a Subject pattern equal to
10281 <P>
10282 <PRE>
10283  Subject pattern = urgent
10284                    emergency
10285                    alert
10286 </PRE>
10287 <P>
10288 would match all messages with a subject that contained at least one
10289 of those words.
10290 It would also match subjects containing the words &quot;alerts&quot; or
10291 &quot;Urgently&quot;.
10292 <P>
10293 The same example with &quot;NOT&quot; turned on would be
10294 <P>
10295 <PRE>
10296  ! Subject pattern = urgent
10297                      emergency
10298                      alert
10299 </PRE>
10300 <P>
10301 which would match all messages with a subject that did <EM>NOT</EM> contain any of
10302 those words.
10303 You can use the &quot;Add Value&quot; command to add new words to the list,
10304 or you can enter them as a comma-separated list.
10305 <P>
10306 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
10307 present for a match.
10308 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
10309 pattern2 must be present,
10310 and that is exactly what using a list does.)
10311 <P>
10312 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
10313 also part of the Pattern, although the &quot;Score Interval&quot; is not used
10314 when checking for matches for Scoring.
10315 There are five similar settings that relate to the status of the message.
10316 These settings rely on the message being New or not, Deleted or not,
10317 Answered or not, Important or not, and Recent or not.
10318 There are also some other miscellaneous settings.
10319 The first is the Age of the message in days.
10320 Another is the Size of the message, in bytes.
10321 The third is a setting that detects whether or not the Subject of a
10322 message contains raw 8-bit characters (unencoded characters with the most
10323 significant bit set).
10324 There is a setting that detects whether or not this is the first time
10325 Alpine has been run this month (doesn't depend on individual messages),
10326 and another that detects whether or not this is the first time Alpine has
10327 been run this year.
10328 Other parts of the Pattern detect whether or not the From address of a
10329 message appears in your address book, whether or not certain keywords
10330 are set for a message, and whether or not certain character sets are
10331 used in a message.
10332
10333 <H2>Parts of a Pattern</H2>
10334
10335 <H3>Header patterns</H3>
10336
10337 A header pattern is simply text that is searched for in the corresponding
10338 header field.
10339 For example, if a Pattern has a From header pattern with the value
10340 &quot;@company.com&quot;, then only messages that have a From header
10341 that contains the text &quot;@company.com&quot; will be possible
10342 matches.
10343 Matches don't have to be exact.
10344 For example, if the relevant field of a message contains the text
10345 &quot;mailbox@domain&quot; somewhere
10346 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
10347 &quot;mailbox@domain&quot; are all matches.
10348 <P>
10349 All parts of the Pattern must match so, for example,
10350 if a message matches a defined
10351 From pattern, it still must be checked against the other parts of the
10352 Pattern that have been defined.
10353 The To header pattern is a slightly special case.
10354 If the message being checked has a Resent-To header
10355 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
10356 there are used in place of the addresses in the To header.
10357 This is only true for the To header.
10358 Resent-cc and Resent-From headers are never used unless you add them
10359 with the eXtraHdrs command.
10360 <P>
10361 The meaning of a header pattern may be negated with the
10362 &quot;!&quot; &quot;toggle NOT&quot; command.
10363 You can tell that <EM>NOT</EM> has been turned on by looking for the character
10364 &quot;!&quot; at the beginning of the pattern line.
10365 It would look something like
10366 <P>
10367 <PRE>
10368  ! From pattern = susan@example.com
10369 </PRE>
10370 <P>
10371 When the &quot;!&quot; is present, it reverses the meaning of the match.
10372 <P>
10373 If you want to check for the presence of a header field but don't care
10374 about its value, then
10375 the empty pattern that you get by entering a pair of
10376 double quotes (&quot;&quot;) should match any message that
10377 has the corresponding header field.
10378
10379 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
10380
10381 AllText patterns are just like header patterns except that the text is
10382 searched for anywhere in the message's headers or body, not just in the
10383 contents of a particular header field.
10384 <P>
10385
10386 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
10387
10388 BodyText patterns are just like header patterns except that the text is
10389 searched for anywhere in the message's body, not just in the
10390 contents of a particular header field.
10391 <P>
10392
10393 If there is more than one header pattern or AllText pattern or BodyText pattern
10394 for which you want to take the
10395 same action there is a shorthand notation that may be used.
10396 Any of these patterns may be a list of patterns instead of
10397 just a single pattern.
10398 If any one of the patterns in the list matches the message
10399 then it is considered a match.
10400 For example, if &quot;company1&quot; and &quot;company2&quot; both required
10401 you to use the same role when replying to messages, you might have
10402 a To pattern that looks like
10403 <P>
10404 <PRE>
10405  To pattern = company1.com
10406               company2.com
10407 </PRE>
10408 <P>
10409 This means that if the mail you are replying to was addressed to
10410 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
10411 then this Pattern is a match and the same actions will be taken.
10412 <P>
10413 The meaning of an AllText or BodyText pattern may be negated with the
10414 &quot;!&quot; &quot;toggle NOT&quot; command.
10415 You can tell that <EM>NOT</EM> has been turned on by looking for the character
10416 &quot;!&quot; at the beginning of the pattern line.
10417 When the &quot;!&quot; is present, it reverses the meaning of the match.
10418 <P>
10419 A technicality: Since comma is the character used to separate multiple values
10420 in any of the fields that may have multiple values (such as header patterns,
10421 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
10422 you must escape comma with a
10423 backslash (&#92;) if you want to include a literal comma in one of those fields.
10424 In other words, if you type a backslash followed by a comma it will
10425 be interpreted as a comma by Alpine, instead of as a separator between
10426 pattern values.
10427 All other backslashes (those not followed by a comma) are literal
10428 backslashes and should not be escaped.
10429 It's unlikely you'll ever need to enter a literal comma or backslash in
10430 any of the patterns.
10431
10432 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
10433
10434 The &quot;Current Folder Type&quot; may be set to one of four different
10435 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
10436 &quot;Specific&quot;.
10437 If the value is set to &quot;News&quot;, then the
10438 Pattern will only match if the currently open folder is a newsgroup.
10439 The value &quot;Email&quot; only matches if the current folder is not news and
10440 the value &quot;Any&quot; causes any folder to match.
10441 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
10442 then you must fill in a value for &quot;Folder&quot;, which is on the line
10443 below the &quot;Specific&quot; line.
10444 In this case you will only get a match if the currently open folder is
10445 the specific folder you list.
10446 You may give a list of folders instead of just a single
10447 folder name, in which case the Pattern will match if the open folder is
10448 any one of the folders in the list.
10449 The name of each folder in the list may be either &quot;INBOX&quot;,
10450 the technical specification
10451 of the folder (like what appears in your configuration file) or, if the
10452 folder is one of your incoming folders, it may be the nickname you've given
10453 the folder.
10454 Here are some samples of specific folder names:
10455 <P>
10456 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
10457 <P>
10458 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
10459 <P>
10460 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
10461 <P>
10462 The easiest way to fill in the &quot;Folder&quot; field is to use
10463 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
10464 highlighted, or to use the &quot;Take&quot; command with the configuration
10465 feature
10466 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
10467 turned on.
10468 <P>
10469 When reading a newsgroup, there may be a performance penalty
10470 incurred when collecting the information necessary to check whether
10471 or not a Pattern matches a message.
10472 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
10473 If you have Patterns with a Current Folder Type of either
10474 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
10475 Index Line Coloring or Scoring, you may experience
10476 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
10477
10478 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
10479
10480 The &quot;Age Interval&quot; may be set to an interval of message
10481 ages that should be considered a match.
10482 Like the other parts of the Pattern, if it is unset it will be ignored.
10483 The Age Interval looks like
10484 <P>
10485 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
10486 <P>
10487 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
10488 than or equal to zero.
10489 The special value &quot;INF&quot; may be used for
10490 the max value. It represents infinity.
10491 <P>
10492 Actually, this option may be defined as a list of intervals instead
10493 of just a single interval.
10494 The list is separated by commas.
10495 It can look like
10496 <P>
10497 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
10498 <P>
10499 When there is an Age Interval defined, it is a match if the age, in days, of
10500 the message is contained in any of the intervals.
10501 The intervals include both endpoints.
10502 <P>
10503 Even though this option is called Age, it isn't actually
10504 the <EM>age</EM> of the message.
10505 Instead, it is how many days ago the message arrived in one of your folders.
10506 If the current time is a little past midnight, then a message that arrived
10507 just before midnight arrived yesterday, even though the message is only
10508 a few minutes old.
10509 By default, the date being used is not the date in the Date
10510 header of the message.
10511 It is the date that the message arrived in one of your folders.
10512 When you Save a message from one folder to another that arrival date
10513 is preserved.
10514 If you would like to use the date in the Date header that is possible.
10515 Turn on the option
10516 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
10517 near the bottom of the rule definition.
10518 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
10519
10520 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
10521
10522 The &quot;Size Interval&quot; may be set to an interval of message
10523 sizes that should be considered a match.
10524 Like the other parts of the Pattern, if it is unset it will be ignored.
10525 The Size Interval looks like
10526 <P>
10527 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
10528 <P>
10529 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
10530 than or equal to zero.
10531 The special value &quot;INF&quot; may be used for
10532 the max value. It represents infinity.
10533 <P>
10534 Actually, this option may be defined as a list of intervals instead
10535 of just a single interval.
10536 The list is separated by commas.
10537 It can look like
10538 <P>
10539 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
10540 <P>
10541 When there is a Size Interval defined, it is a match if the size, in bytes, of
10542 the message is contained in any of the intervals.
10543 The intervals include both endpoints.
10544
10545 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
10546
10547 The &quot;Score Interval&quot; may be set to an interval of message
10548 scores that should be considered a match.
10549 Like the other parts of the Pattern, if it is unset it will be ignored.
10550 The Score Interval looks like
10551 <P>
10552 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
10553 <P>
10554 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
10555 negative integers, with min_score less than or equal to max_score.
10556 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
10557 the min and max values to represent negative and positive infinity.
10558 <P>
10559 Actually, a list of intervals may be used if you wish.
10560 A list would look like
10561 <P>
10562 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
10563 <P>
10564 When there is a Score Interval defined, it is a match if the score for
10565 the message is contained in any of the intervals in the list.
10566 The intervals include the endpoints.
10567 The score for a message is calculated by looking at every Score rule defined and
10568 adding up the Score Values for the ones that match the message.
10569 When deciding whether or not a Pattern matches a message for purposes of
10570 calculating the score, the Score Interval is ignored.
10571
10572 <H3><A NAME="pattern_message_status">Message Status</A></H3>
10573
10574 There are five separate message status settings.
10575 By default, all five are set to the value &quot;Don't care&quot;, which
10576 will match any message.
10577 The value &quot;Yes&quot; means that the particular status must be true
10578 for a match, and the value &quot;No&quot; means that the particular
10579 status must not be true for a match.
10580 For example, one of the five Message Status settings is whether a message
10581 is marked Important or not.
10582 A &quot;Yes&quot; means that the message must be Important to be
10583 considered a match and &quot;No&quot; means that the message must not be
10584 Important to be considered a match.
10585 The same is true of the other four message status settings that depend
10586 on whether or not the message is New; whether the message has
10587 been Answered or not; whether the message has been Deleted or not, and
10588 whether the message is Recent or not.
10589 <P>
10590 The nomenclature for New and Recent is a bit confusing:
10591 <P>
10592 New means that the message is Unseen.
10593 It could have been in your mailbox for a long time but if you haven't looked
10594 at it, it is still considered New.
10595 That matches the default Alpine index display that shows an N for such a
10596 message.
10597 <P>
10598 Recent means that the message was added to this folder since the last time
10599 you opened the folder.
10600 Alpine also shows an N by default for these types of messages.
10601 If you were to run two copies of Alpine that opened a folder one right after
10602 the other, a message would only show up as Recent in (at most) the first
10603 Alpine session.
10604
10605 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
10606
10607 Keywords are similar to Message Status, but they are chosen by the user.
10608 Provided the mail server allows for it, you may add a set of possible keywords
10609 to a folder and then you may set those keywords or not for each message
10610 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
10611 The syntax of this part of the Pattern is similar to the header patterns.
10612 It is a list of keywords.
10613 The Keyword part of the Pattern is a match if the message has any of
10614 the keywords in the list set.
10615 Like other parts of the Pattern, if this is unset it will be ignored.
10616
10617 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
10618
10619 A message may use one or more character sets.
10620 This part of the Pattern matches messages that make use of one or more of
10621 the character sets specified in the pattern.
10622 It will be considered a match if a message uses any of the character
10623 sets in the list you give here.
10624
10625 <P>
10626 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
10627 GB2312) you may also use some shorthand names that Alpine provides.
10628 These names are more understandable shorthand names for sets of
10629 character set names.
10630 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
10631 Selecting one of these shorthand names is equivalent to selecting all of
10632 the character sets that make up the set.
10633 You can see all of these shorthand names and the lists of character sets
10634 they stand for by typing the &quot;T&quot; command with the Character
10635 Set pattern highlighted.
10636 The syntax of this part of the Pattern is similar to the header patterns
10637 and the Message Keywords pattern.
10638 It is a list of character sets (or shorthand names).
10639 The Character Set part of the Pattern is a match if the message uses any
10640 of the character sets in the list.
10641 Like other parts of the Pattern, if this is unset it will be ignored.
10642
10643 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
10644
10645 It seems that lots of unwanted email contains unencoded 8-bit characters
10646 in the Subject.
10647 Normally, characters with the 8th bit set are not allowed in the Subject
10648 header unless they are MIME-encoded.
10649 This option gives you a way to match messages that have Subjects that
10650 contain unencoded 8-bit characters.
10651 By default, the value of this option is &quot;Don't care&quot;, which
10652 will match any message.
10653 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
10654 the Subject of the message in order for there to be a match,
10655 and the value &quot;No&quot; is the opposite.
10656 Setting this option will affect performance in large folders because the
10657 subject of each message in the folder has to be checked.
10658
10659 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
10660
10661 This option gives you a way to take some action once per month.
10662 By default, the value of this option is &quot;Don't care&quot;, which
10663 will always match.
10664 The value &quot;Yes&quot; means that this must be the first time Alpine has
10665 been run this month in order to count as a match,
10666 and the value &quot;No&quot; is the opposite.
10667
10668 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
10669
10670 This option gives you a way to take some action once per year.
10671 By default, the value of this option is &quot;Don't care&quot;, which
10672 will always match.
10673 The value &quot;Yes&quot; means that this must be the first time Alpine has
10674 been run this year in order to count as a match,
10675 and the value &quot;No&quot; is the opposite.
10676
10677 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
10678
10679 This option gives you a way to match messages that have an address
10680 that is in one of your address books.
10681 Only the simple entries in your address books are searched.
10682 Address book distribution lists are ignored!
10683 By default, the value of this option is &quot;Don't care&quot;, which
10684 will match any message.
10685 The value &quot;Yes, in any address book&quot; means the address
10686 from the message must be in at least one of your
10687 address books in order to be a match.
10688 The value &quot;No, not in any address book&quot;
10689 means none of the addresses may
10690 be in any of your address books in order to be a match.
10691 The values &quot;Yes, in specific address books&quot; and
10692 &quot;No, not in any of specific address books&quot; are similar but instead
10693 of depending on all address books you are allowed to give a list of address
10694 books to look in.
10695 The addresses from the message that are checked for are determined by the
10696 setting you have for &quot;Types of addresses to check for in address book&quot;.
10697 If you set this to &quot;From&quot; the From address from the message will
10698 be looked up in the address book.
10699 If you set it to only &quot;To&quot; then the To addresses will be used.
10700 If any of the To addresses are in the address book then it is considered
10701 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
10702 You could set it to both From and To, in which case all of the From and To
10703 addresses are used.
10704 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
10705 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
10706 exists or the From address if there is no Reply-To address.
10707 Same for the Sender address.
10708 Setting this option may affect performance in large folders because the
10709 From and Reply-To of each message in the folder have to be checked.
10710
10711 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
10712
10713 This is a command that is run with its standard input set to the message
10714 being checked and its standard output discarded.
10715 The full directory path should be specified.
10716 The command will be run and then its exit status will be checked against
10717 the Exit Status Interval, which defaults to just the value zero.
10718 If the exit status of the command falls in the interval, it is considered
10719 a match, otherwise it is not a match.
10720 <P>
10721
10722 This option may actually be a list of commands.
10723 The first one that exists and is executable is used.
10724 That makes it possible to use the same configuration with Unix Alpine and
10725 PC-Alpine.
10726 <P>
10727
10728 If none of the commands in the list exists and is executable then the rule
10729 is <EM>not</EM> a match.
10730 If it is possible that the command may not exist, you should be careful
10731 to structure your rules so that nothing destructive
10732 happens when the command does not exist.
10733 For example, you might have a filter that filters away spam when there is
10734 a match but does nothing when there is not a match.
10735 That would continue to work correctly if the command didn't exist.
10736 However, if you have a filter that filters away spam when there is not
10737 a match and keeps it when there is a match, that would filter everything
10738 if the categorizer command didn't exist.
10739 <P>
10740 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
10741 setup for the bogofilter filter.
10742
10743 <P>
10744 &lt;End of help on this topic&gt;
10745 </BODY>
10746 </HTML>
10747 ===== h_rules_roles =====
10748 <HTML>
10749 <HEAD>
10750 <TITLE>SETUP ROLES SCREEN</TITLE>
10751 </HEAD>
10752 <BODY>
10753 <H1>SETUP ROLES SCREEN</H1>
10754 <H2>SETUP ROLES COMMANDS</H2>
10755 <!--chtml if pinemode="function_key"-->
10756 <PRE>
10757 Available  Commands -- Group 1         Available Commands -- Group 2
10758 -------------------------------        ------------------------------
10759 F1  Show Help Text                      F1  Show Help Text
10760 F2  See commands in next group          F2  See commands in next group
10761 F3  Back to MAIN Alpine menu
10762 F4  Change configuration for role
10763 F5  Move to previous role               F5  Include file in role config
10764 F6  Move to next role                   F6  Exclude file from config
10765 F7  Previous page of roles
10766 F8  Next page of roles
10767 F9  Add new role                        F9  Replicate existing role
10768 F10 Delete existing role
10769 F11 Shuffle the order of roles
10770 F12 Whereis (search role nicknames)
10771 </PRE>
10772 <!--chtml else-->
10773 <PRE>
10774 Navigation                     General Alpine Commands
10775 -------------------------      -----------------------
10776  P  Prev Role                     ?  Display this help text
10777  N  Next Role                     E  Back to MAIN Alpine menu
10778  -  Previous page
10779 Spc (space bar) Next page
10780  W  WhereIs (search for word in role nicknames)
10781
10782 Setup Roles Commands
10783 ------------------------------------------------
10784  A  Add new role                  $  Shuffle the order of roles
10785  D  Delete existing role          C  Change configuration for highlighted role
10786  R  Replicate existing role
10787  I  Include file in role config   X  Exclude file from role config
10788 </PRE>
10789 <!--chtml endif-->
10790
10791 <H2>Description of the Setup Roles Screen</H2>
10792
10793 This screen lets you add, delete, modify, or change the order of the rules
10794 that determine the role you are playing when composing a message.
10795 <P>
10796 You may play different roles depending on who you are replying to.
10797 For example, if you are replying to a message addressed to help-desk you
10798 may be acting as a Help Desk Worker.
10799 That role may require that you use a different return address and/or
10800 a different signature.
10801 <P>
10802 Roles are optional.
10803 If you set up roles they work like this:  Each role has a set of
10804 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
10805 considered for a particular use; a &quot;Pattern&quot;,
10806 which is used to decide which of the eligible roles is used; and a set
10807 of &quot;Actions&quot;, which are taken when that role is used.
10808 When you reply to a message, the message you are replying to is compared
10809 with the Patterns of the roles marked as eligible for use when replying.
10810 The comparisons start with the first eligible role and keep going until there
10811 is a match.
10812 If a match is found, the matching role's Actions are taken.
10813 <P>
10814 It is also possible to set a default role and to change that role during
10815 your Alpine session.
10816 When you start Alpine no default role will be set.
10817 You may set or change the current default role by using the &quot;D&quot;
10818 command in the role selection screen.
10819 You'll see that screen while composing a message and being asked to select
10820 a role.
10821 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
10822 compose a message.
10823 You may find a default role useful if you normally perform the duties of one
10824 of your roles for a while, then you switch to another role and stay in the
10825 new role for another period of time.
10826 It may be easier than using the Role Command to select the role each time you
10827 compose a message.
10828
10829 <H2>Role Uses</H2>
10830
10831 There are three types of use to be configured;
10832 one for Replying, one for Forwarding, and one for Composing.
10833 These indicate whether or not you want a role to be considered when you
10834 type the Reply, Forward, or Compose commands.
10835 (The Role command is an alternate form of the Compose command, and it is
10836 not affected by these settings.)
10837 Each of these Use types has three possible values.
10838 The value &quot;Never&quot;
10839 means that the role will never be considered as a candidate for use with
10840 the corresponding command.
10841 For example, if you set a role's Reply Use to Never, then when you Reply to
10842 a message, that role won't even be considered.
10843 (That isn't quite true. If the message you are replying to matches some other
10844 role that requires confirmation,
10845 then there will be a ^T command available which allows you to select a role
10846 from all of your roles, not just the reply-eligible roles.)
10847 <P>
10848
10849 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
10850 both mean that you do want to consider this role when using the corresponding
10851 command.
10852 For either of these settings the role's Pattern will
10853 be checked to see if it matches the message.
10854 For Reply Use, the message used to compare the Pattern with is the message
10855 being replied to.
10856 For Forward Use, the message used to compare the Pattern with is the message
10857 being forwarded.
10858 For Compose Use, there is no message, so the parts of the Pattern that depend
10859 on a message (everything other than Current Folder Type) are ignored.
10860 In all cases, the Current Folder Type is checked if defined.
10861 If there is a match then this role will either be used without confirmation
10862 or will be the default when confirmation is asked for, depending on
10863 which of the two options is selected.
10864 If confirmation is requested, you will have a chance to
10865 choose No Role instead of the offered role, or to
10866 change the role to any one of your other roles (with the ^T command).
10867
10868 <H2>Role Patterns</H2>
10869
10870 In order to determine whether or not a message matches a role the message is
10871 compared with the Role's Pattern.
10872 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10873 Scoring, Other Rules, and Search Rules, so are described in only one place,
10874 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10875 <P>
10876 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
10877 a role that has all header patterns unset, the AllText pattern unset,
10878 the BodyText pattern unset,
10879 the Score Interval unset, and the Current Folder Type set to
10880 &quot;Any&quot; may be used as a default role.
10881 It should be put last in the list of roles since the matching
10882 starts at the beginning and proceeds until one of the roles is a match.
10883 If no roles at all match, then Alpine will
10884 use its regular methods of defining the role.
10885 If you wanted to, you could define a different &quot;default&quot; role
10886 for Replying, Forwarding, and Composing by setting the
10887 &quot;Use&quot; fields appropriately.
10888
10889 <H2>Role Actions</H2>
10890
10891 Once a role match is found, the role's Actions are taken.
10892 For each role there are several possible actions that may be defined.
10893 They are actions to set the From address, the Reply-To address,
10894 the Fcc, the Signature, the Template file, and Other Headers.
10895
10896 <H3>Set From</H3>
10897
10898 The From address is the address used on the From line of the message
10899 you are sending.
10900
10901 <H3>Set Reply-To</H3>
10902
10903 The Reply-To address is the address used on the Reply-To line of the message
10904 you are sending.
10905 You don't need a Reply-To address unless it is different from the From address.
10906
10907 <H3>Set Other Headers</H3>
10908
10909 If you want to set the value of the From or Reply-To headers, use
10910 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
10911 If you want to set the values of other headers, use this field.
10912 This field is similar to the
10913 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
10914 Each header you specify here must include the header tag
10915 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
10916 and may optionally include a value for that header.
10917 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
10918 for a header here will replace any value that already exists.
10919 For example, if you are Replying to a message there will be at least one
10920 address in the To header (the address you are Replying to).
10921 However, if you Reply using a role that sets the To header, that role's
10922 To header value will be used instead.
10923
10924 <H3>Set Fcc</H3>
10925
10926 The Fcc is used as the Fcc for the message you are sending.
10927
10928 <H3>Set Signature or Set LiteralSig</H3>
10929
10930 The Signature is the name of a file to be used as the signature file when
10931 this role is being used.
10932 If the name of the file has a vertical bar following it (|)
10933 then it is assumed that the file is a program that should be run to
10934 produce the signature.
10935 If the LiteralSig is set, then it is used instead of the signature file.
10936 LiteralSig is just a different way to store the signature.
10937 It is stored in the pine configuration file instead of in a separate
10938 signature file.
10939 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
10940 either in the role or as the default signature in the Setup/Config screen,
10941 then the signature file is ignored.
10942
10943 <H3>Set Template</H3>
10944
10945 A Template is the name of a file to be included in the message when this
10946 role is being used.
10947 If the name of the file has a vertical bar following it (|)
10948 then it is assumed that the file is a program that should be run to
10949 produce the template.
10950
10951 <P>
10952 Both signature files and template files may be stored remotely on an IMAP
10953 server.
10954 In order to do that you just give the file a remote name.
10955 This works just like the regular
10956 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
10957 option that is configured from the Setup/Configuration screen.
10958 A remote signature file name might look like:
10959 <P>
10960 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
10961 <P>
10962 Once you have named the remote signature or template file you create its
10963 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
10964 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
10965 line of the role editor.
10966
10967 <P>
10968 Both signature files and template files (or the output of signature programs
10969 and template file programs) may contain special tokens
10970 that are replaced with contents
10971 that depend on the message being replied to or forwarded.
10972 See the help for the individual fields inside the role editor for more
10973 information on tokens.
10974
10975 <H3>Use SMTP Server</H3>
10976
10977 If this field has a value, then it will be used as the SMTP server
10978 to send mail when this role is being used (unless the SMTP server variable
10979 is set in the system-wide fixed configuration file).
10980 It has the same semantics as the
10981 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
10982 variable in the Setup/Config screen.
10983 When you postpone the composition this SMTP server list will be saved
10984 with the postponed composition and it cannot be changed later.
10985 Because of that, you may want to make this a list of SMTP servers
10986 with the preferred server at the front of the list and alternate servers
10987 later in the list.
10988
10989 <P>
10990 If any of the actions are left unset, then the action depends on what
10991 is present in the &quot;Initialize settings using role&quot; field.
10992 If you've listed the nickname of another one of your roles there, then the
10993 corresponding action from that role will be used here.
10994 If that action is also blank, or if there is no nickname specified,
10995 then Alpine will do whatever it normally does to set these actions.
10996 This depends on other configuration options and features you've set.
10997
10998 <H2>Command Descriptions</H2>
10999
11000 <H3>Add</H3>
11001
11002 The Add command is used to add a new role definition to your set of
11003 roles.
11004 The new role will be added after the highlighted role.
11005
11006 <H3>Delete</H3>
11007
11008 The Delete command deletes the currently highlighted role.
11009
11010 <H3>Change</H3>
11011
11012 The Change command lets you edit the nickname, Uses, Pattern,
11013 and Actions of the currently highlighted role.
11014
11015 <H3>Shuffle</H3>
11016
11017 The Shuffle command allows you to change the order of the roles.
11018 You may move the currently highlighted role up or down in the list.
11019 The order of the roles is important since the roles are tested for a
11020 match starting with the first role and continuing until a match is found.
11021 You should place the roles with more specific Patterns near the beginning
11022 of the list, and those with more general Patterns near the end so that
11023 the more specific matches will happen when appropriate.
11024
11025 <H3>Replicate</H3>
11026
11027 The Replicate command is used to copy an existing role and modify it.
11028 The new role will be added after the highlighted role.
11029
11030 <H3>IncludeFile</H3>
11031
11032 The IncludeFile command allows you to add a roles file to your configuration.
11033 Usually, your roles will be contained in your Alpine configuration file.
11034 If you wish, some or all of your roles may be stored in a separate file.
11035 If a roles file already exists (maybe it was made by somebody else using
11036 Alpine), you may insert it before the currently highlighted role.
11037 You may also insert an empty file or a file that does not yet exist.
11038 Once you have an empty roles file in your configuration, you may use
11039 the Shuffle command to move roles into it.
11040 In fact, that's the only way to get the initial role into the file.
11041
11042 <H3>eXcludeFile</H3>
11043
11044 The eXcludeFile command removes a roles file from your roles configuration.
11045 A limitation of the program is that in order to exclude a roles file
11046 that file must have at least one role
11047 in it, otherwise you won't be able to highlight a line in the file.
11048 So you may have to add a dummy role to the file in order to exclude the file.
11049 <P><UL>
11050 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11051 </UL>
11052 <P>
11053 &lt;End of help on this topic&gt;
11054 </BODY>
11055 </HTML>
11056 ===== h_rules_other =====
11057 <HTML>
11058 <HEAD>
11059 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
11060 </HEAD>
11061 <BODY>
11062 <H1>SETUP OTHER RULES SCREEN</H1>
11063 <H2>SETUP OTHER RULES 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 Other Rules 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 Other Rules Screen</H2>
11101
11102 This is where you may set various actions that do not fit well into the
11103 other Rules categories.
11104
11105 <H2>Patterns</H2>
11106
11107 Other Rules are a little different from the rest of the Rules because
11108 they depend only on the current folder, and not on a particular message.
11109 In order to determine whether or not a rule's actions should be applied
11110 the current folder is compared with the rule's Pattern, which consists
11111 of only the Current Folder Type.
11112 Current Folder Type works the same for Other Rules as it does for Roles,
11113 Filtering, Index Coloring, and Scoring.
11114 Keep in mind that the only part of the Pattern that applies to Other
11115 Rules is the Current Folder Type when looking at the description of
11116 Patterns given
11117 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11118
11119 <H2>The Actions</H2>
11120
11121 <H3>Set Sort Order</H3>
11122
11123 When you enter a new folder, these rules will be checked to see if you
11124 have set a sort order that is different from your default sort order.
11125 The default is set in the Setup/Config screen with
11126 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
11127 If the Sort Order action is set, then the folder will be displayed sorted in
11128 that sort order instead of in the default order.
11129 <P>
11130 A possible point of confusion arises when you change the configuration
11131 of the Sort Order for the currently open folder.
11132 The folder will normally be re-sorted when you go back to viewing the
11133 index.
11134 However, if you have manually sorted the folder with the
11135 Sort
11136 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
11137 command, then it will not be re-sorted until the next time it is opened.
11138
11139 <H3>Set Index Format</H3>
11140
11141 When you enter a new folder, these rules will be checked to see if you
11142 have set an Index Format that is different from your default Index Format,
11143 which is set with the
11144 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
11145 If so, the index will be displayed with this format instead of the default.
11146
11147 <H3>Set Startup Rule</H3>
11148
11149 When you enter a new folder, these rules will be checked to see if you
11150 have set a startup rule that is different from the default startup rule.
11151 The default for incoming folders is set in the Setup/Config screen with
11152 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
11153 The default for folders other than INBOX that are not part of your
11154 incoming collection
11155 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
11156 is to start with the last message in the folder.
11157 If the Startup Rule is set to something other than &quot;default&quot;,
11158 then the rule will determine which message will be the current message when
11159 the folder is first opened.
11160 <P>
11161 The various startup rule possibilities work the same here as they do in
11162 the incoming collection, so check
11163 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
11164 for more help.
11165
11166 <H2>Command Descriptions</H2>
11167
11168 <H3>Add</H3>
11169
11170 The Add command is used to add a new rule definition to your set of
11171 rules.
11172 The new rule will be added after the highlighted rule.
11173
11174 <H3>Delete</H3>
11175
11176 The Delete command deletes the currently highlighted rule.
11177
11178 <H3>Change</H3>
11179
11180 The Change command lets you edit the nickname, Pattern,
11181 and Action of the currently highlighted rule.
11182
11183 <H3>Shuffle</H3>
11184
11185 The Shuffle command allows you to change the order of the rules.
11186 You may move the currently highlighted rule up or down in the list.
11187 The order of the rules is important since the rules are tested for a
11188 match starting with the first rule and continuing until a match is found.
11189 You should place the rules with more specific Patterns near the beginning
11190 of the list, and those with more general Patterns near the end so that
11191 the more specific matches will happen when appropriate.
11192
11193 <H3>Replicate</H3>
11194
11195 The Replicate command is used to copy an existing rule definition and modify it.
11196 The new rule will be added after the highlighted rule.
11197
11198 <H3>IncludeFile</H3>
11199
11200 The IncludeFile command allows you to add a rules file to your configuration.
11201 Usually, your rules will be contained in your Alpine configuration file.
11202 If you wish, some or all of your rules may be stored in a separate file.
11203 If a rules file already exists (maybe it was made by somebody else using
11204 Alpine), you may insert it before the currently highlighted rule.
11205 You may also insert an empty file or a file that does not yet exist.
11206 Once you have an empty rules file in your configuration, you may use
11207 the Shuffle command to move rules into it.
11208 In fact, that's the only way to get the initial rule into the file.
11209
11210 <H3>eXcludeFile</H3>
11211
11212 The eXcludeFile command removes a rules file from your rules configuration.
11213 A limitation of the program is that in order to exclude a rules file
11214 that file must have at least one rule
11215 in it, otherwise you won't be able to highlight a line in the file.
11216 So you may have to add a dummy rule to the file in order to exclude the file.
11217 <P><UL>
11218 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11219 </UL>
11220 <P>
11221 &lt;End of help on this topic&gt;
11222 </BODY>
11223 </HTML>
11224 ===== h_rules_srch =====
11225 <HTML>
11226 <HEAD>
11227 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
11228 </HEAD>
11229 <BODY>
11230 <H1>SETUP SEARCH RULES SCREEN</H1>
11231 <H2>SETUP SEARCH RULES COMMANDS</H2>
11232 <!--chtml if pinemode="function_key"-->
11233 <PRE>
11234 Available  Commands -- Group 1         Available Commands -- Group 2
11235 -------------------------------        ------------------------------
11236 F1  Show Help Text                      F1  Show Help Text
11237 F2  See commands in next group          F2  See commands in next group
11238 F3  Back to MAIN Alpine menu
11239 F4  Change configuration for rule
11240 F5  Move to previous rule               F5  Include file in rule config
11241 F6  Move to next rule                   F6  Exclude file from config
11242 F7  Previous page of rules
11243 F8  Next page of rules
11244 F9  Add new rule                        F9  Replicate existing rule
11245 F10 Delete existing rule
11246 F11 Shuffle the order of rules
11247 F12 Whereis (search rule nicknames)
11248 </PRE>
11249 <!--chtml else-->
11250 <PRE>
11251 Navigation                     General Alpine Commands
11252 -------------------------      -----------------------
11253  P  Prev rule                     ?  Display this help text
11254  N  Next rule                     E  Back to MAIN Alpine menu
11255  -  Previous page
11256 Spc (space bar) Next page
11257  W  WhereIs (search for word in rule nicknames)
11258
11259 Setup Search Rules Commands
11260 ------------------------------------------------
11261  A  Add new rule                  $  Shuffle the order of rules
11262  D  Delete existing rule          C  Change configuration for highlighted rule
11263  R  Replicate existing rule
11264  I  Include file in rule config   X  Exclude file from rule config
11265 </PRE>
11266 <!--chtml endif-->
11267
11268 <H2>Description of the Setup Search Rules Screen</H2>
11269
11270 One of the commands that becomes available when that feature is turned on
11271 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
11272 screen to select a set of messages.
11273 One way of selecting messages is to use a Rule.
11274 All of the messages that match (or don't match if you wish)
11275 a Rule's Pattern will be selected.
11276 <P>
11277 Any of your Rules may be used for this purpose.
11278 You might already have Rules set up for filtering, index line color, scores, or roles;
11279 and you may use any of those Rules with the Select command.
11280 However, you might find it more convenient to set up a separate set of Rules
11281 just for this purpose without having to worry about what other effects
11282 they may cause.
11283 That is the purpose of these Select Rules.
11284
11285 <P>
11286 Each rule has a &quot;Pattern&quot;
11287 that is used to decide which messages are selected when you use it with
11288 the Select command.
11289
11290 <H2>Patterns</H2>
11291
11292 In order to determine whether or not a message should be selected
11293 the message is compared with the rule's Pattern.
11294 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11295 Scoring, Other Rules, and Search Rules, so are described in only one place,
11296 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11297
11298 <H2>Command Descriptions</H2>
11299
11300 <H3>Add</H3>
11301
11302 The Add command is used to add a new rule definition to your set of
11303 rules.
11304 The new rule will be added after the highlighted rule.
11305
11306 <H3>Delete</H3>
11307
11308 The Delete command deletes the currently highlighted rule.
11309
11310 <H3>Change</H3>
11311
11312 The Change command lets you edit the nickname and Pattern
11313 of the currently highlighted rule.
11314
11315 <H3>Shuffle</H3>
11316
11317 The Shuffle command allows you to change the order of the rules.
11318 This affects only the order they are presented in when you use the
11319 ^T subcommand of the Select by Rule command.
11320 You may move the currently highlighted rule up or down in the list.
11321
11322 <H3>Replicate</H3>
11323
11324 The Replicate command is used to copy an existing rule definition and modify it.
11325 The new rule will be added after the highlighted rule.
11326
11327 <H3>IncludeFile</H3>
11328
11329 The IncludeFile command allows you to add a rules file to your configuration.
11330 Usually, your rules will be contained in your Alpine configuration file.
11331 If you wish, some or all of your rules may be stored in a separate file.
11332 If a rules file already exists (maybe it was made by somebody else using
11333 Alpine), you may insert it before the currently highlighted rule.
11334 You may also insert an empty file or a file that does not yet exist.
11335 Once you have an empty rules file in your configuration, you may use
11336 the Shuffle command to move rules into it.
11337 In fact, that's the only way to get the initial rule into the file.
11338
11339 <H3>eXcludeFile</H3>
11340
11341 The eXcludeFile command removes a rules file from your rules configuration.
11342 A limitation of the program is that in order to exclude a rules file
11343 that file must have at least one rule
11344 in it, otherwise you won't be able to highlight a line in the file.
11345 So you may have to add a dummy rule to the file in order to exclude the file.
11346 <P><UL>
11347 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11348 </UL>
11349 <P>
11350 &lt;End of help on this topic&gt;
11351 </BODY>
11352 </HTML>
11353 ===== h_rules_incols =====
11354 <HTML>
11355 <HEAD>
11356 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
11357 </HEAD>
11358 <BODY>
11359 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
11360 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
11361 <!--chtml if pinemode="function_key"-->
11362 <PRE>
11363 Available  Commands -- Group 1         Available Commands -- Group 2
11364 -------------------------------        ------------------------------
11365 F1  Show Help Text                      F1  Show Help Text
11366 F2  See commands in next group          F2  See commands in next group
11367 F3  Back to MAIN Alpine menu
11368 F4  Change configuration for rule
11369 F5  Move to previous rule               F5  Include file in rule config
11370 F6  Move to next rule                   F6  Exclude file from config
11371 F7  Previous page of rules
11372 F8  Next page of rules
11373 F9  Add new rule                        F9  Replicate existing rule
11374 F10 Delete existing rule
11375 F11 Shuffle the order of rules
11376 F12 Whereis (search rule nicknames)
11377 </PRE>
11378 <!--chtml else-->
11379 <PRE>
11380 Navigation                     General Alpine Commands
11381 -------------------------      -----------------------
11382  P  Prev rule                     ?  Display this help text
11383  N  Next rule                     E  Back to MAIN Alpine menu
11384  -  Previous page
11385 Spc (space bar) Next page
11386  W  WhereIs (search for word in rule nicknames)
11387
11388 Setup Index Color Commands
11389 ------------------------------------------------
11390  A  Add new rule                  $  Shuffle the order of rules
11391  D  Delete existing rule          C  Change configuration for highlighted rule
11392  R  Replicate existing rule
11393  I  Include file in rule config   X  Exclude file from rule config
11394 </PRE>
11395 <!--chtml endif-->
11396
11397 <H2>Description of the Setup Index Line Colors Screen</H2>
11398
11399 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
11400 This action is only available if your terminal is capable of displaying
11401 color and color display has been enabled with the
11402 <A HREF="h_config_color_style">Color Style</A> option within the
11403 Setup Color screen.
11404 (In PC-Alpine, color is always enabled so there is no option to turn on.)
11405 This screen lets you add, delete, modify, or change the order of the rules
11406 that cause the lines in the MESSAGE INDEX to be displayed in different
11407 colors.
11408 <P>
11409 Each rule has a &quot;Pattern&quot;,
11410 which is used to decide which of the rules is used; and the color that
11411 is used if the Pattern matches a particular message.
11412
11413 <H2>Index Color Patterns</H2>
11414
11415 In order to determine whether or not a message matches an Index Color Rule
11416 the message is compared with the rule's Pattern.
11417 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11418 Scoring, Other Rules, and Search Rules, so are described in only one place,
11419 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11420
11421 <P>
11422 If none of the Index Color rules is a match for a particular index line,
11423 then the color used is set using
11424 the <A HREF="h_color_setup">Setup Kolor</A> screen.
11425
11426 <H2>Index Line Color</H2>
11427
11428 This is the color that index lines are colored when there is a matching
11429 Pattern.
11430 This colors the whole index line, except possibly the status letters,
11431 which may be colored separately using
11432 the <A HREF="h_color_setup">Setup Kolor</A> screen.
11433
11434 <H2>Command Descriptions</H2>
11435
11436 <H3>Add</H3>
11437
11438 The Add command is used to add a new rule definition to your set of
11439 rules.
11440 The new rule will be added after the highlighted rule.
11441
11442 <H3>Delete</H3>
11443
11444 The Delete command deletes the currently highlighted rule.
11445
11446 <H3>Change</H3>
11447
11448 The Change command lets you edit the nickname, Pattern,
11449 and Index Line Color of the currently highlighted rule.
11450
11451 <H3>Shuffle</H3>
11452
11453 The Shuffle command allows you to change the order of the rules.
11454 You may move the currently highlighted rule up or down in the list.
11455 The order of the rules is important since the rules are tested for a
11456 match starting with the first rule and continuing until a match is found.
11457 You should place the rules with more specific Patterns near the beginning
11458 of the list, and those with more general Patterns near the end so that
11459 the more specific matches will happen when appropriate.
11460
11461 <H3>Replicate</H3>
11462
11463 The Replicate command is used to copy an existing rule definition and modify it.
11464 The new rule will be added after the highlighted rule.
11465
11466 <H3>IncludeFile</H3>
11467
11468 The IncludeFile command allows you to add a rules file to your configuration.
11469 Usually, your rules will be contained in your Alpine configuration file.
11470 If you wish, some or all of your rules may be stored in a separate file.
11471 If a rules file already exists (maybe it was made by somebody else using
11472 Alpine), you may insert it before the currently highlighted rule.
11473 You may also insert an empty file or a file that does not yet exist.
11474 Once you have an empty rules file in your configuration, you may use
11475 the Shuffle command to move rules into it.
11476 In fact, that's the only way to get the initial rule into the file.
11477
11478 <H3>eXcludeFile</H3>
11479
11480 The eXcludeFile command removes a rules file from your rules configuration.
11481 A limitation of the program is that in order to exclude a rules file
11482 that file must have at least one rule
11483 in it, otherwise you won't be able to highlight a line in the file.
11484 So you may have to add a dummy rule to the file in order to exclude the file.
11485 <P><UL>
11486 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11487 </UL>
11488 <P>
11489 &lt;End of help on this topic&gt;
11490 </BODY>
11491 </HTML>
11492 ===== h_rules_filter =====
11493 <HTML>
11494 <HEAD>
11495 <TITLE>SETUP FILTERING SCREEN</TITLE>
11496 </HEAD>
11497 <BODY>
11498 <H1>SETUP FILTERING SCREEN</H1>
11499 <H2>SETUP FILTERING COMMANDS</H2>
11500 <!--chtml if pinemode="function_key"-->
11501 <PRE>
11502 Available  Commands -- Group 1         Available Commands -- Group 2
11503 -------------------------------        ------------------------------
11504 F1  Show Help Text                      F1  Show Help Text
11505 F2  See commands in next group          F2  See commands in next group
11506 F3  Back to MAIN Alpine menu
11507 F4  Change configuration for filter
11508 F5  Move to previous filter             F5  Include file in filter config
11509 F6  Move to next filter                 F6  Exclude file from config
11510 F7  Previous page of filters
11511 F8  Next page of filters
11512 F9  Add new filter                      F9  Replicate existing filter
11513 F10 Delete existing filter
11514 F11 Shuffle the order of filters
11515 F12 Whereis (search filter nicknames)
11516 </PRE>
11517 <!--chtml else-->
11518 <PRE>
11519 Navigation                     General Alpine Commands
11520 -------------------------      -----------------------
11521  P  Prev Filter                   ?  Display this help text
11522  N  Next Filter                   E  Back to MAIN Alpine menu
11523  -  Previous page
11524 Spc (space bar) Next page
11525  W  WhereIs (search for word in filter nicknames)
11526
11527 Setup Filters Commands
11528 ------------------------------------------------
11529  A  Add new filter                $  Shuffle the order of filters
11530  D  Delete existing filter        C  Change configuration for highlighted filter
11531  R  Replicate existing filter
11532  I  Include file in filter config X  Exclude file from filter config
11533 </PRE>
11534 <!--chtml endif-->
11535
11536 <H2>Description of the Setup Filtering Screen</H2>
11537
11538 This screen lets you add, delete, modify, or change the order of the rules
11539 that determine the filtering Alpine does on folders you view.
11540 <P>
11541 The software that actually delivers mail (the stuff that happens
11542 before Alpine is involved) for you is in a better position to do mail filtering
11543 than Alpine itself.
11544 If possible, you may want to look into using that sort of mail filtering to
11545 deliver mail to different folders, delete it, or forward it.
11546 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
11547 <P>
11548 Filtering is a way to automatically move certain messages from one folder
11549 to another or to delete messages.
11550 It can also be used to set message status (Important, Deleted, New,
11551 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
11552 Alpine doesn't have the ability to forward mail to another address or
11553 to deliver vacation messages.
11554 <P>
11555 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
11556 When a folder is opened, when new mail arrives in an open folder, or
11557 when mail is Expunged from a folder; each
11558 message is compared with the Patterns of your filtering rules.
11559 The comparisons start with the first rule and keep going until there
11560 is a match.
11561 If a match is found, the message may be deleted or moved, depending on
11562 the setting of the Filter Action.
11563 If the message is not deleted, it may have its status altered.
11564
11565 <P>
11566 <EM>NOTE:</EM>
11567 When setting up a Pattern used to delete messages,
11568 it is recommended that you test the Pattern first with a &quot;Move&quot;
11569 folder specified in
11570 case unintended matches occur.  Messages that are deleted will be removed
11571 from the folder and <EM>unrecoverable</EM> from within Alpine after the
11572 next Expunge command or once the folder being filtered has been closed.
11573
11574 <H2>Filter Patterns</H2>
11575
11576 In order to determine whether or not a message matches a filter the message is
11577 compared with the Filter's Pattern.
11578 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11579 Scoring, Other Rules, and Search Rules, so are described in only one place,
11580 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11581 <P>
11582 Since filtering is a potentially destructive action, if you have a filtering
11583 Pattern with nothing other than Current Folder Type set, that filtering
11584 rule is ignored.
11585
11586 <H2>Filter Actions</H2>
11587
11588 Once a filter match is found for a particular message, there are some actions
11589 that may be taken.
11590 First, the message may have its status changed.
11591 This is the same message status that you can manipulate manually using the
11592 <a href="h_common_flag">Flag Command</a>.
11593 There are always four elements of message status that you can control.
11594 You can set or clear the Important status, the New status, the Deleted
11595 status, and the Answered status.
11596 Of course, if the filter is going to delete the message,
11597 then there is no point in setting message status.
11598 You may also be able to set user-defined keywords for a message.
11599 Read a little about keywords in the help text for the
11600 <A HREF="h_common_flag">Flag</A> command.
11601 <P>
11602 Second, the filter may delete or move the message.
11603 Deleting the message marks it Deleted and removes it from view.
11604 It is effectively gone forever (though it technically is still there until
11605 the next expunge command, which may happen implicitly).
11606 Moving the message moves it from the open folder into the folder
11607 listed on the &quot;Folder List&quot; line of the filter configuration.
11608 If you list more than one folder name (separated by commas) then the message
11609 will be copied to each of those folders.
11610 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
11611 message is removed from the current folder.
11612 If you just want to set the messages status without deleting it from
11613 the folder, then set the filter action to
11614 &quot;Just Set Message Status&quot;.
11615 <P>
11616 (There is no way to do a Copy instead of a Move, due to the difficulties
11617 involved in keeping track of whether or not a message has
11618 already been copied.)
11619
11620 <H2>Command Descriptions</H2>
11621
11622 <H3>Add</H3>
11623
11624 The Add command is used to add a new filter definition to your set of
11625 filters.
11626 The new filter will be added after the highlighted filter.
11627
11628 <H3>Delete</H3>
11629
11630 The Delete command deletes the currently highlighted filter.
11631
11632 <H3>Change</H3>
11633
11634 The Change command lets you edit the nickname, Pattern,
11635 and Folder of the currently highlighted filter.
11636
11637 <H3>Shuffle</H3>
11638
11639 The Shuffle command allows you to change the order of the filters.
11640 You may move the currently highlighted filter up or down in the list.
11641 The order of the filters is important since the filters are tested for a
11642 match starting with the first filter and continuing until a match is found.
11643 You should place the filters with more specific Patterns near the beginning
11644 of the list, and those with more general Patterns near the end so that
11645 the more specific matches will happen when appropriate.
11646
11647 <H3>Replicate</H3>
11648
11649 The Replicate command is used to copy an existing filter and modify it.
11650 The new filter will be added after the highlighted filter.
11651
11652 <H3>IncludeFile</H3>
11653
11654 The IncludeFile command allows you to add a filters file to your configuration.
11655 Usually, your filters will be contained in your Alpine configuration file.
11656 If you wish, some or all of your filters may be stored in a separate file.
11657 If a filters file already exists (maybe it was made by somebody else using
11658 Alpine), you may insert it before the currently highlighted filter.
11659 You may also insert an empty file or a file that does not yet exist.
11660 Once you have an empty filters file in your configuration, you may use
11661 the Shuffle command to move filters into it.
11662 In fact, that's the only way to get the initial filter into the file.
11663
11664 <H3>eXcludeFile</H3>
11665
11666 The eXcludeFile command removes a filters file from your filters configuration.
11667 A limitation of the program is that in order to exclude a filters file
11668 that file must have at least one filter
11669 in it, otherwise you won't be able to highlight a line in the file.
11670 So you may have to add a dummy filter to the file in order to exclude the file.
11671 <P><UL>
11672 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11673 </UL>
11674 <P>
11675 <H3>Performance Considerations</H3>
11676 The number and type of patterns being tested can
11677 adversely effect performance.  Issues to be aware
11678 of include:
11679 <P>
11680 <UL>
11681   <LI> The more filters you have defined the longer it will take to run down
11682 the list.  Deleting unused filters is a good idea.
11683   <LI> Filtering in newsgroups served by an NNTP server will be slow
11684 if your patterns include tests other than &quot;From:&quot;
11685 or &quot;Subject:&quot;.
11686 </UL>
11687 <P>
11688 &lt;End of help on this topic&gt;
11689 </BODY>
11690 </HTML>
11691 ===== h_rules_score =====
11692 <HTML>
11693 <HEAD>
11694 <TITLE>SETUP SCORING SCREEN</TITLE>
11695 </HEAD>
11696 <BODY>
11697 <H1>SETUP SCORING SCREEN</H1>
11698 <H2>SETUP SCORING COMMANDS</H2>
11699 <!--chtml if pinemode="function_key"-->
11700 <PRE>
11701 Available  Commands -- Group 1         Available Commands -- Group 2
11702 -------------------------------        ------------------------------
11703 F1  Show Help Text                      F1  Show Help Text
11704 F2  See commands in next group          F2  See commands in next group
11705 F3  Back to MAIN Alpine menu
11706 F4  Change configuration for rule
11707 F5  Move to previous rule               F5  Include file in rule config
11708 F6  Move to next rule                   F6  Exclude file from config
11709 F7  Previous page of rules
11710 F8  Next page of rules
11711 F9  Add new rule                        F9  Replicate existing rule
11712 F10 Delete existing rule
11713 F11 Shuffle the order of rules
11714 F12 Whereis (search rule nicknames)
11715 </PRE>
11716 <!--chtml else-->
11717 <PRE>
11718 Navigation                     General Alpine Commands
11719 -------------------------      -----------------------
11720  P  Prev rule                     ?  Display this help text
11721  N  Next rule                     E  Back to MAIN Alpine menu
11722  -  Previous page
11723 Spc (space bar) Next page
11724  W  WhereIs (search for word in rule nicknames)
11725
11726 Setup Scoring Commands
11727 ------------------------------------------------
11728  A  Add new rule                  $  Shuffle the order of rules
11729  D  Delete existing rule          C  Change configuration for highlighted rule
11730  R  Replicate existing rule
11731  I  Include file in rule config   X  Exclude file from rule config
11732 </PRE>
11733 <!--chtml endif-->
11734
11735 <H2>Description of the Setup Scoring Screen</H2>
11736
11737 Most people will not use scores at all, but if you do use them, here's how
11738 they work in Alpine.
11739 Using this screen, you may define Scoring rules.
11740 The score for a message is calculated by looking at every Score rule defined
11741 and adding up the Score Values for the ones that match the message.
11742 If there are no matches for a message, it has a score of zero.
11743 Message scores may be used a couple of ways in Alpine.
11744
11745 <H3>Sorting by Score</H3>
11746
11747 One of the methods you may use to sort message indexes is to sort by
11748 score.
11749 The scores of all the messages in a folder will be calculated and then
11750 the index will be ordered by placing the messages in order of ascending or
11751 descending score.
11752
11753 <H3>Scores for use in Patterns</H3>
11754
11755 The Patterns used for Roles, Index Line Coloring, and Filtering have a
11756 category labeled &quot;Score Interval&quot;.
11757 When a message is being compared with a Pattern to check for a match, if
11758 the Score Interval is set only messages that have a score somewhere in
11759 the interval are a match.
11760
11761 <H2>Scoring Rule Patterns</H2>
11762
11763 In order to determine whether or not a message matches a scoring rule
11764 the message is compared with the rule's Pattern.
11765 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11766 Scoring, Other Rules, and Search Rules, so are described in only one place,
11767 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11768
11769 <P>
11770 Actually, Scoring rule Patterns are slightly different from the other types of
11771 Patterns because Scoring rule Patterns don't contain a Score Interval.
11772 In other words, when calculating the score for a message, which is done
11773 by looking at the Scoring rule Patterns, scores aren't used.
11774
11775 <H2>Score Value</H2>
11776
11777 This is the value that will be added to the score for a message if the
11778 rule's Pattern is a match.
11779 Each individual Score Value is an integer between -100 and 100, and the
11780 values from matching rules are added together to get a message's score.
11781 There is also a way to extract the value from a particular header of each
11782 message. See the help text for Score Value for further information.
11783
11784 <H2>Command Descriptions</H2>
11785
11786 <H3>Add</H3>
11787
11788 The Add command is used to add a new scoring rule definition.
11789 The new rule will be added after the highlighted rule.
11790
11791 <H3>Delete</H3>
11792
11793 The Delete command deletes the currently highlighted scoring rule.
11794
11795 <H3>Change</H3>
11796
11797 The Change command lets you edit the nickname, Pattern,
11798 and Score Value of the currently highlighted scoring rule.
11799
11800 <H3>Shuffle</H3>
11801
11802 The Shuffle command allows you to change the order of the scoring rules.
11803 You may move the currently highlighted rule up or down in the list.
11804 The order of the rules is important since the rules are tested for a
11805 match starting with the first rule and continuing until a match is found.
11806 You should place the rules with more specific Patterns near the beginning
11807 of the list, and those with more general Patterns near the end so that
11808 the more specific matches will happen when appropriate.
11809
11810 <H3>Replicate</H3>
11811
11812 The Replicate command is used to copy an existing rule and modify it.
11813 The new rule will be added after the highlighted rule.
11814
11815 <H3>IncludeFile</H3>
11816
11817 The IncludeFile command allows you to add a rules file to your configuration.
11818 Usually, your rules will be contained in your Alpine configuration file.
11819 If you wish, some or all of your rules may be stored in a separate file.
11820 If a rules file already exists (maybe it was made by somebody else using
11821 Alpine), you may insert it before the currently highlighted rule.
11822 You may also insert an empty file or a file that does not yet exist.
11823 Once you have an empty rules file in your configuration, you may use
11824 the Shuffle command to move rules into it.
11825 In fact, that's the only way to get the initial rule into the file.
11826
11827 <H3>eXcludeFile</H3>
11828
11829 The eXcludeFile command removes a rules file from your rules configuration.
11830 A limitation of the program is that in order to exclude a rules file
11831 that file must have at least one rule
11832 in it, otherwise you won't be able to highlight a line in the file.
11833 So you may have to add a dummy rule to the file in order to exclude the file.
11834 <P><UL>
11835 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11836 </UL>
11837 <P>
11838 &lt;End of help on this topic&gt;
11839 </BODY>
11840 </HTML>
11841 ===== h_direct_config =====
11842 <HTML>
11843 <HEAD>
11844 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
11845 </HEAD>
11846 <BODY>
11847 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
11848 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
11849 <!--chtml if pinemode="function_key"-->
11850 <PRE>
11851 Available  Commands
11852 -------------------------------
11853 F1  Show Help Text
11854 F3  Back to MAIN Alpine menu
11855 F4  Change configuration for directory server
11856 F5  Move to previous directory server
11857 F6  Move to next directory server
11858 F7  Previous page of directory servers
11859 F8  Next page of directory servers
11860 F9  Add new directory server
11861 F10 Delete existing directory server
11862 F11 Shuffle the order of directory servers
11863 F12 Whereis (search directory server titles)
11864 </PRE>
11865 <!--chtml else-->
11866 <PRE>
11867 Navigation                     General Alpine Commands
11868 -------------------------      -----------------------
11869  P  Prev Directory Server         ?  Display this help text
11870  N  Next Directory Server         E  Back to MAIN Alpine menu
11871  -  Previous page
11872 Spc (space bar) Next page
11873  W  WhereIs (search for word in directory server titles)
11874
11875 Setup LDAP Directory Server Commands
11876 ------------------------------------------------
11877  A  Add new directory server      $  Shuffle the order of directory servers
11878  D  Delete existing dir server    C  Change configuration for highlighted server
11879 </PRE>
11880 <!--chtml endif-->
11881
11882 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
11883
11884 This screen lets you add, delete, modify, or change the order of your
11885 directory servers. You may also set some optional behavior for each server.
11886 The &quot;Add Dir&quot; command brings up a blank form to
11887 fill in. You will have to supply at least the name of the LDAP server.
11888 You will often have to supply a search base to be used with that server,
11889 as well. Once the form has been brought up on your screen, there is help
11890 available for each of the options you may set.
11891 <P>
11892 The &quot;Del Dir&quot; command allows you to remove a directory server
11893 from your configuration.
11894 <P>
11895 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
11896 The difference is that instead of bringing up a form for a new server
11897 configuration, you are changing the configuration of an existing entry.
11898 For example, you might want to correct a typing error, change a
11899 nickname, or change one of the options set for that server.
11900 <P>
11901 The &quot;Shuffle&quot; command is used to change the order of directory
11902 servers.
11903 <P><UL>
11904 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11905 </UL>
11906 <P>
11907 &lt;End of help on this topic&gt;
11908 </BODY>
11909 </HTML>
11910 ============= h_address_display ========================
11911 <HTML>
11912 <HEAD>
11913 <TITLE>SEARCH RESULTS INDEX</TITLE>
11914 </HEAD>
11915 <BODY>
11916 <H1>SEARCH RESULTS INDEX</H1>
11917 This screen shows the results, if any, of your Directory Server search.
11918 Commands (besides those for screen navigation) are:
11919 <DL>
11920 <DT>View
11921 <!--chtml if pinemode="function_key"-->
11922 (F4)
11923 <!--chtml else-->
11924 (V)
11925 <!--chtml endif-->
11926 </DT>
11927 <DD>See the full information for the selected entry.
11928
11929 <DT>Compose
11930 <!--chtml if pinemode="function_key"-->
11931 (F9)
11932 <!--chtml else-->
11933 (C)
11934 <!--chtml endif--></DT>
11935 <DD>Compose a message with the selected entry as the recipient.
11936
11937 <DT>Role
11938 <!--chtml if pinemode="function_key"-->
11939 (F2)
11940 <!--chtml else-->
11941 (#)
11942 <!--chtml endif--></DT>
11943 <DD>Compose a message with the selected entry as the recipient. This differs
11944 from Compose in that you may select a role before beginning your composition.
11945
11946 <DT>Forward
11947 <!--chtml if pinemode="function_key"-->
11948 (F10)
11949 <!--chtml else-->
11950 (F)
11951 <!--chtml endif--></DT>
11952 <DD>Send the full information for the selected entry as an
11953 email message to someone else.
11954
11955 <DT>Save
11956 <!--chtml if pinemode="function_key"-->
11957 (F11)
11958 <!--chtml else-->
11959 (S)
11960 <!--chtml endif-->
11961 </DT>
11962 <DD>Save to your address book:
11963 <UL>
11964 <LI>the result of the search (as just found through your query) for the
11965 selected entry; or
11966 <LI>the selected entry for repeated Directory Server searching when used
11967 in the future.
11968 </UL>
11969 or<BR>
11970 Export to a file (external to Alpine):
11971 <UL>
11972 <LI>the full information for the selected entry; or
11973 <LI>the email address from the selected entry; or
11974 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
11975 </UL>
11976 <DT>WhereIs
11977 <!--chtml if pinemode="function_key"-->
11978 (F12)
11979 <!--chtml else-->
11980 (W)
11981 <!--chtml endif-->
11982 </DT>
11983 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
11984 displayed text, not the full records for each entry.)
11985 </DL>
11986 &lt;End of help on this topic&gt;
11987 </BODY>
11988 </HTML>
11989 ============= h_address_select ========================
11990 <HTML>
11991 <HEAD>
11992 <TITLE>SEARCH RESULTS INDEX</TITLE>
11993 </HEAD>
11994 <BODY>
11995 <H1>SEARCH RESULTS INDEX</H1>
11996 This screen shows the results, if any, of your Directory Server search.
11997 Commands (besides those for screen navigation) are:
11998 <DL>
11999 <DT>Select
12000 </DT>
12001 <DD>Select this entry for use.
12002
12003 <DT>ExitSelect
12004 <DD>Exit without selecting any of the entries.
12005
12006 <DT>WhereIs
12007 </DT>
12008 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
12009 displayed text, not the full records for each entry.)
12010 </DL>
12011 &lt;End of help on this topic&gt;
12012 </BODY>
12013 </HTML>
12014 ===== h_folder_maint =====
12015 <HTML>
12016 <HEAD>
12017 <TITLE>Help for Folder List</TITLE>
12018 </HEAD>
12019 <BODY>
12020 <H1>FOLDER LIST COMMANDS</H1>
12021 <!--chtml if pinemode="function_key"-->
12022 <PRE>
12023 Available Commands -- Group 1        Available Commands -- Group 2
12024 -------------------------------      ------------------------------
12025 F1  Show Help Text                    F1  Show Help Text
12026 F2  See commands in next group        F2  See commands in next group
12027 F3  MAIN MENU Screen                  F3  Quit Alpine
12028 F4  Select folder and view it         F4  MAIN MENU Screen
12029 F5  Move to previous folder
12030 F6  Move to next folder               F6  Specify a folder to go to
12031 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
12032 F8  Show next screen of listing       F8  Compose a message
12033 F9  Add a new folder                  F9  Print folder listing
12034 F10 Delete selected folder
12035 F11 Rename selected folder
12036 F12 Whereis (search folder names)
12037
12038 Available Commands -- Group 3
12039 F1  Show Help Text
12040 F2  See commands in next group
12041 F5  Go to next new message
12042     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
12043 F8  Compose a message using roles
12044 F9  Export folder to a file
12045 F10 Import the file back to a folder
12046 </PRE>
12047 <!--chtml else-->
12048 <PRE>
12049 Navigating the Folder Screen            Operations on the Selected Folder
12050 ----------------------------            ---------------------------------
12051  P   Move to previous folder              V  View Index of selected folder
12052  N   Move to next folder                  D  Delete
12053  -   Show previous page of listing        R  Rename
12054 Spc  (space bar) Show next page           E  Export to file
12055                                           U  Import from file to folder
12056
12057 FOLDER LIST Screen Commands              General Alpine Command
12058 ---------------------------              -----------------------
12059  A  Add a folder                          O  Show all other available commands
12060  G  Specify a folder to go to             ?  Show Help text
12061  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
12062  W  Whereis (search folder names)         Q  Quit Alpine
12063  %  Print folder listing                  C  Compose a message
12064                                           #  Compose a message using roles
12065 </PRE>
12066 <!--chtml endif-->
12067 <P>
12068 These commands are only available in the FOLDER LIST screen when the
12069 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
12070 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
12071 <DT>Select:</DT>
12072 <DD>Select folders by certain criteria:<UL>
12073 <LI>All: of limited use, since there is no Apply command.
12074 <LI>by Property: <UL>
12075         <LI>folder contains messages not yet seen
12076         <LI>folder contains new messages
12077         <LI>folder contains exactly as many, more, or fewer messages
12078 than a given number
12079         </UL>
12080 <LI>by Text: <UL>
12081         <LI>contained in name of folder (Name Select)
12082         <LI>contained in messages in folder (Content Select)
12083         </UL>
12084 </UL></DD>
12085
12086 <DT>Select current:</DT>
12087 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
12088 add one or more folders to a set created with the Select command described
12089 above.)</DD>
12090 <DT>Zoom mode:</DT>
12091 <DD>Toggles display of only selected folders or all folders on and off.</DD>
12092 </DL>
12093 <P>
12094 If the feature
12095 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
12096 is set then the TAB key will display the number of recent messages and
12097 the total number of messages in the highlighted folder.
12098 <P>
12099 The &quot;Export&quot; command causes the lowest common denominator style
12100 mailbox to be written to a file.
12101 If the file already exists, you are asked if you want to delete it.
12102 If you say No, then the operation is aborted.
12103 Export might be a reasonable way to store a backup or an archival copy of
12104 a folder.
12105 The exported-to file is a local file on the system where you are running Alpine.
12106 The &quot;Import&quot; command is the opposite of the Export command.
12107 It reads a file created by Export and asks where it should save it in your
12108 folders.
12109 This could be a new folder or an existing folder.
12110 If the folder already exists, the messages from the exported file will be
12111 appended to the folder.
12112 <P>
12113 <CENTER>Description of the FOLDER LIST Screen</CENTER>
12114
12115 The purpose of the FOLDER LIST screen is to help you browse and manage
12116 the folders and directories (also known as &quot;hierarchy&quot;)
12117 contained within a collection.
12118
12119 <P>
12120 Folders and directories are arranged alphabetically across lines of
12121 the screen.  Directories, if present, are denoted by a special
12122 character at the end of the name known as the hierarchy delimiter
12123 (typically, &quot;/&quot;).  By default, folders and directories are
12124 mixed together.  The
12125 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
12126 configuration option can be used to group directories toward the
12127 beginning or end of the list.
12128
12129 <P>
12130 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
12131 commands change the &quot;selected&quot; (i.e., highlighted) folder or
12132 directory, and the View Fldr/Dir commands will &quot;open&quot; the
12133 selected item.  Folder and directory management is provided via the
12134 Rename, Delete and Add commands.
12135
12136 <P><CENTER>About Folders</CENTER>
12137 What are Folders?<P>
12138
12139 Folders are simply files where messages are kept.  Every message has to be
12140 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
12141 folder for sent mail and a folder for saved messages.<P>
12142
12143 You may create as many other folders as you wish.  They must be given
12144 names that can be filenames on the filesystem.
12145 <P>
12146
12147 You can move messages from one folder to another by opening the original
12148 folder and saving messages into the other folder just as you can save
12149 message from your INBOX to any other folder.<P>
12150
12151 Folders are typically just files in the filesystem.  However, the files
12152 that are
12153 folders have some special formatting in them (so that Alpine knows where one
12154 message ends and another begins) and should <EM>not</EM> be edited outside of
12155 Alpine.  If you want copies of your messages in text files that you can edit
12156 or otherwise manipulate, use the Export command to copy them from Alpine into
12157 your regular file area.
12158
12159 <P>
12160 FOR MORE INFORMATION: See the section on
12161 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12162 <P>
12163 <CENTER>About Directories</CENTER>
12164 <P>
12165 A directory is simply a container used to group folders within a
12166 folder list.  You can create as many directories as you like.  And
12167 directories can even contain directories themselves.
12168
12169 <P>
12170 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
12171 to note that not all IMAP servers support directories.  If you find that
12172 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
12173 then it's likely that directories are not supported by the server serving
12174 in that collection.
12175
12176 <P>
12177 Similarly, servers that do provide for directories may not do so in
12178 the same way.  On some servers, for example, each folder name you
12179 create is at the same time capable of being a directory.  When this
12180 happens, Alpine will display both the folder name and the name of the
12181 directory (with trailing hierarchy delimiter) in the folder list.
12182
12183 <P>
12184 Another issue with IMAP access, though with a much smaller set of servers,
12185 is that not all servers accept the request to list out the available
12186 folders and directories in the same way.  If you find yourself having
12187 trouble viewing folders on your server, you might investigate the
12188 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
12189 feature.
12190 <P>
12191 <UL>
12192 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12193 </UL>
12194 <P>
12195 &lt;End of help on this topic&gt;
12196 </BODY>
12197 </HTML>
12198 ========= h_valid_folder_names ========
12199 <HTML>
12200 <HEAD>
12201 <TITLE>Explanation of Valid Folder Names</TITLE>
12202 </HEAD>
12203 <BODY>
12204 <H1>Folder Name Syntax Explained</H1>
12205
12206 Once your folder collections are defined, you can usually refer to
12207 folders by their simple (unqualified) name, or pick from a FOLDER LIST
12208 display.  However, understanding the complete syntax for folder names,
12209 both local and remote, is handy when using the Goto command and when
12210 you are adding new folder collections via the Setups/collectionList screen.
12211 <P>
12212 An Alpine folder name looks like
12213
12214 <P>
12215 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
12216 <P>
12217
12218 The square brackets ([]) mean that the part is optional.
12219
12220 <P>
12221 If there is no remote-specification, then the folder name is interpreted
12222 locally on the computer running Alpine.
12223 Local folder names depend on the operating system used by the computer
12224 running Alpine, as well as the configuration of that system.  For example,
12225 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
12226 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
12227 system running Unix.
12228
12229 <P>
12230 Alpine users have the option of using folders that are stored on some other
12231 computer.  Alpine accesses remote folders via IMAP (the Internet Message
12232 Access Protocol), or in the case of news, via NNTP (the Network News
12233 Transport Protocol).  To be able to access remote folders in Alpine, the
12234 remote host must be running the appropriate server software (imapd or
12235 nntpd) and you must correctly specify the name of the folder to Alpine,
12236 including the domain name of the remote machine. For example,
12237 <P>
12238 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
12239 <P>
12240 could be a remote folder specification, and so could
12241 <P>
12242 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
12243 and
12244 <P>
12245 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
12246 <P>
12247 Note that in the case of remote folders, the directory/file path in the specification is
12248 determined by the operating system of the remote computer, <B>not</B> by
12249 the operating system of the computer on which you are running Alpine.
12250 <P>
12251 As you can tell, the name of the computer is in &#123;} brackets
12252 followed immediately by the name of the folder.  (In each of these cases the
12253 optional namespace is missing.)  If, as in these
12254 examples, there is no remote access protocol specified, then IMAP is
12255 assumed.  Check
12256 <A HREF="h_folder_server_syntax">here</A>
12257 for a more detailed look at what options can be placed between the brackets.
12258 If there are no brackets at all, then the folder name is interpreted locally
12259 on the computer on which you are running Alpine.
12260
12261 <P>
12262 To the right of the brackets when a server name is present, or at the
12263 start of the foldername if no server is present, the sharp sign,
12264 &quot;#&quot;, holds special meaning.  It indicates a folder name
12265 outside the area reserved for your personal folders.  In fact, it's
12266 used to indicate both the name of the folder, and a special phrase
12267 telling Alpine how to interpret the name that follows.
12268
12269 <P>
12270 So, for example, Alpine can be used to access a newsgroup that might be
12271 available on your computer using:
12272 <P>
12273 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
12274 <P>
12275 The sharp sign indicates the folder name is outside your personal
12276 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
12277 interpret the remainder of the name as a newsgroup.
12278
12279 <P>
12280 Similarly, to access a newsgroup on your IMAP server, you might
12281 use something like:
12282 <P>
12283 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
12284
12285 <P>
12286 There are a number of such special phrases (or &quot;namespaces&quot;)
12287 available.  For a more detailed explanation read about
12288 <A HREF="h_folder_name_namespaces">Namespaces</A>.
12289
12290 <P>
12291 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
12292 names.  The name INBOX refers to your &quot;principal incoming
12293 message folder&quot; and will be mapped to the actual file name used for your
12294 INBOX on any given host.  Therefore, a name like
12295 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
12296 store incoming mail for you on that particular host.
12297
12298 <P>
12299 &lt;End of help on this topic&gt;
12300 </BODY>
12301 </HTML>
12302 ======= h_folder_name_namespaces =======
12303 <HTML>
12304 <HEAD>
12305 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
12306 </HEAD>
12307 <BODY>
12308 <H1>Folder Name Namespaces Explained</H1>
12309
12310 An Alpine folder name looks like
12311
12312 <P>
12313 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
12314 <P>
12315
12316 The local part of a folder name has an optional &quot;Namespace&quot; which
12317 tells Alpine how to interpret the rest of the name.
12318
12319 <P>
12320 By default the folder name is interpreted as defining a section of your personal
12321 folder area.  This area and how you specify it are defined by the
12322 server, if one is specified, or, typically, the home
12323 directory, if no server is defined.
12324
12325 <P>
12326 If a namespace is specified, it begins with the
12327 sharp, &quot;#&quot;, character followed by the name of the namespace
12328 and then the namespace's path-element-delimiter.  Aside from the
12329 path's format, namespaces can also imply access rights, content
12330 policy, audience, location, and, occasionally, access methods.
12331
12332 <P>
12333 Each server exports its own set (possibly of size one) of
12334 namespaces.  Hence, it's likely communication with your server's
12335 administrator will be required for specific configurations.  Some of
12336 the more common namespaces, however, include:
12337
12338 <DL>
12339 <DT>#news.</DT>
12340 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
12341 names are hierarchically defined with each level delimited by a period.
12342 <P>
12343 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
12344 <P>
12345 </DD>
12346 <DT>#public/</DT>
12347 <DD>This specifies a folder area that the server may export to the general
12348 public.
12349 </DD>
12350 <DT>#shared/</DT>
12351 <DD>This specifies a folder area that the server may export to groups
12352 of users.
12353 </DD>
12354 <DT>#ftp/</DT>
12355 <DD>This specifies a folder area that is the same as that it may have
12356 exported via the &quot;File Transfer Protocol&quot;.
12357 </DD>
12358 <DT>#mh/</DT>
12359 <DD>This specifies the personal folder area associated with folders
12360 and directories that were created using the MH message handling system.
12361 </DD>
12362 <DT>#move/</DT>
12363 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
12364 <P>
12365 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
12366 <P>
12367 The #move namespace is followed by two folder names separated by a delimiter
12368 character.
12369 The delimiter character may be any character that does not appear in
12370 the MailDropFolder name.
12371 The meaning of #move is that mail will be copied from the MailDropFolder to
12372 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
12373 Periodic checks at frequency
12374 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
12375 time between checks set by
12376 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
12377 are made for new mail arriving in the MailDropFolder.
12378 An example that copies mail from a POP inbox to a local folder follows
12379 <P>
12380 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
12381 <P>
12382 To you it appears that mail is being delivered to the local folder when it
12383 is copied from the MailDropFolder, and you read mail from the local folder.
12384 <P>
12385 Note that if the DestinationFolder does not exist then the messages are not
12386 copied from the MailDropFolder.
12387 A #move folder may only be used as an
12388 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
12389 an Inbox.
12390 When you are in the FOLDER LIST of Incoming Message Folders (after turning
12391 on the
12392 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
12393 option)
12394 the Add command has a subcommand &quot;Use Mail Drop&quot;
12395 which may be helpful for defining the folder in your Alpine configuration.
12396 The same is true when you edit the
12397 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
12398 option in Setup/Config.
12399 Each of these configuration methods will also create the DestinationFolder
12400 if it doesn't already exist.
12401 If you are having problems, make sure the DestinationFolder exists.
12402 You may find some more useful information about Mail Drops at
12403 <A HREF="h_maildrop">What is a Mail Drop?</A>.
12404 </DD>
12405 </DL>
12406 <P>
12407
12408 In addition, the server may support access to other user's folders,
12409 provided you have suitable permissions.  Common methods use a prefix
12410 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
12411 indicate the root of the other user's folder area.
12412
12413 <P>
12414 No, nothing's simple.
12415
12416 <P>
12417 &lt;End of help on this topic&gt;
12418 </BODY>
12419 </HTML>
12420 ============= h_whatis_vcard ========================
12421 <HTML>
12422 <HEAD>
12423 <TITLE>VCARD EXPLAINED</TITLE>
12424 </HEAD>
12425 <BODY>
12426 <H1>What is the vCard format?</H1>
12427 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
12428 information about and among people and organizations electronically.
12429 More information about vCard can be found (as of May 1998) on the WWW site
12430 of the Internet Mail Consortium at the URL:
12431 <P>
12432 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
12433 <P>
12434 &lt;End of help on this topic&gt;
12435 </BODY>
12436 </HTML>
12437 ===== h_folder_open =====
12438 <HTML>
12439 <HEAD>
12440 <TITLE>Explanation of Folder Selection</TITLE>
12441 </HEAD>
12442 <BODY>
12443 <BR>
12444 <BR>
12445 This screen is designed to allow you to quickly and easily survey your
12446 folders and select one to open.
12447 <!--chtml if pinemode="function_key"-->
12448 <PRE>
12449 Navigating the List of Folders             General Alpine Commands
12450 ------------------------------             -----------------------
12451  P   Move to previous folder               ?   Show this help text
12452  N   Move to next folder
12453  -   Show previous screen of folders
12454 Spc  (space bar) Show next screen
12455  W   WhereIs (search folder names)
12456
12457 Folder Selection Commands
12458 -------------------------
12459  E   Exit the Folder Select menu (without selecting a folder)
12460  S   Select the currently highlighted folder
12461 </PRE>
12462 <!--chtml else-->
12463 <PRE>
12464 Navigating the List of Folders             General Alpine Commands
12465 ------------------------------             -----------------------
12466 F5   Move to previous folder               F1  Show this help text
12467 F6   Move to next folder
12468 F7   Show previous screen of folders
12469 F8   Show next screen of folders
12470 F12  WhereIs (search folder names)
12471
12472 Folder Selection Commands
12473 -------------------------
12474 F3   Exit the Folder Select menu (without selecting a folder)
12475 F4   Select the currently highlighted folder
12476 </PRE>
12477 <!--chtml endif-->
12478 <P>
12479 FOR MORE INFORMATION: See the section on
12480 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12481 <P>
12482 &lt;End of help on this topic&gt;
12483 </BODY>
12484 </HTML>
12485 ===== h_folder_subscribe =====
12486 <HTML>
12487 <HEAD>
12488 <TITLE>Newsgroup Subscribe Screen explained</TITLE>
12489 </HEAD>
12490 <BODY>
12491 <H1>FOLDER SUBSCRIBE HELP</H1>
12492
12493 This screen is designed to help you subscribe to newsgroups you are
12494 not currently subscribed to.  The screen display is a list of all
12495 available newsgroups (or possibly a partial list if you specified a
12496 partial name when entering the screen).  Groups you have already
12497 subscribed to have the letters &quot;SUB&quot; next to them.  You may
12498 select a single new group to subscribe to by moving the cursor to that
12499 group and pressing &quot;S&quot; or carriage return.  Alternatively,
12500 you may change into ListMode with the &quot;ListMode&quot; command.
12501 The display will change slightly so that each group has a checkbox in
12502 front of it.  Use the cursor and the Set/Unset command to place an
12503 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
12504 <P>
12505
12506 When you are finished marking groups, the &quot;Subscribe&quot;
12507 command will subscribe you to those groups you have marked.  Note, you
12508 may not unsubscribe to groups with this command.  Instead of the
12509 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
12510 UnSbscrbe command.
12511 <P>
12512
12513 <!--chtml if pinemode="function_key"-->
12514 <PRE>
12515 Navigating the List of Newsgroups          General Alpine Commands
12516 ---------------------------------          -----------------------
12517 F5   Move to previous group                F1   Show this help text
12518 F6   Move to next group
12519 F7   Show previous screen of groups
12520 F8   Show next screen of groups
12521 F12  WhereIs (search group names)
12522 F9   Use ListMode
12523
12524 Group Selection Commands
12525 -------------------------
12526 F3  Exit the News Subscribe menu (without selecting any groups)
12527 F4  Subscribe to the currently highlighted newsgroup
12528 </PRE>
12529 <!--chtml else-->
12530 <PRE>
12531 Navigating the List of Newsgroups          General Alpine Commands
12532 ---------------------------------          -----------------------
12533  P   Move to previous group                ?   Show this help text
12534  N   Move to next group
12535  -   Show previous screen of groups
12536 Spc  (space bar) Show next screen
12537  W   WhereIs (search group names)
12538  L   Use ListMode
12539
12540 Group Selection Commands
12541 -------------------------
12542  E   Exit the News Subscribe menu (without selecting any groups)
12543  S   Subscribe to the currently highlighted newsgroup
12544 </PRE>
12545 <!--chtml endif-->
12546 <P>
12547 When in ListMode, there is an additional command for marking groups to
12548 subscribe to:
12549 <P>
12550 <!--chtml if pinemode="function_key"-->
12551 <PRE>
12552 ListMode Commands
12553 -------------------------
12554 F9  Set or unset the highlighted group
12555 </PRE>
12556 <!--chtml else-->
12557 <PRE>
12558 ListMode Commands
12559 -------------------------
12560 X   Set or unset the highlighted group
12561 </PRE>
12562 <!--chtml endif-->
12563 <P>
12564 &lt;End of help on this topic&gt;
12565 </BODY>
12566 </HTML>
12567 ===== h_folder_postnews =====
12568 <HTML>
12569 <HEAD>
12570 <TITLE>Newsgroup selecting for Posting explained</TITLE>
12571 </HEAD>
12572 <BODY>
12573 This screen is designed to allow you to quickly and easily survey
12574 the available newsgroups and select one to post news to.
12575 <P>
12576 <!--chtml if pinemode="function_key"-->
12577 <PRE>
12578 Navigating the List of Newsgroups          General Alpine Commands
12579 ---------------------------------          -----------------------
12580 F5   Move to previous group                F1  Show this help text
12581 F6   Move to next group
12582 F7   Show previous screen of groups
12583 F8   Show next screen of groups
12584 F12  WhereIs (search group names)
12585
12586 Group Selection Commands
12587 -------------------------
12588 F3   Exit the Selection menu (without selecting a group)
12589 F4   Select the currently highlighted newsgroup
12590 </PRE>
12591 <!--chtml else-->
12592 <PRE>
12593 Navigating the List of Newsgroups          General Alpine Commands
12594 ---------------------------------          -----------------------
12595  P   Move to previous group                ?  Show this help text
12596  N   Move to next group
12597  -   Show previous screen of groups
12598 Spc  (space bar) Show next screen of groups
12599  W   WhereIs (search group names)
12600
12601 Group Selection Commands
12602 -------------------------
12603  E   Exit the Selection menu (without selecting a group)
12604  S   Select the currently highlighted newsgroup
12605 </PRE>
12606 <!--chtml endif-->
12607 <P>
12608 &lt;End of help on this topic&gt;
12609 </BODY>
12610 </HTML>
12611 ===== h_folder_save =====
12612 <HTML>
12613 <HEAD>
12614 <TITLE>Folder Select for Save Explained</TITLE>
12615 </HEAD>
12616 <BODY>
12617 This screen is designed to allow you to quickly and easily survey your
12618 folders and select one to use for saving the current message.
12619 <P>
12620
12621 <!--chtml if pinemode="function_key"-->
12622 <PRE>
12623 Navigating the List of Folders             General Alpine Commands
12624 ------------------------------             -----------------------
12625 F5   Move to previous folder               F1  Show this help text
12626 F6   Move to next folder
12627 F7   Show previous screen of folders
12628 F8   Show next screen of folders
12629 F12  WhereIs (search folder names)
12630
12631 Folder Selection Commands
12632 -------------------------
12633 F3   Exit the Folder Select menu (without selecting a folder)
12634 F4   Select the currently highlighted folder
12635 F11  AddNew folder (just like Select, but you type in a new folder name)
12636 </PRE>
12637 <!--chtml else-->
12638 <PRE>
12639 Navigating the List of Folders             General Alpine Commands
12640 ------------------------------             -----------------------
12641  P   Move to previous folder               ?  Show this help text
12642  N   Move to next folder
12643  -   Show previous screen of folders
12644 Spc  (space bar) Show next screen of folders
12645  W   WhereIs (search folder names)
12646
12647 Folder Selection Commands
12648 -------------------------
12649  E   Exit the Folder Select menu (without selecting a folder)
12650  S   Select the currently highlighted folder
12651  A   AddNew folder (just like Select, but you type in a new folder name)
12652 </PRE>
12653 <!--chtml endif-->
12654 <P>
12655 FOR MORE INFORMATION: See the section on
12656 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12657 <P>
12658 &lt;End of help on this topic&gt;
12659 </BODY>
12660 </HTML>
12661 ===== h_folder_fcc =====
12662 <HTML>
12663 <HEAD>
12664 <TITLE>Folder Select for Fcc Explained</TITLE>
12665 </HEAD>
12666 <BODY>
12667 This screen is designed to allow you to quickly and easily survey your
12668 folders and select one to use as the file carbon copy (fcc) for the
12669 current message.
12670 <P>
12671
12672 <!--chtml if pinemode="function_key"-->
12673 <PRE>
12674 Navigating the List of Folders             General Alpine Commands
12675 ------------------------------             -----------------------
12676 F5   Move to previous folder               F1  Show this help text
12677 F6   Move to next folder
12678 F7   Show previous screen of folders
12679 F8   Show next screen of folders
12680 F12  WhereIs (search folder names)
12681
12682 Folder Selection Commands
12683 -------------------------
12684 F3   Exit the Folder Select menu (without selecting a folder)
12685 F4   Select the currently highlighted folder
12686 F11  AddNew folder (just like Select, but you type in a new folder name)
12687 </PRE>
12688 <!--chtml else-->
12689 <PRE>
12690 Navigating the List of Folders             General Alpine Commands
12691 ------------------------------             -----------------------
12692  P   Move to previous folder               ?  Show this help text
12693  N   Move to next folder
12694  -   Show previous screen of folders
12695 Spc  (space bar) Show next screen of folders
12696  W   WhereIs (search folder names)
12697
12698 Folder Selection Commands
12699 -------------------------
12700  E   Exit the Folder Select menu (without selecting a folder)
12701  S   Select the currently highlighted folder
12702  A   AddNew folder (just like Select, but you type in a new folder name)
12703 </PRE>
12704 <!--chtml endif-->
12705 <P>
12706 FOR MORE INFORMATION: See the section on
12707 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12708 <P>
12709 &lt;End of help on this topic&gt;
12710 </BODY>
12711 </HTML>
12712 ===== h_folder_pattern_roles =====
12713 <HTML>
12714 <HEAD>
12715 <TITLE>Folder Select for Current Folder Explained</TITLE>
12716 </HEAD>
12717 <BODY>
12718 This screen is designed to allow you to quickly and easily survey your
12719 folders and select one to use as the specific Current Folder
12720 in a Pattern.
12721 <P>
12722
12723 <!--chtml if pinemode="function_key"-->
12724 <PRE>
12725 Navigating the List of Folders             General Alpine Commands
12726 ------------------------------             -----------------------
12727 F5   Move to previous folder               F1  Show this help text
12728 F6   Move to next folder
12729 F7   Show previous screen of folders
12730 F8   Show next screen of folders
12731 F12  WhereIs (search folder names)
12732
12733 Folder Selection Commands
12734 -------------------------
12735 F3   Exit the Folder Select menu (without selecting a folder)
12736 F4   Select the currently highlighted folder
12737 F11  AddNew folder (just like Select, but you type in a new folder name)
12738 </PRE>
12739 <!--chtml else-->
12740 <PRE>
12741 Navigating the List of Folders             General Alpine Commands
12742 ------------------------------             -----------------------
12743  P   Move to previous folder               ?  Show this help text
12744  N   Move to next folder
12745  -   Show previous screen of folders
12746 Spc  (space bar) Show next screen of folders
12747  W   WhereIs (search folder names)
12748
12749 Folder Selection Commands
12750 -------------------------
12751  E   Exit the Folder Select menu (without selecting a folder)
12752  S   Select the currently highlighted folder
12753  A   AddNew folder (just like Select, but you type in a new folder name)
12754 </PRE>
12755 <!--chtml endif-->
12756 <P>
12757 FOR MORE INFORMATION: See the section on
12758 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12759 <P>
12760 &lt;End of help on this topic&gt;
12761 </BODY>
12762 </HTML>
12763 ===== h_folder_stayopen_folders =====
12764 <HTML>
12765 <HEAD>
12766 <TITLE>Folder Select Explained</TITLE>
12767 </HEAD>
12768 <BODY>
12769 This screen is designed to allow you to quickly and easily survey your
12770 folders and select one to use as a Stay-Open folder.
12771 <P>
12772
12773 <!--chtml if pinemode="function_key"-->
12774 <PRE>
12775 Navigating the List of Folders             General Alpine Commands
12776 ------------------------------             -----------------------
12777 F5   Move to previous folder               F1  Show this help text
12778 F6   Move to next folder
12779 F7   Show previous screen of folders
12780 F8   Show next screen of folders
12781 F12  WhereIs (search folder names)
12782
12783 Folder Selection Commands
12784 -------------------------
12785 F3   Exit the Folder Select menu (without selecting a folder)
12786 F4   Select the currently highlighted folder
12787 F11  AddNew folder (just like Select, but you type in a new folder name)
12788 </PRE>
12789 <!--chtml else-->
12790 <PRE>
12791 Navigating the List of Folders             General Alpine Commands
12792 ------------------------------             -----------------------
12793  P   Move to previous folder               ?  Show this help text
12794  N   Move to next folder
12795  -   Show previous screen of folders
12796 Spc  (space bar) Show next screen of folders
12797  W   WhereIs (search folder names)
12798
12799 Folder Selection Commands
12800 -------------------------
12801  E   Exit the Folder Select menu (without selecting a folder)
12802  S   Select the currently highlighted folder
12803  A   AddNew folder (just like Select, but you type in a new folder name)
12804 </PRE>
12805 <!--chtml endif-->
12806 <P>
12807 FOR MORE INFORMATION: See the section on
12808 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12809 <P>
12810 &lt;End of help on this topic&gt;
12811 </BODY>
12812 </HTML>
12813 ===== h_folder_action_roles =====
12814 <HTML>
12815 <HEAD>
12816 <TITLE>Folder Select Explained</TITLE>
12817 </HEAD>
12818 <BODY>
12819 This screen is designed to allow you to quickly and easily survey your
12820 folders and select one to use as the folder into which messages
12821 matching this filter will be moved.
12822 <P>
12823
12824 <!--chtml if pinemode="function_key"-->
12825 <PRE>
12826 Navigating the List of Folders             General Alpine Commands
12827 ------------------------------             -----------------------
12828 F5   Move to previous folder               F1  Show this help text
12829 F6   Move to next folder
12830 F7   Show previous screen of folders
12831 F8   Show next screen of folders
12832 F12  WhereIs (search folder names)
12833
12834 Folder Selection Commands
12835 -------------------------
12836 F3   Exit the Folder Select menu (without selecting a folder)
12837 F4   Select the currently highlighted folder
12838 F11  AddNew folder (just like Select, but you type in a new folder name)
12839 </PRE>
12840 <!--chtml else-->
12841 <PRE>
12842 Navigating the List of Folders             General Alpine Commands
12843 ------------------------------             -----------------------
12844  P   Move to previous folder               ?  Show this help text
12845  N   Move to next folder
12846  -   Show previous screen of folders
12847 Spc  (space bar) Show next screen of folders
12848  W   WhereIs (search folder names)
12849
12850 Folder Selection Commands
12851 -------------------------
12852  E   Exit the Folder Select menu (without selecting a folder)
12853  S   Select the currently highlighted folder
12854  A   AddNew folder (just like Select, but you type in a new folder name)
12855 </PRE>
12856 <!--chtml endif-->
12857 <P>
12858 FOR MORE INFORMATION: See the section on
12859 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12860 <P>
12861 &lt;End of help on this topic&gt;
12862 </BODY>
12863 </HTML>
12864 ===== h_abook_config =====
12865 <HTML>
12866 <HEAD>
12867 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
12868 </HEAD>
12869 <BODY>
12870 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
12871 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
12872 <!--chtml if pinemode="function_key"-->
12873 <PRE>
12874 Available  Commands
12875 -------------------------------
12876 F1  Show Help Text
12877 F3  Back to MAIN Alpine menu
12878 F4  Change configuration for address book
12879 F5  Move to previous address book
12880 F6  Move to next address book
12881 F7  Previous page of address books
12882 F8  Next page of address books
12883 F9  Add new address book
12884 F10 Delete existing address book
12885 F11 Shuffle the order of address books
12886 F12 Whereis (search address book titles)
12887 </PRE>
12888 <!--chtml else-->
12889 <PRE>
12890 Navigation                     General Alpine Commands
12891 -----------------------        -----------------------
12892  P  Prev Address Book           ?  Display this help text
12893  N  Next Address Book           E  Back to MAIN Alpine menu
12894  -  Previous page
12895 Spc (space bar) Next page
12896  W  WhereIs (search for word in address book titles)
12897
12898 Setup Address Books Commands
12899 ------------------------------------------------
12900  A  Add new address book          $  Shuffle the order of address books
12901  D  Delete existing address book  C  Change configuration for address book
12902 </PRE>
12903 <!--chtml endif-->
12904
12905 <H2>Description of the Setup Address Books Screen</H2>
12906
12907 This screen lets you add, delete, modify, or change the order of your
12908 address books.  The &quot;Add Abook&quot; command brings up a blank form to
12909 fill in.  If you are adding a remote address book on an IMAP server
12910 you should fill in the name of the IMAP server.  Otherwise, leave
12911 that field blank.  (Note that remote IMAP address books are an Alpine
12912 concept and are unlikely to interoperate with other mail clients.)
12913 For a remote address book, fill in the name of the remote folder
12914 in the Folder field.  This should be a folder that is used only for
12915 this one purpose, not a general purpose folder you expect to store
12916 messages in.
12917 <P>If you are adding a local address book, fill in the
12918 Folder Name field with a local file name (e.g., .addressbook).
12919 <P>
12920 <B>Please note:</B> Remote address books stored on an IMAP server are
12921 of an entirely different format (namely, a special-purpose
12922 &quot;mail folder&quot;) than that of the local addressbook familiar
12923 to Alpine users.  Therefore,
12924 you cannot use &quot;add a remote address book&quot; to make an existing
12925 Alpine .addressbook file you may have on a remote IMAP server accessible to
12926 Alpine running on a different host.
12927 <P>
12928
12929 The &quot;Del Abook&quot; command allows you to remove an address book
12930 from your configuration.  It will also ask you if you wish to remove
12931 the data for that address book, which would erase all traces of the
12932 address book if you answer Yes.
12933 <P>
12934
12935 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
12936 The difference is that instead of adding a new address book to your
12937 configuration, you are changing the configuration of an existing entry.
12938 For example, you might want to correct a typing error or change a
12939 nickname.  The &quot;Change&quot; command is not a move command.  If you
12940 change the folder name or server name the data will not be moved for you.
12941 <P>
12942
12943 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
12944 an address book toward another address book in the same group then
12945 the order of those two address books will be swapped.  If you shuffle
12946 the last Personal address book down towards the Global address book
12947 section, it will become a Global address book.  If you shuffle
12948 the first Global address book up it will become a Personal address
12949 book.  The main difference between Personal and Global address
12950 books is that Global address books are forced read-only.
12951 <P><UL>
12952 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12953 </UL>
12954 <P>
12955 &lt;End of help on this topic&gt;
12956 </BODY>
12957 </HTML>
12958 ===== h_abook_top =====
12959 <HTML>
12960 <HEAD>
12961 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
12962 </HEAD>
12963 <BODY>
12964 <H1>ADDRESS BOOK LIST COMMANDS</H1>
12965 <!--chtml if pinemode="function_key"-->
12966 <PRE>
12967 Available  Commands -- Group 1         Available Commands -- Group 2
12968 -------------------------------        ------------------------------
12969 F1  Show Help Text                      F1  Show Help Text
12970 F2  See commands in next group          F2  See commands in next group
12971 F3  Exit to MAIN MENU                   F3  Quit Alpine
12972 F4  View/Edit selected address book
12973 F5  Move to previous address book       F5  FOLDER LIST screen
12974 F6  Move to next address book           F6  Specify a folder to go to
12975 F7  Previous page                       F7  MESSAGE INDEX screen
12976 F8  Next page                           F9  Print list of address books
12977 F12 Whereis (search for word)
12978 </PRE>
12979 <!--chtml else-->
12980 <PRE>
12981 Navigation                       General Alpine Commands
12982 -----------------------          -----------------------
12983  P  Previous Entry                ?  Display this help text
12984  N  Next Entry                    O  Show all other available commands
12985  -  Previous page                 &lt;  Back to MAIN Alpine menu
12986 Spc (space bar) Next page         Q  Quit Alpine
12987  W  WhereIs (search for word)     L  FOLDER LIST screen
12988                                   G  Specify a folder to go to
12989 Address Book Commands             I  MESSAGE INDEX screen
12990 ------------------------------------------------
12991  &gt;  View/Edit selected address book
12992               or
12993  &gt;  Search on selected directory server
12994
12995  %  Print list of address books and directory servers
12996 </PRE>
12997 <!--chtml endif-->
12998
12999 <H2>Description of the Address Book List Screen</H2>
13000
13001 From this screen you may choose which address book you wish to view
13002 or edit. For more information on address books, view one of your
13003 address books (with
13004 <!--chtml if pinemode="function_key"-->
13005 F4
13006 <!--chtml else-->
13007 &quot;&gt;&quot;
13008 <!--chtml endif-->)
13009 and see the Help Text there.<P>
13010
13011 You may also choose a directory server on which to search for entries.
13012 You do that by highlighting the directory server line and using
13013 <!--chtml if pinemode="function_key"-->
13014 F4
13015 <!--chtml else-->
13016 &quot;&gt;&quot;
13017 <!--chtml endif-->.<P>
13018
13019 If you wish to define new address books or directory servers go to the Main
13020 menu and choose Setup. You may then either choose to setup AddressBooks or
13021 Directory (among other things). It's possible that the Directory option
13022 will not be there if the Alpine you are using does not contain LDAP directory
13023 lookup functionality.
13024
13025 <P><UL>
13026 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13027 </UL><P>
13028 &lt;End of help on this topic&gt;
13029 </BODY>
13030 </HTML>
13031 ===== h_abook_opened =====
13032 <HTML>
13033 <HEAD>
13034 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
13035 </HEAD>
13036 <BODY>
13037 <H1>THE ALPINE ADDRESS BOOK</H1>
13038 <H2>ADDRESS BOOK COMMANDS</H2>
13039 <PRE>
13040 <!--chtml if pinemode="function_key"-->
13041 Available  Commands -- Group 1         Available Commands -- Group 2
13042 -------------------------------        ------------------------------
13043 F1  Show Help Text                      F1  Show Help Text
13044 F2  See commands in next group          F2  See commands in next group
13045 F3  Exit this screen                    F3  Quit Alpine
13046 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
13047 F5  Move to previous entry              F5  FOLDER LIST screen
13048 F6  Move to next entry                  F6  Specify a folder to go to
13049 F7  Previous page of address book       F7  MESSAGE INDEX screen
13050 F8  Next page of address book           F8  Compose to entry using roles
13051 F9  Add new entry to address book       F9  Print address book
13052 F10 Delete selected entry               F10 TakeAddr to another addrbook
13053 F11 Compose to selected entry           F11 Save or Export addrbook selections
13054 F12 Whereis (search address book)       F12 Forward entry by mail
13055
13056 Available Commands -- Group 3
13057 ------------------------------
13058 F3  Select                              F6  Zoom (or unZoom)
13059 F5  Select Current                      F7  Apply Command to Selection
13060 <!--chtml else-->
13061 Address Book Navigation        General Alpine Commands
13062 -----------------------        -----------------------
13063  P  Prev Address                  ?  Display this help text
13064  N  Next Address                  O  Show all other available commands
13065  -  Previous page of address book M  Back to MAIN MENU
13066 Spc (space bar) Next page         Q  Quit Alpine
13067  W  WhereIs (search for word      C  Compose message to selected addr
13068      or name in address book)     #  Compose to addr using roles
13069  &lt;  To List of Address Books if   L  FOLDER LIST screen
13070      more than one, else to MAIN  G  Specify a folder to go to
13071                                   I  MESSAGE INDEX screen
13072
13073 Address Book Commands
13074 ----------------------------------------------------
13075  &gt;  View/Update selected entry    D  Delete selected entries
13076  %  Print address book            S  Save or Export address book selections
13077  F  Forward entries by mail       @  Add new entry to address book
13078
13079  ;  Select command                Z  Toggle Zoom Mode
13080  :  Select highlighted entry      A  Apply command to selected entries
13081
13082 <!--chtml endif-->
13083 </PRE>
13084 Note:  The presence or absence of the final four commands above is
13085 controlled by the option
13086 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
13087 <P>
13088
13089 <H2>Description of the Address Book Screen</H2>
13090
13091 This screen lets you edit and manage entries in your address book.  It
13092 also acts as a short-cut for composing messages to people in the address
13093 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
13094 message starts &quot;pre-addressed&quot; to whatever address book entry is
13095 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
13096 role to use in your composition.
13097 <P>
13098 Alpine's address book helps you keep a list of addresses you send email to so
13099 you do not have to remember addresses that are often complex.  Each entry
13100 in the address book has five fields, all of them optional.  The three
13101 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
13102
13103         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
13104         This is what you type in as you are addressing the message in the
13105         composer.  If there is a matching entry in your address book(s),
13106         Alpine will extract the corresponding FullName and Address fields to
13107         generate the actual address for your message.
13108
13109         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
13110 of the
13111         person or organization.  Usually the full names are put in last
13112         name first so they sort nicely in alphabetical order.  Whatever
13113         you put as the name here will appear on the message when it is
13114         finally delivered.  Examples:<PRE>
13115            Garcia Marquez, Gabriel
13116            Henscheid, Eckhard
13117            Alpine-Info mailing list
13118            Library materials renewal requests
13119            Kim An-guk
13120            &quot;George III, King of Great Britain, 1738-1820&quot;
13121 </PRE>
13122 (In the second-to-last example, no comma is used in the name so that
13123 the family name appears first in the address book and when the entry is
13124 used in the composer.
13125 In the last example, retaining the commas is intended;
13126 double-quotation marks surround the name to
13127 prevent the transposition of its parts when the entry is used in
13128 the composer.)
13129
13130         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
13131         a valid Internet address that conforms to the Internet message
13132         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
13133
13134 The two fields that aren't usually visible are:<DL>
13135
13136   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
13137         message to this address to be saved in.  If this field is set, and
13138         this address is the first one in the message's To: header, then
13139         Alpine will use this folder name for the FCC in lieu of the normal
13140         FCC folder name.
13141
13142   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
13143         </DL>
13144 <P>
13145 Due to screen width limitations, these last two fields do not show up in
13146 the normal ADDRESS BOOK display.  You may select the
13147 &quot;View/Update&quot; command to
13148 view or modify them.  You may use the configuration variable
13149 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
13150 to add these fields to your ADDRESS BOOK
13151 display, or to modify the format of the display.
13152
13153 <H2>Sorting the Address book</H2>
13154
13155 By default, address book entries are sorted alphabetically on the full
13156 name with distribution lists sorted to the end.  Sorting can be changed by
13157 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
13158 --assuming you have &quot;write&quot; permission for the address book file.
13159 <P>
13160 Unlike the sorting of folders (which only changes presentation), sorting an
13161 address book actually changes the file as it is kept on the computer.  For
13162 this reason you won't be able to sort a shared or system-wide address
13163 book.
13164
13165 <H2>Adding New Entries</H2>
13166
13167 The easiest way to add new entries to your address book is to use the
13168 &quot;TakeAddr&quot; command when viewing a message.
13169 This command allows you to take addresses from the header and body of the
13170 message and put them into your address book, without having to type
13171 them in.
13172 <P>
13173
13174 To manually add a new entry from within the address book screen, use the AddNew
13175 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
13176 Use this command both for adding a simple alias and for adding a
13177 distribution list.
13178
13179 <H2>Distribution Lists</H2>
13180
13181 Address book entries can be simple cases of aliases (a single nickname is linked
13182 to a single email address) or distribution lists (a single nickname
13183 pointing at more than one email address).  Each distribution list has a
13184 nickname, a full name and a list of addresses.  The addresses may be
13185 actual addresses or they may be other nicknames in your address book.
13186 They may even refer to other distribution lists.
13187 There's really no difference between a simple alias and a distribution list,
13188 other than the number of addresses.
13189 Therefore, you can turn a simple alias with one address into a distribution
13190 list simply by adding more addresses.
13191 To add entries to an existing list or alias
13192 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
13193 a single address from the list if the cursor is placed on the address;
13194 it will delete the entire distribution list if the cursor is on the
13195 nickname/fullname line.  View/Update may also be used to delete addresses
13196 from a list.
13197 <P>
13198 Address field entries in distribution lists may take any one of three
13199 forms: a nickname existing in any of the defined address books, a normal
13200 address of the form &quot;jsmith@art.example.com&quot;, or a complete
13201 fullname/address combination, e.g. &quot;John Smith
13202 &lt;jsmith@art.example.com&gt;&quot;.
13203 <P>
13204 Distribution lists in Alpine address books can only be used by the person or
13205 people who have access to that address book.  They are not usually used to
13206 implement discussion groups, but can be used to facilitate small
13207 discussion groups if all the participants have access to the same shared
13208 address book.
13209
13210 <H2>FCC and Comments</H2>
13211
13212 As mentioned above, each entry in the address book also has two other optional
13213 fields, Fcc and Comments.  The command to look at or change either of these
13214 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
13215 Comments field is just for your own use.  The Fcc field overrides the
13216 default Fcc if this address is the first one on the To line.  The WhereIs
13217 command may be used to search for particular strings in the address book,
13218 including fields that are not visible (like Comment and Fcc by default).
13219
13220 <H2>Aggregate Operations</H2>
13221
13222 If the feature
13223 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
13224 is turned on (the default), then the four commands &quot;Select&quot;,
13225 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
13226 are available.  The two selection commands allow you to mark a set of
13227 address book entries as being selected.  If you have more than one address
13228 book, the selections may be in more than one of those address books.
13229 The &quot;Zoom&quot; command will toggle between displaying only the selected
13230 entries and all of the entries.  The &quot;Apply&quot; command allows you to
13231 apply one of the regular address book commands to all of the selected
13232 entries.  Usually the address book commands apply to only the entry
13233 highlighted by the cursor.  The &quot;Apply&quot; command works with the
13234 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
13235 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
13236
13237 <H2>Exporting and Forwarding Address book entries</H2>
13238
13239 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
13240 address book entry is placed in a plain text file in your home directory
13241 <!--chtml if pinemode="running"-->
13242 (which, in the present configuration of your system, is
13243  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13244 <!--chtml endif-->
13245 or current working directory
13246 <!--chtml if pinemode="running"-->
13247 (which, at least for your current Alpine &quot;session,&quot;
13248 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13249 <!--chtml endif-->, depending on the
13250 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13251 configuration setting.  If you have some entries selected and use the
13252 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
13253 placed in the text file.
13254 <P>
13255 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
13256 address book entry is placed in a special attachment and you are put into
13257 the composer.  You can fill in some comments in the body of the message,
13258 if you'd like, and send it to somebody else who uses Alpine.  The recipient
13259 may use the TakeAddr command on that message to insert the address book
13260 entry you sent in their own address book.  If you have some entries
13261 selected and use the Apply Forward command all of the selected entries
13262 will be forwarded in a single message.  You may
13263 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.
13264 The recipient must be using Alpine in order to receive this correctly.
13265 One way for the recipient to handle this might be to create an empty
13266 address book and then &quot;Take&quot; your forwarded address book entries into
13267 that empty address book.
13268
13269 <H2>Multiple and/or Site-Wide Address books</H2>
13270
13271 You may have more than one personal address book.  In addition, there may
13272 be one or more global address books.  This capability allows you to have
13273 multiple personal address books (some of which may be shared) and it also
13274 allows system administrators to implement site-wide address books that
13275 contain entries for users on multiple machines within the organization.
13276 <P><DL>
13277 <DT>Searching
13278   <DD> If you enter a nickname when composing a message, your
13279   personal address books will be searched through in order, and then the
13280   global address book(s) searched. If more than one address book has an entry
13281   for the nickname, Alpine uses the first one that it finds, so an entry in
13282   your personal address book would override a global address book entry. If
13283   after searching all the address books there is still no match, (Unix) Alpine
13284   then searches the local host password file on the assumption that you have
13285   entered a local user name rather than an address book nickname.
13286   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
13287   command, but global address books are always searched after personal
13288   address books.
13289
13290   <P><DT>Tab completion
13291   <DD> If the
13292   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
13293   feature is turned on (the default) then the Tab key may be used
13294   in the composer to complete partially typed nicknames in the To
13295   or Cc lines. You type the first few letters of a nickname and then
13296   press the Tab key. It there is only one nickname that matches it will
13297   be filled in by Alpine. If there is more than one the unambiguous part
13298   of the nicknames will be filled in. For example, if your address book or
13299   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
13300   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
13301   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
13302   If you then type a second Tab character you will be presented with a list
13303   of matching nicknames to select from. Alternatively, you could type another
13304   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
13305   in the entire &quot;barbecue&quot; entry.
13306
13307   <P><DT>Defining
13308   <DD> You define multiple personal address books in the
13309   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
13310   from the MAIN MENU.
13311   You may add as many as you like.  Global address books are usually
13312   site-wide address books defined by the System administrator, but
13313   you may define global address books of your own just like you define
13314   personal address books.
13315
13316   <P><DT>Creating and updating
13317   <DD> Personal address books are normally created empty
13318   and populated by explicit additions from within Alpine, e.g. via the
13319   TakeAddr command.  Unlike personal address books, global address books may
13320   not be modified/updated from within Alpine; that is, they are Read-Only.
13321   Thus, global address books are created, populated and updated outside of
13322   Alpine. They might be hand-edited, generated by a program from another
13323   database, or by copying an existing address book.  They might also be
13324   some other user's personal address book, and so be modified normally by
13325   that user but accessed Read-Only by you.  See the Alpine Technical
13326   Notes document (included in the Alpine distribution) for more information on
13327   this.
13328
13329   <P><DT>Accessing
13330   <DD>There are two different types of address books in Alpine.
13331   A local address book is stored in a regular file and the normal file
13332   access permissions apply.  A remote address book is stored on an IMAP
13333   server in a special folder that contains only messages pertaining to
13334   that address book.  The last message in the remote folder contains a
13335   copy of the address book data, and that data is copied to a local cache
13336   file in your home directory.  From there it is accessed just like a local
13337   address book.  The name of the cache file is kept track of in a special
13338   file called the
13339   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
13340   the name of which is stored in
13341   your Alpine configuration file the first time you use a remote address book.
13342   Just as local Alpine address books use a format that only Alpine understands,
13343   remote Alpine address books do the same and other mail reading programs
13344   are unlikely to be able to understand them.<P>
13345   While global address books are explicitly intended to be shared, there is
13346   nothing to prevent you from sharing a personal address book with other
13347   Alpine users. This might be useful in the case of a small workgroup.
13348   However, it is recommended that updates to shared personal address books
13349   be done when other Alpine users are not accessing the address book. Alpine
13350   does not do any file-locking to manage concurrent updates to the
13351   addressbook, but it does check to see if the file has been modified before
13352   making any changes.  Consequently, inadvertent concurrent updates will
13353   only cause other Alpine users to have to restart their address book
13354   operation, which will cause Alpine to reopen the updated file.
13355
13356   <P><DT>Converting to Remote
13357   <DD>The easiest way to convert an existing local
13358   address book into a remote address book is to create an empty new remote
13359   personal address book by typing &quot;A&quot; to execute the
13360   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
13361   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
13362   address book.
13363   After you have added the empty
13364   remote address book, go into the screen for the address book you wish
13365   to copy and &quot;Select&quot; &quot;All&quot;.
13366   This selects every entry in that
13367   address book.  Then type the command &quot;Apply Save&quot;.
13368   You will be asked for the address book to save to.  You may use ^P and ^N
13369   to get to the new empty address book, then hit RETURN and the addresses
13370   will be copied.
13371   At this point you'll probably want to unselect all the entries in the local
13372   address book before proceeding. You do that with
13373   &quot;Select&quot; &quot;unselect All&quot;.
13374
13375 </DL>
13376 <UL>
13377 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13378 </UL>
13379 <P><UL>
13380 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13381 </UL>
13382 <P>
13383 &lt;End of help on this topic&gt;
13384 </BODY>
13385 </HTML>
13386 ===== h_abook_select_addr =====
13387 <HTML>
13388 <HEAD>
13389 <TITLE>Addressbook Selection Explained</TITLE>
13390 </HEAD>
13391 <BODY>
13392 <H1>SELECT ADDRESS</H1>
13393 <!--chtml if pinemode="function_key"-->
13394 <PRE>
13395 Navigating the List of Messages               General Alpine Commands
13396 -------------------------------               -----------------------
13397 F5   Move to previous entry                   F1  Show this help text
13398 F6   Move to next entry
13399 F7   Show previous screen of address book
13400 F8   Show next screen of address book
13401 F12  WhereIs (search through address book)
13402
13403 Address Selection Commands
13404 --------------------------
13405 F3   Exit the Address Select screen (without selecting an address)
13406 F4   Select the currently highlighted entry
13407 </PRE>
13408 <!--chtml else-->
13409 <PRE>
13410 Navigating the List of Messages               General Alpine Commands
13411 -------------------------------               -----------------------
13412  P   Move to previous entry                    ?  Show this help text
13413  N   Move to next entry
13414  -   Show previous screen of address book
13415 Spc  (space bar) Show next screen of address book
13416  W   WhereIs (search through address book)
13417
13418 Address Selection Commands
13419 --------------------------
13420  E   Exit the Address Select screen (without selecting an address)
13421  S   Select the currently highlighted entry
13422 </PRE>
13423 <!--chtml endif-->
13424 <P>
13425
13426 This screen is designed to let you easily scan your address book(s) in
13427 order to select an entry for the message you are composing.  You cannot
13428 edit your address book in any way at this time, for address book
13429 maintenance, select the address book command when not composing a message.
13430 <P>
13431
13432 If you are composing a message and know the nickname of the person/list you
13433 want, you can bypass this screen by simply typing in the nickname on the
13434 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
13435 selecting an entry does not cancel your message.
13436 <P>
13437
13438 FOR MORE INFORMATION on addressing see
13439 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13440 <A HREF="h_abook_opened">Address Book Screen's</A>
13441 help text.
13442 <P>
13443 &lt;End of help on this topic&gt;
13444 </BODY>
13445 </HTML>
13446 ===== h_abook_select_top =====
13447 <HTML>
13448 <HEAD>
13449 <TITLE>Addressbook Selection Navigation Explained</TITLE>
13450 </HEAD>
13451 <BODY>
13452 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
13453 <!--chtml if pinemode="function_key"-->
13454 <PRE>
13455 Navigating the List of Address Books       General Alpine Commands
13456 ------------------------------------       -----------------------
13457 F4   View the highlighted address book
13458 F5   Move to previous address book         F1  Show this help text
13459 F6   Move to next address book
13460 F7   Show previous screen of address books
13461 F8   Show next screen of address books
13462 F12  WhereIs (search through address books)
13463
13464 Address Selection Commands
13465 --------------------------
13466 F3   Exit the Address Select screen (without selecting an address)
13467 F4   Select the currently selected entries (if using ListMode)
13468 F9   Change to ListMode
13469 </PRE>
13470 <!--chtml else-->
13471 <PRE>
13472 Navigating the List of Address Books       General Alpine Commands
13473 ------------------------------------       -----------------------
13474  &gt;   View the highlighted address book
13475  P   Move to previous address book         ?  Show this help text
13476  N   Move to next address book
13477  -   Show previous screen of address books
13478 Spc  (space bar) Show next screen of address books
13479  W   WhereIs (search through address books)
13480
13481 Address Selection Commands
13482 --------------------------
13483  E   Exit the Address Select screen (without selecting an address)
13484  S   Select the currently selected entries (if using ListMode)
13485  L   Change to ListMode
13486 </PRE>
13487 <!--chtml endif-->
13488 <P>
13489
13490 This screen is designed to let you easily scan your address book(s) in
13491 order to select entries for the message you are composing.  You cannot
13492 edit your address book in any way at this time.  For address book
13493 maintenance, select the address book command when not composing a message.
13494 <P>
13495
13496 If you are composing a message and know the nickname of the person/list you
13497 want, you can bypass this screen by simply typing in the nickname on the
13498 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
13499 selecting an entry does not cancel your message.
13500 <P>
13501
13502 The ListMode command will add a column at the left edge of the screen.
13503 You mark the entries that you wish to select with the &quot;X&quot; command.
13504 This allows you to choose more than one entry at a time.
13505 <P>
13506
13507 An alternative method of composing a message to entries in your
13508 address book(s) is to first use the &quot;Select&quot; command from
13509 the address book maintenance screen and then the &quot;Apply&quot;
13510 &quot;ComposeTo&quot; command to start the composer composing to the
13511 selected entries.
13512 <P>
13513
13514 FOR MORE INFORMATION on addressing see
13515 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13516 <A HREF="h_abook_opened">Address Book Screen's</A>
13517 help text.
13518 <P>
13519 &lt;End of help on this topic&gt;
13520 </BODY>
13521 </HTML>
13522 ===== h_abook_select_listmode =====
13523 <HTML>
13524 <HEAD>
13525 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
13526 </HEAD>
13527 <BODY>
13528 <H1>COMPOSER: SELECT ADDRESSES</H1>
13529 <!--chtml if pinemode="function_key"-->
13530 <PRE>
13531 Navigating the List of Messages                 General Alpine Commands
13532 -------------------------------                 -----------------------
13533 F5   Move to previous entry                     F1  Show this help text
13534 F6   Move to next entry
13535 F7   Show previous screen of address book
13536 F8   Show next screen of address book
13537 F12  WhereIs (search through address book)
13538
13539 Address Selection Commands
13540 --------------------------
13541 F3   Exit the Address Select screen (without selecting an address)
13542 F4   Select the currently highlighted entry
13543 F9   Change to ListMode
13544 </PRE>
13545 <!--chtml else-->
13546 <PRE>
13547 Navigating the List of Messages                 General Alpine Commands
13548 -------------------------------                 -----------------------
13549  P   Move to previous entry                     ?  Show this help text
13550  N   Move to next entry
13551  -   Show previous screen of address book
13552 Spc  (space bar) Show next screen of address book
13553  W   WhereIs (search through address book)
13554
13555 Address Selection Commands
13556 --------------------------
13557  E   Exit the Address Select screen (without selecting an address)
13558  S   Select the currently highlighted entry
13559  L   Change to ListMode
13560 </PRE>
13561 <!--chtml endif-->
13562 <P>
13563
13564 This screen is designed to let you easily scan your address book(s) in
13565 order to select entries for the message you are composing.  You cannot
13566 edit your address book in any way at this time, for address book
13567 maintenance, select the address book command when not composing a message.
13568 <P>
13569
13570 If you are composing a message and know the nickname of the person/list you
13571 want, you can bypass this screen by simply typing in the nickname on the
13572 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
13573 selecting an entry does not cancel your message.
13574 <P>
13575
13576 The ListMode command will add a column at the left edge of the screen.
13577 You mark the entries that you wish to select with the &quot;X&quot; command.
13578 This allows you to choose more than one entry at a time.
13579 <P>
13580
13581 An alternative method of composing a message to entries in your
13582 address book(s) is to first use the &quot;Select&quot; command from
13583 the address book maintenance screen and then the &quot;Apply&quot;
13584 &quot;ComposeTo&quot; command to start the composer composing to the
13585 selected entries.
13586 <P>
13587
13588 FOR MORE INFORMATION on addressing see
13589 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13590 <A HREF="h_abook_opened">Address Book Screen's</A>
13591 help text.
13592 <P>
13593 &lt;End of help on this topic&gt;
13594 </BODY>
13595 </HTML>
13596 ===== h_abook_select_checks =====
13597 <HTML>
13598 <HEAD>
13599 <TITLE>Address Selection from Composer Explained</TITLE>
13600 </HEAD>
13601 <BODY>
13602 <H1>COMPOSER: SELECT ADDRESSES</H1>
13603 <!--chtml if pinemode="function_key"-->
13604 <PRE>
13605 Navigating the List of Messages                 General Alpine Commands
13606 -------------------------------                 -----------------------
13607 F5   Move to previous entry                     F1  Show this help text
13608 F6   Move to next entry
13609 F7   Show previous screen of address book
13610 F8   Show next screen of address book
13611 F12  WhereIs (search through address book)
13612
13613 Address Selection Commands
13614 --------------------------
13615 F3   Exit the Address Select screen (without selecting an address)
13616 F4   Select the currently highlighted entry
13617 F8   Either Sets or Unsets all entries in this address book
13618 F9   Set or Unset the highlighted entry
13619 </PRE>
13620 <!--chtml else-->
13621 <PRE>
13622 Navigating the List of Messages                 General Alpine Commands
13623 -------------------------------                 -----------------------
13624  P   Move to previous entry                     ?  Show this help text
13625  N   Move to next entry
13626  -   Show previous screen of address book
13627 Spc  (space bar) Show next screen of address book
13628  W   WhereIs (search through address book)
13629
13630 Address Selection Commands
13631 --------------------------
13632  E   Exit the Address Select screen (without selecting an address)
13633  S   Select the currently highlighted entry
13634  X   Set or Unset the highlighted entry
13635  A   Either Sets or Unsets all entries in this address book
13636 </PRE>
13637 <!--chtml endif-->
13638 <P>
13639
13640 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
13641 command.  Type &quot;S Select&quot; to select all of the entries you
13642 have marked, just as if you had typed them in by hand.
13643 <P>
13644
13645 An alternative method of composing a message to entries in your
13646 address book(s) is to first use the &quot;Select&quot; command from
13647 the address book maintenance screen and then the &quot;Apply&quot;
13648 &quot;ComposeTo&quot; command to start the composer composing to the
13649 selected entries.
13650 <P>
13651
13652 FOR MORE INFORMATION on addressing see
13653 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13654 <A HREF="h_abook_opened">Address Book Screen's</A>
13655 help text.
13656 <P>
13657 &lt;End of help on this topic&gt;
13658 </BODY>
13659 </HTML>
13660 ===== h_abook_select_nicks_take =====
13661 <HTML>
13662 <HEAD>
13663 <TITLE>Take Address Nickname Selection Explained</TITLE>
13664 </HEAD>
13665 <BODY>
13666 <H1>TAKEADDR: SELECT NICKNAME</H1>
13667 <!--chtml if pinemode="function_key"-->
13668 <PRE>
13669 Navigating the List of Messages                 General Alpine Commands
13670 -------------------------------                 -----------------------
13671 F5   Move to previous entry                     F1  Show this help text
13672 F6   Move to next entry
13673 F7   Show previous screen of address book
13674 F8   Show next screen of address book
13675 F12  WhereIs (search through address book)
13676
13677 Message Selection Commands
13678 --------------------------
13679 F3   Exit the Nickname Select screen (without selecting an address)
13680 F4   Select the currently highlighted entry
13681 </PRE>
13682 <!--chtml else-->
13683 <PRE>
13684 Navigating the List of Messages                 General Alpine Commands
13685 -------------------------------                 -----------------------
13686  P   Move to previous entry                     ?  Show this help text
13687  N   Move to next entry
13688  -   Show previous screen of address book
13689 Spc  (space bar) Show next screen of address book
13690  W   WhereIs (search through address book)
13691
13692 Message Selection Commands
13693 --------------------------
13694  E   Exit the Nickname Select screen (without selecting an address)
13695  S   Select the currently highlighted entry
13696 </PRE>
13697 <!--chtml endif-->
13698 <P>
13699
13700 This screen is designed to let you modify or add to an existing
13701 address book entry.  You have already selected the name(s) and
13702 address(es) through &quot;Take Address&quot;.  This screen simply lets
13703 you scan your address books and select the nickname to be
13704 changed/augmented.  If you want to add a new entry, then you are in
13705 the wrong place-- Select &quot;Exit&quot; command.
13706 <P>
13707
13708 FOR MORE INFORMATION on addressing see
13709 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13710 <A HREF="h_abook_opened">Address Book Screen's</A>
13711 help text.
13712 <P>
13713 &lt;End of help on this topic&gt;
13714 </BODY>
13715 </HTML>
13716 ===== h_abook_select_nick =====
13717 <HTML>
13718 <HEAD>
13719 <TITLE>Nickname Selection Explained</TITLE>
13720 </HEAD>
13721 <BODY>
13722 <H1>SELECT NICKNAME</H1>
13723 <!--chtml if pinemode="function_key"-->
13724 <PRE>
13725 Navigating the List of Messages                 General Alpine Commands
13726 -------------------------------                 -----------------------
13727 F5   Move to previous entry                     F1  Show this help text
13728 F6   Move to next entry
13729 F7   Show previous screen of address book
13730 F8   Show next screen of address book
13731 F12  WhereIs (search through address book)
13732
13733 Message Selection Commands
13734 --------------------------
13735 F3   Exit the Nickname Select screen (without selecting an address)
13736 F4   Select the currently highlighted entry
13737 </PRE>
13738 <!--chtml else-->
13739 <PRE>
13740 Navigating the List of Messages                 General Alpine Commands
13741 -------------------------------                 -----------------------
13742  P   Move to previous entry                     ?  Show this help text
13743  N   Move to next entry
13744  -   Show previous screen of address book
13745 Spc  (space bar) Show next screen of address book
13746  W   WhereIs (search through address book)
13747
13748 Message Selection Commands
13749 --------------------------
13750  E   Exit the Nickname Select screen (without selecting an address)
13751  S   Select the currently highlighted entry
13752 </PRE>
13753 <!--chtml endif-->
13754 <P>
13755
13756 This screen is designed to let you look at the nicknames in your address
13757 books before choosing a new one.
13758 <P>
13759
13760 FOR MORE INFORMATION on addressing see
13761 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13762 <A HREF="h_abook_opened">Address Book Screen's</A>
13763 help text.
13764 <P>
13765 &lt;End of help on this topic&gt;
13766 </BODY>
13767 </HTML>
13768 ===== h_takeaddr_screen =====
13769 <HTML>
13770 <HEAD>
13771 <TITLE>Take Address Screen Explained</TITLE>
13772 </HEAD>
13773 <BODY>
13774 <H1>TAKE ADDRESS COMMANDS</H1>
13775 <!--chtml if pinemode="function_key"-->
13776 <PRE>
13777 Navigating the List of Addresses       Address Selection Commands
13778 --------------------------------       --------------------------
13779  F5  Move to previous entry            F3  Exit without taking address
13780  F6  Move to next entry                F4  Take current address(es)
13781  F7  Show previous page of address list
13782  F8  Show next page of address list
13783  F2  WhereIs (search list)
13784                                --------------
13785 Mode Toggle            F9  Set/Unset current address
13786 -----------            F10 Set all
13787  F12 Toggle between List and single mode       F11 Unset all
13788 </PRE>
13789 <!--chtml else-->
13790 <PRE>
13791 Navigating the List of Addresses       Address Selection Commands
13792 --------------------------------       --------------------------
13793  P  Move to previous entry              &lt;  Exit without taking address
13794  N  Move to next entry                  T  Take address
13795  -  Show previous page of address list
13796 Spc (space bar) Show next page of address list
13797  W  WhereIs (search list)              List Mode
13798                                        ---------
13799 Single Mode                             X  Set/Unset current address
13800 -----------                             A  Set all addresses
13801  L  Switch to list mode                 U  Unset all addresses
13802                                         S  Switch to single mode
13803 </PRE>
13804 <!--chtml endif-->
13805
13806 <H2>Description of the Take Address Screen</H2>
13807
13808 This screen is designed to let you select one or more address/name
13809 combinations from the current message and put them into your address book.
13810 The cursor is initially placed on the line with the message author.
13811 Other lines include the names of people and/or mailing lists who also
13812 received the message.  Other people &quot;involved&quot; in the
13813 message (e.g. the person named as Reply-To:) are also listed here.
13814 <P>
13815
13816 The simple case is adding a new, single entry into your address book. To
13817 do this, simply highlight the correct line and press
13818 <!--chtml if pinemode="function_key"-->
13819 F4.
13820 <!--chtml else-->
13821 &quot;T&quot;.
13822 <!--chtml endif-->
13823 To create a new list or add to an existing list, switch the screen display
13824 into List Mode by pressing
13825 <!--chtml if pinemode="function_key"-->
13826 F12.
13827 <!--chtml else-->
13828 &quot;L&quot;.
13829 <!--chtml endif-->
13830 In List Mode, you select the
13831 group of addresses you wish to manipulate by marking them with an
13832 &quot;X&quot;.
13833 The Set/Unset
13834 <!--chtml if pinemode="function_key"-->
13835 (F9)
13836 <!--chtml else-->
13837 (&quot;X&quot;)
13838 <!--chtml endif-->
13839 command will turn the &quot;X&quot; on for the
13840 highlighted address if it was off or turn it off if it was previously on.
13841 The SetAll command will select all of the addresses, and the UnSetAll
13842 command will turn off all the selections.  Once you've gotten the
13843 selection the way you want it, you may create a new list by pressing
13844 <!--chtml if pinemode="function_key"-->
13845 F4.
13846 <!--chtml else-->
13847 &quot;T&quot;.
13848 <!--chtml endif-->
13849 <P>
13850
13851 In both the simple and list cases, after choosing to take the address,
13852 you will be asked for the nickname of the entry.  Typing in a new name
13853 creates the new entry/list.  Entering an existing nickname will replace
13854 the entry (simple case) or add to the list (list case).  Alternatively,
13855 you can press Ctrl-T at the nickname prompt and select an existing
13856 nickname from your address book.
13857 <P>
13858
13859 You will normally start in Single Mode, unless you used the Apply command
13860 to startup the TakeAddr screen, in which case you will start in List Mode.
13861 You may switch between the two modes at any time.  If you've already
13862 selected several addresses in List Mode, those will be remembered when you
13863 switch to Single Mode and then back to List Mode.  The set of addresses
13864 that are pre-selected when you start in List Mode are the From addresses
13865 of all of the messages you are operating on.  You may, of course, easily
13866 erase those selections with the UnSetAll command.
13867 <P>
13868
13869 If you have more than one writable address book, you will be prompted for
13870 the name of the address book you wish to add the new entry to before
13871 anything else. You can use ^N and ^P to choose among the defined address
13872 books, or type in the address book name.
13873 <P>
13874
13875 FOR MORE INFORMATION on addressing see
13876 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13877 <A HREF="h_abook_opened">Address Book Screen's</A>
13878 help text.
13879 <P>
13880 &lt;End of help on this topic&gt;
13881 </BODY>
13882 </HTML>
13883 ===== h_takeexport_screen =====
13884 <HTML>
13885 <HEAD>
13886 <TITLE>Take Export Screen Explained</TITLE>
13887 </HEAD>
13888 <BODY>
13889 <H1>TAKE EXPORT COMMANDS</H1>
13890 <!--chtml if pinemode="function_key"-->
13891 <PRE>
13892 Navigating the List of Addresses       Address Selection Commands
13893 --------------------------------       --------------------------
13894  F5  Move to previous entry            F3  Exit without taking address
13895  F6  Move to next entry                F4  Take current address(es)
13896  F7  Show previous page of address list
13897  F8  Show next page of address list
13898  F2  WhereIs (search list)
13899                                --------------
13900 Mode Toggle            F9  Set/Unset current address
13901 -----------            F10 Set all
13902  F12 Toggle between List and single mode       F11 Unset all
13903 </PRE>
13904 <!--chtml else-->
13905 <PRE>
13906 Navigating the List of Addresses       Address Selection Commands
13907 --------------------------------       --------------------------
13908  P  Move to previous entry              &lt;  Exit without taking address
13909  N  Move to next entry                  T  Take address
13910  -  Show previous page of address list
13911 Spc (space bar) Show next page of address list
13912  W  WhereIs (search list)              List Mode
13913                                        ---------
13914 Single Mode                             X  Set/Unset current address
13915 -----------                             A  Set all addresses
13916  L  Switch to list mode                 U  Unset all addresses
13917                                         S  Switch to single mode
13918 </PRE>
13919 <!--chtml endif-->
13920
13921 <H2>Description of the Take Export Screen</H2>
13922
13923 This screen is designed to let you select one or more addresses
13924 from the current message and put them into a file.
13925 Only the user@domain_name part of each address is put into the file.
13926 <P>
13927
13928 To put a single entry into a file simply highlight the correct line and press
13929 <!--chtml if pinemode="function_key"-->
13930 F4.
13931 <!--chtml else-->
13932 &quot;T&quot;.
13933 <!--chtml endif-->
13934 To put more than one entry into a file
13935 switch the screen display
13936 into List Mode by pressing
13937 <!--chtml if pinemode="function_key"-->
13938 F12.
13939 <!--chtml else-->
13940 &quot;L&quot;.
13941 <!--chtml endif-->
13942 In List Mode, you select the
13943 group of addresses you wish to manipulate by marking them with an
13944 &quot;X&quot;.
13945 The Set/Unset
13946 <!--chtml if pinemode="function_key"-->
13947 (F9)
13948 <!--chtml else-->
13949 (&quot;X&quot;)
13950 <!--chtml endif-->
13951 command will turn the &quot;X&quot; on for the
13952 highlighted address if it was off or turn it off if it was previously on.
13953 The SetAll command will select all of the addresses, and the UnSetAll
13954 command will turn off all the selections.  Once you've gotten the
13955 selection the way you want it, you may put the addresses in a file by typing
13956 <!--chtml if pinemode="function_key"-->
13957 F4.
13958 <!--chtml else-->
13959 &quot;T&quot;.
13960 <!--chtml endif-->
13961 <P>
13962
13963 You will be asked for the name of a file to put the addresses in.
13964 If the file already exists, you will be asked whether you want to Overwrite
13965 (replace) the contents of the file or Append to the contents of the file.
13966 <P>
13967
13968 &lt;End of help on this topic&gt;
13969 </BODY>
13970 </HTML>
13971 ============= h_abook_view ========================
13972 <HTML>
13973 <HEAD>
13974 <TITLE>Address Book View Explained</TITLE>
13975 </HEAD>
13976 <BODY>
13977 This function allows you to view the contents of an address book entry. You
13978 can only view one entry at a time.
13979 <P>
13980 <DL>
13981 <DT>Help
13982 <!--chtml if pinemode="function_key"-->
13983 (F1)
13984 <!--chtml else-->
13985 (?)
13986 <!--chtml endif-->
13987 </DT>
13988 <DD>
13989 Display this help text.
13990
13991 <DT>Abook
13992 <!--chtml if pinemode="function_key"-->
13993 (F3)
13994 <!--chtml else-->
13995 (&lt;)
13996 <!--chtml endif-->
13997 </DT>
13998 <DD>
13999 Go back to index of address book entries.
14000
14001 <DT>Update
14002 <!--chtml if pinemode="function_key"-->
14003 (F4)
14004 <!--chtml else-->
14005 (U)
14006 <!--chtml endif-->
14007 </DT>
14008 <DD>
14009 Update (modify) this entry.
14010
14011 <DT>ComposeTo
14012 <!--chtml if pinemode="function_key"-->
14013 (F5)
14014 <!--chtml else-->
14015 (C)
14016 <!--chtml endif-->
14017 </DT>
14018 <DD>Compose a message to the address(es) in this entry.
14019
14020 <DT>Role
14021 <!--chtml if pinemode="function_key"-->
14022 (F6)
14023 <!--chtml else-->
14024 (#)
14025 <!--chtml endif-->
14026 </DT>
14027 <DD>Compose a message to the address(es) in this entry using roles.
14028
14029 <DT>Prev Page
14030 <!--chtml if pinemode="function_key"-->
14031 (F7)
14032 <!--chtml else-->
14033 (-)
14034 <!--chtml endif-->
14035 </DT>
14036 <DD>
14037 Show the previous page of the current entry.
14038
14039 <DT>Next Page
14040 <!--chtml if pinemode="function_key"-->
14041 (F8)
14042 <!--chtml else-->
14043 (Space)
14044 <!--chtml endif-->
14045 </DT>
14046 <DD>
14047 Show the next page of the current entry.
14048
14049 <DT>Print
14050 <!--chtml if pinemode="function_key"-->
14051 (F9)
14052 <!--chtml else-->
14053 (%)
14054 <!--chtml endif-->
14055 </DT>
14056 <DD>Print the current entry.  You can select the
14057 printer or the print command via the &quot;Setup&quot; command
14058 on the MAIN MENU.
14059
14060 <DT>WhereIs
14061 <!--chtml if pinemode="function_key"-->
14062 (F10)
14063 <!--chtml else-->
14064 (W)
14065 <!--chtml endif-->
14066 </DT>
14067 <DD>Search the entry for a string of letters.  If it is
14068 found, move to it.  The string can be one word or a phrase.
14069 If there are multiple occurrences, the cursor moves to the
14070 first occurrence beyond the current cursor position.
14071
14072 <DT>Fwd Email
14073 <!--chtml if pinemode="function_key"-->
14074 (F11)
14075 <!--chtml else-->
14076 (F)
14077 <!--chtml endif-->
14078 </DT>
14079 <DD>Begin composition of a new mail message with the displayed
14080 text already inserted in the message body.
14081
14082 </DL>
14083 <P>
14084 &lt;End of help on this topic&gt;
14085 </BODY>
14086 </HTML>
14087 ============= h_ldap_view ========================
14088 <HTML>
14089 <HEAD>
14090 <TITLE>LDAP Response View Explained</TITLE>
14091 </HEAD>
14092 <BODY>
14093 This function allows you to view the contents of a directory entry. You
14094 can only view one entry at a time.
14095 <P>
14096 <DL>
14097 <DT>Help
14098 <!--chtml if pinemode="function_key"-->
14099 (F1)
14100 <!--chtml else-->
14101 (?)
14102 <!--chtml endif-->
14103 </DT>
14104 <DD>
14105 Display this help text.
14106
14107 <DT>Results Index
14108 <!--chtml if pinemode="function_key"-->
14109 (F3)
14110 <!--chtml else-->
14111 (&lt;)
14112 <!--chtml endif-->
14113 </DT>
14114 <DD>Go back to index of search results.
14115
14116 <DT>ComposeTo
14117 <!--chtml if pinemode="function_key"-->
14118 (F5)
14119 <!--chtml else-->
14120 (C)
14121 <!--chtml endif-->
14122 </DT>
14123 <DD>Compose a message to the address(es) in this entry.
14124
14125 <DT>Role
14126 <!--chtml if pinemode="function_key"-->
14127 (F6)
14128 <!--chtml else-->
14129 (#)
14130 <!--chtml endif-->
14131 </DT>
14132 <DD>Compose a message to the address(es) in this entry using roles.
14133
14134 <DT>Prev Page
14135 <!--chtml if pinemode="function_key"-->
14136 (F7)
14137 <!--chtml else-->
14138 (-)
14139 <!--chtml endif-->
14140 </DT>
14141 <DD>
14142 Show the previous page of the current entry.
14143
14144 <DT>Next Page
14145 <!--chtml if pinemode="function_key"-->
14146 (F8)
14147 <!--chtml else-->
14148 (Space)
14149 <!--chtml endif-->
14150 </DT>
14151 <DD>
14152 Show the next page of the current entry.
14153
14154 <DT>Print
14155 <!--chtml if pinemode="function_key"-->
14156 (F9)
14157 <!--chtml else-->
14158 (%)
14159 <!--chtml endif-->
14160 </DT>
14161 <DD>Print the current entry on paper.  You can select the
14162 printer or the print command via the &quot;Setup&quot; command
14163 on the MAIN MENU.
14164
14165 <DT>WhereIs
14166 <!--chtml if pinemode="function_key"-->
14167 (F10)
14168 <!--chtml else-->
14169 (W)
14170 <!--chtml endif-->
14171 </DT>
14172 <DD>Search the entry for a string of letters.  If it is
14173 found, move to it.  The string can be one word or a phrase.
14174 If there are multiple occurrences, the cursor moves to the
14175 first occurrence beyond the current cursor position.
14176
14177 <DT>Fwd Email
14178 <!--chtml if pinemode="function_key"-->
14179 (F11)
14180 <!--chtml else-->
14181 (F)
14182 <!--chtml endif-->
14183 </DT>
14184 <DD>Begin composition of a new mail message with the displayed
14185 text already inserted in the message body.
14186
14187 <DT>Save
14188 <!--chtml if pinemode="function_key"-->
14189 (F12)
14190 <!--chtml else-->
14191 (S)
14192 <!--chtml endif-->
14193 </DT>
14194 <DD>Save the displayed entry to one of your address books or export
14195 it to a file.
14196 </DL>
14197 <P>
14198 &lt;End of help on this topic&gt;
14199 </BODY>
14200 </HTML>
14201 ===== h_attachment_screen =====
14202 <HTML>
14203 <HEAD>
14204 <TITLE>Attachment Index Screen Explained</TITLE>
14205 </HEAD>
14206 <BODY>
14207 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
14208 message's attachments, and allows various operations on them.  The
14209 first attachment is usually the message text, but does not include the
14210 header portion of the message.
14211 <P>
14212 Available commands include:
14213 <P>
14214 <DL>
14215
14216 <DT>Help</DT>
14217 <DD>Show this help text.
14218
14219 <DT>Msg #<I>num</I></DT>
14220 <DD>Leave this screen without displaying or saving any attachments.
14221
14222 <DT>View</DT>
14223 <DD>View the currently selected attachment.
14224
14225 <DT>External</DT>
14226 <DD>Passes a TEXT/HTML message to an external browser for its display.
14227
14228 <DT>Prev Attach</DT>
14229 <DD>Move to previous attachment.
14230
14231 <DT>Next Attach</DT>
14232 <DD>Move to next attachment.
14233
14234 <DT>Prev Page</DT>
14235 <DD>Previous page of the listed attachments.
14236
14237 <DT>Next Page</DT>
14238 <DD>Next page of the listed attachments.
14239
14240 <DT>Delete</DT>
14241 <DD>Mark the currently selected attachment for Deletion.
14242 This does not modify the current message by deleting the attachment from
14243 it, but instead the delete flag <EM>only</EM> has an effect when saving
14244 the message to a folder.
14245 Attachments marked for deletion are not copied to the destination folder
14246 along with the rest of the message when it is saved.
14247 It is ok for the destination folder to be the same as the current folder.
14248 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
14249
14250 <DT>Undelete</DT>
14251 <DD>Turn off the Delete flag for the selected attachment.
14252
14253 <DT>Save</DT>
14254 <DD>Save the selected attachment to a file.  If the attachment is of
14255 type &quot;RFC822/Message&quot;, then the attachment will be saved to
14256 the specified mail folder.
14257
14258 <DT>Export</DT>
14259 <DD>If the attachment is of
14260 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
14261 copy the message to a file in the same way this command works on
14262 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
14263
14264 <DT>Pipe</DT>
14265 <DD>Pipe the attachment contents into a UNIX command (if enabled).
14266 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
14267
14268 <DT>WhereIs</DT>
14269 <DD>Find a matching string in the attachment list.
14270
14271 <DT>AboutAttch</DT>
14272 <DD>Examine various aspects of the selected attachment.
14273
14274 <DT>Print</DT>
14275 <DD>Print the selected attachment.
14276
14277 <DT>Forward</DT>
14278 <DD>Forward the selected attachment as an attachment.
14279 </DL>
14280
14281 <P>
14282
14283 All attachments can be saved or piped into a UNIX command, but some may
14284 not be readily displayed by either Alpine or an external tool.  In such
14285 cases, the reason why the message cannot be displayed is displayed on
14286 Alpine's message line.
14287 <P>
14288 &lt;End of help on this topic&gt;
14289 </BODY>
14290 </HTML>
14291 ============= h_mail_text_att_view ========================
14292 <HTML>
14293 <HEAD>
14294 <TITLE>Attachment View Screen Explained</TITLE>
14295 </HEAD>
14296 <BODY>
14297 This function allows you to view the contents of a text attachment. You
14298 can only view one attachment at a time.
14299 <P>
14300 Available commands include:
14301 <P>
14302 <DL>
14303
14304 <DT>Help</DT>
14305 <DD>Display this help text
14306
14307 <DT>AttchIndex</DT>
14308 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
14309
14310 <DT>Prev Page</DT>
14311 <DD>Show the previous page of the current attachment.
14312
14313 <DT>Next Page</DT>
14314 <DD>Show the next page of the current attachment by pressing the space bar.
14315
14316 <DT>Delete</DT>
14317 <DD>Mark the viewed attachment for Deletion.  The delete
14318 flag <EM>only</EM> has affect when saving the message to a folder.
14319 Attachments marked for deletion are excluded from the message when
14320 it is saved.  In addition, the delete mark <EM>only</EM> applies to
14321 this Alpine session.
14322
14323 <DT>Undelete</DT>
14324 <DD>Turn off the Delete flag for the selected attachment.
14325
14326 <DT>Save</DT>
14327 <DD>Copy the current attachment to a file.  If you just enter
14328 a filename, the attachment will be saved with that name in
14329 your home directory
14330 <!--chtml if pinemode="running"-->
14331 (which, in the present configuration of your system, is
14332  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14333 <!--chtml endif-->
14334 or current working directory
14335 <!--chtml if pinemode="running"-->
14336 (which, at least for your current Alpine &quot;session,&quot;
14337 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14338 <!--chtml endif-->, depending on the
14339 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14340 configuration setting.  You may enter the full
14341 path and filename to save it in another directory instead.
14342
14343 <DT>Export</DT>
14344 <DD>If the attachment is of
14345 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
14346 copy the message to a file in the same way this command works on
14347 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
14348 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
14349 defined, they may affect the contents of the exported file.)
14350
14351 <DT>Pipe</DT>
14352 <DD>Pipe the attachment contents into a UNIX command (if enabled)
14353
14354 <DT>WhereIs</DT>
14355 <DD>Search the attachment for a string of letters.  If it is
14356 found, move to it.  The string can be one word or a phrase.
14357 If there are multiple occurrences, the cursor moves to the
14358 first occurrence beyond the current cursor position.
14359
14360 <DT>Print</DT>
14361 <DD>Print the current attachment on paper.  You can select the
14362 printer or the print command via the &quot;Setup&quot; command
14363 on the MAIN MENU.
14364
14365 <DT>Forward</DT>
14366 <DD>Forward the selected attachment as an attachment.
14367 </DL>
14368 <P>
14369 &lt;End of help on this topic&gt;
14370 </BODY>
14371 </HTML>
14372 ============= h_journal ==============
14373 <HTML>
14374 <HEAD>
14375 <TITLE>Recent Message Journal Explained</TITLE>
14376 </HEAD>
14377 <BODY>
14378
14379 The following commands are available on this screen:
14380 <P>
14381 <DL>
14382 <DT>Help</DT>
14383 <DD>Show this help text
14384
14385 <DT>Exit</DT>
14386 <DD>Exit Viewer, and go back to mail processing
14387
14388 <DT>Prev Page</DT>
14389 <DD>Show the previous page text
14390
14391 <DT>Next Page</DT>
14392 <DD>Show the next page of text by pressing the space bar
14393
14394 <DT>Print</DT>
14395 <DD>Print the displayed text on paper.  You can select the
14396 printer or the print command via the &quot;Setup&quot; command
14397 on the MAIN MENU.
14398
14399 <DT>Fwd Email</DT>
14400 <DD>Begin composition of a new mail message with the displayed
14401 text already inserted in the message body.
14402
14403 <DT>Save</DT>
14404 <DD>Copy the displayed text to a file.  If you just enter
14405 a filename, the text will be saved with that name in
14406 your
14407 home directory
14408 <!--chtml if pinemode="running"-->
14409 (which, in the present configuration of your system, is
14410  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14411 <!--chtml endif-->
14412 or current working directory
14413 <!--chtml if pinemode="running"-->
14414 (which, at least for your current Alpine &quot;session,&quot;
14415 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14416 <!--chtml endif-->, depending on the
14417 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14418 configuration setting.   You may enter the full
14419 path and filename to save it in another directory instead.
14420
14421 <DT>WhereIs</DT>
14422 <DD>Search the text for a string of letters.  If it is
14423 found, move to it.  The string can be one word or a phrase.
14424 If there are multiple occurrences, the cursor moves to the
14425 first occurrence beyond the current cursor position.
14426 </DL>
14427 <P>
14428 &lt;End of help on this topic&gt;
14429 </BODY>
14430 </HTML>
14431 ============= h_debugjournal ==============
14432 <HTML>
14433 <HEAD>
14434 <TITLE>Debug Journal Explained</TITLE>
14435 </HEAD>
14436 <BODY>
14437
14438 The following commands are available on this screen:
14439 <P>
14440 <DL>
14441 <DT>Help</DT>
14442 <DD>Show this help text
14443
14444 <DT>Exit</DT>
14445 <DD>Exit Viewer, and go back to mail processing
14446
14447 <DT>Timestamps</DT>
14448 <DD>Turn on or off timestamps.
14449
14450 <DT>DebugView</DT>
14451 <DD>Set the level of debugging you want to see. The level may be any number
14452 in the range 0-9. Higher numbers show more debugging detail. Note that the
14453 debugging information has already been captured. This setting just causes the
14454 debugging information that you see to be filtered. If you set this to
14455 the number &quot;5&quot; then you will be shown all of the debugging information
14456 at levels 5 and below.
14457 It's actually a bit more complicated than that. A fixed amount of memory
14458 is used to store the debug information.
14459 Since the amount of memory used is limited the debugging information
14460 has to be trimmed back when it gets too large.
14461
14462 <DT>Prev Page</DT>
14463 <DD>Show the previous page text
14464
14465 <DT>Next Page</DT>
14466 <DD>Show the next page of text by pressing the space bar
14467
14468 <DT>Print</DT>
14469 <DD>Print the displayed text on paper.  You can select the
14470 printer or the print command via the &quot;Setup&quot; command
14471 on the MAIN MENU.
14472
14473 <DT>Fwd Email</DT>
14474 <DD>Begin composition of a new mail message with the displayed
14475 text already inserted in the message body.
14476
14477 <DT>Save</DT>
14478 <DD>Copy the displayed text to a file.  If you just enter
14479 a filename, the text will be saved with that name in
14480 your
14481 home directory
14482 <!--chtml if pinemode="running"-->
14483 (which, in the present configuration of your system, is
14484  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14485 <!--chtml endif-->
14486 or current working directory
14487 <!--chtml if pinemode="running"-->
14488 (which, at least for your current Alpine &quot;session,&quot;
14489 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14490 <!--chtml endif-->, depending on the
14491 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14492 configuration setting.   You may enter the full
14493 path and filename to save it in another directory instead.
14494
14495 <DT>WhereIs</DT>
14496 <DD>Search the text for a string of letters.  If it is
14497 found, move to it.  The string can be one word or a phrase.
14498 If there are multiple occurrences, the cursor moves to the
14499 first occurrence beyond the current cursor position.
14500 </DL>
14501 <P>
14502 &lt;End of help on this topic&gt;
14503 </BODY>
14504 </HTML>
14505 ============= h_simple_text_view ==============
14506 <HTML>
14507 <HEAD>
14508 <TITLE>Simple Text View Screen Explained</TITLE>
14509 </HEAD>
14510 <BODY>
14511
14512 The following commands are available on this screen:
14513 <P>
14514 <DL>
14515 <DT>Help</DT>
14516 <DD>Show this help text
14517
14518 <DT>Exit</DT>
14519 <DD>Exit Viewer, and go back to mail processing
14520
14521 <DT>Prev Page</DT>
14522 <DD>Show the previous page text
14523
14524 <DT>Next Page</DT>
14525 <DD>Show the next page of text by pressing the space bar
14526
14527 <DT>Print</DT>
14528 <DD>Print the displayed text on paper.  You can select the
14529 printer or the print command via the &quot;Setup&quot; command
14530 on the MAIN MENU.
14531
14532 <DT>Fwd Email</DT>
14533 <DD>Begin composition of a new mail message with the displayed
14534 text already inserted in the message body.
14535
14536 <DT>Save</DT>
14537 <DD>Copy the displayed text to a file.  If you just enter
14538 a filename, the attachment will be saved with that name in
14539 your
14540 home directory
14541 <!--chtml if pinemode="running"-->
14542 (which, in the present configuration of your system, is
14543  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14544 <!--chtml endif-->
14545 or current working directory
14546 <!--chtml if pinemode="running"-->
14547 (which, at least for your current Alpine &quot;session,&quot;
14548 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14549 <!--chtml endif-->, depending on the
14550 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14551 configuration setting.   You may enter the full
14552 path and filename to save it in another directory instead.
14553
14554 <DT>WhereIs</DT>
14555 <DD>Search the attachment for a string of letters.  If it is
14556 found, move to it.  The string can be one word or a phrase.
14557 If there are multiple occurrences, the cursor moves to the
14558 first occurrence beyond the current cursor position.
14559 </DL>
14560 <P>
14561 &lt;End of help on this topic&gt;
14562 </BODY>
14563 </HTML>
14564 ======= h_pine_for_windows ========
14565 <HTML>
14566 <HEAD>
14567 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
14568 </HEAD>
14569 <BODY>
14570 <H1>Getting Help In PC-Alpine</H1>
14571
14572 <P>
14573 PC-Alpine offers general and specific help text. From the <A
14574 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
14575 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
14576 specific help for that screen is available from the toolbar Help menu or
14577 with the
14578 <!--chtml if pinemode="function_key"-->
14579 &quot;F1&quot; key.
14580 <!--chtml else-->
14581 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
14582 typing &quot;?&quot; would be mistaken as entering text.
14583 <!--chtml endif-->
14584
14585 <P>
14586 Although this version of Alpine is for Microsoft Windows, it is not
14587 considered a full &quot;Graphical User Interface&quot; application.
14588 Yet, many of the controls that Windows users are accustomed to seeing,
14589 such as scrollbars and toolbars, are available.
14590
14591 <P>
14592 PC-Alpine offers considerable mouse support.  You can view what is
14593 &quot;click-able&quot; by dragging your mouse over any screen; when the
14594 arrow cursor changes into a hand, you found something. Mouse-click
14595 possibilities include navigating between screens and folders and
14596 double-clicking on hyperlinks to open your Web browser.
14597 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
14598 screen.  Examples of right-click options include &quot;copy&quot; after
14599 selecting text to copy and &quot;View in New Window&quot; when you click
14600 on a particular message in the Message Index. The menu choices available
14601 to you will vary based upon what screen is open, where on the screen your
14602 cursor is located, and even what action you have already taken.
14603
14604 <P>
14605 &lt;End of help on this topic&gt;
14606 </BODY>
14607 </HTML>
14608 ===== h_composer =====
14609 <HTML>
14610 <HEAD>
14611 <TITLE>COMPOSER COMMANDS</TITLE>
14612 </HEAD>
14613 <BODY>
14614 <H1>COMPOSER COMMANDS</H1>
14615
14616 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>
14617 &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>
14618 &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>
14619 &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>
14620 &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>
14621 &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>
14622 &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>
14623 &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>
14624 &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>
14625 &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>
14626 ---------------------------------------|&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>
14627 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>
14628 &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>
14629 &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>
14630 &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>
14631
14632 <P>
14633 NOTE:
14634 <OL>
14635  <LI>For help on a particular command, highlight the bold text associated
14636 with it above and hit Return.
14637  <LI> The availability of certain commands
14638 is determined by Alpine configuration files and system capabilities.
14639 At some sites, certain commands may not be available due to security or
14640 support concerns.
14641  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14642 Ctrl-&#92;, ESC.
14643  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14644 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14645 </OL>
14646
14647 <P>
14648 HINT: To move rapidly to the bottom of a message you are composing,
14649 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
14650 with the Mark and Cut commands to eliminate large amounts of unwanted
14651 text in a Reply.
14652
14653 <H2>Description of Composer</H2>
14654
14655 Alpine has a built-in editing program that allows you to compose messages
14656 without having to leave Alpine.  The editor is designed to be very simple to
14657 use so that you can get started writing email right away.
14658
14659 <P>
14660 Messages are usually just text, about 80 columns wide.  Using upper and
14661 lower case is encouraged.  On some systems the size limit of the message
14662 is about 100,000 characters, which is about 2,000 lines.  You can include
14663 punctuation and special characters found on most keyboards, but you can't
14664 include characters with diacritical marks and certain special symbols.
14665
14666 <P>
14667 Text automatically wraps as you type past the end of a line so you do not
14668 have to hit return.  Using the
14669 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
14670 you can also reformat text explicitly, perhaps after you have
14671 deleted some text.
14672
14673 <P>
14674 You can include other text files with the
14675 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
14676 which will prompt you for the name of the file to insert at the
14677 current cursor position.
14678
14679 <P>
14680 <UL>
14681 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14682 </UL>
14683 <P>
14684 &lt;End of help on this topic&gt;
14685 </BODY>
14686 </HTML>
14687 ====== h_composer_browse =====
14688 <HTML>
14689 <HEAD>
14690 <TITLE>BROWSER</TITLE>
14691 </HEAD>
14692 <BODY>
14693 <H1>BROWSER</H1>
14694 This screen lets you browse your files and directories.  To go to another
14695 directory (identified by &quot;(dir)&quot;), move the cursor to it and
14696 choose &quot;Select&quot; (the default choice on the menu);
14697 or choose &quot;Goto&quot; and enter the name of the directory.
14698 <!--chtml if pinemode="os_windows"-->
14699 <!--chtml else-->
14700 In Unix Alpine, you may use
14701 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
14702 to another's home directory.
14703 <!--chtml endif--><P>
14704 To select a file, move the cursor to it and
14705 choose &quot;Select&quot; (the default choice on the menu).
14706 <P>
14707 <UL>
14708 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
14709 inclusion in the
14710 message body (that is, you chose &quot;Read File&quot; with the cursor under
14711 the
14712 &quot;----- Message Text -----&quot; line
14713 while composing, then &quot;To Files&quot;):  Since the file
14714 selected will become part of the message text, it must be in a format
14715 suitable for that (Alpine does not check!), such as a plain text file.
14716 Files of other formats (for example, graphics, databases, software
14717 programs) should be
14718 <B>attached</B> to the message instead --
14719 by moving the cursor in the COMPOSE MESSAGE screen into the
14720 message header area and pressing
14721 <!--chtml if pinemode="function_key"-->
14722 F6.
14723 <!--chtml else-->
14724 Ctrl-J.
14725 <!--chtml endif-->
14726
14727 <P><LI>
14728 Note <B>if</B> you are currently using the BROWSER for saving a message
14729 attachment, or exporting a message, to a file: You can use the Add command to
14730 provide the name for a new file to save/export to, and then select that name
14731 to use it for the save/export operation.  Back at the prompt
14732 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
14733 either Overwrite or Append (it doesn't make a difference, since the file is
14734 so far empty).  Note: If you cancel the
14735 operation at that point, the file created with the Add command will remain
14736 0 bytes in size.
14737
14738 </UL>
14739 <P><UL>
14740 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14741 </UL>
14742 <P>
14743 &lt;End of help on this topic&gt;
14744 </BODY>
14745 </HTML>
14746 ====== h_composer_ins =====
14747 <HTML>
14748 <HEAD>
14749 <TITLE>INSERT TEXT FILE</TITLE>
14750 </HEAD>
14751 <BODY>
14752 <H1>INSERT TEXT FILE</H1>
14753
14754 Use this function to insert a text file. The file name
14755 given can be an absolute file path name for your system
14756 <!--chtml if pinemode="os_windows"-->
14757 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14758 with a relative pathname, or simply a file name without
14759 drive or directory specification.
14760 <!--chtml else-->
14761 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14762 a file in your home directory, or a file path relative to your
14763 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14764 your home directory or &quot;~user&quot; to refer to another
14765 account's home directory.
14766 <!--chtml endif-->
14767 <P>
14768 No wild card characters may be used.
14769 The file must reside on the system running Alpine.
14770 <P>
14771 If the
14772 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14773 feature is set, names are relative to your current working directory
14774 <!--chtml if pinemode="running"-->
14775 (which, at least for your current Alpine &quot;session,&quot;
14776 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14777 <!--chtml endif-->
14778 rather than your home directory
14779 <!--chtml if pinemode="running"-->
14780 (which, in the present configuration of your system, is
14781  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14782 <!--chtml endif-->
14783 .
14784 <P><UL>
14785 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14786 </UL>
14787 <P>
14788 &lt;End of help on this topic&gt;
14789 </BODY>
14790 </HTML>
14791 ====== h_composer_ins_m =====
14792 <HTML>
14793 <HEAD>
14794 <TITLE>INSERT MESSAGE</TITLE>
14795 </HEAD>
14796 <BODY>
14797 <H1>INSERT MESSAGE</H1>
14798
14799 Type in the number of a message in the currently open folder to insert it
14800 into your message.
14801 <P><UL>
14802 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14803 </UL>
14804 <P>
14805 &lt;End of help on this topic&gt;
14806 </BODY>
14807 </HTML>
14808 ====== h_composer_search =====
14809 <HTML>
14810 <HEAD>
14811 <TITLE>Explanation of Composer Whereis Command </TITLE>
14812 </HEAD>
14813 <BODY>
14814 <H1>Help For Whereis Command</H1>
14815
14816 Whereis is used to search the message for a word or part of a word.
14817 When searching in the composer, only the message part of your mail is
14818 searched, and the cursor is put on the first occurrence appearing
14819 after the location of the cursor.  The search will wrap to the
14820 beginning of the message when it no longer finds matches in the
14821 remainder of the message.
14822
14823 To search for the same string a second time, press
14824 <!--chtml if pinemode="function_key"-->
14825 &quot;F6&quot;
14826 <!--chtml else-->
14827 &quot;^W&quot;
14828 <!--chtml endif-->
14829 to begin search and then just press RETURN to accept the previous
14830 search string shown in square brackets rather than entering a new
14831 search string.<P>
14832
14833 The &quot;Search&quot; prompt has several sub-command available:
14834
14835 <DL>
14836 <DT>Get Help</DT>
14837 <DD> Takes you to this help page.
14838
14839 <DT>Cancel</DT>
14840 <DD> Cancels the prompt.  No search takes place.
14841
14842 <DT>First Line</DT>
14843 <DD> Takes you back to the composer with the cursor on the first character
14844 of the first line of text.
14845
14846 <DT>Last Line</DT>
14847 <DD> Takes you back to the composer with the cursor on the last character
14848 of the last line of text.
14849
14850 <DT>Replace (Optional)</DT>
14851 <DD> This sub-command is enabled by the
14852 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14853 feature (which is on by default); see its help screen for details on how replacing works.
14854
14855 </DL>
14856
14857 &lt;End of help on this topic&gt;
14858 </BODY>
14859 </HTML>
14860 ====== h_sigedit_search =====
14861 <HTML>
14862 <HEAD>
14863 <TITLE>Explanation of Whereis Command </TITLE>
14864 </HEAD>
14865 <BODY>
14866 <H1>Help For Whereis Command</H1>
14867
14868 Whereis is used to search for a word or part of a word.
14869 When searching the cursor is put on the first occurrence appearing
14870 after the location of the cursor.  The search will wrap to the
14871 beginning of the signature when it no longer finds matches in the
14872 remainder of the signature.
14873
14874 To search for the same string a second time, press
14875 <!--chtml if pinemode="function_key"-->
14876 &quot;F6&quot;
14877 <!--chtml else-->
14878 &quot;^W&quot;
14879 <!--chtml endif-->
14880 to begin search and then just press RETURN to accept the previous
14881 search string shown in square brackets rather than entering a new
14882 search string.<P>
14883
14884 The &quot;Search&quot; prompt has several sub-command available:
14885
14886 <DL>
14887 <DT>Get Help</DT>
14888 <DD> Takes you to this help page.
14889
14890 <DT>Cancel</DT>
14891 <DD> Cancels the prompt.  No search takes place.
14892
14893 <DT>First Line</DT>
14894 <DD> Takes you back to the composer with the cursor on the first character
14895 of the first line of text.
14896
14897 <DT>Last Line</DT>
14898 <DD> Takes you back to the composer with the cursor on the last character
14899 of the last line of text.
14900
14901 <DT>Replace (Optional)</DT>
14902 <DD> This sub-command is enabled by the
14903 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14904 feature (which is on by default); see its help screen for details on how replacing works.
14905
14906 </DL>
14907
14908 &lt;End of help on this topic&gt;
14909 </BODY>
14910 </HTML>
14911 ======= h_composer_to ====
14912 <HTML>
14913 <HEAD>
14914 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
14915 </HEAD>
14916 <BODY>
14917 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
14918
14919 <H2>The &quot;To:&quot; field</H2>
14920 The address you enter here must be a valid email address that is reachable
14921 from your site.
14922
14923 <H2>Email Address Format</H2>
14924 You may enter a full name and email address,
14925 <!--chtml if pinemode="os_windows"-->
14926 <!--chtml else-->
14927 a local (meaning, on the same
14928 host as the one you are running Alpine on) username that Alpine will
14929 complete for you,
14930 <!--chtml endif-->
14931 the nickname of someone in a
14932 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
14933 mail alias defined by your system administrator.  When you move the cursor
14934 out of this field, the nicknames will be expanded to the addresses in your
14935 address book, and the local usernames will be expanded to include the
14936 persons' actual names.  You may enter as many addresses as you wish, but they
14937 must be separated by commas.  You can move around this and other header fields
14938 with the arrow keys and use many of the usual composer editing keys.
14939 <P>
14940 <UL>
14941 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14942 </UL>
14943
14944 <P>
14945 <H2>MESSAGE HEADER COMMANDS</H2>
14946 <!--chtml if pinemode="function_key"-->
14947 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14948 ^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>
14949 ^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>
14950 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
14951 ^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>
14952 ^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>
14953 ^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>
14954 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>
14955 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>
14956 ^@&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>
14957 ----------------------------------------|<BR>
14958 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
14959 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>
14960 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>
14961 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>
14962 <!--chtml else-->
14963 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14964 ^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>
14965 ^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>
14966 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
14967 ^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>
14968 ^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>
14969 ^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>
14970 ^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>
14971 ^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>
14972 ^@&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>
14973 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
14974 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>
14975 ^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>
14976 ^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>
14977 ^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>
14978 <!--chtml endif-->
14979
14980 <P>
14981 NOTE:
14982 <OL>
14983  <LI>For help on a particular command, highlight the bold text associated
14984 with it above and hit Return.
14985  <LI> The availability of certain commands
14986 is determined by Alpine configuration files and system capabilities.
14987 At some sites, certain commands may not be available due to security or
14988 support concerns.
14989 </OL>
14990
14991 <P>
14992 <UL>
14993 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14994 </UL><P>
14995 &lt;End of help on this topic&gt;
14996 </BODY>
14997 </HTML>
14998 ======= h_composer_cc ====
14999 <HTML>
15000 <HEAD>
15001 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
15002 </HEAD>
15003 <BODY>
15004 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
15005 The Cc: field is just like the To: field, except it is used for addressees
15006 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
15007 not directly meant directly &quot;for&quot; these recipients, but you wanted
15008 them to see the message.  The only difference the recipients see is that their
15009 name is in the Cc: field, rather than the To: field.
15010 <P>
15011 For help with Cc: field editing
15012 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15013 <P>
15014 <UL>
15015 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15016 </UL>
15017 <P>
15018 <UL>
15019 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15020 </UL><P>
15021 &lt;End of help on this topic&gt;
15022 </BODY>
15023 </HTML>
15024 ======= h_composer_bcc ====
15025 <HTML>
15026 <HEAD>
15027 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
15028 </HEAD>
15029 <BODY>
15030 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
15031 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
15032 a copy of the message to one or more people whose addresses you do not
15033 wish disclosed, either to reduce clutter or for confidentiality.
15034 <P>
15035 The format of the Bcc: field is just the same as the To: and Cc: fields in
15036 the way the addresses are entered.  The recipients listed here will
15037 receive a copy of the message, but --assuming your site's mail transport
15038 software is properly configured-- their addresses will not show up in the
15039 headers of the message, as delivered to all of the recipients.  The To:
15040 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
15041 <P>
15042 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
15043 will automatically generate and place in the To: field a pseudo-address of
15044   &quot;undisclosed-recipients: ;&quot;
15045 or whatever string has been specified in the
15046 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
15047 variable.
15048 <P>
15049 The reason for this is to avoid embarrassment caused by some Internet
15050 mail transfer software that interprets a &quot;missing&quot; To: header as
15051 an error and replaces it with an Apparently-to: header that may contain
15052 the addresses you entered on the Bcc: line.  In addition, it may be
15053 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
15054 <P>
15055 You can manipulate what text ends up on the (originally) empty To:
15056 field.  Just remember to put a colon and semicolon at the end of the
15057 field, which is a special notation denoting that it is not a real address.
15058 <P>
15059 For information on message header editing
15060 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15061 <P>
15062 <UL>
15063 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15064 </UL>
15065 <P>
15066 <UL>
15067 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15068 </UL><P>
15069 &lt;End of help on this topic&gt;
15070 </BODY>
15071 </HTML>
15072 ======= h_composer_lcc ====
15073 <HTML>
15074 <HEAD>
15075 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
15076 </HEAD>
15077 <BODY>
15078 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
15079 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
15080 you wish to send a message to a list of people but avoid having all
15081 of their addresses visible, in order to reduce clutter when the
15082 message is received.
15083 <P>
15084 It is similar to the
15085 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
15086 in that individual
15087 addressees are hidden, but Lcc is designed to work specifically with
15088 distribution lists you have created in your
15089 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
15090 the nickname of the list on the Lcc line will result in the full name of
15091 your Alpine Address Book list being placed on the To: line of the message,
15092 using a special notation that distinguishes it from a real address. You
15093 must leave the To: line blank for your list name to appear there.
15094 <P>
15095 For example, if you have this list entered in your Address Book:<PRE>
15096
15097         largo         Key Largo List       DISTRIBUTION LIST:
15098                                            bogie@mgm.com
15099                                            lauren@mgm.com
15100                                            walter@mgm.com</PRE>
15101
15102
15103 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
15104 the result is:<PRE>
15105
15106         To      : Key Largo List: ;
15107         Cc      :
15108         Bcc     :
15109         Fcc     : sent-mail
15110         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
15111                   lauren@mgm.com,
15112                   walter@mgm.com
15113         Subject :</PRE>
15114
15115 Each recipient listed on the Lcc: line receives a copy of the message
15116 without their address being visible (as though they were listed on the
15117 Bcc: line). The colon-semicolon notation used to put the full-name of the
15118 list on the To: line is a special address format that doesn't specify any
15119 actual addressees, but does give some information to the recipients of the
15120 message.
15121 <P>
15122 Note: if after entering an LCC, you delete the list name that is placed
15123 on the To: line, then recipients will see <PRE>
15124        To: undisclosed-recipients: ;</PRE>
15125
15126 (or whatever string is defined in the
15127 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
15128 variable) just as in the BCC case.
15129 <P>
15130 For help with Lcc: field editing
15131 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15132 <P>
15133 <UL>
15134 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15135 </UL>
15136 <P>
15137 <UL>
15138 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15139 </UL><P>
15140 &lt;End of help on this topic&gt;
15141 </BODY>
15142 </HTML>
15143 ======= h_composer_from =======
15144 <HTML>
15145 <HEAD>
15146 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
15147 </HEAD>
15148 <BODY>
15149 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
15150
15151 This header carries your return address.  It is the address toward which
15152 replies (and often, future unrelated correspondence) will be directed,
15153 unless you have <A HREF="h_config_custom_hdrs">defined an optional
15154 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
15155 sure this address is correct.
15156 <P>
15157 For help with message header editing
15158 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15159 <P>
15160 <UL>
15161 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15162 </UL>
15163 <P>
15164 <UL>
15165 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15166 </UL><P>
15167 &lt;End of help on this topic&gt;
15168 </BODY>
15169 </HTML>
15170 ======= h_composer_reply_to =======
15171 <HTML>
15172 <HEAD>
15173 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
15174 </HEAD>
15175 <BODY>
15176 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
15177
15178 Most people should not need this header. The Reply-To: header is used in
15179 cases where you would like replies to your messages to be directed to an
15180 address other than your normal &quot;From:&quot; address.  This is atypical,
15181 but can happen when you use multiple machines and do not have the same account
15182 name on each one, or when you wish to direct certain replies to accounts
15183 or folders designated for specific classes of correspondence.
15184 <P>
15185 For help with message header editing
15186 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15187 <P>
15188 <UL>
15189 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15190 </UL>
15191
15192 <P>
15193 <UL>
15194 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15195 </UL><P>
15196 &lt;End of help on this topic&gt;
15197 </BODY>
15198 </HTML>
15199 ======= h_composer_custom_addr ====
15200 <HTML>
15201 <HEAD>
15202 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
15203 </HEAD>
15204 <BODY>
15205 <H1>CUSTOMIZED HEADER FIELD</H1>
15206 This is a customized header, i.e. not one that is part of Alpine's normal
15207 set of Compose headers.
15208 <P>
15209 For help with message header editing
15210 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15211 <P>
15212 <UL>
15213 <LI><A HREF="h_address_format">Explanation of Address formats</A>
15214 </UL>
15215 <P>
15216 <UL>
15217 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15218 </UL><P>
15219 &lt;End of help on this topic&gt;
15220 </BODY>
15221 </HTML>
15222 ======= h_composer_custom_free ====
15223 <HTML>
15224 <HEAD>
15225 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
15226 </HEAD>
15227 <BODY>
15228 <H1>CUSTOMIZED HEADER FIELD</H1>
15229 This is a customized header, i.e. not one that is part of Alpine's normal
15230 set of Compose headers.
15231 <P>
15232 This field consists of arbitrary text.
15233 <P>
15234 For help with message header editing
15235 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15236 <P>
15237 <UL>
15238 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15239 </UL><P>
15240 &lt;End of help on this topic&gt;
15241 </BODY>
15242 </HTML>
15243 ====== h_composer_news =====
15244 <HTML>
15245 <HEAD>
15246 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
15247 </HEAD>
15248 <BODY>
15249 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
15250 Use the newsgroups line to specify any and all USENET newsgroups to which
15251 your message should be posted.  When composing a message from scratch, this
15252 line may be hidden.  If so, just press the rich headers command
15253 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
15254 to make it visible.
15255 <P>
15256 <EM>Be aware</EM> that when you post to a newsgroup thousands of
15257 people will be reading your message.  Also, you or your system manager
15258 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
15259 in order for you to be able to post.
15260 <P>
15261 For help with message header editing
15262 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15263 <P><UL>
15264 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15265 </UL>
15266 <P>
15267 &lt;End of help on this topic&gt;
15268 </BODY>
15269 </HTML>
15270 ======= h_composer_fcc ====
15271 <HTML>
15272 <HEADER>
15273 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
15274 </HEADER>
15275 <BODY>
15276 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
15277 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
15278 each outgoing message.  The default value can be configured with the
15279 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
15280 the file carbon copy on any message you send by editing the FCC header.<p>
15281
15282 You may type ^T to get a list of all your folders and select one to use as
15283 the FCC for this message.<P>
15284
15285 For help with message header editing
15286 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15287 <P>
15288 <UL>
15289 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15290 </UL><P>
15291 &lt;End of help on this topic&gt;
15292 </BODY>
15293 </HTML>
15294 ======= h_composer_subject ====
15295 <HTML>
15296 <HEADER>
15297 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
15298 </HEADER>
15299 <BODY>
15300 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
15301
15302 The subject header provides a place to enter a few words that summarize
15303 the topic of the message you are sending.  You may leave this line blank,
15304 but it is considered a courtesy to use a meaningful subject.<p>
15305
15306 For help with message header editing
15307 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15308 <P>
15309 <UL>
15310 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15311 </UL><P>
15312 &lt;End of help on this topic&gt;
15313 </BODY>
15314 </HTML>
15315 ======= h_composer_attachment ====
15316 <HTML>
15317 <HEAD>
15318 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
15319 </HEAD>
15320 <BODY>
15321 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
15322
15323 The &quot;Attchmnt:&quot; field is where you specify what file or
15324 files you'd like attached to
15325 the message you are composing.  Those files must reside on the machine
15326 running Alpine. If your file is on a PC or Mac and you run Alpine with an
15327 account on a Unix machine, you'll have to transfer it before attaching it.
15328 Contact local computer support people for assistance with transferring.
15329
15330 <P>
15331 The file name
15332 given can be an absolute file path name for your system
15333 <!--chtml if pinemode="os_windows"-->
15334 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
15335 with a relative pathname, or simply a file name without
15336 drive or directory specification.
15337 <!--chtml else-->
15338 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
15339 a file in your home directory, or a file path relative to your
15340 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
15341 your home directory or &quot;~user&quot; to refer to another
15342 account's home directory.
15343 <!--chtml endif--><P>
15344 No wild card characters may be used.
15345 <P>If the
15346 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
15347 feature is set, names are relative to your current working directory
15348 <!--chtml if pinemode="running"-->
15349 (which, at least for your current Alpine &quot;session,&quot;
15350 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
15351 <!--chtml endif-->
15352 rather than your home directory
15353 <!--chtml if pinemode="running"-->
15354 (which, in the present configuration of your system, is
15355  &quot;<!--#echo var="HOME_DIR"-->&quot;)
15356 <!--chtml endif-->
15357 .
15358 <P>
15359 Alpine uses MIME encoding for attachments, so binaries and files of any
15360 length can safely be delivered to any MIME-capable mail reading program.
15361 If you send an attachment to someone who does not have a MIME-capable mail
15362 reading program yet, then the main message text will be readable, but
15363 attachments (even attachments that are just plain text) are not.
15364 <P>
15365
15366 Typing the filename on the Attchmnt: line achieves the same
15367 result as using the
15368 <!--chtml if pinemode="function_key"-->
15369 F6
15370 <!--chtml else-->
15371 Ctrl-J
15372 <!--chtml endif--> command.
15373 <P>
15374
15375 If you Forward a message with attachments, you may delete them from your
15376 Forwarded message by editing the Attchmnt header line.
15377 <P>
15378
15379 For help with message header editing
15380 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
15381 <P>
15382 <UL>
15383 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15384 </UL><P>
15385 &lt;End of help on this topic&gt;
15386 </BODY>
15387 </HTML>
15388 ======= h_composer_ctrl_j ====
15389 <HTML>
15390 <HEAD>
15391 <TITLE>COMPOSER ATTACH</TITLE>
15392 </HEAD>
15393 <BODY>
15394 After the
15395 <!--chtml if pinemode="function_key"-->
15396 F6
15397 <!--chtml else-->
15398 Ctrl-J
15399 <!--chtml endif--> command:
15400 At the &quot;File to attach:&quot; prompt, enter the name of the
15401 existing file to attach to your message.
15402 When the feature
15403 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
15404 is set
15405 you need only enter the beginning of the filename (enough of it to uniquely
15406 identify the file) and press TAB to complete it.
15407
15408 Or, press ^T to use the BROWSER screen for
15409 selecting the file.  <P>
15410 For more information on attaching files, see the help screen for the
15411 composer's
15412 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
15413 but can be revealed using the
15414 <!--chtml if pinemode="function_key"-->
15415 F5
15416 <!--chtml else-->
15417 Ctrl-R
15418 <!--chtml endif-->
15419 command with the cursor positioned above the
15420 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
15421 <P>
15422 &lt;End of help on this topic&gt;
15423 </BODY>
15424 </HTML>
15425 ======= h_edit_nav_cmds =========
15426 <HTML>
15427 <HEAD>
15428 <TITLE>Composer Editing Commands Explained</TITLE>
15429 </HEAD>
15430 <BODY>
15431 <H1>EDITING and NAVIGATION COMMANDS</H1>
15432 <!--chtml if pinemode="function_key"-->
15433 <PRE>
15434 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
15435 ^B (Left Arrow)    Back character       | ^D       Delete current character
15436 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
15437 ^P (Up Arrow)      Previous line        |
15438 ^N (Down Arrow)    Next line            | F9       Cut marked text or
15439 ^A                 Beginning of line    |            delete current line
15440 ^E                 End of line          | F10      Undelete line(s)
15441 F7                 Previous page        |
15442 F8                 Next page            |-------------------------------------
15443 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
15444 ----------------------------------------|
15445 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
15446 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
15447 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
15448 </PRE>
15449 <!--chtml else-->
15450 <PRE>
15451 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
15452 ^B (Left Arrow)    Back character       | ^D       Delete current character
15453 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
15454 ^P (Up Arrow)      Previous line        |
15455 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
15456 ^A                 Beginning of line    |            delete current line
15457 ^E                 End of line          | ^U       Undelete line(s)
15458 ^Y                 Previous page        |
15459 ^V                 Next page            |-------------------------------------
15460 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
15461 ----------------------------------------|
15462 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
15463 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
15464 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
15465 </PRE>
15466 <!--chtml endif-->
15467 &lt;End of help on this topic&gt;
15468 </BODY>
15469 </HTML>
15470 ===== h_composer_sigedit =====
15471 <HTML>
15472 <HEAD>
15473 <TITLE>Signature Editor Commands Explained</TITLE>
15474 </HEAD>
15475 <BODY>
15476 <H1>SIGNATURE EDITOR COMMANDS</H1>
15477 <!--chtml if pinemode="function_key"-->
15478 <PRE>
15479 CURSOR MOTION KEYS                     |EDITING KEYS
15480   ^B (Left Arrow)   Back character     | ^D       Delete current character
15481   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15482   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15483   ^N (Down Arrow)   Next line          | F9       Cut marked text or
15484   ^A                Beginning of line  |           delete current line
15485   ^E                End of line        | F10       Paste text, undelete lines
15486   F7                Previous page      |           cut with ^K, or unjustify
15487   F8                Next page          |-------------------------------------
15488   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15489 ---------------------------------------| F6       Whereis (search for string)
15490 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
15491  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
15492                  |  ^Z    Suspend      | ^L       Redraw Screen
15493  F2   Send       |  F6    Alt. editor  | F5       Read in a file
15494 </PRE>
15495 <!--chtml else-->
15496 <PRE>
15497 CURSOR MOTION KEYS                     |EDITING KEYS
15498   ^B (Left Arrow)   Back character     | ^D       Delete current character
15499   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15500   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15501   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
15502   ^A                Beginning of line  |           delete current line
15503   ^E                End of line        | ^U        Paste text, undelete lines
15504   ^Y                Previous page      |           cut with ^K, or unjustify
15505   ^V                Next page          |-------------------------------------
15506   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15507 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
15508 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
15509  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
15510                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
15511  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
15512 </PRE>
15513 <!--chtml endif-->
15514
15515 NOTE: The presence or absence of the following commands is determined
15516 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
15517 some of these commands may be administratively disabled by your system
15518 manager; if they don't work, please check with your local help desk
15519 before reporting a bug.
15520 <P>
15521 <UL>
15522  <LI>Suspend (suspends Alpine and gives a system prompt)
15523  <LI>Alternate editor (allows you to compose with your own editor)
15524 </UL>
15525 <P>
15526
15527 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
15528 Ctrl-&#92;, ESC
15529 <P>
15530
15531 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
15532 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
15533 <P>
15534 &lt;End of help on this topic&gt;
15535 </BODY>
15536 </HTML>
15537 ===== h_composer_commentedit =====
15538 <HTML>
15539 <HEAD>
15540 <TITLE>Comment Editor Commands Explained</TITLE>
15541 </HEAD>
15542 <BODY>
15543 <H1>COMMENT EDITOR COMMANDS</H1>
15544 <!--chtml if pinemode="function_key"-->
15545 <PRE>
15546 CURSOR MOTION KEYS                     |EDITING KEYS
15547   ^B (Left Arrow)   Back character     | ^D       Delete current character
15548   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15549   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15550   ^N (Down Arrow)   Next line          | F9       Cut marked text or
15551   ^A                Beginning of line  |           delete current line
15552   ^E                End of line        | F10       Paste text, undelete lines
15553   F7                Previous page      |           cut with ^K, or unjustify
15554   F8                Next page          |-------------------------------------
15555   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15556 ---------------------------------------| F6       Whereis (search for string)
15557 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
15558  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
15559                  |  ^Z    Suspend      | ^L       Redraw Screen
15560  F2   Send       |  F6    Alt. editor  | F5       Read in a file
15561 </PRE>
15562 <!--chtml else-->
15563 <PRE>
15564 CURSOR MOTION KEYS                     |EDITING KEYS
15565   ^B (Left Arrow)   Back character     | ^D       Delete current character
15566   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15567   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15568   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
15569   ^A                Beginning of line  |           delete current line
15570   ^E                End of line        | ^U        Paste text, undelete lines
15571   ^Y                Previous page      |           cut with ^K, or unjustify
15572   ^V                Next page          |-------------------------------------
15573   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15574 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
15575 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
15576  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
15577                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
15578  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
15579 </PRE>
15580 <!--chtml endif-->
15581
15582 NOTE: The presence or absence of the following commands is determined
15583 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
15584 some of these commands may be administratively disabled by your system
15585 manager; if they don't work, please check with your local help desk
15586 before reporting a bug.
15587 <P>
15588 <UL>
15589  <LI>Suspend (suspends Alpine and gives a system prompt)
15590  <LI>Alternate editor (allows you to compose with your own editor)
15591 </UL>
15592 <P>
15593
15594 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
15595 Ctrl-&#92;, ESC
15596 <P>
15597
15598 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
15599 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
15600 <P>
15601 &lt;End of help on this topic&gt;
15602 </BODY>
15603 </HTML>
15604 ======= h_composer_abook_nick =======
15605 <HTML>
15606 <HEAD>
15607 <TITLE>Addressbook Nickname Explained</TITLE>
15608 </HEAD>
15609 <BODY>
15610 This is a short nickname for this address book entry.  If it is used in
15611 place of an address from the composer, the composer will fill in the
15612 address(es) for the entry that matches the nickname.
15613 <P>
15614
15615 Look <A HREF="h_edit_nav_cmds">here</A>
15616 to see the available Editing and Navigation commands.
15617 <P>
15618 &lt;End of help on this topic&gt;
15619 </BODY>
15620 </HTML>
15621 ======= h_composer_abook_full =======
15622 <HTML>
15623 <HEAD>
15624 <TITLE>Addressbook Fullname Explained</TITLE>
15625 </HEAD>
15626 <BODY>
15627 This is the full name field for this entry.  If this is going to be a
15628 distribution list (more than one address), it should be a descriptive
15629 phrase describing the list.  It will be included in the mail header if you
15630 put the list in the To: or CC: field, or in the To: line if you put the
15631 list in the Lcc: field.  It's OK to leave this field blank (and OK to
15632 leave any of the other fields blank, too). If this address book entry is
15633 going to be a simple entry with just one address, then this field is the
15634 person's name. When you send mail to this entry, this is the field to the
15635 left of the brackets. That is, it is the most readable part of the
15636 address. For example, in the sample address:
15637 <PRE>
15638        John Doe &lt;jdoe@some.domain&gt;
15639 </PRE>
15640 "John Doe" is the full name field. If you are sorting your address book
15641 with one of the options that uses full names, then it might be useful to
15642 enter the full name as "Last, First", for example:
15643 <PRE>
15644        Doe, John
15645 </PRE>
15646 so that it will be sorted using Doe instead of John. This will be changed
15647 back into John Doe when you use it.
15648 <P>
15649 Look <A HREF="h_edit_nav_cmds">here</A>
15650 to see the available Editing and Navigation commands.
15651 <P>
15652 &lt;End of help on this topic&gt;
15653 </BODY>
15654 </HTML>
15655 ======= h_composer_abook_fcc =======
15656 <HTML>
15657 <HEAD>
15658 <TITLE>Addressbook Fcc Explained</TITLE>
15659 </HEAD>
15660 <BODY>
15661 If this entry is the first one in the To: line of an outgoing message,
15662 this field will be used for the Fcc (File Carbon Copy) instead of whatever
15663 you would normally get (which depends on which
15664 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
15665 you've chosen).
15666 <P>
15667 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
15668 that you don't want any Fcc associated with this entry.
15669 <P>
15670 Look <A HREF="h_edit_nav_cmds">here</A>
15671 to see the available Editing and Navigation commands.
15672 <P>
15673 &lt;End of help on this topic&gt;
15674 </BODY>
15675 </HTML>
15676 ====== h_config_combined_abook_display =====
15677 <HTML>
15678 <HEAD>
15679 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
15680 </HEAD>
15681 <BODY>
15682 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
15683
15684 This feature affects the address book display screens.
15685 Normally, expanding an address book from the ADDRESS BOOK LIST screen
15686 will cause the remaining address books and directory servers to disappear
15687 from the screen, leaving only the entries of the expanded address book.
15688 If this feature is set, then the other address books will remain on the screen,
15689 so that all of the address books can be present at once.
15690
15691 <P>
15692 The way that commands work won't be changed.
15693 For example, the Select All command will select all of the entries in the
15694 current address book, not all of the entries in all of the address books.
15695 The WhereIs command will change a little.
15696 It will search through all of the text on the screen plus all of the entries
15697 from expanded address books.
15698
15699 <P>
15700 When this feature is set, the setting of the feature
15701 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
15702 has an effect.
15703 <P>
15704 &lt;End of help on this topic&gt;
15705 </BODY>
15706 </HTML>
15707 ====== h_config_titlebar_color_style =====
15708 <HTML>
15709 <HEAD>
15710 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
15711 </HEAD>
15712 <BODY>
15713 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
15714
15715 This option affects the colors used to display the titlebar (the top
15716 line on the screen) when viewing a message.
15717
15718 <P>
15719 The available options include:
15720 <P>
15721
15722 <DL>
15723 <DT>default</DT>
15724 <DD>The color of the titlebar will be the color you set for the
15725 <A HREF="h_config_title_color">Title Color</A>.
15726 The Title Color may be set by using the
15727 <A HREF="h_color_setup">Setup Kolor</A> screen.
15728 </DD>
15729
15730 <DT>indexline</DT>
15731 <DD>The color of the titlebar will be the same as the color of the
15732 index line corresponding to the message being viewed.
15733 The rules that determine what color the index line will be may be set
15734 up by going to the Setup/Rules/Indexcolor screen.
15735 If the index line for a message is not colored explicitly by the
15736 Indexcolor rules, then the titlebar will be colored the same as for
15737 the &quot;default&quot; option above (which is not the same color that
15738 the index line itself will have).
15739 </DD>
15740
15741 <DT>reverse-indexline</DT>
15742 <DD>This is similar to the &quot;indexline&quot; option except the
15743 foreground and background colors from the corresponding index line will
15744 be reversed.
15745 For example, if the index line color is red letters on a white background,
15746 then the titlebar will be white letters on a red background.
15747 If the index line for a message is not colored explicitly by the
15748 Indexcolor rules, then the titlebar will be colored the same as for
15749 the &quot;default&quot; option above (which is not the same color that
15750 the index line itself will have).
15751 </DD>
15752 </DL>
15753
15754 <P>
15755
15756 <UL>
15757 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15758 </UL><P>
15759 &lt;End of help on this topic&gt;
15760 </BODY>
15761 </HTML>
15762 ====== h_config_index_color_style =====
15763 <HTML>
15764 <HEAD>
15765 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
15766 </HEAD>
15767 <BODY>
15768 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
15769
15770 This option affects the colors used to display the current line in the
15771 MESSAGE INDEX screen.
15772 If you do not have Index Color Rules defined, then this option will
15773 have no effect in the index.
15774 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
15775 <P>
15776 If the option
15777 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
15778 is turned on and the
15779 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
15780 is set to something other than the default, then
15781 this option also affects the color used to display the current folder
15782 in the Incoming FOLDER LIST screen.
15783
15784 <P>
15785 The available options include:
15786 <P>
15787
15788 <DL>
15789 <DT>flip-colors</DT>
15790 <DD>This is the default.
15791 If an index line is colored because it matches one of your
15792 Index Color Rules, then its colors will be reversed when it is the currently
15793 highlighted line.
15794 For example, if the line is normally red text on a blue background, then
15795 when it is the current line it will be drawn as blue text on a red background.
15796 <P>
15797 The rest of the option values all revert to this flip-colors behavior if
15798 there is no Reverse Color defined.
15799 </DD>
15800
15801 <DT>reverse</DT>
15802 <DD>With this option the Reverse color is always used to highlight the
15803 current line.
15804 </DD>
15805
15806 <DT>reverse-fg</DT>
15807 <DD>The foreground part of the Reverse Color is used to highlight
15808 the current line.
15809 If this would cause the text to be unreadable (because the foreground and
15810 background colors are the same) or if it would cause no change in the
15811 color of the index line, then the colors are flipped instead.
15812 <P>
15813 Some people think this works particularly well if you use different
15814 background colors to emphasize &quot;interesting&quot; lines,
15815 but always with the same Normal foreground color,
15816 and you use a different foreground color for the Reverse Color.
15817 </DD>
15818
15819 <DT>reverse-fg-no-ambiguity</DT>
15820 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
15821 the resulting color will be exactly the same as the regular Reverse
15822 Color.
15823 That can lead to some possible confusion because an
15824 &quot;interesting&quot;
15825 line that is the current line will be displayed exactly the same as a
15826 non-interesting line that is current.
15827 You can't tell whether the line is just a regular current line or if it is
15828 an &quot;interesting&quot; current line by looking at the color.
15829 Setting the option to this value removes that ambiguity.
15830 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
15831 interesting current line would look just like a non-interesting current line.
15832 In that case, the interesting line's colors are simply flipped (like in the
15833 default behavior).
15834 <P>
15835 As an alternative way to preserve the line's interestingness in this case,
15836 you may find that using both a different foreground and a different
15837 background color for the interesting line will help.
15838 </DD>
15839
15840 <DT>reverse-bg</DT>
15841 <DD>The background part of the Reverse Color is used to highlight
15842 the current line.
15843 If this would cause the text to be unreadable (because the foreground and
15844 background colors are the same) or if it would cause no change in the
15845 color of the index line, then the colors are flipped instead.
15846 <P>
15847 Some people think this works particularly well if you use different
15848 foreground colors to emphasize &quot;interesting&quot; lines,
15849 but always with the same Normal background color,
15850 and you use a different background color for the Reverse Color.
15851 </DD>
15852
15853 <DT>reverse-bg-no-ambiguity</DT>
15854 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
15855 rule may also result in a color that is exactly the same as the regular
15856 Reverse Color.
15857 Setting the option to this value removes that ambiguity.
15858 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
15859 current line has the same color as the Reverse Color.
15860 In that case, the interesting line's colors are simply flipped (like in the
15861 default behavior).
15862 </DD>
15863 </DL>
15864
15865 <P>
15866
15867 <UL>
15868 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15869 </UL><P>
15870 &lt;End of help on this topic&gt;
15871 </BODY>
15872 </HTML>
15873 ====== h_config_expanded_addrbooks =====
15874 <HTML>
15875 <HEAD>
15876 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
15877 </HEAD>
15878 <BODY>
15879 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
15880
15881 If multiple address books (either personal or global) are defined, and you
15882 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
15883 screen, then set this feature. This feature will have no effect unless the
15884 feature
15885 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
15886 is also set.
15887 <P>
15888 &lt;End of help on this topic&gt;
15889 </BODY>
15890 </HTML>
15891 ====== h_config_combined_folder_display =====
15892 <HTML>
15893 <HEAD>
15894 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
15895 </HEAD>
15896 <BODY>
15897 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
15898
15899 This feature affects the folder list display screens.
15900 Normally, each folder list is viewed within its collection only.  This
15901 command allows folder lists to be viewed within a single screen that
15902 combines the contents of all collections.
15903
15904 <P>
15905 The way that commands work won't be changed.
15906 For example, the Select All command will select all of the folders in the
15907 current collection, not all of the entries in all of the collections.
15908 The WhereIs command will change a little.
15909 It will search through all of the folders in the current collection as well
15910 as all the folder in any other expanded collection.
15911
15912 <P>
15913 When this feature is set, the setting of the feature
15914 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
15915 has an effect.
15916 <P>
15917 &lt;End of help on this topic&gt;
15918 </BODY>
15919 </HTML>
15920 ====== h_config_combined_subdir_display =====
15921 <HTML>
15922 <HEAD>
15923 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
15924 </HEAD>
15925 <BODY>
15926 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
15927
15928 This feature affects the Folder List screen when
15929 the
15930 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
15931 feature is enabled.  Normally, selecting a directory from the Folder
15932 List takes you into a new screen displaying only the contents of
15933 that directory.
15934
15935 <P>
15936 Enabling this feature will cause the contents of the selected
15937 directory to be
15938 displayed within the boundaries of the &quot;Collection&quot; it
15939 is a part of.  All previously displayed collections will remain
15940 in the screen.
15941
15942 <P>
15943 The way that commands work won't be changed.
15944 For example, the Select All command will select all of the folders in the
15945 directory, as opposed to all of the entries in all of the collections.
15946 The WhereIs command will change a little.
15947 It will search through all of the folders in the current collection as well
15948 as all the folder in any other expanded collection.
15949
15950 <P>
15951 &lt;End of help on this topic&gt;
15952 </BODY>
15953 </HTML>
15954 ====== h_config_separate_fold_dir_view =====
15955 <HTML>
15956 <HEAD>
15957 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
15958 </HEAD>
15959 <BODY>
15960 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
15961
15962 This feature affects folder collections wherein a folder
15963 and directory can have the same name.  By default, Alpine displays them
15964 only once, denoting that it is both a folder and directory by appending
15965 the folder name with the hierarchy character enclosed
15966 in square brackets.
15967
15968
15969 <P>
15970 Enabling this feature will cause Alpine to display such names
15971 separately marking the name representing a directory with a trailing
15972 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
15973
15974 <P>
15975 The feature also alters the command set slightly.  By default, the
15976 right-arrow descends into the directory, while hitting the Return key will
15977 cause the folder by that name to be opened.
15978
15979 <P>
15980 With this feature set, the Return key will open the highlighted folder, or
15981 enter the highlighted directory.
15982
15983 <P>
15984 &lt;End of help on this topic&gt;
15985 </BODY>
15986 </HTML>
15987 ====== h_config_expanded_folders =====
15988 <HTML>
15989 <HEAD>
15990 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
15991 </HEAD>
15992 <BODY>
15993 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
15994
15995 If multiple folder collections are defined, and you
15996 wish to have them all expanded implicitly upon entering the FOLDER LIST
15997 screen, then set this feature. This feature will have no effect unless the
15998 feature
15999 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
16000 is also set.
16001 <P>
16002 &lt;End of help on this topic&gt;
16003 </BODY>
16004 </HTML>
16005 ======= h_config_ldap_server =======
16006 <HTML>
16007 <HEAD>
16008 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
16009 </HEAD>
16010 <BODY>
16011 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
16012 This is the name of the host where an LDAP server is running.
16013 For redundancy, this may be a space-delimited set of server names, in which
16014 case the first server that answers is used.
16015 Each of the server names may be optionally followed by
16016 a colon and a port number.
16017 If this form is used then the port number configured below in the
16018 <EM>port</EM> field is not used.
16019 <P>
16020 To find out whether your organization has its own LDAP server,
16021 contact its computing support staff.
16022 <P><UL>
16023 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
16024 </UL>
16025 <P>
16026 &lt;End of help on this topic&gt;
16027 </BODY>
16028 </HTML>
16029 ======= h_config_ldap_base =======
16030 <HTML>
16031 <HEAD>
16032 <TITLE>LDAP OPTION: Search-Base</TITLE>
16033 </HEAD>
16034 <BODY>
16035 <H1>LDAP OPTION: Search-Base</H1>
16036
16037 This is the search base to be used on this server.  It functions as a filter
16038 by restricting your searches in the LDAP server database
16039 to the specified contents of the specified fields.  Without it, searches
16040 submitted to this directory server may fail.  It might be something
16041 like:
16042
16043 <PRE>
16044       O = &lt;Your Organization Name&gt;, C = US
16045 </PRE>
16046 or it might be blank.
16047 (Some LDAP servers actually ignore anything specified here.)
16048 <P>
16049 If in doubt what parameters you should specify here,
16050 contact the maintainers of the LDAP server.
16051 <P><UL>
16052 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
16053 </UL>
16054 <P>
16055 &lt;End of help on this topic&gt;
16056 </BODY>
16057 </HTML>
16058 ======= h_config_ldap_port =======
16059 <HTML>
16060 <HEAD>
16061 <TITLE>LDAP OPTION: Port</TITLE>
16062 </HEAD>
16063 <BODY>
16064 <H1>LDAP OPTION: Port</H1>
16065
16066 This is the TCP port number to be used with this LDAP server. If you leave
16067 this blank port 389 will be used.
16068 <P>
16069 &lt;End of help on this topic&gt;
16070 </BODY>
16071 </HTML>
16072 ======= h_config_ldap_nick =======
16073 <HTML>
16074 <HEAD>
16075 <TITLE>LDAP OPTION: Nickname</TITLE>
16076 </HEAD>
16077 <BODY>
16078 <H1>LDAP OPTION: Nickname</H1>
16079
16080 This is a nickname to be used in displays. If you don't supply a
16081 nickname the server name
16082 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
16083 will be used instead.  This option is strictly for your convenience.
16084 <P>
16085 &lt;End of help on this topic&gt;
16086 </BODY>
16087 </HTML>
16088 ======= h_config_ldap_binddn =======
16089 <HTML>
16090 <HEAD>
16091 <TITLE>LDAP OPTION: Bind-DN</TITLE>
16092 </HEAD>
16093 <BODY>
16094 <H1>LDAP OPTION: Bind-DN</H1>
16095
16096 You may need to authenticate to the LDAP server before you are able to use it.
16097 This is the Distinguished Name to bind to when authenticating to this server.
16098 Try leaving this blank until you know you need it.
16099 <P>
16100 Alpine only knows about LDAP Simple authentication.
16101 It does not attempt LDAP SASL authentication.
16102 The DN and password will be sent in the clear unless TLS encryption is
16103 being used on this connection.
16104 Because of this, you may want to set the LDAP feature
16105 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
16106 or the feature
16107 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
16108 if you are going to be providing a password.
16109 <P><UL>
16110 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
16111 </UL>
16112 <P>
16113 &lt;End of help on this topic&gt;
16114 </BODY>
16115 </HTML>
16116 ======= h_config_ldap_opts_impl =======
16117 <HTML>
16118 <HEAD>
16119 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
16120 </HEAD>
16121 <BODY>
16122 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
16123
16124 Set this to have lookups done to this server implicitly from the composer.
16125 If an address doesn't look like a fully-qualified address, it will be looked
16126 up in your address books, and if it doesn't match a nickname there, then it
16127 will be looked up on the LDAP servers that have this feature set.
16128 The lookups will also be done when using the address completion feature
16129 (TAB command) in the composer if any of the servers have this feature set.
16130 Also see the LDAP feature
16131 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
16132 and the Setup/Config feature
16133 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
16134 <P>
16135 &lt;End of help on this topic&gt;
16136 </BODY>
16137 </HTML>
16138 ======= h_config_ldap_opts_tls =======
16139 <HTML>
16140 <HEAD>
16141 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
16142 </HEAD>
16143 <BODY>
16144 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
16145
16146 When connecting to this server Alpine will attempt to use TLS encryption
16147 on the connection.
16148 Also see the closely related feature
16149 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
16150 <P>
16151 Note that if this option is set, then
16152 <A HREF="h_config_ldap_opts_ldaps">
16153 &quot;Require-LDAPS-On-Connection&quot;</A>
16154 can not be enabled for this server. You must disable this feature in
16155 order to use
16156 <A HREF="h_config_ldap_opts_ldaps">
16157 &quot;Require-LDAPS-On-Connection&quot;</A>
16158 <P>
16159 &lt;End of help on this topic&gt;
16160 </BODY>
16161 </HTML>
16162 ======= h_config_ldap_opts_tlsmust =======
16163 <HTML>
16164 <HEAD>
16165 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
16166 </HEAD>
16167 <BODY>
16168 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
16169
16170 When connecting to this server Alpine will attempt to use TLS encryption
16171 on the connection.
16172 If the StartTLS operation fails then the connection will not be used.
16173 <P>
16174 Note that if this option is set, then
16175 <A HREF="h_config_ldap_opts_ldaps">
16176 &quot;Require-LDAPS-On-Connection&quot;</A>
16177 can not be enabled for this server. You must disable this feature in
16178 order to use
16179 <A HREF="h_config_ldap_opts_ldaps">
16180 &quot;Require-LDAPS-On-Connection&quot;</A>
16181 <P>
16182 &lt;End of help on this topic&gt;
16183 </BODY>
16184 </HTML>
16185 ======= h_config_ldap_opts_ldaps =======
16186 <HTML>
16187 <HEAD>
16188 <TITLE>LDAP FEATURE: Require-LDAPS-On-Connection</TITLE>
16189 </HEAD>
16190 <BODY>
16191 <H1>LDAP FEATURE: Require-LDAPS-On-Connection</H1>
16192
16193 When connecting to this server Alpine will use LDAPS (LDAP over SSL/TLS)
16194 on the connection.
16195 <P>
16196 This feature can not be used along with
16197 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
16198  or
16199 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>.
16200 If you want to connect using StartTLS to this server, you must disable
16201 this feature first.
16202 <P>
16203 &lt;End of help on this topic&gt;
16204 </BODY>
16205 </HTML>
16206 ====== h_config_ldap_opts_rhs =====
16207 <HTML>
16208 <HEAD>
16209 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
16210 </HEAD>
16211 <BODY>
16212 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
16213
16214 Normally implicit LDAP lookups from the composer are done only for the
16215 strings you type in from the composer screen. In other words, you type in
16216 something in the To or CC field and press return, then the string is looked up.
16217 First that string is looked up in your address books. If a match is found
16218 there, then the results of that match are looked up again. If you place
16219 a string in your address book that you want to have looked up on the LDAP
16220 directory server, you need to turn on this feature. If you set this feature
16221 for a server, you almost always will also want to set the
16222 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
16223 feature. An example might serve to best illustrate this feature.
16224 <P>
16225 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
16226 entry with an
16227 address of pres@whitehouse.gov, then you might put an entry in your address
16228 book that looks like:
16229 <P>
16230 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
16231 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
16232 <P>
16233 Now, when you type &quot;bill&quot; into an
16234 address field in the composer Alpine will
16235 find the &quot;bill&quot; entry in your address book.
16236 It will replace &quot;bill&quot; with
16237 &quot;William Clinton&quot;.
16238 It will then search for an entry with that nickname
16239 in your address book and not find one. If this feature
16240 is set, Alpine will then attempt to lookup
16241 &quot;William Clinton&quot; on the LDAP server and find the entry with address
16242 pres@whitehouse.gov.
16243 <P>
16244 A better way to accomplish the same thing is probably to use the feature
16245 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
16246 <P>
16247 &lt;End of help on this topic&gt;
16248 </BODY>
16249 </HTML>
16250 ====== h_config_ldap_opts_ref =====
16251 <HTML>
16252 <HEAD>
16253 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
16254 </HEAD>
16255 <BODY>
16256 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
16257
16258 Normally when you save the results of an LDAP directory lookup to your
16259 address book the results of the lookup are saved. If this feature is set
16260 and the entry being saved was found on this directory server, then the
16261 search criteria is saved instead of the results of the search. When this
16262 address book entry is used in the future, instead of copying the results
16263 from the address book the directory lookup will be done again. This could
16264 be useful if the copied result might become stale because the data on
16265 the directory server changes (for example, the entry's email address changes).
16266 You probably don't want to set this feature if the server is at all slow or
16267 unreliable.
16268 <P>
16269 The way this actually works is that instead of saving the email address
16270 in your address book, Alpine saves enough information to look up the same
16271 directory entry again. In particular, it saves the server name and the
16272 distinguished name of the entry. It's possible that the server administrators
16273 might change the format of distinguished names on the server, or that the
16274 entry might be removed from the server. If Alpine notices this, you will be warned
16275 and a backup copy of the email address will be used. You may want to create
16276 a new entry in this case, since you will get the annoying warning every
16277 time you use the old entry. You may do that by Saving the entry to a new
16278 nickname in the same address book. You will be asked whether or not you
16279 want to use the backup email address.
16280 <P>
16281 A related feature in the Setup/Config screen is
16282 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
16283 <P>
16284 &lt;End of help on this topic&gt;
16285 </BODY>
16286 </HTML>
16287 ======= h_config_ldap_opts_nosub =======
16288 <HTML>
16289 <HEAD>
16290 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
16291 </HEAD>
16292 <BODY>
16293 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
16294
16295 Spaces in your input are normally handled specially.
16296 Each space character is replaced
16297 by
16298 <P>
16299 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
16300 <P>
16301 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
16302 The reason this is done is so the input string
16303 <P>
16304 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
16305 <P>
16306 (which is converted to &quot;Greg* Donald&quot;) will match
16307 the names &quot;Greg Donald&quot;,
16308 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
16309 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
16310 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
16311 then it would also match the name &quot;Greg Donaldson&quot;.
16312 <P>
16313 Turning on this feature will disable this substitution.
16314 <P>
16315 &lt;End of help on this topic&gt;
16316 </BODY>
16317 </HTML>
16318 ====== h_config_ldap_searchtypes =======
16319 <HTML>
16320 <HEAD>
16321 <TITLE>LDAP OPTION: Search-Type</TITLE>
16322 </HEAD>
16323 <BODY>
16324 <H1>LDAP OPTION: Search-Type</H1>
16325
16326 This affects the way that LDAP searches are done.
16327 In particular, this tells the server where to look for the string to be matched.
16328 If set to &quot;name&quot; then the string that is being searched for will
16329 be compared with the string in the
16330 &quot;Name&quot; field on the server
16331 (technically, it is the &quot;commonname&quot; field on the server).
16332 &quot;Surname&quot; means we're looking for a
16333 match in the &quot;Surname&quot; field on the
16334 server (actually the &quot;sn&quot; field).
16335 &quot;Givenname&quot; really is &quot;givenname&quot;
16336 and &quot;email&quot; is the electronic mail address (this is actually the field
16337 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
16338 The other three types are combinations of
16339 the types listed so far. &quot;Name-or-email&quot;
16340 means the string should appear
16341 in either the &quot;name&quot; field OR the &quot;email&quot; field.
16342 Likewise, &quot;surname-or-givenname&quot;
16343 means &quot;surname&quot; OR &quot;givenname&quot;
16344 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
16345 <P>
16346 This search TYPE is combined with the
16347 search <A HREF="h_config_ldap_searchrules">RULE</A>
16348 to form the actual search query.
16349 <P>
16350 The usual default value for this
16351 option is &quot;sur-or-given-or-name-or-email&quot;.
16352 This type of search may be slow on some servers.
16353 Try &quot;name-or-email&quot;, which is often
16354 faster, or just &quot;name&quot; if the performance seems to be a problem.
16355 <P>
16356 Some servers have been configured with different attribute names for
16357 these four fields.
16358 In other words, instead of using the attribute name &quot;mail&quot;
16359 for the email address field, the server might be configured to use something
16360 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
16361 Alpine can be configured to use these different attribute names by using
16362 the four configuration options:
16363 <P><UL>
16364 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
16365 </UL>
16366 <P><UL>
16367 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
16368 </UL>
16369 <P><UL>
16370 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
16371 </UL>
16372 <P><UL>
16373 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
16374 </UL>
16375 <P>
16376 &lt;End of help on this topic&gt;
16377 </BODY>
16378 </HTML>
16379 ====== h_config_ldap_searchrules =======
16380 <HTML>
16381 <HEAD>
16382 <TITLE>LDAP OPTION: Search-Rule</TITLE>
16383 </HEAD>
16384 <BODY>
16385 <H1>LDAP OPTION: Search-Rule</H1>
16386
16387 This affects the way that LDAP searches are done.
16388 If set to &quot;equals&quot; then
16389 only exact matches count.
16390 &quot;Contains&quot; means that the string you type in
16391 is a substring of what you are matching against.
16392 &quot;Begins-with&quot; and &quot;ends-with&quot;
16393 mean that the string starts or ends with the string you type in.
16394 <P>
16395 Spaces in your input are normally handled specially, but you can turn that
16396 special handling off with the
16397 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
16398 feature.
16399 <P>
16400 The usual default value for this option is &quot;begins-with&quot;.
16401 <P>
16402 &lt;End of help on this topic&gt;
16403 </BODY>
16404 </HTML>
16405 ======= h_config_ldap_email_attr =======
16406 <HTML>
16407 <HEAD>
16408 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
16409 </HEAD>
16410 <BODY>
16411 <H1>LDAP OPTION: EmailAttribute</H1>
16412
16413 This is the name of the attribute that is searched for when looking for
16414 an email address. The default value for this option is &quot;mail&quot; or
16415 &quot;electronicmail&quot;.
16416 If the server you are using uses a different attribute name for the email
16417 address, put that attribute name here.
16418 <P>
16419 This will affect the search filter used if your Search-Type is one that
16420 contains a search for &quot;email&quot;.
16421 It will also cause the attribute value matching this attribute name to be used
16422 as the email address when you look up an entry from the composer.
16423 <P>
16424 &lt;End of help on this topic&gt;
16425 </BODY>
16426 </HTML>
16427 ======= h_config_ldap_sn_attr =======
16428 <HTML>
16429 <HEAD>
16430 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
16431 </HEAD>
16432 <BODY>
16433 <H1>LDAP OPTION: SurnameAttribute</H1>
16434
16435 This is the name of the attribute that is searched for when looking for
16436 the surname of the entry. The default value for this option is &quot;sn&quot;.
16437 If the server you are using uses a different attribute name for the surname,
16438 put that attribute name here.
16439 This will affect the search filter used if your Search-Type is one that
16440 contains a search for &quot;surname&quot;.
16441 <P>
16442 &lt;End of help on this topic&gt;
16443 </BODY>
16444 </HTML>
16445 ======= h_config_ldap_gn_attr =======
16446 <HTML>
16447 <HEAD>
16448 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
16449 </HEAD>
16450 <BODY>
16451 <H1>LDAP OPTION: GivennameAttribute</H1>
16452
16453 This is the name of the attribute that is searched for when looking for
16454 the given name of the entry. The default value for this option is &quot;givenname&quot;.
16455 If the server you are using uses a different attribute name for the given name,
16456 put that attribute name here.
16457 This will affect the search filter used if your Search-Type is one that
16458 contains a search for &quot;givenname&quot;.
16459 <P>
16460 &lt;End of help on this topic&gt;
16461 </BODY>
16462 </HTML>
16463 ======= h_config_ldap_cn_attr =======
16464 <HTML>
16465 <HEAD>
16466 <TITLE>LDAP OPTION: NameAttribute</TITLE>
16467 </HEAD>
16468 <BODY>
16469 <H1>LDAP OPTION: NameAttribute</H1>
16470
16471 This is the name of the attribute that is searched for when looking for
16472 the name of the entry. The default value for this option is &quot;cn&quot;, which
16473 stands for common name.
16474 If the server you are using uses a different attribute name for the name,
16475 put that attribute name here.
16476 This will affect the search filter used if your Search-Type is one that
16477 contains a search for &quot;name&quot;.
16478 <P>
16479 &lt;End of help on this topic&gt;
16480 </BODY>
16481 </HTML>
16482 ======= h_config_ldap_time =======
16483 <HTML>
16484 <HEAD>
16485 <TITLE>LDAP OPTION: Timelimit</TITLE>
16486 </HEAD>
16487 <BODY>
16488 <H1>LDAP OPTION: Timelimit</H1>
16489
16490 This places a limit on the number of seconds the LDAP search will continue.
16491 The default is 30 seconds. A value of 0 means no limit. Note that some servers
16492 may place limits of their own on searches.
16493 <P>
16494 &lt;End of help on this topic&gt;
16495 </BODY>
16496 </HTML>
16497 ======= h_config_ldap_size =======
16498 <HTML>
16499 <HEAD>
16500 <TITLE>LDAP OPTION: Sizelimit</TITLE>
16501 </HEAD>
16502 <BODY>
16503 <H1>LDAP OPTION: Sizelimit</H1>
16504
16505 This places a limit on the number of entries returned by the LDAP server.
16506 A value of 0 means no limit. The default is 0. Note that some servers
16507 may place limits of their own on searches.
16508 <P>
16509 &lt;End of help on this topic&gt;
16510 </BODY>
16511 </HTML>
16512 ======= h_config_ldap_cust =======
16513 <HTML>
16514 <HEAD>
16515 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
16516 </HEAD>
16517 <BODY>
16518 <H1>LDAP OPTION: Custom-Search-Filter</H1>
16519
16520 This one is for advanced users only! If you define this, then the
16521 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
16522 However, the feature
16523 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
16524 is still in effect.
16525 That is, the space substitution will take place even in a custom filter unless
16526 you disable it.
16527 <P>
16528 If your LDAP service stops working and you suspect it might be because
16529 of your custom filter, just delete this filter and try using the
16530 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
16531 Another option that sometimes causes trouble is the
16532 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
16533 <P>
16534 This variable may be set to the string representation of an LDAP search
16535 filter (see RFC1960). In the places where you want the address string to be
16536 substituted in, put a '%s' in this filter string. Here are some examples:
16537 <P>
16538 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
16539 is equivalent to the &quot;Custom-Search-Filter&quot;
16540 <PRE>
16541      (cn=%s*)
16542 </PRE>
16543 When you try to match against the string &quot;string&quot; the program replaces
16544 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
16545 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
16546 <P>
16547 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
16548 of &quot;contains&quot; is equivalent to
16549 <PRE>
16550      (|(cn=*%s*)(mail=*%s*))
16551 </PRE>
16552 <P>
16553 If your server uses a different attribute <EM>name</EM> than
16554 Alpine uses by default,
16555 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
16556 then you may be able to use one or more of the four attribute configuration
16557 options instead of defining a custom filter:
16558 <P><UL>
16559 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
16560 </UL>
16561 <P><UL>
16562 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
16563 </UL>
16564 <P><UL>
16565 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
16566 </UL>
16567 <P><UL>
16568 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
16569 </UL>
16570 <P>
16571 &lt;End of help on this topic&gt;
16572 </BODY>
16573 </HTML>
16574 ======= h_composer_abook_comment =======
16575 <HTML>
16576 <HEAD>
16577 <TITLE>Addressbook Comment Explained</TITLE>
16578 </HEAD>
16579 <BODY>
16580 This is a comment to help you remember what this entry is. The WhereIs
16581 command searches comments so that it is easier to find an entry with a comment
16582 you know about attached to it. This field is not used in the outgoing message.
16583 <P>
16584 Look <A HREF="h_edit_nav_cmds">here</A>
16585 to see the available Editing and Navigation commands.
16586 <P>
16587 &lt;End of help on this topic&gt;
16588 </BODY>
16589 </HTML>
16590 ======= h_composer_abook_addrs =======
16591 <HTML>
16592 <HEAD>
16593 <TITLE>Addressbook Lists</TITLE>
16594 </HEAD>
16595 <BODY>
16596 <H1>Addressbook Lists</H1>
16597
16598 This is a list of addresses to send to when sending to this address book
16599 entry.  Each member of the list may be an address or another nickname from
16600 any of your address books.  If it is an address, it is OK to include the
16601 full name field as well as the electronic address portion of that address.
16602 For example, the following are all legitimate entries in this field:
16603
16604 <DL><DT>&nbsp;</DT>
16605 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
16606 <DD>jdoe@some.domain
16607 <DD>John Doe &lt;jdoe@some.domain&gt;
16608 </DL>
16609
16610 The addresses should be listed separated by commas, just like you would
16611 enter them from the composer.
16612
16613 <P>
16614
16615 The only difference between a distribution list and a simple entry with a
16616 single address, is that a distribution list has more than one address
16617 listed in the Addresses: field, whereas a simple personal entry has just
16618 one address.
16619
16620 <P>
16621
16622 For individual address book entries, if there is a full name in the
16623 Fullname: field (filling in the Fullname: field is not required), it is
16624 used.  If the full name is specified in the Address: field and not in the
16625 Fullname: field, then the full name from the Address: field is used.
16626
16627 <P>
16628
16629 If you type the nickname of a distribution list from one of your address
16630 books in the Lcc: field, then the full name of that list is used in the
16631 To: field.  If you put a list in the To: or Cc: fields, that list will be
16632 expanded into all of its addresses.  If the list has a full name, then
16633 that will appear at the beginning of the addresses.
16634
16635 <DL><DT>&nbsp;</DT>
16636 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
16637 &lt;sal@here.there&gt;
16638 </DL>
16639
16640 If the first address in the distribution list also has a full name, then
16641 the list full name and that full name are combined into something like the
16642 following:
16643
16644 <DL><DT>&nbsp;</DT>
16645 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
16646 </DL>
16647
16648
16649 If you specify a list via Lcc, the full name is used in the To: line.  If
16650 you specify a list in the To: or Cc: fields, then it uses the same method
16651 as for individual entries for filling in the full name.
16652
16653 <P>
16654
16655 For help with editing and navigation commands, check the Help for the
16656 Nickname: field.
16657
16658 <P>
16659 &lt;End of help on this topic&gt;
16660 </BODY>
16661 </HTML>
16662 ======= h_config_xoauth2_client_id =======
16663 <HTML>
16664 <HEAD>
16665 <TITLE>Client-Id Explained</TITLE>
16666 </HEAD>
16667 <BODY>
16668 <H1>Client-Id Explained</H1>
16669
16670 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16671 someone has shared a client-id and client-secret with you, use this field to input the
16672 client-id.
16673 <P>
16674 The Client-Id field is a string that your provider generates for the program
16675 being registered. However, some providers allow different users to register
16676 the same program. Users of the Mutt email program already do this to use
16677 XOAUTH2 authentication in Gmail.
16678
16679 <P>
16680 &lt;End of help on this topic&gt;
16681 </BODY>
16682 </HTML>
16683 ======= h_config_xoauth2_client_secret =======
16684 <HTML>
16685 <HEAD>
16686 <TITLE>Client-Secret Explained</TITLE>
16687 </HEAD>
16688 <BODY>
16689 <H1>Client-Secret Explained</H1>
16690
16691 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16692 someone has shared a client-id and client-secret with you, use this field to input the
16693 client-secret. Some servers require both a client-id and a client-secret, some other servers do
16694 not require a client-secret. If a client-secret is required, use this field to add one.
16695
16696 <P> The client-secret field is supposed to be kept secret, that is, not
16697 shared with any of the users, but due to the open source nature of Alpine,
16698 it is not possible to keep it secret in any meaningful way. The intention
16699 of this field is so that only the coders of an app can use the codes given
16700 to them and authenticate their users to the services they are requesting.
16701 This means that other coders would not be able to impresonate that app,
16702 and use it to steal data from those users. In the case of Alpine this is
16703 not possible, as Alpine does not steal data from its users, so users are safe
16704 sharing client-secrets. Just make sure you obtain your copy of Alpine from
16705 a reputable provider or compile the source code by yourself. The official
16706 source code of this project is located at
16707
16708 <P><CENTER><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A>.</CENTER>
16709
16710 <P>
16711 &lt;End of help on this topic&gt;
16712 </BODY>
16713 </HTML>
16714 ======= h_config_xoauth2_tenant =======
16715 <HTML>
16716 <HEAD>
16717 <TITLE>Tenant Explained</TITLE>
16718 </HEAD>
16719 <BODY>
16720 <H1>Tenant Explained</H1>
16721
16722 The tenant is a way in which an app can be restricted. Alpine by default
16723 has no restrictions, which means that it can be used to access any service;
16724 however, a system administrator might register their own app and make it
16725 available only to those in their organization.
16726
16727 <P>
16728 This setting allows a system administrator to register Alpine with a different
16729 client-id and client-secret and further restrict access to only authorized
16730 users.
16731
16732 <P>
16733 &lt;End of help on this topic&gt;
16734 </BODY>
16735 </HTML>
16736 ======= h_config_xoauth2_flow =======
16737 <HTML>
16738 <HEAD>
16739 <TITLE>Flow Explained</TITLE>
16740 </HEAD>
16741 <BODY>
16742 <H1>Flow Explained</H1>
16743
16744 The first time you connect to a service to authorize Alpine access to your
16745 email, you will have to do a certain number of steps, which typically involve
16746 to login to your account using a browser, and agreeing to give Alpine certain
16747 rights to access your account.
16748
16749 <P>
16750 How this process is going to be done depends on the service. Some services
16751 allow you to give access to Alpine and later generate a code that you
16752 input into Alpine, while others give you a code you have to use before you
16753 approve access to Alpine to access your email.
16754
16755 <P> An example of a service that gives you a code after you authorize
16756 Alpine is Gmail, and this process is called internally as &quot;Authorize&quot;.
16757 An example of a service that gives you a code before you authorize Alpine
16758 is Outlook, and this process is called &quot;Device&quot;. However, some services,
16759 like Outlook, offer both services, and you can choose which flow you would like
16760 to use. You
16761 can choose between the &quot;Authorize&qupt; and &quot;Device&quot; in these servers.
16762 If you forget to configure
16763 this, Alpine will ask you in these situations which method to use before it starts
16764 to setup the process to get your authrization.
16765
16766 <P>
16767 &lt;End of help on this topic&gt;
16768 </BODY>
16769 </HTML>
16770 ======= h_config_xoauth2_username =======
16771 <HTML>
16772 <HEAD>
16773 <TITLE>Username Explained</TITLE>
16774 </HEAD>
16775 <BODY>
16776 <H1>Username Explained</H1>
16777
16778 This variable is a list of usernames for which the configuration for the
16779 given service is valid. You may have more than one username for which this
16780 configuration is correct.
16781
16782 <P>
16783 Alpine will use the usernames in this list to associate your username with
16784 the correct configuration in Alpine. If Alpine cannot determine which configuration
16785 to use, Alpine will offer you a list of client-ids that you have configured
16786 for that service and ask you to pick one. Your answer will be saved  in your
16787 .pinerc file.
16788
16789 <P>
16790 &lt;End of help on this topic&gt;
16791 </BODY>
16792 </HTML>
16793 ======= h_config_role_nick =======
16794 <HTML>
16795 <HEAD>
16796 <TITLE>Nickname Explained</TITLE>
16797 </HEAD>
16798 <BODY>
16799 <H1>Nickname Explained</H1>
16800
16801 This is a nickname to help you.
16802 You should have a different nickname for each role you define.
16803 The nickname will be used in the SETUP ROLE RULES screen to allow you to
16804 pick a role to edit.
16805 It will also be used when you send a message to let you know you are
16806 sending with a different role than you use by default, and
16807 it will be useful for choosing a role when composing with the Role command
16808 or when composing with one of the Role Uses set to With Confirmation.
16809 This field is not used in the outgoing message.
16810 <P>
16811 Look <A HREF="h_edit_nav_cmds">here</A>
16812 to see the available Editing and Navigation commands.
16813 <P>
16814 &lt;End of help on this topic&gt;
16815 </BODY>
16816 </HTML>
16817 ======= h_config_role_comment =======
16818 <HTML>
16819 <HEAD>
16820 <TITLE>Comment Explained</TITLE>
16821 </HEAD>
16822 <BODY>
16823 <H1>Comment Explained</H1>
16824
16825 This is a comment to help you.
16826 This comment does not play any functional role, it is simply an optional
16827 comment to help you remember what the rule is for.
16828 <P>
16829 Look <A HREF="h_edit_nav_cmds">here</A>
16830 to see the available Editing and Navigation commands.
16831 <P>
16832 &lt;End of help on this topic&gt;
16833 </BODY>
16834 </HTML>
16835 ======= h_config_other_nick =======
16836 <HTML>
16837 <HEAD>
16838 <TITLE>Nickname Explained</TITLE>
16839 </HEAD>
16840 <BODY>
16841 <H1>Nickname Explained</H1>
16842
16843 This is a nickname to help you.
16844 You should have a different nickname for each rule you define.
16845 The nickname will be used in the SETUP OTHER RULES screen to allow you to
16846 pick a rule to edit.
16847 <P>
16848 Look <A HREF="h_edit_nav_cmds">here</A>
16849 to see the available Editing and Navigation commands.
16850 <P>
16851 &lt;End of help on this topic&gt;
16852 </BODY>
16853 </HTML>
16854 ======= h_config_score_nick =======
16855 <HTML>
16856 <HEAD>
16857 <TITLE>Nickname Explained</TITLE>
16858 </HEAD>
16859 <BODY>
16860 <H1>Nickname Explained</H1>
16861
16862 This is a nickname to help you.
16863 You should have a different nickname for each scoring rule you define.
16864 The nickname will be used in the SETUP SCORING RULES screen to allow you to
16865 pick a rule to edit.
16866 <P>
16867 Look <A HREF="h_edit_nav_cmds">here</A>
16868 to see the available Editing and Navigation commands.
16869 <P>
16870 &lt;End of help on this topic&gt;
16871 </BODY>
16872 </HTML>
16873 ======= h_config_incol_nick =======
16874 <HTML>
16875 <HEAD>
16876 <TITLE>Nickname Explained</TITLE>
16877 </HEAD>
16878 <BODY>
16879 <H1>Nickname Explained</H1>
16880
16881 This is a nickname to help you.
16882 You should have a different nickname for each color rule you define.
16883 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
16884 pick a rule to edit.
16885 <P>
16886 Look <A HREF="h_edit_nav_cmds">here</A>
16887 to see the available Editing and Navigation commands.
16888 <P>
16889 &lt;End of help on this topic&gt;
16890 </BODY>
16891 </HTML>
16892 ======= h_config_filt_nick =======
16893 <HTML>
16894 <HEAD>
16895 <TITLE>Nickname Explained</TITLE>
16896 </HEAD>
16897 <BODY>
16898 <H1>Nickname Explained</H1>
16899
16900 This is a nickname to help you.
16901 You should have a different nickname for each filtering rule you define.
16902 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
16903 pick a rule to edit.
16904 <P>
16905 Look <A HREF="h_edit_nav_cmds">here</A>
16906 to see the available Editing and Navigation commands.
16907 <P>
16908 &lt;End of help on this topic&gt;
16909 </BODY>
16910 </HTML>
16911 ======= h_config_score_topat =======
16912 <HTML>
16913 <HEAD>
16914 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16915 </HEAD>
16916 <BODY>
16917 <H1>&quot;To:&quot; Pattern Explained</H1>
16918
16919 Any text you enter as the &quot;To pattern&quot;
16920 will be compared to the recipients from the To: line of
16921 the message being scored.
16922 When the text you entered matches
16923 all or part of the To: line of a message, then the Score Value
16924 you have specified will be added to the score for the message.
16925 (Any other non-blank parts of the Pattern must match, too.)
16926 <P>
16927
16928 You may enter a complete email address, part of an address, or a
16929 list of addresses or partial addresses.
16930 For example:
16931 <P>
16932
16933 <PRE>
16934  To pattern = friend@public.com
16935
16936  To pattern = rated.net
16937
16938  To pattern = xxx@adults.com
16939               admin@msn.com
16940               fool@motleyfool.com
16941 </PRE>
16942
16943 <P>
16944 Each of those are valid To patterns.
16945 <P>
16946
16947 Messages match those patterns if any of the
16948 addresses in the To: line of the message contains the pattern.
16949 If the pattern is a list of patterns
16950 (like the last example above) then it is a match if any of the patterns in
16951 the list match any of the addresses in the To: line.
16952 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16953 present for a match.
16954 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16955 address2 must be present.
16956 That is exactly what using a list does.)
16957 <P>
16958
16959 Some messages may be &quot;bounced&quot; to you, and will
16960 have a &quot;Resent-To:&quot; header line.
16961 If the message contains a Resent-To: line
16962 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16963 Alpine will look for
16964 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16965 the original To: line.
16966 <P>
16967
16968 When entering a pattern, you may choose an address from your address book
16969 with the &quot;T&quot; command.
16970 <P>
16971
16972 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16973 &quot;!&quot; &quot;toggle NOT&quot; command.
16974 This changes the meaning of the To pattern so that it has the opposite meaning.
16975 It will be considered a match if there are no matches between the
16976 addresses in the To: line and the list of To patterns.
16977 <P>
16978 Don't make the mistake of putting the &quot;!&quot; in the data field for
16979 the pattern.
16980 For example, if you type the characters &quot;!frizzle&quot; into the To
16981 pattern, the pattern will look like:
16982 <P>
16983 <PRE>
16984  To pattern = !frizzle
16985 </PRE>
16986 <P>
16987 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16988 In order to match messages that do not have &quot;frizzle&quot; in
16989 their To field, first type the characters &quot;frizzle&quot; followed
16990 by carriage return for the value of the To pattern, then negate it
16991 by typing the &quot;!&quot; command.
16992 It should end up looking like
16993 <P>
16994 <PRE>
16995  ! To pattern = frizzle
16996 </PRE>
16997 <P>
16998 You are not limited to using the six standard header patterns that are
16999 normally shown (To, From, Sender, Cc, News, and Subject).
17000 You may add any other header to a Pattern by
17001 using the &quot;eXtraHdr&quot; command to specify a different
17002 message header line; and then the Add or Change command to fill in
17003 a pattern for the new header line, just like you would for a standard header.
17004 <P>
17005 A technicality: Since comma is the character used to separate multiple
17006 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17007 you want to include a literal comma in the field.
17008 In other words, if you type a backslash followed by a comma it will
17009 be interpreted as a comma by Alpine, instead of as a separator between
17010 pattern values.
17011 All other backslashes are literal backslashes and should not be escaped.
17012 <P>
17013 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17014 for more information on Patterns.
17015 <P>
17016 Look <A HREF="h_edit_nav_cmds">here</A>
17017 to see the available Editing and Navigation commands.
17018 <P>
17019 &lt;End of help on this topic&gt;
17020 </BODY>
17021 </HTML>
17022 ======= h_config_incol_topat =======
17023 <HTML>
17024 <HEAD>
17025 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
17026 </HEAD>
17027 <BODY>
17028 <H1>&quot;To:&quot; Pattern Explained</H1>
17029
17030 Any text you enter as the &quot;To pattern&quot;
17031 will be compared to the recipients from the To: lines of
17032 the messages in the index.
17033 When the text you entered matches
17034 all or part of the To: line of a message, then the Index Line Color you have
17035 specified will be used for that line in the index.
17036 (Any other non-blank parts of the Pattern must match, too.)
17037 <P>
17038
17039 You may enter a complete email address, part of an address, or a
17040 list of addresses or partial addresses.
17041 For example:
17042 <P>
17043
17044 <PRE>
17045  To pattern = friend@public.com
17046  To pattern = rated.net
17047  To pattern = xxx@adults.com
17048               admin@msn.com
17049               fool@motleyfool.com
17050 </PRE>
17051
17052 <P>
17053 Each of those are valid To patterns.
17054 <P>
17055
17056 Messages match those patterns if any of the
17057 addresses in the To: line of the message contains the pattern.
17058 If the pattern is a list of patterns
17059 (like the last example above) then it is a match if any of the patterns in
17060 the list match any of the addresses in the To: line.
17061 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
17062 present for a match.
17063 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
17064 address2 must be present.
17065 That is exactly what using a list does.)
17066 <P>
17067
17068 Some messages may be &quot;bounced&quot; to you, and will
17069 have a &quot;Resent-To:&quot; header line.
17070 If the message contains a Resent-To: line
17071 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
17072 Alpine will look for
17073 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
17074 the original To: line.
17075 <P>
17076
17077 When entering a pattern, you may choose an address from your address book
17078 with the &quot;T&quot; command.
17079 <P>
17080
17081 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
17082 &quot;!&quot; &quot;toggle NOT&quot; command.
17083 This changes the meaning of the To pattern so that it has the opposite meaning.
17084 It will be considered a match if there are no matches between the
17085 addresses in the To: line and the list of To patterns.
17086 <P>
17087 Don't make the mistake of putting the &quot;!&quot; in the data field for
17088 the pattern.
17089 For example, if you type the characters &quot;!frizzle&quot; into the To
17090 pattern, the pattern will look like:
17091 <P>
17092 <PRE>
17093  To pattern = !frizzle
17094 </PRE>
17095 <P>
17096 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17097 In order to match messages that do not have &quot;frizzle&quot; in
17098 their To field, first type the characters &quot;frizzle&quot; followed
17099 by carriage return for the value of the To pattern, then negate it
17100 by typing the &quot;!&quot; command.
17101 It should end up looking like
17102 <P>
17103 <PRE>
17104  ! To pattern = frizzle
17105 </PRE>
17106 <P>
17107
17108 You are not limited to using the six standard header patterns that are
17109 normally shown (To, From, Sender, Cc, News, and Subject).
17110 You may add any other header to a Pattern by
17111 using the &quot;eXtraHdr&quot; command to specify a different
17112 message header line; and then the Add or Change command to fill in
17113 a pattern for the new header line, just like you would for a standard header.
17114 <P>
17115 A technicality: Since comma is the character used to separate multiple
17116 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17117 you want to include a literal comma in the field.
17118 In other words, if you type a backslash followed by a comma it will
17119 be interpreted as a comma by Alpine, instead of as a separator between
17120 pattern values.
17121 All other backslashes are literal backslashes and should not be escaped.
17122 <P>
17123 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17124 for more information on Patterns.
17125 <P>
17126 Look <A HREF="h_edit_nav_cmds">here</A>
17127 to see the available Editing and Navigation commands.
17128 <P>
17129 &lt;End of help on this topic&gt;
17130 </BODY>
17131 </HTML>
17132 ======= h_config_other_topat =======
17133 <HTML>
17134 <HEAD>
17135 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
17136 </HEAD>
17137 <BODY>
17138 <H1>&quot;To:&quot; Pattern Explained</H1>
17139
17140 For some of the OTHER RULES actions, there is no message that is being
17141 compared against.
17142 If that is the case, then only the Current Folder Type is checked.
17143 In particular, this To pattern is ignored.
17144 Actions that fall into this category include both
17145 Sort Order and Index Format.
17146 <P>
17147 A technicality: Since comma is the character used to separate multiple
17148 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17149 you want to include a literal comma in the field.
17150 In other words, if you type a backslash followed by a comma it will
17151 be interpreted as a comma by Alpine, instead of as a separator between
17152 pattern values.
17153 All other backslashes are literal backslashes and should not be escaped.
17154 <P>
17155 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17156 for more information on Patterns.
17157 <P>
17158 Look <A HREF="h_edit_nav_cmds">here</A>
17159 to see the available Editing and Navigation commands.
17160 <P>
17161 &lt;End of help on this topic&gt;
17162 </BODY>
17163 </HTML>
17164 ======= h_config_filt_topat =======
17165 <HTML>
17166 <HEAD>
17167 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
17168 </HEAD>
17169 <BODY>
17170 <H1>&quot;To:&quot; Pattern Explained</H1>
17171
17172 Any text you enter as the &quot;To pattern&quot;
17173 will be compared to the recipients from the To: line of
17174 messages when Alpine opens folders.
17175 When the text you entered matches
17176 all or part of the To: line of a message, then the Filter Action you have
17177 specified will be carried out.
17178 (Any other non-blank parts of the Pattern must match, too.)
17179 <P>
17180
17181 You may enter a complete email address, part of an address, or a
17182 list of addresses or partial addresses.
17183 For example:
17184 <P>
17185
17186 <PRE>
17187  To pattern = friend@public.com
17188  To pattern = rated.net
17189  To pattern = xxx@adults.com
17190               admin@msn.com
17191               fool@motleyfool.com
17192 </PRE>
17193
17194 <P>
17195 Each of those are valid To patterns.
17196 <P>
17197
17198 Messages match those patterns if any of the
17199 addresses in the To: line of the message contains the pattern.
17200 If the pattern is a list of patterns
17201 (like the last example above) then it is a match if any of the patterns in
17202 the list match any of the addresses in the To: line.
17203 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
17204 present for a match.
17205 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
17206 address2 must be present.
17207 That is exactly what using a list does.)
17208 <P>
17209
17210 Some messages may be &quot;bounced&quot; to you, and will
17211 have a &quot;Resent-To:&quot; header line.
17212 If the message contains a Resent-To: line
17213 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
17214 Alpine will look for
17215 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
17216 the original To: line.
17217 <P>
17218
17219 When entering a pattern, you may choose an address from your address book
17220 with the &quot;T&quot; command.
17221 <P>
17222
17223 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
17224 &quot;!&quot; &quot;toggle NOT&quot; command.
17225 This changes the meaning of the To pattern so that it has the opposite meaning.
17226 It will be considered a match if there are no matches between the
17227 addresses in the To: line and the list of To patterns.
17228 <P>
17229 Don't make the mistake of putting the &quot;!&quot; in the data field for
17230 the pattern.
17231 For example, if you type the characters &quot;!frizzle&quot; into the To
17232 pattern, the pattern will look like:
17233 <P>
17234 <PRE>
17235  To pattern = !frizzle
17236 </PRE>
17237 <P>
17238 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17239 In order to match messages that do not have &quot;frizzle&quot; in
17240 their To field, first type the characters &quot;frizzle&quot; followed
17241 by carriage return for the value of the To pattern, then negate it
17242 by typing the &quot;!&quot; command.
17243 It should end up looking like
17244 <P>
17245 <PRE>
17246  ! To pattern = frizzle
17247 </PRE>
17248 <P>
17249
17250 You are not limited to using the six standard header patterns that are
17251 normally shown (To, From, Sender, Cc, News, and Subject).
17252 You may add any other header to a Pattern by
17253 using the &quot;eXtraHdr&quot; command to specify a different
17254 message header line; and then the Add or Change command to fill in
17255 a pattern for the new header line, just like you would for a standard header.
17256 <P>
17257 A technicality: Since comma is the character used to separate multiple
17258 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17259 you want to include a literal comma in the field.
17260 In other words, if you type a backslash followed by a comma it will
17261 be interpreted as a comma by Alpine, instead of as a separator between
17262 pattern values.
17263 All other backslashes are literal backslashes and should not be escaped.
17264 <P>
17265 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17266 for more information on Patterns.
17267 <P>
17268 Look <A HREF="h_edit_nav_cmds">here</A>
17269 to see the available Editing and Navigation commands.
17270 <P>
17271 &lt;End of help on this topic&gt;
17272 </BODY>
17273 </HTML>
17274 ======= h_config_role_topat =======
17275 <HTML>
17276 <HEAD>
17277 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
17278 </HEAD>
17279 <BODY>
17280 <H1>&quot;To:&quot; Pattern Explained</H1>
17281
17282 Any text you enter as the &quot;To pattern&quot;
17283 will be compared to the recipients from the To: line of
17284 the message being replied to or forwarded.
17285 (Any other non-blank parts of the Pattern must match, too.)
17286 In the case of the Compose command, this pattern and the other header
17287 patterns are ignored.
17288 <P>
17289
17290 You may enter a complete email address, part of an address, or a
17291 list of addresses or partial addresses.
17292 For example:
17293 <P>
17294
17295 <PRE>
17296  To pattern = friend@public.com
17297  To pattern = rated.net
17298  To pattern = xxx@adults.com
17299               admin@msn.com
17300               fool@motleyfool.com
17301 </PRE>
17302
17303 <P>
17304 Each of those are valid To patterns.
17305 <P>
17306
17307 Messages match those patterns if any of the
17308 addresses in the To: line of the message contains the pattern.
17309 If the pattern is a list of patterns
17310 (like the last example above) then it is a match if any of the patterns in
17311 the list match any of the addresses in the To: line.
17312 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
17313 present for a match.
17314 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
17315 address2 must be present.
17316 That is exactly what using a list does.)
17317 <P>
17318
17319 Some messages may be &quot;bounced&quot; to you, and will
17320 have a &quot;Resent-To:&quot; header line.
17321 If the message contains a Resent-To: line
17322 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
17323 Alpine will look for
17324 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
17325 the original To: line.
17326 <P>
17327
17328 When entering a pattern, you may choose an address from your address book
17329 with the &quot;T&quot; command.
17330 <P>
17331
17332 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
17333 &quot;!&quot; &quot;toggle NOT&quot; command.
17334 This changes the meaning of the To pattern so that it has the opposite meaning.
17335 It will be considered a match if there are no matches between the
17336 addresses in the To: line and the list of To patterns.
17337 <P>
17338 Don't make the mistake of putting the &quot;!&quot; in the data field for
17339 the pattern.
17340 For example, if you type the characters &quot;!frizzle&quot; into the To
17341 pattern, the pattern will look like:
17342 <P>
17343 <PRE>
17344  To pattern = !frizzle
17345 </PRE>
17346 <P>
17347 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17348 In order to match messages that do not have &quot;frizzle&quot; in
17349 their To field, first type the characters &quot;frizzle&quot; followed
17350 by carriage return for the value of the To pattern, then negate it
17351 by typing the &quot;!&quot; command.
17352 It should end up looking like
17353 <P>
17354 <PRE>
17355  ! To pattern = frizzle
17356 </PRE>
17357 <P>
17358
17359 You are not limited to using the six standard header patterns that are
17360 normally shown (To, From, Sender, Cc, News, and Subject).
17361 You may add any other header to a Pattern by
17362 using the &quot;eXtraHdr&quot; command to specify a different
17363 message header line; and then the Add or Change command to fill in
17364 a pattern for the new header line, just like you would for a standard header.
17365 <P>
17366 A technicality: Since comma is the character used to separate multiple
17367 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17368 you want to include a literal comma in the field.
17369 In other words, if you type a backslash followed by a comma it will
17370 be interpreted as a comma by Alpine, instead of as a separator between
17371 pattern values.
17372 All other backslashes are literal backslashes and should not be escaped.
17373 <P>
17374 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17375 for more information on Patterns.
17376 <P>
17377 Look <A HREF="h_edit_nav_cmds">here</A>
17378 to see the available Editing and Navigation commands.
17379 <P>
17380 &lt;End of help on this topic&gt;
17381 </BODY>
17382 </HTML>
17383 ======= h_config_role_frompat =======
17384 <HTML>
17385 <HEAD>
17386 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
17387 </HEAD>
17388 <BODY>
17389 <H1>&quot;From:&quot; Pattern Explained</H1>
17390
17391 This is just like the &quot;To pattern&quot; except that it is compared with
17392 the address in the From: line of the message
17393 instead of the addresses from the To: line.
17394 See the help for the To pattern for more information on header patterns.
17395 <P>
17396 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17397 for more information on Patterns.
17398 <P>
17399 Look <A HREF="h_edit_nav_cmds">here</A>
17400 to see the available Editing and Navigation commands.
17401 <P>
17402 &lt;End of help on this topic&gt;
17403 </BODY>
17404 </HTML>
17405 ======= h_config_role_senderpat =======
17406 <HTML>
17407 <HEAD>
17408 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
17409 </HEAD>
17410 <BODY>
17411 <H1>&quot;Sender:&quot; Pattern Explained</H1>
17412
17413 This is just like the &quot;To pattern&quot; except that it is compared with
17414 the address from the Sender: line of the message
17415 instead of the addresses from the To: line.
17416 See the help for the To pattern for more information on header patterns.
17417 <P>
17418 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17419 for more information on Patterns.
17420 <P>
17421 Look <A HREF="h_edit_nav_cmds">here</A>
17422 to see the available Editing and Navigation commands.
17423 <P>
17424 &lt;End of help on this topic&gt;
17425 </BODY>
17426 </HTML>
17427 ======= h_config_role_ccpat =======
17428 <HTML>
17429 <HEAD>
17430 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
17431 </HEAD>
17432 <BODY>
17433 <H1>&quot;Cc:&quot; Pattern Explained</H1>
17434
17435 This is just like the &quot;To pattern&quot; except that it is compared with
17436 the addresses from the Cc: line of the message
17437 instead of the addresses from the To: line.
17438 See the help for the To pattern for more information on header patterns.
17439 <P>
17440 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17441 for more information on Patterns.
17442 <P>
17443 Look <A HREF="h_edit_nav_cmds">here</A>
17444 to see the available Editing and Navigation commands.
17445 <P>
17446 &lt;End of help on this topic&gt;
17447 </BODY>
17448 </HTML>
17449 ======= h_config_role_recippat =======
17450 <HTML>
17451 <HEAD>
17452 <TITLE>Recipient Pattern Explained</TITLE>
17453 </HEAD>
17454 <BODY>
17455 <H1>Recipient Pattern Explained</H1>
17456
17457 This is just like the &quot;To pattern&quot; except that it is compared with
17458 the addresses from both the To: line and the Cc: line of the
17459 message instead of just the addresses from the To: line.
17460 In other words, it is considered a match if the pattern matches
17461 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
17462 in the Cc: line.
17463 (Notice that defining the Recipient pattern does not have the same
17464 effect as defining both the To and Cc patterns.
17465 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
17466 It is equivalent to having two different rules;
17467 one with a To pattern and the other with the same Cc pattern.)
17468 <P>
17469 A technicality: Since comma is the character used to separate multiple
17470 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17471 you want to include a literal comma in the field.
17472 In other words, if you type a backslash followed by a comma it will
17473 be interpreted as a comma by Alpine, instead of as a separator between
17474 pattern values.
17475 All other backslashes are literal backslashes and should not be escaped.
17476 <P>
17477 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17478 for more information on Patterns.
17479 <P>
17480 Look <A HREF="h_edit_nav_cmds">here</A>
17481 to see the available Editing and Navigation commands.
17482 <P>
17483 &lt;End of help on this topic&gt;
17484 </BODY>
17485 </HTML>
17486 ======= h_config_role_particpat =======
17487 <HTML>
17488 <HEAD>
17489 <TITLE>Participant Pattern Explained</TITLE>
17490 </HEAD>
17491 <BODY>
17492 <H1>Participant Pattern Explained</H1>
17493
17494 This is just like the &quot;To pattern&quot; except that it is compared with
17495 the addresses from the From: line, the To: line, and the Cc: line of the
17496 message instead of just the addresses from the To: line.
17497 In other words, it is considered a match if the pattern matches
17498 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
17499 in the To: line, <EM>OR</EM> an address in the Cc: line.
17500 (Notice that defining the Participant pattern does not have the same
17501 effect as defining all of the From, To, and Cc patterns.
17502 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
17503 From <EM>AND</EM> To <EM>AND</EM> Cc.
17504 It is equivalent to having three different rules;
17505 one with a From pattern, another with the same To pattern, and a third with
17506 the same Cc pattern.)
17507 <P>
17508 A technicality: Since comma is the character used to separate multiple
17509 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17510 you want to include a literal comma in the field.
17511 In other words, if you type a backslash followed by a comma it will
17512 be interpreted as a comma by Alpine, instead of as a separator between
17513 pattern values.
17514 All other backslashes are literal backslashes and should not be escaped.
17515 <P>
17516 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17517 for more information on Patterns.
17518 <P>
17519 Look <A HREF="h_edit_nav_cmds">here</A>
17520 to see the available Editing and Navigation commands.
17521 <P>
17522 &lt;End of help on this topic&gt;
17523 </BODY>
17524 </HTML>
17525 ======= h_config_role_newspat =======
17526 <HTML>
17527 <HEAD>
17528 <TITLE>News Pattern Explained</TITLE>
17529 </HEAD>
17530 <BODY>
17531 <H1>News Pattern Explained</H1>
17532
17533 If this pattern is non-blank, then for this rule to be considered a
17534 match, at least one of the newsgroups from
17535 the Newsgroups line of the message must match this pattern.
17536 If this pattern is a list of patterns, then at least one of the
17537 newsgroups must match at least one of the patterns.
17538 (Any other non-blank parts of the Pattern must match, too.)
17539 <P>
17540 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
17541 &quot;!&quot; &quot;toggle NOT&quot; command.
17542 This changes the meaning of the News pattern so that it has the opposite meaning.
17543 It will be considered a match if there are no matches between the
17544 addresses in the Newsgroups: line and the list of News patterns.
17545 <P>
17546 Don't make the mistake of putting the &quot;!&quot; in the data field for
17547 the pattern.
17548 For example, if you type the characters &quot;!frizzle&quot; into the News
17549 pattern, the pattern will look like:
17550 <P>
17551 <PRE>
17552  News pattern = !frizzle
17553 </PRE>
17554 <P>
17555 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17556 In order to match messages that do not have &quot;frizzle&quot; in
17557 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
17558 by carriage return for the value of the News pattern, then negate it
17559 by typing the &quot;!&quot; command.
17560 It should end up looking like
17561 <P>
17562 <PRE>
17563  ! News pattern = frizzle
17564 </PRE>
17565 <P>
17566 A technicality: Since comma is the character used to separate multiple
17567 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17568 you want to include a literal comma in the field.
17569 In other words, if you type a backslash followed by a comma it will
17570 be interpreted as a comma by Alpine, instead of as a separator between
17571 pattern values.
17572 All other backslashes are literal backslashes and should not be escaped.
17573 <P>
17574
17575 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17576 for more information on Patterns.
17577 <P>
17578 Look <A HREF="h_edit_nav_cmds">here</A>
17579 to see the available Editing and Navigation commands.
17580 <P>
17581 &lt;End of help on this topic&gt;
17582 </BODY>
17583 </HTML>
17584 ======= h_config_role_subjpat =======
17585 <HTML>
17586 <HEAD>
17587 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
17588 </HEAD>
17589 <BODY>
17590 <H1>&quot;Subject:&quot; Pattern Explained</H1>
17591
17592 This is similar to the other parts of the Pattern.
17593 It is compared with
17594 the contents from the Subject of the message.
17595 <P>
17596 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17597 for more information on Patterns.
17598 <P>
17599 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
17600 &quot;!&quot; &quot;toggle NOT&quot; command.
17601 This changes the meaning of the Subject pattern so that it has the opposite meaning.
17602 It will be considered a match if there are no matches between the
17603 text in the Subject: line and the list of Subject patterns.
17604 <P>
17605
17606 If you wish to have a header pattern that is not one of the six standard
17607 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
17608 <P>
17609 A technicality: Since comma is the character used to separate multiple
17610 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17611 you want to include a literal comma in the field.
17612 In other words, if you type a backslash followed by a comma it will
17613 be interpreted as a comma by Alpine, instead of as a separator between
17614 pattern values.
17615 All other backslashes are literal backslashes and should not be escaped.
17616 <P>
17617 Look <A HREF="h_edit_nav_cmds">here</A>
17618 to see the available Editing and Navigation commands.
17619 <P>
17620 &lt;End of help on this topic&gt;
17621 </BODY>
17622 </HTML>
17623 ======= h_config_role_alltextpat =======
17624 <HTML>
17625 <HEAD>
17626 <TITLE>AllText Pattern Explained</TITLE>
17627 </HEAD>
17628 <BODY>
17629 <H1>AllText Pattern Explained</H1>
17630
17631 This is similar to the header patterns.
17632 Instead of comparing with text in a particular header field it
17633 is compared with all of the text in the message header and body.
17634 <P>
17635 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
17636 &quot;!&quot; &quot;toggle NOT&quot; command.
17637 This changes the meaning of the AllText pattern so that it has the opposite meaning.
17638 It will be considered a match if there are no matches between the
17639 text of the message and the list of AllText patterns.
17640 <P>
17641 Don't make the mistake of putting the &quot;!&quot; in the data field for
17642 the pattern.
17643 For example, if you type the characters &quot;!frizzle&quot; into the AllText
17644 pattern, the pattern will look like:
17645 <P>
17646 <PRE>
17647  AllText pattern = !frizzle
17648 </PRE>
17649 <P>
17650 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17651 In order to match messages that do not have &quot;frizzle&quot; in
17652 the text of the message, first type the characters &quot;frizzle&quot; followed
17653 by carriage return for the value of the AllText pattern, then negate it
17654 by typing the &quot;!&quot; command.
17655 It should end up looking like
17656 <P>
17657 <PRE>
17658  ! AllText pattern = frizzle
17659 </PRE>
17660 <P>
17661 It is possible that you may notice degraded performance when using
17662 AllText Patterns.
17663 <P>
17664 A technicality: Since comma is the character used to separate multiple
17665 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17666 you want to include a literal comma in the field.
17667 In other words, if you type a backslash followed by a comma it will
17668 be interpreted as a comma by Alpine, instead of as a separator between
17669 pattern values.
17670 All other backslashes are literal backslashes and should not be escaped.
17671 <P>
17672 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17673 for more information on Patterns.
17674 <P>
17675 Look <A HREF="h_edit_nav_cmds">here</A>
17676 to see the available Editing and Navigation commands.
17677 <P>
17678 &lt;End of help on this topic&gt;
17679 </BODY>
17680 </HTML>
17681 ======= h_config_role_bodytextpat =======
17682 <HTML>
17683 <HEAD>
17684 <TITLE>BodyText Pattern Explained</TITLE>
17685 </HEAD>
17686 <BODY>
17687 <H1>BodyText Pattern Explained</H1>
17688
17689 This is similar to the header patterns.
17690 Instead of comparing with text in a particular header field it
17691 is compared with all of the text in the message body.
17692 <P>
17693 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
17694 &quot;!&quot; &quot;toggle NOT&quot; command.
17695 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
17696 It will be considered a match if there are no matches between the
17697 text of the body of the message and the list of BodyText patterns.
17698 <P>
17699 Don't make the mistake of putting the &quot;!&quot; in the data field for
17700 the pattern.
17701 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
17702 pattern, the pattern will look like:
17703 <P>
17704 <PRE>
17705  BdyText pattern = !frizzle
17706 </PRE>
17707 <P>
17708 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17709 In order to match messages that do not have &quot;frizzle&quot; in
17710 their BodyText, first type the characters &quot;frizzle&quot; followed
17711 by carriage return for the value of the BodyText pattern, then negate it
17712 by typing the &quot;!&quot; command.
17713 It should end up looking like
17714 <P>
17715 <PRE>
17716  ! BodyText pattern = frizzle
17717 </PRE>
17718 <P>
17719 It is possible that you may notice degraded performance when using
17720 BodyText Patterns.
17721 <P>
17722 A technicality: Since comma is the character used to separate multiple
17723 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17724 you want to include a literal comma in the field.
17725 In other words, if you type a backslash followed by a comma it will
17726 be interpreted as a comma by Alpine, instead of as a separator between
17727 pattern values.
17728 All other backslashes are literal backslashes and should not be escaped.
17729 <P>
17730 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17731 for more information on Patterns.
17732 <P>
17733 Look <A HREF="h_edit_nav_cmds">here</A>
17734 to see the available Editing and Navigation commands.
17735 <P>
17736 &lt;End of help on this topic&gt;
17737 </BODY>
17738 </HTML>
17739 ======= h_config_role_charsetpat =======
17740 <HTML>
17741 <HEAD>
17742 <TITLE>Character Set Pattern Explained</TITLE>
17743 </HEAD>
17744 <BODY>
17745 <H1>Character Set Pattern Explained</H1>
17746
17747 A message may use one or more character sets.
17748 This part of the Pattern matches messages that make use of
17749 certain specified character sets.
17750 It will be considered a match if a message uses any of the character
17751 sets in the list you give here.
17752
17753 <P>
17754 When filling in a value for this field, you may use
17755 the &quot;T&quot; command, which presents you with a large list of
17756 possible character sets to choose from.
17757 You may also just type in the name of a character set, and it need not
17758 be one that Alpine knows about.
17759
17760 <P>
17761 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
17762 GB2312) you may also use some shorthand names that Alpine provides.
17763 These names are more understandable shorthand names for sets of
17764 character set names.
17765 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
17766 Selecting one of these shorthand names is equivalent to selecting all of
17767 the character sets that make up the set.
17768 You can see all of these shorthand names and the lists of character sets
17769 they stand for by typing the &quot;T&quot; command.
17770
17771 <P>
17772 For the purposes of this Pattern,
17773 Alpine will search through a message for all of the text parts and
17774 collect the character sets declared for each part.
17775 It will also look in the Subject line for a character set used there.
17776 Alpine does not actually look at the text of the message or the text
17777 of the Subject to determine if a declared character set is actually
17778 used, it looks only at the declarations themselves in the MIME part headers
17779 and in the Subject.
17780
17781 <P>
17782 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
17783 &quot;!&quot; &quot;toggle NOT&quot; command.
17784 This changes the meaning of the Character Set pattern so that
17785 it has the opposite meaning.
17786 It will be considered a match if none of the character sets in the
17787 list are used in a message.
17788 <P>
17789 Don't make the mistake of putting the &quot;!&quot; in the data field for
17790 the pattern.
17791 For example, if you type the characters &quot;!GB2312&quot; into the
17792 Character Set pattern, the pattern will look like:
17793 <P>
17794 <PRE>
17795  Charset pattern = !GB2312
17796 </PRE>
17797 <P>
17798 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
17799 In order to match messages that do not have the
17800 character set &quot;GB2312&quot;
17801 set, first type the characters &quot;GB2312&quot; followed
17802 by carriage return for the value of the Character Set pattern, then negate it
17803 by typing the &quot;!&quot; command.
17804 It should end up looking like
17805 <P>
17806 <PRE>
17807  ! Charset pattern = GB2312
17808 </PRE>
17809 <P>
17810 A technicality: Since comma is the character used to separate multiple
17811 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17812 you want to include a literal comma in the field.
17813 In other words, if you type a backslash followed by a comma it will
17814 be interpreted as a comma by Alpine, instead of as a separator between
17815 pattern values.
17816 All other backslashes are literal backslashes and should not be escaped.
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_role_keywordpat =======
17828 <HTML>
17829 <HEAD>
17830 <TITLE>Keyword Pattern Explained</TITLE>
17831 </HEAD>
17832 <BODY>
17833 <H1>Keyword Pattern Explained</H1>
17834
17835 A folder may have user-defined keywords.
17836 These are similar to the Important flag, which the user may set using the
17837 Flag command.
17838 The difference is that the Important flag is always present for each folder.
17839 User-defined keywords are picked by the user.
17840 You may add new keywords by defining them in the
17841 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
17842 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
17843 the Flag command may be used to set or clear the keyword on individual messages.
17844 If you have given a keyword a nickname when configuring it,
17845 that nickname may be used instead of the actual keyword.
17846
17847 <P>
17848 When filling in a value for this field, it may be easiest to use
17849 the &quot;T&quot; command, which presents you with a list of the keywords
17850 you have defined to choose from.
17851
17852 <P>
17853 This part of the Pattern matches messages with certain keywords set.
17854 It will be considered a match if a message has any of the keywords in the
17855 list set.
17856 A keyword that you have not defined using the
17857 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17858 will not be a match.
17859
17860 <P>
17861 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
17862 &quot;!&quot; &quot;toggle NOT&quot; command.
17863 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
17864 It will be considered a match if none of the keywords in the list are set
17865 for a message.
17866 A keyword that you have not defined using the
17867 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17868 will not be a match, so a <EM>NOT</EM> of that keyword does match.
17869 <P>
17870 Don't make the mistake of putting the &quot;!&quot; in the data field for
17871 the pattern.
17872 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
17873 pattern, the pattern will look like:
17874 <P>
17875 <PRE>
17876  Keyword pattern = !frizzle
17877 </PRE>
17878 <P>
17879 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17880 In order to match messages that do not have the keyword &quot;frizzle&quot;
17881 set, first type the characters &quot;frizzle&quot; followed
17882 by carriage return for the value of the Keyword pattern, then negate it
17883 by typing the &quot;!&quot; command.
17884 It should end up looking like
17885 <P>
17886 <PRE>
17887  ! Keyword pattern = frizzle
17888 </PRE>
17889 <P>
17890 A technicality: Since comma is the character used to separate multiple
17891 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17892 you want to include a literal comma in the field.
17893 In other words, if you type a backslash followed by a comma it will
17894 be interpreted as a comma by Alpine, instead of as a separator between
17895 pattern values.
17896 All other backslashes are literal backslashes and should not be escaped.
17897 <P>
17898 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17899 for more information on Patterns.
17900 <P>
17901 Look <A HREF="h_edit_nav_cmds">here</A>
17902 to see the available Editing and Navigation commands.
17903 <P>
17904 &lt;End of help on this topic&gt;
17905 </BODY>
17906 </HTML>
17907 ======= h_config_role_arbpat =======
17908 <HTML>
17909 <HEAD>
17910 <TITLE>Extra Header Patterns Explained</TITLE>
17911 </HEAD>
17912 <BODY>
17913 <H1>Extra Header Patterns Explained</H1>
17914
17915 The header patterns that come after the Participant pattern but before the
17916 AllText pattern are extra header patterns that you have added to a rule's
17917 Pattern. These are just like the other header patterns except that
17918 the contents of the particular header listed on the left hand side will
17919 be used for comparisons.
17920 <P>
17921 The &quot;eXtraHdr&quot; command may be used to add more of these
17922 header patterns to the rule you are editing.
17923 <P>
17924 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
17925 extra header pattern from the rule you are editing.
17926 <P>
17927 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
17928 &quot;!&quot; &quot;toggle NOT&quot; command.
17929 This changes the meaning of the pattern so that it has the opposite meaning.
17930 It will be considered a match if there are no matches between the
17931 text in the header line and the list of patterns.
17932 <P>
17933 Don't make the mistake of putting the &quot;!&quot; in the data field for
17934 the pattern.
17935 For example, if you type the characters &quot;!frizzle&quot; into the
17936 pattern, the pattern will look like:
17937 <P>
17938 <PRE>
17939  Xyz pattern = !frizzle
17940 </PRE>
17941 <P>
17942 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17943 In order to match messages that do not have &quot;frizzle&quot; in
17944 their Xyz field, first type the characters &quot;frizzle&quot; followed
17945 by carriage return for the value of the pattern, then negate it
17946 by typing the &quot;!&quot; command.
17947 It should end up looking like
17948 <P>
17949 <PRE>
17950  ! Xyz pattern = frizzle
17951 </PRE>
17952
17953 <P>
17954 A technicality: Since comma is the character used to separate multiple
17955 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17956 you want to include a literal comma in the field.
17957 In other words, if you type a backslash followed by a comma it will
17958 be interpreted as a comma by Alpine, instead of as a separator between
17959 pattern values.
17960 All other backslashes are literal backslashes and should not be escaped.
17961 <P>
17962 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17963 for more information on Patterns.
17964 <P>
17965 Look <A HREF="h_edit_nav_cmds">here</A>
17966 to see the available Editing and Navigation commands.
17967 <P>
17968 &lt;End of help on this topic&gt;
17969 </BODY>
17970 </HTML>
17971 ======= h_config_role_cat_cmd =======
17972 <HTML>
17973 <HEAD>
17974 <TITLE>Categorizer Command Explained</TITLE>
17975 </HEAD>
17976 <BODY>
17977 <H1>Categorizer Command Explained</H1>
17978
17979 This is a command that is run with its standard input set to the message
17980 being checked and its standard output discarded.
17981 The full directory path should be specified.
17982 The command will be run and then its exit status will be checked against
17983 the Exit Status Interval, which defaults to just the value zero.
17984 If the exit status of the command falls in the interval, it is considered
17985 a match, otherwise it is not a match.
17986 <P>
17987
17988 This option may actually be a list of commands.
17989 The first one that exists and is executable is used.
17990 That makes it possible to use the same configuration with Unix Alpine and
17991 PC-Alpine.
17992 <P>
17993
17994 If none of the commands in the list exists and is executable then the rule
17995 is <EM>not</EM> a match.
17996 If it is possible that the command may not exist, you should be careful
17997 to structure your rules so that nothing destructive
17998 happens when the command does not exist.
17999 For example, you might have a filter that filters away spam when there is
18000 a match but does nothing when there is not a match.
18001 That would cause no harm if the command didn't exist.
18002 However, if you have a filter that filters away spam when there is not
18003 a match and keeps it when there is a match, that would filter everything
18004 if the categorizer command didn't exist.
18005 <P>
18006 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
18007 setup for the bogofilter filter.
18008
18009 <P>
18010 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18011 for more information on Patterns.
18012 <P>
18013 Look <A HREF="h_edit_nav_cmds">here</A>
18014 to see the available Editing and Navigation commands.
18015 <P>
18016 &lt;End of help on this topic&gt;
18017 </BODY>
18018 </HTML>
18019 ======= h_config_role_cat_cmd_example =======
18020 <HTML>
18021 <HEAD>
18022 <TITLE>Categorizer Command Example</TITLE>
18023 </HEAD>
18024 <BODY>
18025 <H1>Categorizer Command Example</H1>
18026
18027 Bogofilter
18028 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
18029 is a mail filter that attempts to classify mail as spam or
18030 non-spam using statistical analysis of the message content.
18031 When run with no arguments and a message as standard input, it exits with
18032 exit status 0 if it thinks a message is spam and 1 if it thinks
18033 it is not spam.
18034 To use bogofilter as your Categorizer Command you would simply set Command to
18035 the pathname of the bogofilter program.
18036 For example,
18037 <P>
18038 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
18039 <P>
18040 Exit status of zero is what you are interested in, so you'd set the
18041 Exit Status Interval to
18042 <P>
18043 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
18044 <P>
18045
18046 In order to prevent downloading an entire huge message to check for spam, you
18047 might want to set the Character Limit to a few thousand characters (the
18048 assumption being that the spam will reveal itself in those characters)
18049 <P>
18050 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
18051 <P>
18052
18053 You would probably use bogofilter in an Alpine Filter Rule, and have the action
18054 be to move the message to a spam folder.
18055 It would usually be wise to also check the &quot;Message is Recent&quot;
18056 part of the rule so that messages are only checked when they first arrive,
18057 and to restrict the Current Folder Type to just your INBOX.
18058 The reason for checking only Recent messages is to save the time it takes
18059 to run bogofilter on each message.
18060 As an experiment, you might start out by using this in an Indexcolor Rule
18061 instead of a Filter Rule.
18062 In that case, you probably wouldn't check the Recent checkbox.
18063 <P>
18064 The use described above assumes that you are somehow maintaining bogofilter's
18065 database of words associated with spam and non-spam messages.
18066 One way to start your database would be to select a bunch of spam messages
18067 in Alpine (you might Save spam messages to a special folder or use Alpine's
18068 Select command to select several) and then Apply
18069 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
18070 a pipe command to the spam messages.
18071 For example, you could have a shell script or an alias
18072 called <EM>this_is_spam</EM>, which would simply be the command
18073 <P>
18074 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
18075 <P>
18076
18077 It is probably best to use the pipe command's Raw Text, With Delimiter,
18078 and Free Output options,
18079 which are at the bottom of the screen when you type the pipe command.
18080 That's because bogofilter expects the raw message as input, and uses
18081 the Delimiters to tell when a new message starts.
18082 You would not need to use a separate pipe for each message, because
18083 bogofilter can handle multiple messages at once.
18084 <P>
18085 Similarly, you would select a group of non-spam messages
18086 and run them through a <EM>this_is_nonspam</EM> script
18087 that was something like
18088 <P>
18089 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
18090 <P>
18091
18092 For the more adventurous, the next step might be to automate the upkeep of
18093 the bogofilter database.
18094 It might make more sense to have bogofilter be part of the delivery process,
18095 but it is also possible to do it entirely from within Alpine.
18096 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
18097 the &quot;-u&quot; argument will cause bogofilter to update the database.
18098 <P>
18099 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
18100 <P>
18101 You'd want a couple more aliases or shell scripts called something like
18102 <EM>change_to_spam</EM>
18103 <P>
18104 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
18105 <P>
18106 and
18107 <EM>change_to_nonspam</EM>
18108 <P>
18109 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
18110 <P>
18111 When you run across a message in your INBOX that should have been
18112 classified as spam you would pipe it to the change_to_spam script, and
18113 when you run across a message in your spam folder that should have been
18114 left in your INBOX you would pipe it through change_to_nonspam.
18115
18116 <P>
18117 There is a technical problem with this approach.
18118 Alpine may check your filters more than once.
18119 In particular, every time you start Alpine the filters will be checked for
18120 each message.
18121 Also, if you have any filters that depend on message state (New, Deleted, etc.)
18122 then Alpine will recheck for matches in messages that have changed state
18123 at the time you close the folder and before expunging.
18124 This is usually ok.
18125 However, in this case it is a problem because the command
18126 <P>
18127 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
18128 <P>
18129 has the side effect of updating the database.
18130 So you run the risk of updating the database multiple times for a single
18131 message instead of updating it just once per message.
18132 There are some ways to work around this problem.
18133 What you need is a way to mark the message after you have run the filter.
18134 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
18135 Besides having the filter move the message to a spam folder, also have it
18136 set the Bogo keyword.
18137 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
18138 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
18139 This rule can only set the Bogo keyword for the messages that it matches.
18140 You will also need to add a second rule right after this one that
18141 matches all the messages that don't have the Bogo keyword set
18142 (put the keyword in the Keyword pattern and toggle
18143 the Not with the ! command)
18144 and takes the action of setting it.
18145 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
18146 (and so it won't re-run the bogofilter command) if the keyword is already
18147 set.
18148 <P>
18149 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
18150 on all messages that don't have the Bogo keyword set.
18151 This will have the side effect of inserting that message in the bogofilter
18152 database, match or not.
18153 If this rule matches (it is spam), the Bogo keyword will be set and
18154 the message will be moved to a spam folder.
18155 If it does not match, the
18156 following rule will mark the message by turning on the keyword.
18157 This second rule should be a non-terminating
18158 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
18159 rule so that it doesn't stop the filtering process before the rest of
18160 your rules are consulted.
18161
18162 <P>
18163 In summary, the first rule is something like
18164 <PRE>
18165   Nickname          = bogofilter -u rule
18166   Current Folder Type =
18167                (*) Specific
18168                    Folder = INBOX
18169
18170   ! Keyword pattern = Bogo
18171
18172   External Categorizer Commands =
18173        Command              = /usr/local/bin/bogofilter -u
18174        Exit Status Interval = (0,0)
18175        Character Limit      = <No Value Set: using "-1">  (optionally set this)
18176
18177   Filter Action =
18178        (*) Move
18179            Folder = spam
18180
18181   Set These Keywords   = Bogo
18182 </PRE>
18183 <P>
18184 and the following rule is
18185 <PRE>
18186   Nickname          = Set Bogo Keyword
18187   Current Folder Type =
18188                (*) Specific
18189                    Folder = INBOX
18190
18191   ! Keyword pattern = Bogo
18192
18193   Filter Action =
18194        (*) Just Set Message Status
18195
18196   Set These Keywords   = Bogo
18197
18198   Features =
18199       [X]  dont-stop-even-if-rule-matches
18200 </PRE>
18201 <P>
18202 If it is possible for you to insert bogofilter in the delivery process instead
18203 of having it called from Alpine you could prevent having to wait
18204 for the bogofilter processing while you read your mail.
18205 You would have bogofilter add a header to the message at the time of delivery
18206 that identified it as spam or nonspam.
18207 With this method, you could avoid using a Categorizer Command while running Alpine,
18208 and just match on the header instead.
18209 You might still want to use the scripts mentioned above to initialize the
18210 database or to re-classify wrongly classified messages.
18211
18212 <P>
18213 Finally, it isn't for the faint-hearted,
18214 but it is also possible to run bogofilter from PC-Alpine.
18215 You can install Cygwin from
18216 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
18217 then compile bogofilter in the cygwin environment, and run it from
18218 within PC-Alpine.
18219 You would end up with a Categorizer command that looked something like
18220 <P>
18221 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
18222 <P>
18223 Note that the &quot;.exe&quot; extension is explicit,
18224 and that the bogofilter.exe executable should be in the same directory
18225 as cygwin1.dll.
18226
18227 <P>
18228 &lt;End of help on this topic&gt;
18229 </BODY>
18230 </HTML>
18231 ======= h_config_role_cat_status =======
18232 <HTML>
18233 <HEAD>
18234 <TITLE>Exit Status Interval Explained</TITLE>
18235 </HEAD>
18236 <BODY>
18237 <H1>Exit Status Interval Explained</H1>
18238
18239 The categorizer command is run and the result is the exit status of
18240 that command.
18241 If that exit status falls in the Exit Status Interval
18242 then it is considered a match, otherwise it is not a match.
18243 Of course for the entire rule to match, it must also be checked against
18244 the other defined parts of the Pattern.
18245 <P>
18246 The Exit Status Interval defaults to the single value 0 (zero).
18247 If you define it, it should be set to something like:
18248 <P>
18249 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
18250 <P>
18251 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
18252 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
18253 positive and negative integers.
18254 <P>
18255 Actually, a list of intervals may be used if you wish.
18256 A list would look like
18257 <P>
18258 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
18259 <P>
18260 When there is an Exit Status Interval defined, it is a match if the exit status
18261 of the categorizer command is contained in any of the intervals.
18262 The intervals include both endpoints.
18263 <P>
18264 The default interval is
18265 <P>
18266 <CENTER><SAMP>(0,0)</SAMP></CENTER>
18267 <P>
18268 and it matches only if the command exits with exit status equal to zero.
18269
18270 <P>
18271 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18272 for more information on Patterns.
18273 <P>
18274 Look <A HREF="h_edit_nav_cmds">here</A>
18275 to see the available Editing and Navigation commands.
18276 <P>
18277 &lt;End of help on this topic&gt;
18278 </BODY>
18279 </HTML>
18280 ======= h_config_role_cat_limit =======
18281 <HTML>
18282 <HEAD>
18283 <TITLE>Character Limit Explained</TITLE>
18284 </HEAD>
18285 <BODY>
18286 <H1>Character Limit Explained</H1>
18287
18288 Setting this option makes it possible to limit how much of the message
18289 is made available to the categorizer command as input.
18290 The default value (-1) means that the entire message is fed to the
18291 command.
18292 A value of 0 (zero) means that only the headers of the message are
18293 made available.
18294 A positive integer means that the headers plus that many characters from
18295 the body of the message are passed to the categorizer.
18296
18297 <P>
18298 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18299 for more information on Patterns.
18300 <P>
18301 Look <A HREF="h_edit_nav_cmds">here</A>
18302 to see the available Editing and Navigation commands.
18303 <P>
18304 &lt;End of help on this topic&gt;
18305 </BODY>
18306 </HTML>
18307 ======= h_config_role_age =======
18308 <HTML>
18309 <HEAD>
18310 <TITLE>Age Interval Explained</TITLE>
18311 </HEAD>
18312 <BODY>
18313 <H1>Age Interval Explained</H1>
18314
18315 The Age Interval, if defined, is part of the Pattern.
18316 If you use this, it should be set to something like:
18317 <P>
18318 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
18319 <P>
18320 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
18321 The special value &quot;INF&quot; may be used for the max value.
18322 It represents infinity.
18323 <P>
18324 In rare cases it may be useful to use the more general form of the value,
18325 which is a comma-separated list of intervals.
18326 It would look something like:
18327 <P>
18328 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
18329 <P>
18330 When there is an Age Interval defined, it is a match if the age, in days, of
18331 the message is contained in the interval.
18332 The interval includes both endpoints.
18333 If the option is set to a list of intervals then it is a match if the
18334 age of the message is contained in any of the intervals.
18335 <P>
18336 Even though this option is called Age, it isn't actually
18337 the <EM>age</EM> of the message.
18338 Instead, it is how many days ago the message arrived in one of your folders.
18339 If the current time is a little past midnight, then a message that arrived
18340 just before midnight arrived yesterday, even though the message is only
18341 a few minutes old.
18342 By default, the date being used is not the date in the Date
18343 header of the message.
18344 It is the date that the message arrived in one of your folders.
18345 When you Save a message from one folder to another that arrival date
18346 is preserved.
18347 If you would like to use the date in the Date header that is possible.
18348 Turn on the option
18349 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
18350 near the bottom of the rule definition.
18351 <P>
18352 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
18353 The age interval
18354 <P>
18355 <CENTER><SAMP>(2,2)</SAMP></CENTER>
18356 <P>
18357 matches all messages that arrived on the day before yesterday.
18358 The interval
18359 <P>
18360 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
18361 <P>
18362 matches all messages that arrived at least 180 days before today.
18363 The interval
18364 <P>
18365 <CENTER><SAMP>(0,1)</SAMP></CENTER>
18366 <P>
18367 matches all messages that arrived today or yesterday.
18368
18369 <P>
18370 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18371 for more information on Patterns.
18372 <P>
18373 Look <A HREF="h_edit_nav_cmds">here</A>
18374 to see the available Editing and Navigation commands.
18375 <P>
18376 &lt;End of help on this topic&gt;
18377 </BODY>
18378 </HTML>
18379 ======= h_config_role_size =======
18380 <HTML>
18381 <HEAD>
18382 <TITLE>Size Interval Explained</TITLE>
18383 </HEAD>
18384 <BODY>
18385 <H1>Size Interval Explained</H1>
18386
18387 The Size Interval, if defined, is part of the Pattern.
18388 If you use this, it should be set to something like:
18389 <P>
18390 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
18391 <P>
18392 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
18393 The special value &quot;INF&quot; may be used for the max value.
18394 It represents infinity.
18395 <P>
18396 In rare cases it may be useful to use the more general form of the value,
18397 which is a comma-separated list of intervals.
18398 It would look something like:
18399 <P>
18400 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
18401 <P>
18402 When there is a Size Interval defined, it is a match if the size of
18403 the message is contained in the interval.
18404 The interval includes both endpoints.
18405 If the option is set to a list of intervals then it is a match if the
18406 size of the message is contained in any of the intervals.
18407 <P>
18408 The size interval
18409 <P>
18410 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
18411 <P>
18412 matches all messages with sizes greater than or equal to 10000, and less
18413 than or equal to 50000.
18414 The interval
18415 <P>
18416 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
18417 <P>
18418 matches all messages with sizes greater than or equal to 100000.
18419
18420 <P>
18421 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18422 for more information on Patterns.
18423 <P>
18424 Look <A HREF="h_edit_nav_cmds">here</A>
18425 to see the available Editing and Navigation commands.
18426 <P>
18427 &lt;End of help on this topic&gt;
18428 </BODY>
18429 </HTML>
18430 ======= h_config_role_scorei =======
18431 <HTML>
18432 <HEAD>
18433 <TITLE>Score Interval Explained</TITLE>
18434 </HEAD>
18435 <BODY>
18436 <H1>Score Interval Explained</H1>
18437
18438 The Score Interval, if defined, is part of the Pattern.
18439 If you use this, it should be set to something like:
18440 <P>
18441 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
18442 <P>
18443 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
18444 -32000 and 32000.
18445 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
18446 the min and max values.
18447 These represent negative and positive infinity.
18448 <P>
18449 Actually, the value may be a list of intervals rather than just a
18450 single interval if that is useful.
18451 The elements of the list are separated by commas like:
18452 <P>
18453 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
18454 <P>
18455 When there is a Score Interval defined, it is a match if the score for
18456 the message is contained in any of the intervals.
18457 The intervals include both endpoints.
18458 The score for a message is calculated by looking at every scoring rule
18459 defined and adding up the Score Values for the rules that match the message.
18460 Scoring rules are created using the
18461 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
18462
18463 <P>
18464 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18465 for more information on Patterns.
18466 <P>
18467 Look <A HREF="h_edit_nav_cmds">here</A>
18468 to see the available Editing and Navigation commands.
18469 <P>
18470 &lt;End of help on this topic&gt;
18471 </BODY>
18472 </HTML>
18473 ======= h_config_role_fldr_type =======
18474 <HTML>
18475 <HEAD>
18476 <TITLE>Current Folder Type Explained</TITLE>
18477 </HEAD>
18478 <BODY>
18479 <H1>Current Folder Type Explained</H1>
18480
18481 The Current Folder Type is part of the role's Pattern.
18482 It refers to the type of the currently open folder, which is the folder
18483 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
18484 In order for a role to be considered a match, the current folder must
18485 be of the type you set here.
18486 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18487 all what you might think.
18488 <P>
18489 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
18490 example, then
18491 that role will only be a match if the current folder is a newsgroup and
18492 the rest of the Pattern matches.
18493 The value &quot;Specific&quot; may be used when you want to limit the match
18494 to a specific folder (not just a specific type of folder), or to a list of
18495 specific folders.
18496 <P>
18497 In order to match a specific folder you Select the &quot;Specific&quot;
18498 button <EM>AND</EM> fill in
18499 the name (or list of names) of
18500 the folder in the &quot;Folder List&quot; field.
18501 If the current folder is any of the folders in the list, that is considered
18502 a match.
18503 The name of each folder in the list may be either &quot;INBOX&quot;,
18504 the technical specification
18505 of the folder (like what appears in your configuration file) or, if the
18506 folder is one of your incoming folders, it may be the nickname you've given
18507 the folder.
18508 Here are a couple samples of specific folder names:
18509 <P>
18510 <CENTER><SAMP>{monet.art.example.com/user=vincent}mail/art-class</SAMP></CENTER>
18511 <P>
18512 <CENTER><SAMP>{news.example.com/nntp/user=peter}#news.comp.mail.pine</SAMP></CENTER>
18513 <P>
18514 Observe that in order for an external folder (IMAP, POP, News) to be a match,
18515 you must also add the /user= option in the definition of the incoming folder.
18516 <P>
18517 The easiest way to fill in the &quot;Folder List&quot; field is to use
18518 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
18519 highlighted, or to use the &quot;Take&quot; command with the configuration
18520 feature
18521 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
18522 turned on.
18523 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18524 Current Folder Type is set to &quot;Specific&quot;, and any value that
18525 &quot;Folder List&quot; has is ignored unless the type
18526 is set to &quot;Specific&quot;.
18527 <P>
18528 When reading a newsgroup, there may be a performance penalty
18529 incurred when collecting the information necessary to check a Pattern.
18530 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18531 <P>
18532 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18533 for more information on Patterns.
18534 <P>
18535 Look <A HREF="h_edit_nav_cmds">here</A>
18536 to see the available Editing and Navigation commands.
18537 <P>
18538 &lt;End of help on this topic&gt;
18539 </BODY>
18540 </HTML>
18541 ======= h_config_filt_rule_type =======
18542 <HTML>
18543 <HEAD>
18544 <TITLE>Filter Action Explained</TITLE>
18545 </HEAD>
18546 <BODY>
18547 <H1>Filter Action Explained</H1>
18548
18549 The Filter Action specifies the action to be taken when the Pattern is a
18550 match.
18551 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
18552 &quot;Just Set Message Status&quot;.
18553 <P>
18554 If it is set to &quot;Delete&quot;, then the message that matches the
18555 Pattern will be deleted from the open folder.
18556 <P>
18557 If it is set to &quot;Move&quot;, then the name of the folder to which
18558 the matching message should be moved is given in the &quot;Folder List&quot; field on the
18559 next line of the screen.
18560 A list of folders separated by commas may be given, in which case the
18561 message will be copied to all of the folders in the list before it is
18562 deleted.
18563 <P>
18564 If it is set to neither of those two values (it is set to the value
18565 labeled &quot;Just Set Message Status&quot;) then the message status
18566 setting will happen
18567 but the message will not be deleted or moved.
18568 <P>
18569 If you are Moving a message you may also set Message Status if you wish.
18570 <P>
18571 The easiest way to fill in the &quot;Folder List&quot; field is to use
18572 the T command that is available when the &quot;Folder List&quot; line is
18573 highlighted.
18574 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18575 Filter Action is set to &quot;Move&quot;, and any value that
18576 &quot;Folder List&quot; has is ignored unless the type
18577 is set to &quot;Move&quot;.
18578 <P>
18579 There are a few tokens that may be used in the names in the Folder List.
18580 They are all related to the date on which the filtering is taking place.
18581 The tokens are words surrounded by underscores.
18582 For example, if you want your filter to move messages to a folder named
18583 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
18584 you could specify the folder as
18585 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
18586 which would result in a file named something like
18587 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
18588 or
18589 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
18590 which would result in a file named something like
18591 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
18592 The available tokens are listed
18593 <A HREF="h_index_tokens">here</A>.
18594 <P>
18595 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18596 for more information on Patterns.
18597 <P>
18598 Look <A HREF="h_edit_nav_cmds">here</A>
18599 to see the available Editing and Navigation commands.
18600 <P>
18601 &lt;End of help on this topic&gt;
18602 </BODY>
18603 </HTML>
18604 ======= h_config_score_fldr_type =======
18605 <HTML>
18606 <HEAD>
18607 <TITLE>Current Folder Type Explained</TITLE>
18608 </HEAD>
18609 <BODY>
18610 <H1>Current Folder Type Explained</H1>
18611
18612 The Current Folder Type is part of the scoring rule's Pattern.
18613 It refers to the type of the folder that
18614 the message being scored is in.
18615 In order for a rule to be considered a match, the current folder must
18616 be of the type you set here.
18617 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18618 all what you might think.
18619 <P>
18620 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18621 example, then
18622 that Pattern will only match if the current folder is a newsgroup and
18623 the rest of the Pattern matches.
18624 The value &quot;Specific&quot; may be used when you want to limit the match
18625 to a specific folder (not just a specific type of folder), or to a list of
18626 specific folders.
18627 <P>
18628 In order to match a specific folder you Select the &quot;Specific&quot;
18629 button <EM>AND</EM> fill in
18630 the name (or list of names) of
18631 the folder in the &quot;Folder List&quot; field.
18632 If the current folder is any of the folders in the list, that is considered
18633 a match.
18634 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18635 of the folder (like what appears in your configuration file) or, if the
18636 folder is one of your incoming folders, it may be the nickname you've given
18637 the folder.
18638 Here are a couple samples of specific folder names:
18639 <P>
18640 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18641 <P>
18642 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18643 <P>
18644 The easiest way to fill in the &quot;Folder List&quot; field is to use
18645 the T command that is available when the &quot;Folder List&quot; line is
18646 highlighted.
18647 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18648 Current Folder Type is set to &quot;Specific&quot;, and any value that
18649 &quot;Folder List&quot; has is ignored unless the type
18650 is set to &quot;Specific&quot;.
18651 <P>
18652 When reading a newsgroup, there may be a performance penalty
18653 incurred when collecting the information necessary to check a Pattern.
18654 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18655 For example, if you have Index Line Coloring rules that have Score Intervals
18656 defined then the scores for all the visible messages will need to be calculated.
18657 If some of your Scoring rules have
18658 a Current Folder Type of
18659 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
18660 screen to draw more slowly when in a newsgroup.
18661 <P>
18662 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18663 for more information on Patterns.
18664 <P>
18665 Look <A HREF="h_edit_nav_cmds">here</A>
18666 to see the available Editing and Navigation commands.
18667 <P>
18668 &lt;End of help on this topic&gt;
18669 </BODY>
18670 </HTML>
18671 ======= h_config_other_fldr_type =======
18672 <HTML>
18673 <HEAD>
18674 <TITLE>Current Folder Type Explained</TITLE>
18675 </HEAD>
18676 <BODY>
18677 <H1>Current Folder Type Explained</H1>
18678
18679 The Current Folder Type is part of the rule's Pattern.
18680 It refers to the type of the folder being viewed.
18681 In order for a rule to be considered a match, the current folder must
18682 be of the type you set here.
18683 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18684 all what you might think.
18685 <P>
18686 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18687 example, then
18688 that Pattern will only match if the current folder is a newsgroup.
18689 The value &quot;Specific&quot; may be used when you want to limit the match
18690 to a specific folder (not just a specific type of folder), or to a list of
18691 specific folders.
18692 <P>
18693 In order to match a specific folder you Select the &quot;Specific&quot;
18694 button <EM>AND</EM> fill in
18695 the name (or list of names) of
18696 the folder in the &quot;Folder List&quot; field.
18697 If the current folder is any of the folders in the list, that is considered
18698 a match.
18699 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18700 of the folder (like what appears in your configuration file) or, if the
18701 folder is one of your incoming folders, it may be the nickname you've given
18702 the folder.
18703 Here are a couple samples of specific folder names:
18704 <P>
18705 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18706 <P>
18707 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18708 <P>
18709 The easiest way to fill in the &quot;Folder List&quot; field is to use
18710 the T command that is available when the &quot;Folder List&quot; line is
18711 highlighted.
18712 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18713 Current Folder Type is set to &quot;Specific&quot;, and any value that
18714 &quot;Folder List&quot; has is ignored unless the type
18715 is set to &quot;Specific&quot;.
18716 <P>
18717 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18718 for more information on Patterns.
18719 <P>
18720 Look <A HREF="h_edit_nav_cmds">here</A>
18721 to see the available Editing and Navigation commands.
18722 <P>
18723 &lt;End of help on this topic&gt;
18724 </BODY>
18725 </HTML>
18726 ======= h_config_incol_fldr_type =======
18727 <HTML>
18728 <HEAD>
18729 <TITLE>Current Folder Type Explained</TITLE>
18730 </HEAD>
18731 <BODY>
18732 <H1>Current Folder Type Explained</H1>
18733
18734 The Current Folder Type is part of the Line Coloring rule's Pattern.
18735 It refers to the type of the folder for which the MESSAGE INDEX is
18736 being viewed.
18737 In order for a rule to be considered a match, the current folder must
18738 be of the type you set here.
18739 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18740 all what you might think.
18741 <P>
18742 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18743 example, then
18744 that Pattern will only match if the current folder is a newsgroup and
18745 the rest of the Pattern matches.
18746 The value &quot;Specific&quot; may be used when you want to limit the match
18747 to a specific folder (not just a specific type of folder), or to a list of
18748 specific folders.
18749 <P>
18750 In order to match a specific folder you Select the &quot;Specific&quot;
18751 button <EM>AND</EM> fill in
18752 the name (or list of names) of
18753 the folder in the &quot;Folder List&quot; field.
18754 If the current folder is any of the folders in the list, that is considered
18755 a match.
18756 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18757 of the folder (like what appears in your configuration file) or, if the
18758 folder is one of your incoming folders, it may be the nickname you've given
18759 the folder.
18760 Here are a couple samples of specific folder names:
18761 <P>
18762 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18763 <P>
18764 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18765 <P>
18766 The easiest way to fill in the &quot;Folder List&quot; field is to use
18767 the T command that is available when the &quot;Folder List&quot; line is
18768 highlighted.
18769 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18770 Current Folder Type is set to &quot;Specific&quot;, and any value that
18771 &quot;Folder List&quot; has is ignored unless the type
18772 is set to &quot;Specific&quot;.
18773 <P>
18774 When reading a newsgroup, there may be a performance penalty
18775 incurred when collecting the information necessary to check a Pattern.
18776 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18777 For example, a rule with a non-Normal Index Line Color
18778 and a Current Folder Type of
18779 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
18780 screen to draw more slowly when in a newsgroup.
18781 <P>
18782 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18783 for more information on Patterns.
18784 <P>
18785 Look <A HREF="h_edit_nav_cmds">here</A>
18786 to see the available Editing and Navigation commands.
18787 <P>
18788 &lt;End of help on this topic&gt;
18789 </BODY>
18790 </HTML>
18791 ======= h_config_filt_fldr_type =======
18792 <HTML>
18793 <HEAD>
18794 <TITLE>Current Folder Type Explained</TITLE>
18795 </HEAD>
18796 <BODY>
18797 <H1>Current Folder Type Explained</H1>
18798
18799 The Current Folder Type is part of the Filtering rule's Pattern.
18800 It refers to the type of the folder for which the filtering is being done.
18801 In order for a rule to be considered a match, the current folder must
18802 be of the type you set here.
18803 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18804 all what you might think.
18805 <P>
18806 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18807 example, then
18808 that Pattern will only match if the current folder is a newsgroup and
18809 the rest of the Pattern matches.
18810 The value &quot;Specific&quot; may be used when you want to limit the match
18811 to a specific folder (not just a specific type of folder), or to a list of
18812 specific folders.
18813 <P>
18814 In order to match a specific folder you Select the &quot;Specific&quot;
18815 button <EM>AND</EM> fill in
18816 the name (or list of names) of
18817 the folder in the &quot;Folder List&quot; field.
18818 If the current folder is any of the folders in the list, that is considered
18819 a match.
18820 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18821 of the folder (like what appears in your configuration file) or, if the
18822 folder is one of your incoming folders, it may be the nickname you've given
18823 the folder.
18824 Here are a couple samples of specific folder names:
18825 <P>
18826 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18827 <P>
18828 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18829 <P>
18830 The easiest way to fill in the &quot;Folder List&quot; field is to use
18831 the T command that is available when the &quot;Folder List&quot; line is
18832 highlighted.
18833 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18834 Current Folder Type is set to &quot;Specific&quot;, and any value that
18835 &quot;Folder List&quot; has is ignored unless the type
18836 is set to &quot;Specific&quot;.
18837 <P>
18838 When reading a newsgroup, there may be a performance penalty
18839 incurred when collecting the information necessary to check a Pattern.
18840 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18841 For example, a rule with a Current Folder Type of either
18842 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
18843 more slowly when opening a newsgroup.
18844 <P>
18845 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18846 for more information on Patterns.
18847 <P>
18848 Look <A HREF="h_edit_nav_cmds">here</A>
18849 to see the available Editing and Navigation commands.
18850 <P>
18851 &lt;End of help on this topic&gt;
18852 </BODY>
18853 </HTML>
18854 ======= h_config_role_stat_imp =======
18855 <HTML>
18856 <HEAD>
18857 <TITLE>Message Important Status Explained</TITLE>
18858 </HEAD>
18859 <BODY>
18860 <H1>Message Important Status Explained</H1>
18861
18862 This part of the Pattern may have one of three possible values.
18863 The default value is &quot;Don't care&quot;, which matches any message.
18864 The other two values are &quot;Yes&quot;, which means the message must be
18865 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
18866 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
18867 to be a match.
18868 <P>
18869 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18870 for more information on Patterns.
18871 <P>
18872 Look <A HREF="h_edit_nav_cmds">here</A>
18873 to see the available Editing and Navigation commands.
18874 <P>
18875 &lt;End of help on this topic&gt;
18876 </BODY>
18877 </HTML>
18878 ======= h_config_role_stat_new =======
18879 <HTML>
18880 <HEAD>
18881 <TITLE>Message New Status Explained</TITLE>
18882 </HEAD>
18883 <BODY>
18884 <H1>Message New Status Explained</H1>
18885
18886 This part of the Pattern may have one of three possible values.
18887 The default value is &quot;Don't care&quot;, which matches any message.
18888 The other two values are &quot;Yes&quot;, which means the message must be
18889 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
18890 means the message must <EM>not</EM> be &quot;New&quot; in order
18891 to be a match.
18892 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
18893 same as <EM>Seen</EM>.
18894 <P>
18895 The nomenclature for New and Recent is a bit confusing:
18896 <P>
18897 New means that the message is Unseen.
18898 It could have been in your mailbox for a long time but if you haven't looked
18899 at it, it is still considered New.
18900 That matches the default Alpine index display that shows an N for such a
18901 message.
18902 <P>
18903 Recent means that the message was added to this folder since the last time
18904 you opened the folder.
18905 Alpine also shows an N by default for these types of messages.
18906 If you were to run two copies of Alpine that opened a folder one right after
18907 the other, a message would only show up as Recent in (at most) the first
18908 Alpine session.
18909 <P>
18910 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18911 for more information on Patterns.
18912 <P>
18913 Look <A HREF="h_edit_nav_cmds">here</A>
18914 to see the available Editing and Navigation commands.
18915 <P>
18916 &lt;End of help on this topic&gt;
18917 </BODY>
18918 </HTML>
18919 ======= h_config_role_stat_recent =======
18920 <HTML>
18921 <HEAD>
18922 <TITLE>Message Recent Status Explained</TITLE>
18923 </HEAD>
18924 <BODY>
18925 <H1>Message Recent Status Explained</H1>
18926
18927 This part of the Pattern may have one of three possible values.
18928 The default value is &quot;Don't care&quot;, which matches any message.
18929 The other two values are &quot;Yes&quot;, which means the message must be
18930 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
18931 means the message must <EM>not</EM> be &quot;Recent&quot; in order
18932 to be a match.
18933 &quot;Recent&quot; means that the message was added to the folder since
18934 the last time the folder was opened.
18935 If more than one mail client has the folder opened, the message will
18936 appear to be &quot;Recent&quot; to only one of the clients.
18937 <P>
18938 The nomenclature for New and Recent is a bit confusing:
18939 <P>
18940 New means that the message is Unseen.
18941 It could have been in your mailbox for a long time but if you haven't looked
18942 at it, it is still considered New.
18943 That matches the default Alpine index display that shows an N for such a
18944 message.
18945 <P>
18946 Recent means that the message was added to this folder since the last time
18947 you opened the folder.
18948 Alpine also shows an N by default for these types of messages.
18949 If you were to run two copies of Alpine that opened a folder one right after
18950 the other, a message would only show up as Recent in (at most) the first
18951 Alpine session.
18952 <P>
18953 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18954 for more information on Patterns.
18955 <P>
18956 Look <A HREF="h_edit_nav_cmds">here</A>
18957 to see the available Editing and Navigation commands.
18958 <P>
18959 &lt;End of help on this topic&gt;
18960 </BODY>
18961 </HTML>
18962 ======= h_config_role_stat_del =======
18963 <HTML>
18964 <HEAD>
18965 <TITLE>Message Deleted Status Explained</TITLE>
18966 </HEAD>
18967 <BODY>
18968 <H1>Message Deleted Status Explained</H1>
18969
18970 This part of the Pattern may have one of three possible values.
18971 The default value is &quot;Don't care&quot;, which matches any message.
18972 The other two values are &quot;Yes&quot;, which means the message must be
18973 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
18974 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
18975 to be a match.
18976 <P>
18977 If you are thinking of using this part of the Pattern as a way to prevent
18978 messages from being filtered more than once in a Filter Pattern,
18979 take a look at the Filter Option
18980 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
18981 instead.
18982 It should work better than using this field since it will hide the filtered
18983 messages even if they are already Deleted.
18984 That option is at the bottom of the Filter configuration screen.
18985 <P>
18986 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18987 for more information on Patterns.
18988 <P>
18989 Look <A HREF="h_edit_nav_cmds">here</A>
18990 to see the available Editing and Navigation commands.
18991 <P>
18992 &lt;End of help on this topic&gt;
18993 </BODY>
18994 </HTML>
18995 ======= h_config_role_stat_ans =======
18996 <HTML>
18997 <HEAD>
18998 <TITLE>Message Answered Status Explained</TITLE>
18999 </HEAD>
19000 <BODY>
19001 <H1>Message Answered Status Explained</H1>
19002
19003 This part of the Pattern may have one of three possible values.
19004 The default value is &quot;Don't care&quot;, which matches any message.
19005 The other two values are &quot;Yes&quot;, which means the message must be
19006 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
19007 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
19008 to be a match.
19009 <P>
19010 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19011 for more information on Patterns.
19012 <P>
19013 Look <A HREF="h_edit_nav_cmds">here</A>
19014 to see the available Editing and Navigation commands.
19015 <P>
19016 &lt;End of help on this topic&gt;
19017 </BODY>
19018 </HTML>
19019 ======= h_config_role_abookfrom =======
19020 <HTML>
19021 <HEAD>
19022 <TITLE>Address in Address Book Explained</TITLE>
19023 </HEAD>
19024 <BODY>
19025 <H1>Address in Address Book Explained</H1>
19026
19027 This option gives you a way to match messages that contain an address
19028 that is in one of your address books.
19029 Only the simple entries in your address books are searched.
19030 Address book distribution lists are ignored!
19031 <P>
19032 This part of the Pattern may have one of five possible values.
19033 The default value is &quot;Don't care&quot;, which matches any message.
19034 The value &quot;Yes, in any address book&quot; means at least one of the addresses
19035 from the message must be in at least one of your
19036 address books in order to be a match.
19037 The value &quot;No, not in any address book&quot;
19038 means none of the addresses may
19039 be in any of your address books in order to be a match.
19040 <P>
19041 The values &quot;Yes, in specific address books&quot; and
19042 &quot;No, not in any of specific address books&quot; are similar but instead
19043 of depending on all address books you are allowed to give a list of address
19044 books to look in.
19045 Usually this would be a single address book but it may be a
19046 list of address books as well.
19047 For each of these &quot;specific&quot; address book options you Select which
19048 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
19049 name (or list of names) of the address book in the
19050 &quot;Abook List&quot; field.
19051 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
19052 The easiest way to fill in the Abook List field it to use
19053 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
19054 line is highlighted.
19055 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
19056 option is set to one of the two &quot;Specific&quot;, values.
19057 <P>
19058 The addresses from the message that are checked for are determined by the
19059 setting you have for &quot;Types of addresses to check for in address book&quot;.
19060 If you set this to &quot;From&quot; the From address from the message will
19061 be looked up in the address book.
19062 If you set it to &quot;To&quot; instead then the To addresses will be used.
19063 If any of the To addresses are in the address book then it is considered
19064 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
19065 You could set it to both From and To, in which case all of the From and To
19066 addresses are used.
19067 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
19068 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
19069 exists or the From address if there is no Reply-To address.
19070 Same for the Sender address.
19071 <P>
19072 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19073 for more information on Patterns.
19074 <P>
19075 Look <A HREF="h_edit_nav_cmds">here</A>
19076 to see the available Editing and Navigation commands.
19077 <P>
19078 &lt;End of help on this topic&gt;
19079 </BODY>
19080 </HTML>
19081 ======= h_config_inabook_from =======
19082 <HTML>
19083 <HEAD>
19084 <TITLE>From</TITLE>
19085 </HEAD>
19086 <BODY>
19087 <H1>From</H1>
19088
19089 Setting the From line will cause the address from the From header line
19090 of the message to be checked for in the address book.
19091 <P>
19092 &lt;End of help on this topic&gt;
19093 </BODY>
19094 </HTML>
19095 ======= h_config_inabook_replyto =======
19096 <HTML>
19097 <HEAD>
19098 <TITLE>Reply-To</TITLE>
19099 </HEAD>
19100 <BODY>
19101 <H1>Reply-To</H1>
19102
19103 Setting the Reply-To line will cause the address from the Reply-To header line
19104 of the message to be checked for in the address book.
19105 However, if there is no Reply-To header line in the message the From header
19106 line will be used instead.
19107 We understand this is dumb but we don't have an easy way around it.
19108 <P>
19109 &lt;End of help on this topic&gt;
19110 </BODY>
19111 </HTML>
19112 ======= h_config_inabook_sender =======
19113 <HTML>
19114 <HEAD>
19115 <TITLE>Sender</TITLE>
19116 </HEAD>
19117 <BODY>
19118 <H1>Sender</H1>
19119
19120 Setting the Sender line will cause the address from the Sender header line
19121 of the message to be checked for in the address book.
19122 However, if there is no Sender header line in the message the From header
19123 line will be used instead.
19124 We understand this is dumb but we don't have an easy way around it.
19125 <P>
19126 &lt;End of help on this topic&gt;
19127 </BODY>
19128 </HTML>
19129 ======= h_config_inabook_to =======
19130 <HTML>
19131 <HEAD>
19132 <TITLE>To</TITLE>
19133 </HEAD>
19134 <BODY>
19135 <H1>To</H1>
19136
19137 Setting the To line will cause the address from the To header line
19138 of the message to be checked for in the address book.
19139 <P>
19140 &lt;End of help on this topic&gt;
19141 </BODY>
19142 </HTML>
19143 ======= h_config_inabook_cc =======
19144 <HTML>
19145 <HEAD>
19146 <TITLE>CC</TITLE>
19147 </HEAD>
19148 <BODY>
19149 <H1>CC</H1>
19150
19151 Setting the CC line will cause the address from the CC header line
19152 of the message to be checked for in the address book.
19153 <P>
19154 &lt;End of help on this topic&gt;
19155 </BODY>
19156 </HTML>
19157 ======= h_config_role_stat_8bitsubj =======
19158 <HTML>
19159 <HEAD>
19160 <TITLE>Raw 8-bit in Subject Explained</TITLE>
19161 </HEAD>
19162 <BODY>
19163 <H1>Raw 8-bit in Subject Explained</H1>
19164
19165 It seems that lots of unwanted email contains unencoded 8-bit characters
19166 in the Subject.
19167 Normally, characters with the 8th bit set are not allowed in the Subject
19168 header unless they are MIME-encoded.
19169 This option gives you a way to match messages that have Subjects that
19170 contain unencoded 8-bit characters.
19171 <P>
19172 This part of the Pattern may have one of three possible values.
19173 The default value is &quot;Don't care&quot;, which matches any message.
19174 The other two values are &quot;Yes&quot;, which means the Subject of
19175 the message must contain unencoded 8-bit characters (characters with the
19176 most significant bit set)
19177 in order to be a match; or &quot;No&quot;, which
19178 means the Subject must <EM>not</EM>
19179 contain unencoded 8-bit characters in order to be a match.
19180 <P>
19181 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19182 for more information on Patterns.
19183 <P>
19184 Look <A HREF="h_edit_nav_cmds">here</A>
19185 to see the available Editing and Navigation commands.
19186 <P>
19187 &lt;End of help on this topic&gt;
19188 </BODY>
19189 </HTML>
19190 ======= h_config_role_bom =======
19191 <HTML>
19192 <HEAD>
19193 <TITLE>Beginning of Month</TITLE>
19194 </HEAD>
19195 <BODY>
19196 <H1>Beginning of Month</H1>
19197
19198 This option gives you a limited ability to take different actions depending on whether
19199 this is the first time Alpine has been run this month or not.
19200 Though it would be nice to have such an option available, this is not the
19201 same as whether or not this is the first time a particular folder has been
19202 opened this month.
19203 If you want some action (probably Filtering) to take place in a folder each
19204 month, then you will need to be sure that the folder is opened during the
19205 first Alpine session of the month in order for this option to be helpful.
19206 <P>
19207 This part of the Pattern may have one of three possible values.
19208 The default value is &quot;Don't care&quot;, which matches any message.
19209 The other two values are &quot;Yes&quot;, which means this is the first
19210 time Alpine has been run this month;
19211 or &quot;No&quot;, which
19212 means this is not the first time Alpine has been run this month.
19213 <P>
19214 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19215 for more information on Patterns.
19216 <P>
19217 Here are some technical details.
19218 The way that Alpine decides if it is the beginning of the month or not is
19219 to compare today's date with the date stored in the
19220 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
19221 variable in the config file.
19222 If the month of today's date is later than the month stored in the variable,
19223 then this is considered to be the first time you have run Alpine this month, and
19224 that turns the Beginning of the Month option on.
19225 <P>
19226 Look <A HREF="h_edit_nav_cmds">here</A>
19227 to see the available Editing and Navigation commands.
19228 <P>
19229 &lt;End of help on this topic&gt;
19230 </BODY>
19231 </HTML>
19232 ======= h_config_role_boy =======
19233 <HTML>
19234 <HEAD>
19235 <TITLE>Beginning of Year</TITLE>
19236 </HEAD>
19237 <BODY>
19238 <H1>Beginning of Year</H1>
19239
19240 This option gives you a limited ability to take different actions depending on whether
19241 this is the first time Alpine has been run this year or not.
19242 Though it would be nice to have such an option available, this is not the
19243 same as whether or not this is the first time a particular folder has been
19244 opened this year.
19245 If you want some action (probably Filtering) to take place in a folder each
19246 year, then you will need to be sure that the folder is opened during the
19247 first Alpine session of the year in order for this option to be helpful.
19248 <P>
19249 This part of the Pattern may have one of three possible values.
19250 The default value is &quot;Don't care&quot;, which matches any message.
19251 The other two values are &quot;Yes&quot;, which means this is the first
19252 time Alpine has been run this year;
19253 or &quot;No&quot;, which
19254 means this is not the first time Alpine has been run this year.
19255 <P>
19256 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19257 for more information on Patterns.
19258 <P>
19259 Here are some technical details.
19260 The way that Alpine decides if it is the beginning of the year or not is
19261 to compare today's date with the date stored in the
19262 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
19263 variable in the config file.
19264 If the year of today's date is later than the year stored in the variable,
19265 then this is considered to be the first time you have run Alpine this year, and
19266 that turns the Beginning of the Year option on.
19267 <P>
19268 Look <A HREF="h_edit_nav_cmds">here</A>
19269 to see the available Editing and Navigation commands.
19270 <P>
19271 &lt;End of help on this topic&gt;
19272 </BODY>
19273 </HTML>
19274 ======= h_config_role_inick =======
19275 <HTML>
19276 <HEAD>
19277 <TITLE>Initialize Values From Role Explained</TITLE>
19278 </HEAD>
19279 <BODY>
19280 <H1>Initialize Values From Role Explained</H1>
19281
19282 This is a power user feature.
19283 You will usually want to leave this field empty.
19284 The value of this field is the nickname of another one of your roles.
19285 The Action values from that other role
19286 are used as the initial values of the Action items for this role.
19287 If you put something in any of the action fields for this role, that will
19288 override whatever was in the corresponding field of the initializer role.
19289 <P>
19290 You might use this field if the &quot;Action&quot; part of one of your roles
19291 is something you want to use in more than one role.
19292 Instead of filling in those action values again for each role, you
19293 may give the nickname of the role where the values are filled in.
19294 It's just a shortcut way to define Role Actions.
19295 <P>
19296 Here's an example to help explain how this works.
19297 Suppose you have a role with nickname &quot;role1&quot; and role1 has
19298 (among other things)
19299 <P>
19300 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
19301 <P>
19302 set.
19303 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
19304 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
19305 from role1 by default (and any of the other inheritable action values
19306 that are set).
19307 So if role2 had
19308 <P>
19309 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
19310 <P>
19311 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
19312 However, if role2 had
19313 <P>
19314 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
19315 <P>
19316 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
19317 <P>
19318 If you wish,
19319 you may choose a nickname from your list of roles by using the
19320 &quot;T&quot; command.
19321 If the role you are using to initialize also has a role it initializes from,
19322 then that initialization happens first.
19323 That is, inheritance works as expected with the grandparent and
19324 great-grandparent (and so on) roles having the expected effect.
19325 <P>
19326 Look <A HREF="h_edit_nav_cmds">here</A>
19327 to see the available Editing and Navigation commands.
19328 <P>
19329 &lt;End of help on this topic&gt;
19330 </BODY>
19331 </HTML>
19332 ======= h_config_role_setfrom =======
19333 <HTML>
19334 <HEAD>
19335 <TITLE>Set From Explained</TITLE>
19336 </HEAD>
19337 <BODY>
19338 <H1>Set From Explained</H1>
19339
19340 This describes part of the action to be taken if the Pattern for this
19341 role is a match.
19342 This field consists of a single address that will be used as the From
19343 address on the message you are sending.
19344 This should be a fully-qualified address like
19345 <P>
19346 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
19347 <P>
19348 or just
19349 <P>
19350 <CENTER><SAMP>user@domain</SAMP></CENTER>
19351 <P>
19352 If you wish,
19353 you may choose an address from your address book with the
19354 &quot;T&quot; command.
19355 <P>
19356 If this is left blank, then your normal From address will be used.
19357 <P>
19358 You may also find it useful to add the changed From address to the
19359 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
19360 configuration option.
19361 <P>
19362 Look <A HREF="h_edit_nav_cmds">here</A>
19363 to see the available Editing and Navigation commands.
19364 <P>
19365 &lt;End of help on this topic&gt;
19366 </BODY>
19367 </HTML>
19368 ======= h_config_role_setreplyto =======
19369 <HTML>
19370 <HEAD>
19371 <TITLE>Set Reply-To Explained</TITLE>
19372 </HEAD>
19373 <BODY>
19374 <H1>Set Reply-To Explained</H1>
19375
19376 This describes part of the action to be taken if the Pattern for this
19377 role is a match.
19378 This field consists of a single address that will be used as the Reply-To
19379 address on the message you are sending.
19380 This may be a fully-qualified address like
19381 <P>
19382 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
19383 <P>
19384 or just
19385 <P>
19386 <CENTER><SAMP>user@domain</SAMP></CENTER>
19387 <P>
19388 If you wish,
19389 you may choose an address from your address book with the
19390 &quot;T&quot; command.
19391 <P>
19392 If this is left blank, then there won't be a Reply-To address unless
19393 you have configured one specially with the
19394 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
19395 configuration option.
19396 <P>
19397 Look <A HREF="h_edit_nav_cmds">here</A>
19398 to see the available Editing and Navigation commands.
19399 <P>
19400 &lt;End of help on this topic&gt;
19401 </BODY>
19402 </HTML>
19403 ======= h_config_role_setfcc =======
19404 <HTML>
19405 <HEAD>
19406 <TITLE>Set Fcc Explained</TITLE>
19407 </HEAD>
19408 <BODY>
19409 <H1>Set Fcc Explained</H1>
19410
19411 This describes part of the action to be taken if the Pattern for this
19412 role is a match.
19413 This field consists of a single folder name that will be used in
19414 the Fcc field of the message you are sending.
19415 You may put anything here that you would normally type into the Fcc
19416 field from the composer.
19417 <P>
19418 In addition, an fcc of &quot;&quot; (two double quotation marks) means
19419 no Fcc.
19420 <P>
19421 A blank field here means that Alpine will use its normal rules for deciding
19422 the default value of the Fcc field.
19423 For many roles, perhaps most, it may make more sense for you to use the
19424 other Alpine facilities for setting the Fcc.
19425 In particular, if you want the Fcc to depend on who you are sending the
19426 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
19427 is probably more useful.
19428 In that case, you would want to leave the Fcc field here blank.
19429 However, if you have a role that depends on who the message you are replying
19430 to was From, or what address that message was sent to;
19431 then it might make sense to set the Fcc for that role here.
19432 <P>
19433 If you wish,
19434 you may choose a folder from your folder collections by using the
19435 &quot;T&quot; command.
19436 <P>
19437 Look <A HREF="h_edit_nav_cmds">here</A>
19438 to see the available Editing and Navigation commands.
19439 <P>
19440 &lt;End of help on this topic&gt;
19441 </BODY>
19442 </HTML>
19443 ======= h_config_role_usesmtp =======
19444 <HTML>
19445 <HEAD>
19446 <TITLE>Use SMTP Server Explained</TITLE>
19447 </HEAD>
19448 <BODY>
19449 <H1>Use SMTP Server Explained</H1>
19450
19451 This describes part of the action to be taken if the Pattern for this
19452 role is a match.
19453 If this field has a value, then it will be used as the SMTP server
19454 to send mail when this role is being used (unless the SMTP server variable
19455 is set in the system-wide fixed configuration file).
19456 It has the same semantics as the
19457 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
19458 variable in the Setup/Config screen.
19459 <P>
19460 If you are using this to post from home when you are at home and from
19461 work when you are at work you need to be careful about postponing messages.
19462 When you postpone a composition that was using a role with this variable
19463 set, the SMTP server list will be saved
19464 with the postponed composition.
19465 It cannot be changed later.
19466 Because of this, you may want to make this a list of SMTP servers
19467 with the preferred server at the front of the list and alternate servers
19468 later in the list.
19469 In your &quot;Home&quot; role you would put the home SMTP server first and
19470 the work SMTP server last.
19471 In your &quot;Work&quot; role you would put the work SMTP server first and
19472 the home SMTP server last.
19473 Then if you start a composition as &quot;Work&quot;, postpone
19474 it, and then later resume it from home the work SMTP server will fail but
19475 the home SMTP server later in the list will succeed.
19476 <P>
19477 You may be able to simplify things by making the regular
19478 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
19479 variable in the Setup/Config screen a list instead of using roles
19480 to set the SMTP server.
19481
19482 <P>
19483 Look <A HREF="h_edit_nav_cmds">here</A>
19484 to see the available Editing and Navigation commands.
19485 <P>
19486 &lt;End of help on this topic&gt;
19487 </BODY>
19488 </HTML>
19489 ======= h_config_role_usenntp =======
19490 <HTML>
19491 <HEAD>
19492 <TITLE>Use NNTP Server Explained</TITLE>
19493 </HEAD>
19494 <BODY>
19495 <H1>Use NNTP Server Explained</H1>
19496
19497 This describes part of the action to be taken if the Pattern for this
19498 role is a match.
19499 If this field has a value, then it will be used as the NNTP server
19500 to post to newsgroups when this role is being used (unless the NNTP server
19501 variable
19502 is set in the system-wide fixed configuration file).
19503 It has the same semantics as the
19504 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
19505 variable in the Setup/Config screen.
19506 <P>
19507 This role setting can facilitate posting to the right nntp server for someone
19508 who reads news from various news sources.  The feature
19509 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
19510 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
19511 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
19512 nntp servers for roles may be more desirable for some people.
19513 <P>
19514 If you are using this to post from home when you are at home and from
19515 work when you are at work you need to be careful about postponing messages.
19516 When you postpone a composition that was using a role with this variable
19517 set, the NNTP server list will be saved
19518 with the postponed composition.
19519 It cannot be changed later.
19520 Because of this, you may want to make this a list of NNTP servers
19521 with the preferred server at the front of the list and alternate servers
19522 later in the list.
19523 In your &quot;Home&quot; role you would put the home NNTP server first and
19524 the work NNTP server last.
19525 In your &quot;Work&quot; role you would put the work NNTP server first and
19526 the home NNTP server last.
19527 Then if you start a composition as &quot;Work&quot;, postpone
19528 it, and then later resume it from home the work NNTP server will fail but
19529 the home NNTP server later in the list will succeed.
19530 <P>
19531 You may be able to simplify things by making the regular
19532 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
19533 variable in the Setup/Config screen a list instead of using roles
19534 to set the NNTP server.
19535
19536 <P>
19537 Look <A HREF="h_edit_nav_cmds">here</A>
19538 to see the available Editing and Navigation commands.
19539 <P>
19540 &lt;End of help on this topic&gt;
19541 </BODY>
19542 </HTML>
19543 ======= h_config_role_setotherhdr =======
19544 <HTML>
19545 <HEAD>
19546 <TITLE>Set Other Headers Explained</TITLE>
19547 </HEAD>
19548 <BODY>
19549 <H1>Set Other Headers Explained</H1>
19550
19551 This describes part of the action to be taken if the Pattern for this
19552 role is a match.
19553 This field gives you a way to set values for headers besides
19554 &quot;From&quot; and &quot;Reply-To&quot;.
19555 If you want to set either of those, use the specific
19556 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
19557 <P>
19558 This field is similar to the
19559 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
19560 Each header you specify here must include the header tag
19561 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
19562 and may optionally include a value for that header.
19563 In order to see these headers when you compose using this role you
19564 must use the rich header
19565 <!--chtml if pinemode="function_key"-->(F5)
19566 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
19567 Here's an example that shows how you might set the To address.
19568 <P>
19569 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
19570 <P>
19571 Headers set in this way are different from headers set with the
19572 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
19573 will replace any value that already exists.
19574 For example, if you are Replying to a message there will already be at
19575 least one address in the To header (the address you are Replying to).
19576 However, if you Reply using a role that sets the To header, that role's
19577 To header value will be used instead.
19578 <P>
19579 Limitation: Because commas are used to separate the list of
19580 Other Headers, it is not possible to have the value of a
19581 header contain a comma;
19582 nor is there currently an &quot;escape&quot; mechanism provided
19583 to make this work.
19584 <P>
19585 Look <A HREF="h_edit_nav_cmds">here</A>
19586 to see the available Editing and Navigation commands.
19587 <P>
19588 &lt;End of help on this topic&gt;
19589 </BODY>
19590 </HTML>
19591 ======= h_config_role_setlitsig =======
19592 <HTML>
19593 <HEAD>
19594 <TITLE>Set Literal Signature Explained</TITLE>
19595 </HEAD>
19596 <BODY>
19597 <H1>Set Literal Signature Explained</H1>
19598
19599 This describes part of the action to be taken if the Pattern for this
19600 role is a match.
19601 This field contains the actual text for your signature, as opposed to
19602 the name of a file containing your signature.
19603 If this is defined it takes precedence over any value set in the
19604 &quot;Set Signature&quot; field.
19605 <P>
19606 This is simply a different way to store the signature.
19607 The signature is stored inside your Alpine configuration file instead of in
19608 a separate file.
19609 Tokens work the same way they do with
19610 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
19611 help text there for more information.
19612 <P>
19613
19614 The two character sequence &#92;n (backslash followed by
19615 the character n) will be used to signify a line-break in your signature.
19616 You don't have to enter the &#92;n, but it will be visible in the
19617 CHANGE THIS ROLE RULE window after you are done editing the signature.
19618 <P>
19619 Look <A HREF="h_edit_nav_cmds">here</A>
19620 to see the available Editing and Navigation commands.
19621 <P>
19622 &lt;End of help on this topic&gt;
19623 </BODY>
19624 </HTML>
19625 ======= h_config_role_setsig =======
19626 <HTML>
19627 <HEAD>
19628 <TITLE>Set Signature Explained</TITLE>
19629 </HEAD>
19630 <BODY>
19631 <H1>Set Signature Explained</H1>
19632
19633 This describes part of the action to be taken if the Pattern for this
19634 role is a match.
19635 <P>
19636 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
19637 option from Setup/Config
19638 or the &quot;Set LiteralSig&quot; option for this role are defined,
19639 then this option will be ignored.
19640 You can tell that that is the case because the value of this
19641 option will show up as
19642 <P>
19643 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
19644 <P>
19645 You may either use all Literal Signatures (signatures stored in your
19646 configuration file) throughout Alpine, or all signature files.
19647 You can't mix the two.
19648 <P>
19649 This field consists of a filename that will be used as the signature
19650 file when using this role.
19651 <P>
19652 If the filename is followed by a vertical bar (|) then instead
19653 of reading the contents of the file the file is assumed to be a
19654 program that will produce the text to be used on its standard output.
19655 The program can't have any arguments and doesn't receive any input from Alpine,
19656 but the rest of the processing works as if the contents came from a file.
19657 <P>
19658 Instead of storing the data in a local file, the
19659 signature data may be stored remotely in an IMAP folder.
19660 In order to do this,
19661 you must use a remote name for the signature.
19662 A remote signature name might look like:
19663 <P>
19664 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
19665 <P>
19666
19667 The syntax used here is the same as the syntax used for a remote
19668 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
19669 Note that you may not access an existing signature file remotely,
19670 you have to create a new <EM>folder</EM> that contains the signature data.
19671 If the name you use here for the signature data is a remote name, then when
19672 you edit the file using the &quot;F&quot; command the data will
19673 be saved remotely in the folder.
19674 You aren't required to do anything special to create the folder, it
19675 gets created if you use a remote name.
19676
19677 <P>
19678 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
19679 the name of the file) you have specified.
19680 If you type &quot;T&quot; you may use a browser to choose an existing filename.
19681 <P>
19682 Besides containing regular text, a signature file may also
19683 contain (or a signature program may produce) tokens that are replaced with text
19684 that depends on the message you are replying to or forwarding.
19685 The tokens all look like _word_ (a word surrounded by underscores).
19686 For example, if the token
19687 <P>
19688 <CENTER><SAMP>_DATE_</SAMP></CENTER>
19689 <P>
19690 is included in the text of the signature file, then when you reply to
19691 or forward a message, the token will be replaced with the actual date
19692 the message you are replying to or forwarding was sent.
19693 <P>
19694 If you use a role that has a signature file for a plain composition
19695 (that is, not a reply or forward) then there is no original message, so
19696 any tokens that depend on the message will be replaced with nothing.
19697 So if you want a signature file to be useful for new compositions it
19698 shouldn't include any of the tokens that depend on the message being
19699 replied to or forwarded.
19700 <P>
19701 The list of available tokens is
19702 <A HREF="h_index_tokens">here</A>.
19703 <P>
19704 Actually, for the adventurous, there is a way to conditionally include text based
19705 on whether or not a token would result in specific replacement text.
19706 For example, you could include some text based on whether or not
19707 the _NEWS_ token would result in any newsgroups if it was used.
19708 It's explained in detail
19709 <A HREF="h_reply_token_conditionals">here</A>.
19710 <P>
19711 In the very unlikely event that you want to include a literal token in
19712 a signature file, you must precede it with a backslash character.
19713 For example, to include the literal text _DATE_ you must actually use
19714 &#92;_DATE_.
19715 It is not possible to have a literal backslash followed by an expanded token.
19716 <P>
19717 A blank field here means that Alpine will use its normal rules for deciding
19718 which file (if any) to use for the signature file.
19719 <P>
19720 An alternate method for storing the signature is available in
19721 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
19722 <P>
19723 Look <A HREF="h_edit_nav_cmds">here</A>
19724 to see the available Editing and Navigation commands.
19725 <P>
19726 &lt;End of help on this topic&gt;
19727 </BODY>
19728 </HTML>
19729 ======= h_config_role_settempl =======
19730 <HTML>
19731 <HEAD>
19732 <TITLE>Set Template Explained</TITLE>
19733 </HEAD>
19734 <BODY>
19735 <H1>Set Template Explained</H1>
19736
19737 This describes part of the action to be taken if the Pattern for this
19738 role is a match.
19739 This field consists of a filename that will be used as the template
19740 file when using this role.
19741 The template file is a file that is included at the top of the message you
19742 are composing.
19743 <P>
19744 If the filename is followed by a vertical bar (|) then instead
19745 of reading the contents of the file the file is assumed to be a
19746 program that will produce the text to be used on its standard output.
19747 The program can't have any arguments and doesn't receive any input from Alpine,
19748 but the rest of the processing works as if the contents came from a file.
19749 <P>
19750 Instead of storing the data in a local file, the
19751 template may be stored remotely in an IMAP folder.
19752 In order to do this,
19753 you must use a remote name for the template.
19754 A remote template name might look like:
19755 <P>
19756 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
19757 <P>
19758
19759 The syntax used here is the same as the syntax used for a remote
19760 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
19761 Note that you may not access an existing template file remotely,
19762 you have to create a new <EM>folder</EM> that contains the template data.
19763 If the name you use here for the template is a remote name, then when
19764 you edit the file using the &quot;F&quot; command the data will
19765 be saved remotely in the folder.
19766 You aren't required to do anything special to create the folder, it
19767 gets created if you use a remote name.
19768 <P>
19769 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
19770 the name of the file) you have specified.
19771 If you type &quot;T&quot; you may use a browser to choose an existing filename.
19772 <P>
19773 Besides containing regular text, the template file may also
19774 contain (or a template file program may produce) tokens that are replaced with text
19775 that depends on the message you are replying to or forwarding.
19776 The tokens all look like _word_ (a word surrounded by underscores).
19777 For example, if the token
19778 <P>
19779 <CENTER><SAMP>_DATE_</SAMP></CENTER>
19780 <P>
19781 is included in the text of the template file, then when you reply to
19782 or forward a message, the token will be replaced with the actual date
19783 the message you are replying to or forwarding was sent.
19784 <P>
19785 If you use a role that has a template file for a plain composition
19786 (that is, not a reply or forward) then there is no original message, so
19787 any tokens that depend on the message will be replaced with nothing.
19788 So if you want a template file to be useful for new compositions it
19789 shouldn't include any of the tokens that depend on the message being
19790 replied to or forwarded.
19791 <P>
19792 The list of available tokens is
19793 <A HREF="h_index_tokens">here</A>.
19794 <P>
19795 Actually, for the adventurous, there is a way to conditionally include text based
19796 on whether or not a token would result in specific replacement text.
19797 For example, you could include some text based on whether or not
19798 the _NEWS_ token would result in any newsgroups if it was used.
19799 It's explained in detail
19800 <A HREF="h_reply_token_conditionals">here</A>.
19801 <P>
19802 In the very unlikely event that you want to include a literal token in
19803 a template file, you must precede it with a backslash character.
19804 For example, to include the literal text _DATE_ you must actually use
19805 &#92;_DATE_.
19806 It is not possible to have a literal backslash followed by an expanded token.
19807 <P>
19808 A blank template field means that Alpine will not use a template file when
19809 this role is being used.
19810 <P>
19811 Look <A HREF="h_edit_nav_cmds">here</A>
19812 to see the available Editing and Navigation commands.
19813 <P>
19814 &lt;End of help on this topic&gt;
19815 </BODY>
19816 </HTML>
19817 ======= h_config_filt_stat_imp =======
19818 <HTML>
19819 <HEAD>
19820 <TITLE>Set Important Status Explained</TITLE>
19821 </HEAD>
19822 <BODY>
19823 <H1>Set Important Status Explained</H1>
19824
19825 This describes part of the action to be taken if the Pattern for this
19826 filter is a match.
19827 If set to &quot;Don't change it&quot; then this does nothing.
19828 If set to &quot;Set this state&quot; then the Important flag is set
19829 for the matching message.
19830 If set to &quot;Clear this state&quot; then the Important flag is cleared
19831 for the matching message.
19832 The important flag usually causes an asterisk to show up in the MESSAGE
19833 INDEX.
19834 It may also be useful when selecting a set of messages
19835 with the Select command.
19836 <P>
19837 Look <A HREF="h_edit_nav_cmds">here</A>
19838 to see the available Editing and Navigation commands.
19839 <P>
19840 &lt;End of help on this topic&gt;
19841 </BODY>
19842 </HTML>
19843 ======= h_config_filt_stat_new =======
19844 <HTML>
19845 <HEAD>
19846 <TITLE>Set New Status Explained</TITLE>
19847 </HEAD>
19848 <BODY>
19849 <H1>Set New Status Explained</H1>
19850
19851 This describes part of the action to be taken if the Pattern for this
19852 filter is a match.
19853 If set to &quot;Don't change it&quot; then this does nothing.
19854 If set to &quot;Set this state&quot; then the
19855 matching message is marked New.
19856 If set to &quot;Clear this state&quot; then the
19857 matching message is marked Seen.
19858 <P>
19859 Look <A HREF="h_edit_nav_cmds">here</A>
19860 to see the available Editing and Navigation commands.
19861 <P>
19862 &lt;End of help on this topic&gt;
19863 </BODY>
19864 </HTML>
19865 ======= h_config_filt_stat_ans =======
19866 <HTML>
19867 <HEAD>
19868 <TITLE>Set Answered Status Explained</TITLE>
19869 </HEAD>
19870 <BODY>
19871 <H1>Set Answered Status Explained</H1>
19872
19873 This describes part of the action to be taken if the Pattern for this
19874 filter is a match.
19875 If set to &quot;Don't change it&quot; then this does nothing.
19876 If set to &quot;Set this state&quot; then the Answered flag is set
19877 for the matching message.
19878 If set to &quot;Clear this state&quot; then the Answered flag is cleared
19879 for the matching message.
19880 <P>
19881 Look <A HREF="h_edit_nav_cmds">here</A>
19882 to see the available Editing and Navigation commands.
19883 <P>
19884 &lt;End of help on this topic&gt;
19885 </BODY>
19886 </HTML>
19887 ======= h_config_filt_stat_del =======
19888 <HTML>
19889 <HEAD>
19890 <TITLE>Set Deleted Status Explained</TITLE>
19891 </HEAD>
19892 <BODY>
19893 <H1>Set Deleted Status Explained</H1>
19894
19895 This describes part of the action to be taken if the Pattern for this
19896 filter is a match.
19897 If set to &quot;Don't change it&quot; then this does nothing.
19898 If set to &quot;Set this state&quot; then the
19899 matching message is marked Deleted.
19900 If set to &quot;Clear this state&quot; then the
19901 matching message is marked UnDeleted.
19902 <P>
19903 You should not use this option unless you are prepared to have matching
19904 messages expunged from the folder permanently.
19905 For example, if you type the Expunge command, this filter is applied
19906 before the expunge, so matching messages will be marked Deleted and then
19907 will be permanently expunged from the folder.
19908 However, since the index isn't redrawn in between the time that the message
19909 is marked Deleted and the time that you are asked to expunge, the only
19910 indication that you are expunging the message comes in the number of messages
19911 being expunged.
19912 The same thing may happen when you close a folder.
19913 It is also possible that an expunge not initiated by you will
19914 delete matching messages.
19915 <P>
19916 Look <A HREF="h_edit_nav_cmds">here</A>
19917 to see the available Editing and Navigation commands.
19918 <P>
19919 &lt;End of help on this topic&gt;
19920 </BODY>
19921 </HTML>
19922 ======= h_config_role_scoreval =======
19923 <HTML>
19924 <HEAD>
19925 <TITLE>Score Value Explained</TITLE>
19926 </HEAD>
19927 <BODY>
19928 <H1>Score Value Explained</H1>
19929
19930 A message's score is the sum of the Score Values from all of the Scoring rules
19931 with Patterns that match the message.
19932 The value you give here is the Score Value associated with this rule.
19933 A Score Value is an integer between -100 and 100, with the default
19934 value of zero.
19935 <P>
19936 Alternatively, if the
19937 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
19938 field is defined
19939 (on the line right below the &quot;Score Value&quot; field)
19940 then the &quot;Score Value&quot; is ignored and
19941 the &quot;Score From Header&quot; field is used instead.
19942 <P>
19943 Look <A HREF="h_edit_nav_cmds">here</A>
19944 to see the available Editing and Navigation commands.
19945 <P>
19946 &lt;End of help on this topic&gt;
19947 </BODY>
19948 </HTML>
19949 ======= h_config_role_scorehdrtok =======
19950 <HTML>
19951 <HEAD>
19952 <TITLE>Score Value From Header Explained</TITLE>
19953 </HEAD>
19954 <BODY>
19955 <H1>Score Value From Header Explained</H1>
19956
19957 This option provides a way to use a number that appears in the headers of your
19958 messages as the message's score, or as a component of that score.
19959 If this field is defined then it is used instead of the &quot;Score Value&quot;.
19960 The idea behind this option is that there may be a score embedded in the
19961 headers of messages that has already been calculated outside of Alpine.
19962 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
19963 somewhere in that header there is a score.
19964 <P>
19965 The value for this option is the name of the header followed by parentheses
19966 with two arguments inside:
19967 <P>
19968 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
19969 <P>
19970 No space is allowed between the comma and the start of the field_separators.
19971 It would be interpreted as the first separator if it was there.
19972 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
19973 starts after that and goes to the second separator, and so on.
19974 It's easier to explain with examples.
19975 <P>
19976 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
19977 <P>
19978 In the above example the header that is used is the &quot;X-Spam&quot; header.
19979 The value of that header (the part after the colon and the space) is split
19980 into fields separated by spaces.
19981 <P>
19982 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
19983 <P>
19984 The second field is selected and converted to an integer. It only makes sense
19985 if Field2 really is an integer.
19986 <P>
19987 Here's an example of a SpamAssassin header.
19988 The exact look of the header will vary, but if your incoming mail
19989 contains headers that look like the following
19990 <P>
19991 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
19992 <P>
19993 you might want to use the hits value as a score.
19994 Since the score is an integer value you can't make use of the decimal part of
19995 the number, but
19996 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
19997 and &quot;.&quot; as your separators.
19998 <P>
19999 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
20000 <P>
20001 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
20002 hits.
20003 The second field is &quot;10&quot; so the score value would be 10.
20004 <P>
20005 Another example we've seen has headers that look like
20006 <P>
20007 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
20008 <P>
20009 Because there are two equals before the 7% the value
20010 <P>
20011 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
20012 <P>
20013 should capture the probability as the score.
20014 <P>
20015 The Score From Header scoring value actually works just like the
20016 regular Score Value in that the rest of the pattern has to match before
20017 it is used and the scores from all the different scoring rules that
20018 match for a particular message are added together.
20019 When using the Score From Header method it may (or may not) make sense to
20020 use only a single scoring rule with a pattern that matches every message.
20021 <P>
20022 Look <A HREF="h_edit_nav_cmds">here</A>
20023 to see the available Editing and Navigation commands.
20024 <P>
20025 &lt;End of help on this topic&gt;
20026 </BODY>
20027 </HTML>
20028 ======= h_config_role_replyuse =======
20029 <HTML>
20030 <HEAD>
20031 <TITLE>Reply Use Explained</TITLE>
20032 </HEAD>
20033 <BODY>
20034 <H1>Reply Use Explained</H1>
20035
20036 This option determines how this particular role will be used when Replying
20037 to a message.
20038 There are three possible values for this option.
20039 The value &quot;Never&quot;
20040 means that this role will not be a candidate for use when Replying.
20041 The role's Pattern will not be checked for a match, however the role will
20042 be available to be manually switched to if there is a confirmation prompt.
20043 <P>
20044
20045 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
20046 mean that you do want to consider this role when Replying.
20047 For either of these settings, the role's Pattern will be compared with
20048 the message being replied to.
20049 If there is a match then this role will either be used without confirmation
20050 or will be the default when confirmation is asked for, depending on
20051 which of the two options is selected.
20052 If confirmation is requested, you will also have a chance to
20053 manually change the role to any one of your other roles.
20054 <P>
20055
20056 You won't be prompted for confirmation if none of your role Patterns
20057 match the message being replied to.
20058 This is independent of the value of the current option.
20059 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
20060 feature may be used to change this behavior.
20061 <P>
20062 &lt;End of help on this topic&gt;
20063 </BODY>
20064 </HTML>
20065 ======= h_config_role_forwarduse =======
20066 <HTML>
20067 <HEAD>
20068 <TITLE>Forward Use Explained</TITLE>
20069 </HEAD>
20070 <BODY>
20071 <H1>Forward Use Explained</H1>
20072
20073 This option determines how this particular role will be used when Forwarding
20074 a message.
20075 There are three possible values for this option.
20076 The value &quot;Never&quot;
20077 means that this role will not be a candidate for use when Forwarding.
20078 The role's Pattern will not be checked for a match, however the role will
20079 be available to be manually switched to if there is a confirmation prompt.
20080 <P>
20081
20082 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
20083 mean that you do want to consider this role when Forwarding.
20084 For either of these settings, the role's Pattern will be compared with
20085 the message being forwarded.
20086 If there is a match then this role will either be used without confirmation
20087 or will be the default when confirmation is asked for, depending on
20088 which of the two options is selected.
20089 If confirmation is requested, you will also have a chance to
20090 manually change the role to any one of your other roles.
20091 <P>
20092
20093 You won't be prompted for confirmation if none of your role Patterns
20094 match the message being forwarded.
20095 This is independent of the value of the current option.
20096 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
20097 feature may be used to change this behavior.
20098 <P>
20099 &lt;End of help on this topic&gt;
20100 </BODY>
20101 </HTML>
20102 ======= h_config_role_composeuse =======
20103 <HTML>
20104 <HEAD>
20105 <TITLE>Compose Use Explained</TITLE>
20106 </HEAD>
20107 <BODY>
20108 <H1>Compose Use Explained</H1>
20109
20110 This option determines how this particular role will be used when Composing
20111 a new message using the &quot;Compose&quot; command.
20112 This does not affect what happens when using the &quot;Role&quot; command
20113 to compose a new message.
20114 The &quot;Role&quot; command allows you to select a role from all of the
20115 roles you have defined, regardless of what Uses you've assigned to those
20116 roles.
20117 <P>
20118
20119 There are three possible values for this option.
20120 The value &quot;Never&quot;
20121 means that this role will not be a candidate for use when Composing.
20122 The role's Current Folder Type will not be checked for a match, however the role
20123 will be available to be manually switched to if there is a confirmation prompt.
20124 <P>
20125
20126 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
20127 mean that you do want to consider this role when Composing.
20128 For either of these settings,
20129 the role's Current Folder Type will be checked (since there is no message
20130 to compare with, the rest of the Pattern is considered a match).
20131 If there is a match then this role will either be used without confirmation
20132 or will be the default when confirmation is asked for, depending on
20133 which of the two options is selected.
20134 If confirmation is requested, you will also have a chance to
20135 manually change the role to any one of your other roles.
20136 <P>
20137
20138 When using the Compose command the role checking is a little different
20139 because there is no message being replied to or forwarded.
20140 Because of this the Current Folder Type is checked but the header pattern
20141 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
20142 A role is considered to be a match if it is a candidate for Compose Use and
20143 its Current Folder Type matches the currently open folder.
20144 This could be useful if you want to set a role based on the folder you
20145 are reading, or the type of folder you are reading.
20146 <P>
20147
20148 You won't be prompted for confirmation if none of your role Patterns
20149 are a match.
20150 This is independent of the value of the current option.
20151 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
20152 feature may be used to change this behavior.
20153 <P>
20154 &lt;End of help on this topic&gt;
20155 </BODY>
20156 </HTML>
20157 ======= h_config_filter_folder =======
20158 <HTML>
20159 <HEAD>
20160 <TITLE>Filter Folder Explained</TITLE>
20161 </HEAD>
20162 <BODY>
20163 <H1>Filter Folder Explained</H1>
20164
20165 When the Filter Action is set to &quot;Move&quot;,
20166 the folder or folders specified here will be used to store messages matching
20167 the provided pattern.
20168
20169 <P>
20170 If you set the Filter Action to &quot;Move&quot; you must give a folder name
20171 here.
20172
20173 <P>
20174 If you wish,
20175 you may choose a folder from your folder collections by using the
20176 &quot;T&quot; command.
20177 <P>
20178 Besides regular text, the folder name may also contain
20179 tokens that are replaced with text representing the current date
20180 when you run Alpine.
20181 For example, if the folder name you use is
20182 <P>
20183 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
20184 <P>
20185 that is replaced with something like
20186 <P>
20187 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
20188 <P>
20189 Or,
20190 <P>
20191 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
20192 <P>
20193 becomes
20194 <P>
20195 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
20196 <P>
20197 The token names must be surrounded by underscores in order to be recognized
20198 as tokens.
20199 The tokens that may be used are those that are derived from the current date.
20200 They're listed near the bottom of the list of tokens give
20201 <A HREF="h_index_tokens">here</A>.
20202 <P>
20203 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
20204 for more information on Patterns.
20205 <P>
20206 Look <A HREF="h_edit_nav_cmds">here</A>
20207 to see the available Editing and Navigation commands.
20208 <P>
20209 &lt;End of help on this topic&gt;
20210 </BODY>
20211 </HTML>
20212 ======= h_config_filter_kw_set =======
20213 <HTML>
20214 <HEAD>
20215 <TITLE>Set These Keywords Explained</TITLE>
20216 </HEAD>
20217 <BODY>
20218 <H1>Set These Keywords Explained</H1>
20219
20220 This describes part of the action to be taken if the Pattern for this
20221 filter is a match.
20222 Read a little about keywords in the help text for the
20223 <A HREF="h_common_flag">Flag</A> command.
20224 This option is a list of keywords that will be Set when there is a match.
20225 If you wish, you may choose keywords from the list of keywords you have
20226 defined with the &quot;T&quot; command.
20227 You may add new keywords by defining them in the
20228 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
20229 If you have given a keyword a nickname when configuring it,
20230 that nickname may be used instead of the actual keyword.
20231
20232 <P>
20233 Look <A HREF="h_edit_nav_cmds">here</A>
20234 to see the available Editing and Navigation commands.
20235 <P>
20236 &lt;End of help on this topic&gt;
20237 </BODY>
20238 </HTML>
20239 ======= h_config_filter_kw_clr =======
20240 <HTML>
20241 <HEAD>
20242 <TITLE>Clear These Keywords Explained</TITLE>
20243 </HEAD>
20244 <BODY>
20245 <H1>Clear These Keywords Explained</H1>
20246
20247 This describes part of the action to be taken if the Pattern for this
20248 filter is a match.
20249 Read a little about keywords in the help text for the
20250 <A HREF="h_common_flag">Flag</A> command.
20251 This option is a list of keywords that will be Cleared when there is a match.
20252 If you wish, you may choose keywords from the list of keywords you have
20253 defined with the &quot;T&quot; command.
20254 You may add new keywords by defining them in the
20255 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
20256 If you have given a keyword a nickname when configuring it,
20257 that nickname may be used instead of the actual keyword.
20258
20259 <P>
20260 Look <A HREF="h_edit_nav_cmds">here</A>
20261 to see the available Editing and Navigation commands.
20262 <P>
20263 &lt;End of help on this topic&gt;
20264 </BODY>
20265 </HTML>
20266 ======= h_index_tokens =======
20267 <HTML>
20268 <HEAD>
20269 <TITLE>Tokens for Index and Replying</TITLE>
20270 </HEAD>
20271 <BODY>
20272
20273 This set of special tokens may be used in the
20274 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
20275 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
20276 in signature files,
20277 in template files used in
20278 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
20279 that is the target of a Filter Rule.
20280 Some of them aren't available in all situations.
20281 <P>
20282 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
20283 option, but they must be surrounded by underscores for the
20284 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
20285 and in the target of Filter Rules.
20286 <P>
20287 <P>
20288
20289 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
20290
20291 <DL>
20292 <DT>SUBJECT</DT>
20293 <DD>
20294 This token represents the Subject the sender gave the message.
20295 Alternatives for use in the index screen are SHORTSUBJECT,
20296 SUBJKEY, SHORTSUBJKEY, SUBJKEYINIT, SHORTSUBJKEYINIT, SUBJECTTEXT,
20297 SUBJKEYTEXT, and SUBJKEYINITTEXT.
20298 You may color the subject text in the MESSAGE INDEX screen differently by using the
20299 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
20300 <A HREF="h_config_index_opening_color">Index Opening Color</A>
20301 options available from
20302 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20303 </DD>
20304
20305 <DT>FROM</DT>
20306 <DD>
20307 This token represents the personal name (or email address if the name
20308 is unavailable) of the person specified in the message's &quot;From:&quot;
20309 header field.
20310 You may color the from text in the MESSAGE INDEX screen differently by using the
20311 <A HREF="h_config_index_from_color">Index From Color</A>
20312 option available from
20313 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20314 </DD>
20315
20316 <DT>ADDRESS</DT>
20317 <DD>
20318 This is similar to the &quot;FROM&quot; token, only it is always the
20319 email address, never the personal name.
20320 For example, &quot;mailbox@domain&quot;.
20321 </DD>
20322
20323 <DT>MAILBOX</DT>
20324 <DD>
20325 This is the same as the &quot;ADDRESS&quot; except that the
20326 domain part of the address is left off.
20327 For example, &quot;mailbox&quot;.
20328 </DD>
20329
20330 <DT>SENDER</DT>
20331 <DD>
20332 This token represents the personal name (or email address) of the person
20333 listed in the message's &quot;Sender:&quot; header field.
20334 </DD>
20335
20336 <DT>TO</DT>
20337 <DD>
20338 This token represents the personal names (or email addresses if the names
20339 are unavailable) of the persons specified in the
20340 message's &quot;To:&quot; header field.
20341 </DD>
20342
20343 <DT>NEWSANDTO</DT>
20344 <DD>
20345 This token represents the newsgroups from the
20346 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
20347 the personal names (or email addresses if the names
20348 are unavailable) of the persons specified in the
20349 message's &quot;To:&quot; header field.
20350 </DD>
20351
20352 <DT>TOANDNEWS</DT>
20353 <DD>
20354 Same as &quot;NEWSANDTO&quot; except in the opposite order.
20355 </DD>
20356
20357 <DT>NEWS</DT>
20358 <DD>
20359 This token represents the newsgroups from the
20360 message's &quot;Newsgroups:&quot; header field.
20361 </DD>
20362
20363 <DT>CC</DT>
20364 <DD>
20365 This token represents the personal names (or email addresses if the names
20366 are unavailable) of the persons specified in the
20367 message's &quot;Cc:&quot; header field.
20368 </DD>
20369
20370 <DT>RECIPS</DT>
20371 <DD>
20372 This token represents the personal names (or email addresses if the names
20373 are unavailable) of the persons specified in both the
20374 message's &quot;To:&quot; header field and
20375 the message's &quot;Cc:&quot; header field.
20376 </DD>
20377
20378 <DT>NEWSANDRECIPS</DT>
20379 <DD>
20380 This token represents the newsgroups from the
20381 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
20382 the personal names (or email addresses if the names
20383 are unavailable) of the persons specified in the
20384 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
20385 </DD>
20386
20387 <DT>RECIPSANDNEWS</DT>
20388 <DD>
20389 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
20390 </DD>
20391
20392 <DT>INIT</DT>
20393 <DD>
20394 This token represents the initials from the personal name
20395 of the person specified in the message's &quot;From:&quot;
20396 header field.
20397 If there is no personal name, it is blank.
20398 </DD>
20399
20400 <DT>DATE</DT>
20401 <DD>
20402 This token represents the date on which the message was sent, according
20403 to the &quot;Date&quot; header field.
20404 It has the format MMM DD. For example, &quot;Oct 23&quot;.
20405 The feature
20406 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
20407 which adjusts for the timezone the message was sent from,
20408 may have an effect on the value of this token as well as the values of
20409 all of the other DATE or TIME tokens.
20410 Some of the DATE and TIME tokens are displayed in a locale-specific
20411 way unless the option
20412 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
20413 </DD>
20414
20415 <DT>SMARTDATE</DT>
20416 <DD>
20417 This token represents the date on which the message was sent, according
20418 to the &quot;Date&quot; header field.
20419 It is &quot;Today&quot; if the message was sent today,
20420 &quot;Yesterday&quot; for yesterday,
20421 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
20422 message is from last year and is more than six months old it includes the year, as well.
20423 See the SMARTDATE alternatives below, as well.
20424 </DD>
20425
20426 <DT>SMARTTIME</DT>
20427 <DD>
20428 This token represents the most relevant elements of the date on which
20429 the message was sent (according to the &quot;Date&quot; header field),
20430 in a compact form. If the message was sent today, only the time is used
20431 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
20432 the past week, the day of the week and the hour are used
20433 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
20434 given as date, month, and year (e.g. &quot;23Aug00&quot;,
20435 &quot;9Apr98&quot;).
20436 </DD>
20437
20438 <DT>SMARTTIME24</DT>
20439 <DD>
20440 This token has the structure &quot;day hour:minute&quot;
20441 (e.g. &quot;Sun 19:03&quot;) for messages dated less than a week
20442 from the current date, or &quot;month day&quot; (e.g.
20443 &quot;Nov 23&quot;) for messages dated less than 6 months
20444 ago, or &quot;day/month/year&quot; (e.g &quot;06/Jan/16&quot;)
20445 for messages dated more than 6 months ago. It uses 9 characters
20446 of the width of the screen, and it left aligned.
20447 </DD>
20448
20449 <DT>SMARTDATETIME</DT>
20450 <DD>
20451 This is a combination of SMARTDATE and SMARTTIME.
20452 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
20453 case it is SMARTTIME.
20454 See the SMARTDATETIME alternatives below, as well.
20455 </DD>
20456
20457 <DT>DATEISO</DT>
20458 <DD>
20459 This token represents the date on which the message was sent, according
20460 to the &quot;Date&quot; header field.
20461 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
20462 </DD>
20463
20464 <DT>SHORTDATEISO</DT>
20465 <DD>
20466 This token represents the date on which the message was sent, according
20467 to the &quot;Date&quot; header field.
20468 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
20469 </DD>
20470
20471 <DT>SHORTDATE1</DT>
20472 <DD>
20473 This token represents the date on which the message was sent, according
20474 to the &quot;Date&quot; header field.
20475 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
20476 </DD>
20477
20478 <DT>SHORTDATE2</DT>
20479 <DD>
20480 This token represents the date on which the message was sent, according
20481 to the &quot;Date&quot; header field.
20482 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
20483 </DD>
20484
20485 <DT>SHORTDATE3</DT>
20486 <DD>
20487 This token represents the date on which the message was sent, according
20488 to the &quot;Date&quot; header field.
20489 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
20490 </DD>
20491
20492 <DT>SHORTDATE4</DT>
20493 <DD>
20494 This token represents the date on which the message was sent, according
20495 to the &quot;Date&quot; header field.
20496 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
20497 </DD>
20498
20499 <DT>LONGDATE</DT>
20500 <DD>
20501 This token represents the date on which the message was sent, according
20502 to the &quot;Date&quot; header field.
20503 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
20504 </DD>
20505
20506 <DT>SMARTDATE alternatives</DT>
20507 <DD>
20508 There are several versions of SMARTDATE that are all the same except
20509 for the way they format dates far in the past.
20510 SMARTDATE formats the date using the information from your locale settings
20511 to format the date string. It may end up formatting dates so that they look
20512 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
20513 The feature
20514 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
20515 may have an effect on the values of these tokens.
20516 If you want more control you may use one of the following.
20517   <DL>
20518   <DT>SMARTDATE</DT> <DD>If the option
20519 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
20520 then this will be locale specific. Control this with the
20521 LC_TIME locale setting on a UNIX system. On Windows
20522 the Regional Options control panel may be used to set the Short date
20523 format. At the programming level, the strftime routine is what Alpine
20524 uses to print the date.
20525 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
20526 to SMARTDATES1.</DD>
20527   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
20528   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
20529   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
20530   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
20531   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
20532   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
20533   </DL>
20534 </DD>
20535
20536 <DT>SMARTDATETIME alternatives</DT>
20537 <DD>
20538 There are several versions of SMARTDATETIME that are all very similar.
20539 The ones that end in 24 use a 24-hour clock for Today's messages instead
20540 of a 12-hour clock.
20541 The other variation is
20542 for the way they format dates far in the past.
20543 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
20544 to format the date string. It may end up formatting dates so that they look
20545 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
20546 The feature
20547 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
20548 may have an effect on the values of these tokens.
20549 The possible choices are:
20550   <DL>
20551   <DT>SMARTDATETIME</DT> <DD>If the option
20552 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
20553 then this will be locale specific. Control this with the
20554 LC_TIME locale setting on a UNIX system. On Windows
20555 the Regional Options control panel may be used to set the Short date
20556 format. At the programming level, the strftime routine is what Alpine
20557 uses to print the date.
20558 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
20559 to SMARTDATETIMES1.</DD>
20560   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
20561   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
20562   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
20563   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
20564   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
20565   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
20566   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
20567   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
20568   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
20569   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
20570   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
20571   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
20572   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
20573   </DL>
20574 </DD>
20575
20576 <DT>DAYDATE</DT>
20577 <DD>
20578 This token represents the date on which the message was sent, according
20579 to the &quot;Date&quot; header field.
20580 It looks like &quot;Sat, 23 Oct 1998&quot;.
20581 This token is never converted in any locale-specific way.
20582 </DD>
20583
20584 <DT>PREFDATE</DT>
20585 <DD>
20586 This token represents the date on which the message was sent, according
20587 to the &quot;Date&quot; header field.
20588 It is your operating system's idea of the preferred date representation for the current locale.
20589 Internally it uses the %x version of the date from the strftime routine.
20590 </DD>
20591
20592 <DT>PREFTIME</DT>
20593 <DD>
20594 This token represents the time at which the message was sent, according
20595 to the &quot;Date&quot; header field.
20596 It is the preferred time representation for the current locale.
20597 Internally it uses the %X version of the time from the strftime routine.
20598 </DD>
20599
20600 <DT>PREFDATETIME</DT>
20601 <DD>
20602 This token represents the date and time at which the message was sent, according
20603 to the &quot;Date&quot; header field.
20604 It is the preferred date and time representation for the current locale.
20605 Internally it uses the %c version of the time from the strftime routine.
20606 </DD>
20607
20608 <DT>DAY</DT>
20609 <DD>
20610 This token represents the day of the month on which the message was sent,
20611 according to the &quot;Date&quot; header field.
20612 For example, &quot;23&quot; or &quot;9&quot;.
20613 </DD>
20614
20615 <DT>DAY2DIGIT</DT>
20616 <DD>
20617 This token represents the day of the month on which the message was sent,
20618 according to the &quot;Date&quot; header field.
20619 For example, &quot;23&quot; or &quot;09&quot;.
20620 It is always 2 digits.
20621 </DD>
20622
20623 <DT>DAYORDINAL</DT>
20624 <DD>
20625 This token represents the ordinal number that is the day of
20626 the month on which the message was sent,
20627 according to the &quot;Date&quot; header field.
20628 For example, &quot;23rd&quot; or &quot;9th&quot;.
20629 </DD>
20630
20631 <DT>DAYOFWEEK</DT>
20632 <DD>
20633 This token represents the day of the week on which the message was sent,
20634 according to the &quot;Date&quot; header field.
20635 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20636 </DD>
20637
20638 <DT>DAYOFWEEKABBREV</DT>
20639 <DD>
20640 This token represents the day of the week on which the message was sent,
20641 according to the &quot;Date&quot; header field.
20642 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20643 </DD>
20644
20645 <DT>MONTHABBREV</DT>
20646 <DD>
20647 This token represents the month the message was sent, according
20648 to the &quot;Date&quot; header field.
20649 For example, &quot;Oct&quot;.
20650 </DD>
20651
20652 <DT>MONTHLONG</DT>
20653 <DD>
20654 This token represents the month in which the message was sent, according
20655 to the &quot;Date&quot; header field.
20656 For example, &quot;October&quot;.
20657 </DD>
20658
20659 <DT>MONTH</DT>
20660 <DD>
20661 This token represents the month in which the message was sent, according
20662 to the &quot;Date&quot; header field.
20663 For example, &quot;10&quot; or &quot;9&quot;.
20664 </DD>
20665
20666 <DT>MONTH2DIGIT</DT>
20667 <DD>
20668 This token represents the month in which the message was sent, according
20669 to the &quot;Date&quot; header field.
20670 For example, &quot;10&quot; or &quot;09&quot;.
20671 It is always 2 digits.
20672 </DD>
20673
20674 <DT>YEAR</DT>
20675 <DD>
20676 This token represents the year the message was sent, according
20677 to the &quot;Date&quot; header field.
20678 For example, &quot;1998&quot; or &quot;2001&quot;.
20679 </DD>
20680
20681 <DT>YEAR2DIGIT</DT>
20682 <DD>
20683 This token represents the year the message was sent, according
20684 to the &quot;Date&quot; header field.
20685 For example, &quot;98&quot; or &quot;01&quot;.
20686 It is always 2 digits.
20687 </DD>
20688
20689 <DT>TIME24</DT>
20690 <DD>
20691 This token represents the time at which the message was sent, according
20692 to the &quot;Date&quot; header field.
20693 There is no adjustment made for different time zones, so you'll get
20694 the time the message was sent according to the time zone the sender
20695 was in.
20696 It has the format HH:MM. For example, &quot;17:28&quot;.
20697 </DD>
20698
20699 <DT>TIME12</DT>
20700 <DD>
20701 This token represents the time at which the message was sent, according
20702 to the &quot;Date&quot; header field.
20703 This time is for a 12 hour clock.
20704 It has the format HH:MMpm.
20705 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20706 </DD>
20707
20708 <DT>TIMEZONE</DT>
20709 <DD>
20710 This token represents the numeric timezone from
20711 the &quot;Date&quot; header field.
20712 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
20713 </DD>
20714
20715 </DL>
20716
20717 <P>
20718 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
20719
20720 <DL>
20721 <DT>MSGNO</DT>
20722 <DD>
20723 This token represents the message's current position in the folder that,
20724 of course, may change as the folder is sorted or new mail arrives.
20725 </DD>
20726
20727 <DT>STATUS</DT>
20728 <DD>
20729 This token represents a three character wide field displaying various
20730 aspects of the message's state.
20731 The first character is either blank,
20732 a '*' for message marked Important, or a '+' indicating a message
20733 addressed directly to you (as opposed to your having received it via a
20734 mailing list, for example).
20735 When the feature
20736 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
20737 is set, if the first character would have been
20738 blank then it will instead be a '-' if the message is cc'd to you.
20739 The second character is typically blank,
20740 though the arrow cursor may occupy it if either the
20741 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
20742 or the
20743 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
20744 is set (or you actually are on a slow link).
20745 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
20746 '<A HREF="h_flag_answered">A</A>' (Answered),
20747 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
20748 '<A HREF="h_flag_new">N</A>' (New), or blank.
20749 <P>
20750 If you are using a threaded view of the index and this message is at the
20751 top of a collapsed portion of a thread,
20752 then this token refers to all of the messages in the collapsed portion of
20753 the thread instead of just the top message.
20754 The first character will be a '*' if <EM>any</EM> of the messages in the thread
20755 are marked Important, else a '+' if any of the messages are addressed
20756 to you, else a '-' if any of the messages are cc'd to you.
20757 The third character will be a 'D' if <EM>all</EM> of the messages
20758 in the collapsed thread are marked deleted,
20759 an 'A' if <EM>all</EM> of the messages
20760 in the collapsed thread are marked answered,
20761 it will be an 'N' if any of
20762 the messages are undeleted and unseen, and it will be blank otherwise.
20763 </DD>
20764
20765 <DT>FULLSTATUS</DT>
20766 <DD>
20767 This token represents a less abbreviated alternative
20768 to the &quot;STATUS&quot; token.
20769 It is six characters wide.
20770 The first character is '+', '-', or blank, the
20771 second blank, the third either '*' or blank, the fourth
20772 '<A HREF="h_flag_new">N</A>' or blank,
20773 the fifth '<A HREF="h_flag_answered">A</A>'
20774 or blank, and the sixth character is
20775 either '<A HREF="h_flag_deleted">D</A>' or
20776 blank.
20777 <P>
20778 If you are using a threaded view of the index and this message is at the
20779 top of a collapsed portion of a thread,
20780 then this token refers to all of the messages in the collapsed portion of
20781 the thread instead of just the top message.
20782 The first character is '+', '-', or blank depending on whether <EM>any</EM>
20783 of the messages in the collapsed thread are addressed to you or cc'd to you.
20784 The third character will be '*' if any of the messages are marked
20785 Important.
20786 The fourth character will be 'N' if all of the messages in the thread
20787 are New, else 'n' if some of the messages in the thread are New, else blank.
20788 The fifth character will be 'A' or 'a' or blank, and the sixth character
20789 will be 'D' or 'd' or blank.
20790 </DD>
20791
20792 <DT>IMAPSTATUS</DT>
20793 <DD>
20794 This token represents an even less abbreviated alternative to the
20795 &quot;STATUS&quot; token.
20796 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
20797 an 'N' if the message is new to this folder since the last time
20798 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
20799 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
20800 new to the folder since it was last opened <EM>but</EM> has not been
20801 viewed, or a blank if the message has been in the folder since it was
20802 last opened and has been viewed.
20803 <P>
20804 If you are using a threaded view of the index and this message is at the
20805 top of a collapsed portion of a thread,
20806 then the fourth character will be
20807 'N' if all of the messages in the thread are unseen and recent;
20808 else 'n' if some of the messages in the thread are unseen and recent;
20809 else 'U' if all of the messages in the thread are unseen and not recent;
20810 else 'u' if some of the messages in the thread are unseen and not recent;
20811 else 'R' if all of the messages in the thread are seen and recent;
20812 else 'r' if some of the messages in the thread are seen and recent;
20813 else blank.
20814 </DD>
20815
20816 <DT>SHORTIMAPSTATUS</DT>
20817 <DD>
20818 This is the same as the last four of the six characters of IMAPSTATUS,
20819 so the '+' To Me information will be missing.
20820 </DD>
20821
20822 <DT>SIZE</DT>
20823 <DD>
20824 This token represents the total size, in bytes, of the message.
20825 If a &quot;K&quot; (Kilobyte)
20826 follows the number, the size is approximately 1,000
20827 times that many bytes (rounded to the nearest 1,000).
20828 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20829 1,000,000 times that many bytes.
20830 Commas are not used in this field.
20831 This field is seven characters wide, including the enclosing parentheses.
20832 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20833 The progression of sizes used looks like:
20834
20835 <P>
20836 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
20837 <P>
20838 </DD>
20839
20840 <DT>SIZECOMMA</DT>
20841 <DD>
20842 This token represents the total size, in bytes, of the message.
20843 If a &quot;K&quot; (Kilobyte)
20844 follows the number, the size is approximately 1,000
20845 times that many bytes (rounded to the nearest 1,000).
20846 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20847 1,000,000 times that many bytes.
20848 Commas are used if the number shown is 1,000 or greater.
20849 The SIZECOMMA field is one character wider than the SIZE field.
20850 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20851 The progression of sizes used looks like:
20852
20853 <P>
20854 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
20855 <P>
20856 </DD>
20857
20858 <DT>KSIZE</DT>
20859 <DD>
20860 This token represents the total size of the message, expressed in
20861 kilobytes or megabytes, as most appropriate.
20862 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
20863 The progression of sizes used looks like:
20864
20865 <P>
20866 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
20867 <P>
20868 </DD>
20869
20870 <DT>SIZENARROW</DT>
20871 <DD>
20872 This token represents the total size, in bytes, of the message.
20873 If a &quot;K&quot; (Kilobyte)
20874 follows the number, the size is approximately 1,000
20875 times that many bytes.
20876 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20877 1,000,000 times that many bytes.
20878 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
20879 1,000,000,000 times that many bytes.
20880 This field uses only five characters of screen width, including the enclosing
20881 parentheses.
20882 The progression of sizes used looks like:
20883
20884 <P>
20885 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
20886 <P>
20887 </DD>
20888
20889 <DT>DESCRIPSIZE</DT>
20890 <DD>
20891 This token is intended to represent a more useful description of the
20892 message than just its size, but it isn't very useful at this point.
20893 The plus sign in this view means there are attachments.
20894 Note that including this token in
20895 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
20896 display a little while Alpine collects the necessary information.
20897 </DD>
20898
20899 <DT>SHORTSUBJECT</DT>
20900 <DD> This token is the same as SUBJECT, but removes
20901 text between &quot;[&quot; and &quot;]&quot;. Typically text enclosed
20902 between these characters corresponds to mailing list names, and may be
20903 unnecessary or unwanted in some instances.
20904 </DD>
20905
20906 <DT>SUBJKEY</DT>
20907 <DD>
20908 This token is the same as the SUBJECT token unless keywords are set for
20909 the message.
20910 In that case, a list of keywords enclosed in braces will be prepended to
20911 the subject of the message.
20912 Only those keywords that you have defined in your
20913 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20914 in Setup/Config are considered in the list.
20915 In other words, keywords that have been set by some other means, perhaps
20916 by another email program, won't show up unless included in
20917 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20918 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
20919 prepended to the subject in the MESSAGE TEXT screen.
20920 If you have given a keyword a nickname
20921 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
20922 instead of the actual keyword.
20923 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20924 option may be used to modify this token slightly.
20925 It is also possible to color keywords in the index using the
20926 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20927 </DD>
20928
20929 <DT>SHORTSUBJKEY</DT>
20930 <DD> This token is the same as SUBJKEY, but it is based on
20931 SHORTSUBJECT, instead of in SUBJECT.
20932 </DD>
20933
20934 <DT>SUBJKEYINIT</DT>
20935 <DD>
20936 This token is the same as the SUBJKEY token except that instead of
20937 prepending a list of keywords to the subject, a list of first initials
20938 of keywords will be prepended instead.
20939 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
20940 set (or Work and Now are the Alpine nicknames of keywords that are set)
20941 then the SUBJKEY token would cause a result like
20942 <P>
20943 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
20944 <P>
20945 whereas the SUBJKEYINIT token would give
20946 <P>
20947 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
20948 <P>
20949 Only those keywords that you have defined in your
20950 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20951 in Setup/Config are considered in the list.
20952 In other words, keywords that have been set by some other means, perhaps
20953 by another email program, won't show up unless included in
20954 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20955 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20956 option may be used to modify this token slightly.
20957 It is also possible to color keywords in the index using the
20958 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20959 </DD>
20960
20961 <DT>SHORTSUBJKEYINIT</DT>
20962 <DD> This token is the same as SUBJKEYINIT, but it is based on
20963 SHORTSUBJECT, instead of in SUBJECT.
20964 </DD>
20965
20966 <DT>SUBJECTTEXT</DT>
20967 <DD>
20968 Same as SUBJECT but if there is room in the Subject field for more text,
20969 the opening part of the text of the message is displayed after the subject.
20970 The time needed to fetch the text may cause a performance problem
20971 which can, of course, be avoided by using the SUBJECT version of
20972 the Subject instead.
20973 You may color this opening text differently by using the
20974 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20975 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20976 You may adjust the characters that are displayed between the Subject and the
20977 opening text with the option
20978 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
20979 </DD>
20980
20981 <DT>SUBJKEYTEXT</DT>
20982 <DD>
20983 Same as SUBJKEY but with the opening message text.
20984 </DD>
20985
20986 <DT>OPENINGTEXT</DT>
20987 <DD>
20988 This is similar to SUBJECTTEXT.
20989 Instead of combining the Subject and the opening text in a single
20990 field in the index screen this token allows you to allocate a
20991 separate column just for the opening text of the message.
20992 The time needed to fetch this text may cause a performance problem.
20993 You may color this opening text differently by using the
20994 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20995 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20996 </DD>
20997
20998 <DT>OPENINGTEXTNQ</DT>
20999 <DD>
21000 This is very similar to OPENINGTEXT.
21001 The NQ stands for No Quotes.
21002 The only difference is that quoted text (lines beginning with &gt;) is deleted.
21003 For some messages this may be confusing.
21004 For example, a message might have a line preceding some quoted
21005 text that reads something like &quot;On May 8th person A said.&quot;
21006 That no longer makes sense after the quoted text is deleted and it
21007 will appear that person A said whatever the text after the quote
21008 is, even though that is really person B talking.
21009 </DD>
21010
21011 <DT>SUBJKEYINITTEXT</DT>
21012 <DD>
21013 Same as SUBJKEYINIT but with the opening message text.
21014 </DD>
21015
21016 <DT>KEY</DT>
21017 <DD>
21018 This is a space-delimited list of keywords that are set for the message.
21019 Only those keywords that you have defined in your
21020 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
21021 in Setup/Config are considered in the list.
21022 In other words, keywords that have been set by some other means, perhaps
21023 by another email program, won't show up unless included in
21024 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
21025 If you have given a keyword a nickname
21026 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
21027 instead of the actual keyword.
21028 It is also possible to color keywords in the index using the
21029 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
21030 This token defaults to an arbitrary width of 5.
21031 You should set it to whatever width suits you using something
21032 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
21033 </DD>
21034
21035 <DT>KEYINIT</DT>
21036 <DD>
21037 This is a list of keyword initials that are set for the message.
21038 If you have given a keyword a nickname
21039 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
21040 is displayed instead of the initial of the actual keyword.
21041 It is also possible to color keyword initials in the index using the
21042 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
21043 This token defaults to an arbitrary width of 2.
21044 You should set it to whatever width suits you using something
21045 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
21046 </DD>
21047
21048 <DT>PRIORITY</DT>
21049 <DD>
21050 The X-Priority header is a non-standard header that is used in a
21051 somewhat standard way by many mail programs.
21052 Alpine expects the value of this header to be a digit with a value
21053 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
21054 Since this priority is something that the sender sets it is only an indication
21055 of the priority that the sender attaches to the mail and it is therefore almost
21056 totally unreliable for use as a filtering criterion.
21057 This token will display the numeric value of the priority if it is between
21058 1 and 5.
21059 It will be suppressed (blank) if the value is 3, which is normal priority.
21060 This token may be colored with the
21061 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
21062 </DD>
21063
21064 <DT>PRIORITYALPHA</DT>
21065 <DD>
21066 This is a more verbose interpretation of the X-Priority field.
21067 Once again nothing is displayed unless the value of the field
21068 is 1, 2, 4, or 5.
21069 The values displayed for those values are:
21070 <P>
21071 <TABLE>
21072 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
21073 <TR> <TD>2</TD> <TD>High</TD> </TR>
21074 <TR> <TD>4</TD> <TD>Low</TD> </TR>
21075 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
21076 </TABLE>
21077 <P>
21078 This token may be colored with the
21079 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
21080 </DD>
21081
21082 <DT>PRIORITY!</DT>
21083 <DD>
21084 This is a one character, non-numeric version of the X-Priority field.
21085 If the value of the X-Priority header is 1 or 2 an exclamation
21086 point is displayed.
21087 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
21088 This token may be colored with the
21089 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
21090 </DD>
21091
21092 <DT>ATT</DT>
21093 <DD>
21094 This is a one column wide field that represents the number of attachments
21095 a message has. It will be blank if there are no attachments, a single
21096 digit for one to nine attachments, or an asterisk for more than nine.
21097 Note that including this token in
21098 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
21099 display a little while Alpine collects the necessary information.
21100 </DD>
21101
21102 <DT>FROMORTO</DT>
21103 <DD>
21104 This token represents <EM>either</EM> the personal name (or email address) of
21105 the person listed in the message's &quot;From:&quot; header
21106 field, <EM>or</EM>, if that address is yours or one of your
21107 <A HREF="h_config_alt_addresses">alternate addresses</A>,
21108 the first person specified in the
21109 message's &quot;To:&quot; header field
21110 with the prefix &quot;To: &quot; prepended.
21111 If the from address is yours and there is also no &quot;To&quot; address,
21112 Alpine will use the address on the &quot;Cc&quot; line.
21113 If there is no address there, either, Alpine will look for a newsgroup name
21114 from the &quot;Newsgroups&quot; header field and put
21115 that after the &quot;To: &quot; prefix.
21116 </DD>
21117
21118 <DT>FROMORTONOTNEWS</DT>
21119 <DD>
21120 This is almost the same as <EM>FROMORTO</EM>.
21121 The difference is that newsgroups aren't considered.
21122 When a message is from you, doesn't have a To or Cc, and does have
21123 a Newsgroups header; this token will be your name instead of the name
21124 of the newsgroup (like it would be with FROMORTO).
21125 </DD>
21126
21127 <DT>TEXT</DT>
21128 <DD>
21129 This is a different sort of token.
21130 It allows you to display a label within each index line.
21131 It will be the same fixed text for each line.
21132 It is different from all the other tokens in that there is no space column
21133 displayed after this token.
21134 Instead, it is butted up against the following field.
21135 It also has a different syntax.
21136 The text to display is given following a colon after the
21137 word &quot;TEXT&quot;.
21138 For example,
21139 <P>
21140 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
21141 <P>
21142 would insert the literal text &quot;abc=&quot; (without the quotes)
21143 into the index display line.
21144 You must quote the text if it includes space characters, like
21145 <P>
21146 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
21147 <P>
21148 </DD>
21149
21150 <DT>HEADER</DT>
21151 <DD>
21152 This allows you to display the text from a particular header line in the
21153 message.
21154 The syntax for this token is substantially different from all the others
21155 in order that you might be able to display a portion of the text following
21156 a particular header.
21157 The header name you are interested in is given following a colon
21158 after the word &quot;HEADER&quot;.
21159 For example,
21160 <P>
21161 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
21162 <P>
21163 would display the text of the X-Spam header, if any.
21164 Like for other index tokens a width field may (and probably should)
21165 follow this.
21166 <P>
21167 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
21168 <P>
21169 displays the first ten characters of the X-Spam header.
21170 Unlike other index tokens, the syntax for HEADER is more flexible.
21171 An optional second argument comes after a comma inside the parentheses.
21172 It specifies the &quot;field&quot; number.
21173 By default, the field separator is a space character.
21174 No extra space characters are allowed in the argument list.
21175 <P>
21176 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
21177 <P>
21178 would display the second field, left-justified, in a 10 character
21179 wide field.
21180 The second field would consist of all the text after the first space
21181 up to the next space or the end of the header.
21182 The default field number is zero, which stands for the entire line.
21183 There is also an optional third argument that is a list of field
21184 separators. It defaults to a space character.
21185 The example
21186 <P>
21187 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
21188 <P>
21189 would cause the field separators to be any of colon, percent,
21190 or space (there is a space character between the percent and the
21191 right parenthesis).
21192 The first field runs from the start of the header value up to the first
21193 colon, percent, or space; the second goes from there to the next; and so on.
21194 In order to use a comma character as a field separator you must escape
21195 it by preceding it with a backslash (&#92;).
21196 The same is true of the backslash character itself.
21197 There is one further optional argument.
21198 It is an R or an L to specify right or left adjustment of the text
21199 within the field.
21200 The default is to left justify, however if you are displaying numbers
21201 you might prefer to right justify.
21202 <P>
21203 Here's an example of a SpamAssassin header.
21204 The exact look of the header will vary, but if your incoming mail
21205 contains headers that look like the following
21206 <P>
21207 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
21208 <P>
21209 you might want to display the hits value.
21210 The first field starts with the Y in Yes.
21211 To get what you're interested in you might use &quot;=&quot; and
21212 space as the field separators and display the third field, like
21213 <P>
21214 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
21215 <P>
21216 or maybe you would break at the dot instead
21217 <P>
21218 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
21219 <P>
21220 Another example we've seen has headers that look like
21221 <P>
21222 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
21223 <P>
21224 Because there are two equals and a comma before the 7% and a comma
21225 after it, the token
21226 <P>
21227 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
21228 <P>
21229 should display the probability (for example 7% or 83%) right justified
21230 in a 3-wide field.
21231 </DD>
21232
21233 <DT>ARROW</DT>
21234 <DD>
21235 This gives an alternative way to display the current message in the
21236 MESSAGE INDEX screen.
21237 Usually the current message is indicated by the line being shown in
21238 reverse video.
21239 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
21240 the current line will include an &quot;arrow&quot; that
21241 looks like
21242 <P>
21243 <CENTER><SAMP>-&gt;</SAMP></CENTER>
21244 <P>
21245 in the ARROW token's field.
21246 For all of the non-current messages, the ARROW field will be filled
21247 with blanks.
21248 If you use the fixed-field width feature the length of the &quot;arrow&quot;
21249 may be adjusted.
21250 The arrow will be drawn as width-1 dashes followed by a greater than sign.
21251 For example, if you use ARROW(3) you will get
21252 <P>
21253 <CENTER><SAMP>--&gt;</SAMP></CENTER>
21254 <P>
21255 and ARROW(1) will give you just
21256 <P>
21257 <CENTER><SAMP>&gt;</SAMP></CENTER>
21258 <P>
21259 It is also possible to set the color of the ARROW field.
21260 By default (and for non-current messages) the arrow is colored the same
21261 as the index line it is part of.
21262 You may set it to be another color with the
21263 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
21264 the <A HREF="h_color_setup">Setup Kolor</A> screen.
21265 </DD>
21266
21267 <DT>SCORE</DT>
21268 <DD>
21269 This gives the
21270 <a href="h_rules_score">score</a>
21271 of each message.
21272 This will be six columns wide to accommodate the widest possible score.
21273 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
21274 to limit the width of the field to the widest score that
21275 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
21276 If you have not defined any score rules the scores will all be zero.
21277 If any of your score rules contain AllText or BodyText patterns
21278 then including SCORE in the <!--#echo var="VAR_index-format"-->
21279 may slow down the display of the MESSAGE INDEX screen.
21280 </DD>
21281 </DL>
21282
21283 <P>
21284 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
21285
21286 <DL>
21287 <DT>CURNEWS</DT>
21288 <DD>
21289 This token represents the current newsgroup if there is one.
21290 For example, &quot;comp.mail.pine&quot;.
21291 </DD>
21292
21293 <DT>MSGID</DT>
21294 <DD>
21295 This token represents the message ID of the message.
21296 This token does not work with Filter Rule folder names.
21297 </DD>
21298
21299 <DT>CURDATE</DT>
21300 <DD>
21301 This token represents the current date.
21302 It has the format MMM DD. For example, &quot;Oct 23&quot;.
21303 </DD>
21304
21305 <DT>CURDATEISO</DT>
21306 <DD>
21307 This token represents the current date.
21308 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
21309 </DD>
21310
21311 <DT>CURDATEISOS</DT>
21312 <DD>
21313 This token represents the current date.
21314 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
21315 </DD>
21316
21317 <DT>CURPREFDATE</DT>
21318 <DD>
21319 This token represents the current date.
21320 It is your operating system's idea of the preferred date representation for the current locale.
21321 Internally it uses the %x version of the date from the strftime routine.
21322 </DD>
21323
21324 <DT>CURPREFTIME</DT>
21325 <DD>
21326 This token represents the current time.
21327 It is the preferred time representation for the current locale.
21328 Internally it uses the %X version of the time from the strftime routine.
21329 </DD>
21330
21331 <DT>CURPREFDATETIME</DT>
21332 <DD>
21333 This token represents the current date and time.
21334 It is the preferred date and time representation for the current locale.
21335 Internally it uses the %c version of the time from the strftime routine.
21336 </DD>
21337
21338 <DT>CURTIME24</DT>
21339 <DD>
21340 This token represents the current time.
21341 It has the format HH:MM. For example, &quot;17:28&quot;.
21342 </DD>
21343
21344 <DT>CURTIME12</DT>
21345 <DD>
21346 This token represents the current time.
21347 This time is for a 12 hour clock.
21348 It has the format HH:MMpm.
21349 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
21350 </DD>
21351
21352 <DT>CURDAY</DT>
21353 <DD>
21354 This token represents the current day of the month.
21355 For example, &quot;23&quot; or &quot;9&quot;.
21356 </DD>
21357
21358 <DT>CURDAY2DIGIT</DT>
21359 <DD>
21360 This token represents the current day of the month.
21361 For example, &quot;23&quot; or &quot;09&quot;.
21362 It is always 2 digits.
21363 </DD>
21364
21365 <DT>CURDAYOFWEEK</DT>
21366 <DD>
21367 This token represents the current day of the week.
21368 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
21369 </DD>
21370
21371 <DT>CURDAYOFWEEKABBREV</DT>
21372 <DD>
21373 This token represents the current day of the week.
21374 For example, &quot;Sun&quot; or &quot;Wed&quot;.
21375 </DD>
21376
21377 <DT>CURMONTH</DT>
21378 <DD>
21379 This token represents the current month.
21380 For example, &quot;10&quot; or &quot;9&quot;.
21381 </DD>
21382
21383 <DT>CURMONTH2DIGIT</DT>
21384 <DD>
21385 This token represents the current month.
21386 For example, &quot;10&quot; or &quot;09&quot;.
21387 It is always 2 digits.
21388 </DD>
21389
21390 <DT>CURMONTHLONG</DT>
21391 <DD>
21392 This token represents the current month.
21393 For example, &quot;October&quot;.
21394 </DD>
21395
21396 <DT>CURMONTHABBREV</DT>
21397 <DD>
21398 This token represents the current month.
21399 For example, &quot;Oct&quot;.
21400 </DD>
21401
21402 <DT>CURYEAR</DT>
21403 <DD>
21404 This token represents the current year.
21405 For example, &quot;1998&quot; or &quot;2001&quot;.
21406 </DD>
21407
21408 <DT>CURYEAR2DIGIT</DT>
21409 <DD>
21410 This token represents the current year.
21411 For example, &quot;98&quot; or &quot;01&quot;.
21412 It is always 2 digits.
21413 </DD>
21414
21415 <DT>LASTMONTH</DT>
21416 <DD>
21417 This token represents last month.
21418 For example, if this is November (the 11th month),
21419 it is equal to &quot;10&quot; or if this is October (the 10th month),
21420 it is &quot;9&quot;.
21421 It is possible that this and the other tokens beginning with LASTMONTH
21422 below could be useful when used with a Filtering Rule that
21423 has the &quot;Beginning of Month&quot; option set.
21424 </DD>
21425
21426 <DT>LASTMONTH2DIGIT</DT>
21427 <DD>
21428 This token represents last month.
21429 For example, if this is November (the 11th month),
21430 it is equal to &quot;10&quot; or if this is October (the 10th month),
21431 it is &quot;09&quot;.
21432 It is always 2 digits.
21433 </DD>
21434
21435 <DT>LASTMONTHLONG</DT>
21436 <DD>
21437 This token represents last month.
21438 For example, if this is November the value is &quot;October&quot;.
21439 </DD>
21440
21441 <DT>LASTMONTHABBREV</DT>
21442 <DD>
21443 This token represents last month.
21444 For example, if this is November the value is &quot;Oct&quot;.
21445 </DD>
21446
21447 <DT>LASTMONTHYEAR</DT>
21448 <DD>
21449 This token represents what the year was a month ago.
21450 For example, if this is October, 1998, it is &quot;1998&quot;.
21451 If this is January, 1998, it is &quot;1997&quot;.
21452 </DD>
21453
21454 <DT>LASTMONTHYEAR2DIGIT</DT>
21455 <DD>
21456 This token represents what the year was a month ago.
21457 For example, if this is October, 1998, it is &quot;98&quot;.
21458 If this is January, 1998, it is &quot;97&quot;.
21459 </DD>
21460
21461 <DT>LASTYEAR</DT>
21462 <DD>
21463 This token represents last year.
21464 For example, if this is 1998, it equals &quot;1997&quot;.
21465 It is possible that this
21466 could be useful when used with a Filtering Rule that
21467 has the &quot;Beginning of Year&quot; option set.
21468 </DD>
21469
21470 <DT>LASTYEAR2DIGIT</DT>
21471 <DD>
21472 This token represents last year.
21473 For example, if this is 1998, it equals &quot;97&quot;.
21474 It is always 2 digits.
21475 </DD>
21476
21477 <DT>ROLENICK</DT>
21478 <DD>
21479 This token represents the nickname of the
21480 role currently being used.  If no role is being used,
21481 then no text will be printed for this token.
21482 This token does not work with Filter Rule folder names.
21483 </DD>
21484 </DL>
21485
21486 <P>
21487 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
21488 See the help for the
21489 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
21490 to see why you might want to use this.
21491 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
21492 must be surrounded by underscores when used.
21493
21494 <DL>
21495 <DT>NEWLINE</DT>
21496 <DD>
21497 This is an end of line marker.
21498 </DD>
21499 </DL>
21500
21501 <P>
21502 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
21503
21504 <DL>
21505 <DT>CURSORPOS</DT>
21506 <DD>
21507 This token is different from the others.
21508 When it is replaced it is replaced with nothing, but it sets an Alpine
21509 internal variable that tells the composer to start with the cursor
21510 positioned at the position where this token was.
21511 If both the template file and the signature file contain
21512 a &quot;CURSORPOS&quot; token, then the position in the template file
21513 is used.
21514 If there is a template file and neither it nor the signature file contains
21515 a &quot;CURSORPOS&quot; token, then the cursor is positioned
21516 after the end of the contents of the
21517 template file when the composer starts up.
21518 </DD>
21519 </DL>
21520
21521 <P>
21522 &lt;End of help on this topic&gt;
21523 </BODY>
21524 </HTML>
21525 ======= h_reply_token_conditionals =======
21526 <HTML>
21527 <HEAD>
21528 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
21529 </HEAD>
21530 <BODY>
21531 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
21532
21533 Conditional text inclusion may be used with
21534 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
21535 in signature files, and in template files used in
21536 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
21537 It may <EM>not</EM> be used with the
21538 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
21539
21540 <P>
21541 There is a limited if-else capability for including text.
21542 The if-else condition is based
21543 on whether or not a given token would result in replacement text you
21544 specify.
21545 The syntax of this conditional inclusion is
21546 <P>
21547 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
21548 <P>
21549 The left parenthesis must follow the underscore immediately, with no
21550 intervening space.
21551 It means the token is expanded and the results of that expansion are
21552 compared against the &quot;match_this&quot; argument.
21553 If there is an exact match, then the &quot;if_matched&quot; text is used
21554 as the replacement text.
21555 Otherwise, the &quot;if_not_matched&quot; text is used.
21556 One of the most useful values for the &quot;match_this&quot; argument is
21557 the empty string, &quot;&quot;.
21558 In that case the expansion is compared against the empty string.
21559 <P>
21560 Here's an example to make it clearer.
21561 This text could be included in one of your template files:
21562 <P>
21563 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
21564 <P>
21565 If that is included in a template file that you are using while replying
21566 to a message (because you chose to use the role it was part of),
21567 and that message has a newsgroup header and a newsgroup in that header,
21568 then the text
21569 <P>
21570 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
21571 <P>
21572 will be included in the message you are about to compose.
21573 On the other hand, if the message you are replying to does not have
21574 a newsgroup, then the text
21575 <P>
21576 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
21577 <P>
21578 would be included instead.
21579 This would also work in signature files and in
21580 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
21581 If the &quot;match_this&quot;, &quot;if_matched&quot;,
21582 or &quot;if_not_matched&quot; arguments contain
21583 spaces, parentheses, or commas;
21584 they have to be quoted with double quotation marks (like in the example
21585 above).
21586 If you want to include a literal quote (&quot;) in the text you must escape the
21587 quote by preceding it with a backslash (&#92;) character.
21588 If you want to include a literal backslash character you must escape it
21589 by preceding it with another backslash.
21590 <P>
21591 The comma followed by &quot;if_not_matched&quot; is optional.
21592 If there is no &quot;if_not_matched&quot;
21593 present then no text is included if the not_matched case is true.
21594 Here's another example:
21595 <P>
21596 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
21597 <P>
21598 Here you can see that tokens may appear in the arguments.
21599 The same is true for tokens with the conditional parentheses.
21600 They may appear in arguments,
21601 though you do have to be careful to get the quoting and escaping of
21602 nested double quotes correct.
21603 If this was in the signature file being used and you were replying to a message
21604 sent to comp.mail.pine the resulting text would be:
21605 <P>
21606 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
21607 <P>
21608 If you were replying to a message that wasn't sent to any newsgroup the
21609 resulting text would be a single blank line.
21610 The reason you'd get a blank line is because the end of the line is
21611 outside of the conditional, so is always included.
21612 If you wanted to get rid of that blank line you could do so by moving
21613 the end of line inside the conditional.
21614 In other words, it's ok to have multi-line
21615 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
21616 template file.
21617 The text just continues until the next double quotation, even if it's not
21618 on the same line.
21619 <P>
21620 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
21621 <P>
21622 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
21623 <P>
21624 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
21625 while reading the newsgroup comp.mail.pine the resulting text would be:
21626 <P>
21627 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
21628 <P>
21629 If you were replying to a message while reading an email folder instead
21630 of a newsgroup the resulting leadin text would be
21631 <P>
21632 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
21633 <P>
21634 Here's one more (contrived) example illustrating a matching argument
21635 that is not the empty string.
21636 <P>
21637 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
21638 <P>
21639 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
21640 were replying to
21641 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
21642 would be
21643 <P>
21644 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
21645 <P>
21646 But if you were replying to a message sent on Oct. 27 (and that wasn't
21647 today) you would get
21648 <P>
21649 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
21650 <P>
21651
21652 &lt;End of help on this topic&gt;
21653 </BODY>
21654 </HTML>
21655 ======= h_composer_cntxt_nick =======
21656 <HTML>
21657 <HEAD>
21658 <TITLE>Collection Nickname Explained</TITLE>
21659 </HEAD>
21660 <BODY>
21661 <H1>Collection Edit Help -- Nickname Field</H1>
21662
21663 This field is provided so you can add a short nickname to use when
21664 referring to this collection within Alpine.  Spaces are allowed, and
21665 you don't need to use double-quotes.  However, the double-quote
21666 character is not allowed.
21667 <P>
21668 Look <A HREF="h_edit_nav_cmds">here</A>
21669 to see the available Editing and Navigation commands.
21670 <P>
21671 &lt;End of help on this topic&gt;
21672 </BODY>
21673 </HTML>
21674 ======= h_folder_server_syntax =======
21675 <HTML>
21676 <HEAD>
21677 <TITLE>Server Name Syntax</TITLE>
21678 </HEAD>
21679 <BODY>
21680 <H1>Server Name Syntax</H1>
21681
21682 This help describes the syntax that may be used for server names
21683 that may be associated with remote folders or SMTP servers.
21684
21685 <P>
21686 A server name is the hostname of the server.
21687 It's a good idea to use the host's fully-qualified network name.
21688
21689 <P>
21690 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
21691 <P>
21692
21693 However, IP addresses are allowed if surrounded
21694 with square-brackets.
21695
21696 <P>
21697 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
21698 <P>
21699
21700 An optional network port number may be supplied by appending
21701 a colon (:) followed by the port number
21702 to the server name.
21703 By default, the IMAP port number, 143, is used.
21704
21705 <P>
21706 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
21707 <P>
21708
21709 Besides server name and optional port number, various other optional
21710 parameters may be supplied that alter Alpine's interaction with the server.
21711 A parameter is supplied by appending a slash (/) character followed by
21712 the parameter's name and,
21713 depending on the particular parameter, the value assigned to that
21714 name, to the server name (and optional port number).
21715 Parameter names are <EM>not</EM> case sensitive.
21716 Currently supported parameters include:
21717
21718 <DL>
21719
21720 <DT>User</DT>
21721 <DD>This parameter requires an associated value, and is intended to
21722 provide the username identifier with which to establish the server
21723 connection.
21724 If your SMTP server offers SMTP AUTH authentication, adding this
21725 parameter to the
21726 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
21727 option will cause Alpine to attempt to authenticate to the server using the
21728 supplied username.
21729 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
21730 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
21731 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
21732 option (or to the server name for any folder collection using NNTP)
21733 will cause Alpine to attempt
21734 to authenticate to the server using the supplied username.
21735 An example might be:
21736
21737 <P>
21738 <CENTER><SAMP>/user=katie</SAMP></CENTER>
21739 <P>
21740
21741 </DD>
21742
21743 <DT>STARTTLS</DT>
21744 <DD>
21745 This is a unary parameter indicating communication with the server must
21746 take place over a TLS connection. If you use this parameter, Alpine will
21747 establish an insecure connection to the server, and later will attempts to
21748 use a secure encrypted connection. If the attempt to use TLS fails then
21749 this parameter will cause the connection to fail instead of falling back
21750 to an insecure connection.
21751 <P>
21752 Use this option when you are told to use STARTTLS. If you are told to use
21753 SSL or TLS on port 993, use the /ssl unary parameter instead, and not this
21754 parameter. Use this parameter when establishing a connection to a server
21755 on an insecure port (normally port 143 for IMAP) and then needing to
21756 establish a secure connection using STARTTLS.
21757
21758 <P><A href="h_security_considerations">Learn more</A> about security
21759 considerations when you use this option.
21760
21761 <P>
21762 <CENTER><SAMP>/starttls</SAMP></CENTER>
21763 <P>
21764
21765 </DD>
21766
21767 <DT>SSL</DT>
21768 <DD>
21769 This is a unary parameter indicating communication with the server should
21770 take place over a Secure Socket Layer connection.  The server must support
21771 this method, and be prepared to accept connections on the appropriate
21772 port (993 by default).
21773 Alpine must be linked with an SSL library for this option to be operational.
21774 Using this option will make Alpine try to connect to the server using the
21775 most secure encrypted SSL connection that both your version of Alpine and the
21776 server support.
21777
21778 <P>
21779 <CENTER><SAMP>/ssl</SAMP></CENTER>
21780 <P>
21781
21782 </DD>
21783
21784 <DT>TLS1</DT>
21785 <DD>
21786 This parameter indicates that the connection to the server will be made
21787 over the SSL port, but using the TLSv1 protocol, instead of the usual
21788 SSLv3 or SSLv2 protocols.
21789 Alpine must be linked with an SSL library for this option to be operational.
21790
21791 <P>
21792 <CENTER><SAMP>/tls1</SAMP></CENTER>
21793 <P>
21794 </DD>
21795
21796 <DT>TLS1_1</DT>
21797 <DD>
21798 This parameter indicates that the connection to the server will be made
21799 over the SSL port, but using the TLSv1.1 protocol.
21800 Alpine must be linked with an SSL library that supports this encryption
21801 protocol for this option to be operational.
21802
21803 <P>
21804 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
21805 <P>
21806 </DD>
21807
21808 <DT>TLS1_2</DT>
21809 <DD>
21810 This parameter indicates that the connection to the server will be made
21811 over the SSL port, but using the TLSv1.2 protocol.
21812 Alpine must be linked with an SSL library that supports this encryption
21813 protocol for this option to be operational.
21814
21815 <P>
21816 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
21817 <P>
21818 </DD>
21819
21820 <DT>TLS1_3</DT>
21821 <DD>
21822 This parameter indicates that the connection to the server will be made
21823 over the SSL port, but using the TLSv1.3 protocol.
21824 Alpine must be linked with an SSL library that supports this encryption
21825 protocol for this option to be operational.
21826
21827 <P>
21828 <CENTER><SAMP>/tls1_3</SAMP></CENTER>
21829 <P>
21830 </DD>
21831
21832 <DT>NoValidate-Cert</DT>
21833 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
21834 This is needed if the server uses self-signed certificates or if Alpine
21835 cannot validate the certificate for some other known reason. You should avoid
21836 using this option, and instead install the certificate of the server, so you
21837 are not a victim of a cracker-in-the-middle attack.
21838 <P>
21839 </DD>
21840
21841 <DT>Anonymous</DT>
21842 <DD>This is a unary parameter (that means it does not have a value)
21843 indicating that the connection be logged in as
21844 &quot;anonymous&quot; rather than a specific user.
21845 Not all servers offer anonymous
21846 access; those which do generally only offer read-only access to certain
21847 &quot;public&quot; folders.
21848
21849 <P>
21850 <CENTER><SAMP>/anonymous</SAMP></CENTER>
21851 <P>
21852
21853 </DD>
21854
21855 <DT>Secure</DT>
21856 <DD>This is a unary parameter indicating that the connection use the
21857 most secure authentication method mutually supported by Alpine and the
21858 server.
21859 Alpine is capable of authenticating connections to
21860 the server using several methods.
21861 By default, Alpine will attempt each
21862 method until either a connection is established or the
21863 list of methods is exhausted.
21864 This parameter causes Alpine to instead fail
21865 the connection if the first (generally most &quot;secure&quot;) method fails.
21866
21867 <P>
21868 <CENTER><SAMP>/secure</SAMP></CENTER>
21869 <P>
21870
21871 </DD>
21872
21873 <DT>Submit</DT>
21874 <DD>This is a unary parameter for use with the
21875 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
21876 It indicates that the connection should be made to the Submit server
21877 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
21878 (port 587) instead of the SMTP port (25).
21879 At the time this help was written the submit option was equivalent to
21880 specifying port 587. <A href="h_security_considerations">Learn more</A>
21881 about security considerations when you use this option.
21882
21883 <P>
21884 <CENTER><SAMP>/submit</SAMP></CENTER>
21885 <P>
21886 or
21887 <P>
21888 <CENTER><SAMP>host:587</SAMP></CENTER>
21889 <P>
21890
21891 </DD>
21892
21893 <DT>Debug</DT>
21894 <DD>This is a unary parameter indicating that the connection be established
21895 in a verbose mode.  Basically, it causes Alpine to log the communication with
21896 the server in Alpine's debug file.
21897 Normally, the pine -d command-line flag would be used instead.
21898 <P>
21899 </DD>
21900
21901 <DT>NoRsh</DT>
21902 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
21903 the UNIX remote shell program.
21904 Including &quot;NoRsh&quot; will cause connections to this server to skip
21905 the &quot;rsh&quot; attempt.
21906 This might be useful to avoid long timeouts caused by rsh firewalls, for
21907 example.
21908 <P>
21909 </DD>
21910
21911 <DT>Loser</DT>
21912 <DD>This option makes sense only for IMAP servers that do not perform
21913 a SEARCH command correctly. If your filtering rules
21914 fail to filter some messages, that should have been filtered, then this
21915 option will make Alpine download all data necessary data to perform that
21916 search. There is a performance penalty when using this option. Downloading
21917 the data to perform the search will take longer than requesting the IMAP
21918 server to perform the filtering, but the filtering will be done correctly.
21919 <P>
21920 </DD>
21921
21922
21923 <DT>Service</DT>
21924 <DD>This parameter requires an associated value.  The default value is
21925 &quot;IMAP&quot; which indicates communication with the server based
21926 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
21927 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
21928
21929 Other service values include:
21930  <DL>
21931  <DT>NNTP</DT>
21932  <DD>This value indicates communication with the server takes place via
21933 the Network News Transfer Protocol.  Use this to define a collection
21934 of newsgroups on a remote news server.  So
21935
21936 <P>
21937 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
21938 <P>
21939 or just
21940 <P>
21941 <CENTER><SAMP>/NNTP</SAMP></CENTER>
21942 <P>
21943
21944 is the way to specify NNTP access.
21945 <P>
21946  </DD>
21947
21948  <DT>POP3</DT>
21949  <DD>This value indicates communication with the server takes place via the
21950 Post Office Protocol 3 protocol.
21951
21952 <P>
21953 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
21954 <P>
21955 or just
21956 <P>
21957 <CENTER><SAMP>/POP3</SAMP></CENTER>
21958 <P>
21959
21960 Note that there are several important issues
21961 to consider when selecting this option:
21962 <OL>
21963  <LI> POP3 provides access to only your INBOX.  In other words,
21964 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
21965  <LI> Alpine's implementation of POP3 does not follow the traditional POP
21966 model and will leave your mail on the server. Refer to the
21967 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
21968  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
21969 </OL>
21970 </DD>
21971 </DL>
21972 </DL>
21973
21974 <P>
21975 Note that it is possible to include more than one parameter in a server
21976 specification by concatenating the parameters. For example:
21977
21978 <P>
21979 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
21980 <P>
21981
21982 <P>
21983 &lt;End of help on this topic&gt;
21984 </BODY>
21985 </HTML>
21986 ======= h_security_considerations =======
21987 <HTML>
21988 <HEAD>
21989 <TITLE>SSL, TLS, STARTTLS and More Security Considerations</TITLE>
21990 </HEAD>
21991 <BODY>
21992 <H1>SSL, TLS, STARTTLS and More Security Considerations</H1>
21993
21994 The purpose of this text is to educate users on how to best choose
21995 the type of security connection to a remote server using the SSL and TLS
21996 encryption protocols.
21997
21998 <P>
21999 In the past, and when Alpine originally started to support encrypted connections
22000 to remote servers, the /ssl modifier was needed, and it meant any of the SSLv2
22001 or SSLv3 protocols. Those encryption protocols are considered not fully secure
22002 anymore, and in fact, you might not be able to use them anymore.
22003
22004 <P> Today the /ssl modifier means to use the most secure encryption
22005 protocol between your version of Alpine and what the server supports. This
22006 might mean more modern protocols, such as TLS 1.0, TLS 1.1, etc. As of
22007 this writing, Alpine supports connection using TLS 1.3. These protocols
22008 are considered more secure today and they should be preferred over the old
22009 SSL protocols.
22010
22011 <P> A source of confusion for Alpine users might be the meaning of the
22012 modifier /tls with respect to the names of the encryption protocols, such
22013 as TLS 1.2. The meaning of /tls is to start an encrypted connection to a
22014 server after an insecure connection has been established, and we will
22015 discuss this later in this help text. The preferred way flag is to use
22016 /starttls, instead of /tls.
22017
22018 <P>The best way to start an encrypted connection to a server is to use the
22019 /ssl modifier. If your provider allows encrypted connections on port 993
22020 for IMAP, or port 995 for POP3, or in port 465 for SMTP, just define your
22021 server by adding the /ssl modifier and do not add the port to the server.
22022 Alpine knows that the secure connection will be done in the correct port,
22023 and will use the most secure encryption available between Alpine and the
22024 server. You only need to use the port number when it is different from the
22025 default port numbers for this type of connections, and those were given
22026 above.
22027
22028 <P>Most email service providers identify secure connections by saying
22029 &quot;SSL or TLS&quot;. In this case, use the /ssl modifier, and only use
22030 the port number in case it is different to the ones above.
22031
22032 <P>If your service provider says to use STARTTLS, then you need to use the
22033 /starttls modifier. If your service provider gives you the option to use SSL or
22034 TLS and to use STARTTLS choose the secure port and choose the /ssl
22035 modifier. This is because connections using the /starttls modifier can be
22036 attacked and your username and password can be stolen by a hacker. The next
22037 paragraph describes in short how to do this.
22038
22039 <P> When you use the /starttls modifier, Alpine connects insecurely to the
22040 remote server. Because the connection is insecure, it is possible that you
22041 connect to a different server, which connects you to the real server. This
22042 is called &quot;man-in-the-middle&quot; attack, and so your communication
22043 will pass through the hackers computer before it reaches the real target.
22044 An example of a possible man-in-the-middle is your internet service provider,
22045 or your employer in some instances.
22046 This means that the hacker can modify the replies from the correct server
22047 and give you the illusion of security before you are actually connected to
22048 the secure server. Therefore, you might disclose your username and
22049 password to the hacker before you establish a secure connection to the correct
22050 server.
22051
22052 <P> Therefore, if possible avoid using STARTTLS (for IMAP and POP) or SUBMIT
22053 for SMTP (in port 587), as these are subject to attack. If possible
22054 ask your provider for secure connections for SSL or TLS in the secure ports
22055 993 for IMAP, 995 for POP or 465 for SMTP.
22056
22057 <P> In the current state, even as of TLS 1.3, these protocols are considered
22058 secure but they do not protect your privacy. For example your internet
22059 service provider might track to which servers you are connecting securely.
22060 Encryption protocols are evolving to not only protect the security of your
22061 data, but also your privacy.
22062
22063 <P> Other types of errors can lead to insecure connections. An example is
22064 when the name of the server as provided by the user does not match the
22065 name of the server in the certificate.
22066 <A href="h_tls_validation_failure">Read more</A> about security errors
22067 of this type and learn how to protect yourself against this type of
22068 errors.
22069
22070 <P>
22071 &lt;End of help on this topic&gt;
22072 </BODY>
22073 </HTML>
22074 ======= h_composer_cntxt_server =======
22075 <HTML>
22076 <HEAD>
22077 <TITLE>Collection Server: Explained</TITLE>
22078 </HEAD>
22079 <BODY>
22080 <H1>Collection Edit Help -- Server Field</H1>
22081
22082 This collection's &quot;Server:&quot; definition indicates the
22083 hostname of the server providing access to the folders in this
22084 collection.
22085 The syntax of this server name is the same as for other server names used
22086 in remote folder names in
22087 Alpine and is described
22088 <A HREF="h_folder_server_syntax">here</A>.
22089
22090 <P>
22091 &lt;End of help on this topic&gt;
22092 </BODY>
22093 </HTML>
22094 ======= h_composer_cntxt_path =======
22095 <HTML>
22096 <HEAD>
22097 <TITLE>Collection Path: Explained</TITLE>
22098 </HEAD>
22099 <BODY>
22100 <H1>Collection Edit Help -- Path Field</H1>
22101
22102 The collection's &quot;Path:&quot; definition indicates the location
22103 of the folders in this collection.  If the path or any of its components
22104 do not exist, Alpine will prompt you for their creation when exiting the
22105 Add/Change screen.
22106
22107 <P>
22108 By default the path is interpreted as defining a section of your personal
22109 folder area.  This area and how you specify it are defined by the
22110 server, if one is specified in the collection, or, typically, the home
22111 directory if no server is defined.
22112
22113 <P>
22114 To define a collection outside the default &quot;area&quot;, prefix
22115 the path with the &quot;namespace&quot; to use when interpreting the
22116 given path.  If a namespace is specified, the Path begins with the
22117 sharp, &quot;#&quot;, character followed by the name of the namespace
22118 and then the namespace's path-element-delimiter.  Aside from the
22119 path's format, namespaces can also imply access rights, content
22120 policy, audience, location, and, occasionally, access methods.
22121
22122 <P>
22123 Each server exports its own set (possibly of size one) of
22124 namespaces.  Hence, it's likely communication with your server's
22125 administrator will be required for specific configurations.  Some of
22126 the more common namespaces, however, include:
22127
22128 <DL>
22129 <DT>#news.</DT>
22130 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
22131 names are hierarchically defined with each level delimited by a period.
22132 </DD>
22133 <DT>#public/</DT>
22134 <DD>This specifies a folder area that the server may export to the general
22135 public.
22136 </DD>
22137 <DT>#shared/</DT>
22138 <DD>This specifies a folder area that the folder may export to groups
22139 of users.
22140 </DD>
22141 <DT>#ftp/</DT>
22142 <DD>This specifies a folder area that is the same as that it may have
22143 exported via the &quot;File Transfer Protocol&quot;.
22144 </DD>
22145 <DT>#mh/</DT>
22146 <DD>This specifies the personal folder area associated with folders
22147 and directories that were created using the MH message handling system.
22148 </DD>
22149 </DL>
22150 <P>
22151
22152 In addition, the server may support access to other user's folders,
22153 provided you have suitable permissions.  Common methods use a prefix
22154 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
22155 indicate the root of the other user's folder area.
22156
22157 <P>
22158 No, nothing's simple.
22159
22160 <P>
22161 &lt;End of help on this topic&gt;
22162 </BODY>
22163 </HTML>
22164 ======= h_composer_cntxt_view =======
22165 <HTML>
22166 <HEAD>
22167 <TITLE>Collection View: Explained</TITLE>
22168 </HEAD>
22169 <BODY>
22170 <H1>Collection Edit Help -- View Field</H1>
22171
22172 The collection's &quot;View:&quot; definition provides a way to limit
22173 the displayed list of folders within a collection.  By default, only
22174 folders that contain the specified characters anywhere in their name
22175 are shown in the collection's folder list.
22176
22177 <P>
22178 Additionally, you can use a wildcard character to better control
22179 the list of folders selected for display.  The wildcard specifier is
22180 the star, &quot;*&quot;, character.
22181
22182 <P>
22183 So, for example, to define a collection of all folders ending with
22184 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
22185 quote characters!).  Or, similarly, to define a collection of folders
22186 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
22187 specify a view of &quot;a*z&quot;.
22188
22189 <P>
22190 &lt;End of help on this topic&gt;
22191 </BODY>
22192 </HTML>
22193 ======= h_composer_abook_add_server =======
22194 <HTML>
22195 <HEAD>
22196 <TITLE>Addressbook Server Name Field Explained</TITLE>
22197 </HEAD>
22198 <BODY>
22199 This field should be left blank if the address book is stored in a regular
22200 file on this system.  If it is a remote address book stored on an IMAP
22201 server then this is the name of that IMAP server.
22202 <P>
22203 Look <A HREF="h_edit_nav_cmds">here</A>
22204 to see the available Editing and Navigation commands.
22205 <P>
22206 &lt;End of help on this topic&gt;
22207 </BODY>
22208 </HTML>
22209 ======= h_composer_abook_add_folder =======
22210 <HTML>
22211 <HEAD>
22212 <TITLE>Addressbook Folder Name Field Explained</TITLE>
22213 </HEAD>
22214 <BODY>
22215 For a remote address book (one for which the Server Name is filled in)
22216 this is the name of a folder on the remote server. The address book data
22217 will be stored in this folder. This folder should be used only for
22218 storing this single address book, not for other address books or for
22219 other messages.
22220 <P>
22221 For a local address book (one for which the Server Name is not filled in)
22222 this is the name of a file in which the address book will be stored.
22223 The file is in the same directory as the Alpine configuration file if the
22224 configuration file is local.
22225 If the configuration file is remote, then this will be in the home directory
22226 for Unix Alpine and in the directory specified by the
22227 &quot;-aux local_directory&quot; command line argument.
22228 <P>
22229 Look <A HREF="h_edit_nav_cmds">here</A>
22230 to see the available Editing and Navigation commands.
22231 <P>
22232 &lt;End of help on this topic&gt;
22233 </BODY>
22234 </HTML>
22235 ======= h_composer_abook_add_nick =======
22236 <HTML>
22237 <HEAD>
22238 <TITLE>Addressbook NickName Field Explained</TITLE>
22239 </HEAD>
22240 <BODY>
22241 This is just an optional nickname for this address book. If present, it
22242 is used in some of the displays and error messages in the address book
22243 maintenance screens. It is for your convenience only and serves no
22244 other purpose.
22245 <P>
22246 Look <A HREF="h_edit_nav_cmds">here</A>
22247 to see the available Editing and Navigation commands.
22248 <P>
22249 &lt;End of help on this topic&gt;
22250 </BODY>
22251 </HTML>
22252 ======= h_composer_qserv_cn =======
22253 <HTML>
22254 <HEAD>
22255 <TITLE>Directory Query Form Explained</TITLE>
22256 </HEAD>
22257 <BODY>
22258
22259 Fill in as many of these fields as you wish to narrow down your
22260 search. All the fields you fill in must match in order for an entry
22261 to be returned. You may use the wildcard character &quot;*&quot; in
22262 any of the fields, it matches any zero or more characters at that
22263 point in the string. There are no implicit wildcards, so the match is
22264 exact unless you include wildcards.
22265 <P>
22266
22267 Note that if an attribute isn't present at all, then the match will fail.
22268 For example, if a server doesn't support the Locality attribute, then no
22269 matter what you put in the Locality field (other than leaving it empty)
22270 the search will fail.
22271 <P>
22272
22273 This field, the Common Name field, is typically a person's full name.
22274 <P>
22275
22276 <H1>EDITING and NAVIGATION COMMANDS</H1>
22277 <!--chtml if pinemode="function_key"-->
22278 <PRE>
22279 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
22280 ^B (Left Arrow)    Back character       | ^D       Delete current character
22281 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
22282 ^P (Up Arrow)      Previous line        |
22283 ^N (Down Arrow)    Next line            | F9       Cut marked text or
22284 ^A                 Beginning of line    |            delete current line
22285 ^E                 End of line          | F10      Undelete line(s)
22286 F7                 Previous page        |
22287 F8                 Next page            |-------------------------------------
22288 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
22289 ----------------------------------------|
22290 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
22291 F2   Cancel      |   F1    Get help     |
22292 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
22293 </PRE>
22294 <!--chtml else-->
22295 <PRE>
22296 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
22297 ^B (Left Arrow)    Back character       | ^D       Delete current character
22298 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
22299 ^P (Up Arrow)      Previous line        |
22300 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
22301 ^A                 Beginning of line    |            delete current line
22302 ^E                 End of line          | ^U       Undelete line(s)
22303 ^Y                 Previous page        |
22304 ^V                 Next page            |-------------------------------------
22305 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
22306 ----------------------------------------|
22307 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
22308 ^C   Cancel      |   ^G    Get help     |
22309 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
22310 </PRE>
22311 <!--chtml endif-->
22312 <P><UL>
22313 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22314 </UL><P>
22315 &lt;End of help on this topic&gt;
22316 </BODY>
22317 </HTML>
22318 ======= h_composer_qserv_sn =======
22319
22320 The Surname is usually the family name of a person.
22321
22322 <End of help on this topic>
22323 ======= h_composer_qserv_gn =======
22324
22325 This is the part of a person's name that isn't the surname or initials.
22326
22327 <End of help on this topic>
22328 ======= h_composer_qserv_mail =======
22329
22330 This is the email address of a person.
22331
22332 <End of help on this topic>
22333 ======= h_composer_qserv_org =======
22334
22335 This is the organization a person belongs to.
22336
22337 <End of help on this topic>
22338 ======= h_composer_qserv_unit =======
22339
22340 This is the organizational unit a person belongs to.
22341
22342 <End of help on this topic>
22343 ======= h_composer_qserv_country =======
22344
22345 This is the country a person belongs to.
22346
22347 <End of help on this topic>
22348 ======= h_composer_qserv_state =======
22349
22350 This is the state a person belongs to.
22351
22352 <End of help on this topic>
22353 ======= h_composer_qserv_locality =======
22354
22355 This is the locality a person belongs to.
22356
22357 <End of help on this topic>
22358 ======= h_composer_qserv_custom =======
22359
22360 This one is for advanced users only! If you put something in this field,
22361 then the rest of the fields are ignored.
22362
22363 This field may be set to the string representation of an LDAP search
22364 filter (see RFC1960). Here are some examples:
22365
22366 To search for an entry with a surname equal to "clinton" you could set
22367 the custom filter to:
22368
22369      (sn=clinton)
22370
22371 This is equivalent to putting "clinton" in the SurName field.
22372 To search for an entry that has a surname that begins with "clint" and
22373 has a givenname equal to "william" you could use:
22374
22375      (&(sn=clint*)(givenname=william))
22376
22377 This is equivalent to setting the SurName field to "clint*" and the
22378 GivenName field to "william".
22379 To search for an entry where either the common name OR the email address
22380 contains "abcde" you could use:
22381
22382      (|(cn=*abcde*)(mail=*abcde*))
22383
22384 That isn't equivalent to anything you can do by setting the other fields
22385 because of the OR.
22386
22387 <End of help on this topic>
22388 ======= h_composer_qserv_qq =======
22389
22390 This one is a little different from the rest of the categories.  It causes
22391 a search to be formed from the configured search filter that you filled
22392 in when you added the directory server to your configuration. It can also
22393 be combined with the other fields if you'd like.
22394
22395 <End of help on this topic>
22396 ======= h_address_format =======
22397 <HTML>
22398 <HEAD>
22399 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
22400 </HEAD>
22401 <BODY>
22402 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
22403
22404 A valid email address on the Internet has a username, an &quot;@&quot; sign,
22405 and then a domain, with no spaces.
22406 For example, jsmith@art.example.com might be the email address
22407 of a person
22408 with the username &quot;jsmith&quot; who has an account in the domain
22409 &quot;art.example.com&quot;.  The number of dot-separated segments on the
22410 right of the &quot;@&quot; sign can vary - a shorter example would be
22411 isabelle@elsewhere.edu (the shortest possible form: here, only the
22412 organization's domain is specified after the &quot;@&quot; sign); a longer
22413 example would be
22414  jsingh@shakti.edutech.example.com
22415 (here, the name of the host &quot;shakti&quot; in the domain
22416 edutech.example.com is also specified).
22417 <P>
22418 If you do not know the exact email address of someone you want to write
22419 to, ask them what it is using other means of communication than email; or
22420 use the tools for
22421 finding people's addresses that are available on the Internet.
22422 <P>
22423 If you are sending to someone on the same system as you are, you can leave
22424 the &quot;@&quot; sign and all the information to its right off of the
22425 address, and Alpine will fill it in automatically,
22426 unless the feature
22427 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
22428 <P>
22429
22430 When an email address you send a message to is not reachable -- either because
22431 it is simply an incorrect address, or because email can temporarily not be
22432 delivered to it due to a technical problem on the way to or at the recipient's
22433 end -- you will almost always get an error notification email message back.
22434 <P>
22435 If you encounter problems with, or have questions about, email delivery or
22436 email address syntax, contact your local network computing consultants.
22437 <P><UL>
22438 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22439 </UL>
22440 <P>
22441 &lt;End of help on this topic&gt;
22442 </BODY>
22443 </HTML>
22444 ======= h_flag_user_flag =======
22445 <HTML>
22446 <HEAD>
22447 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
22448 </HEAD>
22449 <BODY>
22450 <H1>STATUS FLAG: User Defined Keyword</h1>
22451
22452 This is a keyword that is defined for this folder.
22453 It was most likely defined by the owner of the folder.
22454 Alpine will not set or clear this flag on its own.
22455
22456 <P><UL>
22457 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22458 </UL><P>
22459 &lt;End of help on this topic&gt;
22460 </BODY>
22461 </HTML>
22462 ======= h_flag_important =======
22463 <html>
22464 <title>STATUS FLAG: Important</title>
22465 <body>
22466 <h1>STATUS FLAG: Important</h1>
22467
22468
22469 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
22470 MESSAGE&nbsp;INDEX
22471 screen, can only be set by the user, and is intended to be used in
22472 whatever fashion makes sense to you.  You are the only one that can set or
22473 clear it.
22474
22475 <P>
22476 &lt;End of help on this topic&gt;
22477 </BODY>
22478 </HTML>
22479 ======= h_flag_new =======
22480 <html>
22481 <title>STATUS FLAG: New</title>
22482 <body>
22483 <h1>STATUS FLAG: New</h1>
22484
22485
22486 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
22487 MESSAGE&nbsp;INDEX screen,
22488 is automatically set when messages are delivered to your Inbox (or other
22489 folder specified outside of Alpine).  Likewise, it is cleared automatically
22490 the first time you read the message it is associated with.
22491
22492 <P>
22493 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
22494 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
22495 you'd like to be reminded of it next time you read mail.  This can be done
22496 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
22497
22498
22499 <P>
22500 &lt;End of help on this topic&gt;
22501 </BODY>
22502 </HTML>
22503 ======= h_flag_answered =======
22504 <html>
22505 <title>STATUS FLAG: Answered</title>
22506 <body>
22507 <h1>STATUS FLAG: Answered</h1>
22508
22509 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
22510 MESSAGE&nbsp;INDEX
22511 screen, is automatically set when you reply to a message.  This flag is not
22512 automatically cleared.
22513
22514 <P>
22515 &lt;End of help on this topic&gt;
22516 </BODY>
22517 </HTML>
22518 ======= h_flag_forwarded =======
22519 <html>
22520 <title>STATUS FLAG: Forwarded</title>
22521 <body>
22522 <h1>STATUS FLAG: Forwarded</h1>
22523
22524 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
22525 MESSAGE&nbsp;INDEX
22526 screen, is automatically set when you forward a message.  This flag is not
22527 automatically cleared.
22528
22529 <P>
22530 &lt;End of help on this topic&gt;
22531 </BODY>
22532 </HTML>
22533 ======= h_flag_deleted =======
22534 <html>
22535 <title>STATUS FLAG: Deleted</title>
22536 <body>
22537 <h1>STATUS FLAG: Deleted</h1>
22538
22539 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
22540 MESSAGE&nbsp;INDEX
22541 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
22542 It is cleared
22543 when you use the &quot;U&nbsp;Undelete&quot; command.
22544
22545 <P>
22546 Messages marked with this flag will be permanently removed from
22547 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
22548 command, or
22549 when you indicate acceptance of their removal upon leaving the folder.
22550
22551 <P>
22552 Note, there can be other actions implicit in the
22553 &quot;D&nbsp;Delete&quot; command,
22554 such as advancing to the next message, that may be momentarily undesirable.
22555 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
22556 flag <A HREF="h_common_flag">explicitly</A>.
22557
22558 <P>
22559 &lt;End of help on this topic&gt;
22560 </BODY>
22561 </HTML>
22562 ====== h_config_incoming_timeo ======
22563 <HTML>
22564 <HEAD>
22565 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
22566 </HEAD>
22567 <BODY>
22568 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
22569
22570 This option has no effect unless the feature
22571 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22572 is set, which in turn has no effect unless
22573 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22574 is set.
22575 <P>
22576 Sets the time in seconds that Alpine will
22577 attempt to open a network connection used for monitoring for Unseen
22578 messages in Incoming Folders. The default is 5.
22579 If a connection has not completed within this many seconds Alpine will
22580 give up and consider it a failed connection.
22581 <P>
22582 <UL>
22583 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22584 </UL><P>
22585 &lt;End of help on this topic&gt;
22586 </BODY>
22587 </HTML>
22588 ====== h_config_incoming_interv ======
22589 <HTML>
22590 <HEAD>
22591 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
22592 </HEAD>
22593 <BODY>
22594 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
22595
22596 This option has no effect unless the feature
22597 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22598 is set, which in turn has no effect unless
22599 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22600 is set.
22601 <P>
22602 This option specifies, in seconds, how often Alpine will check
22603 for new mail and state changes in Incoming Folders when Incoming Folders
22604 Checking is turned on.
22605 The default is 3 minutes (180).
22606 This value applies only to folders that are local to the system that
22607 Alpine is running on or that are accessed using the IMAP protocol.
22608 The similar option
22609 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
22610 applies to all other monitored folders.
22611 <P>
22612 <UL>
22613 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22614 </UL><P>
22615 &lt;End of help on this topic&gt;
22616 </BODY>
22617 </HTML>
22618 ====== h_config_incoming_second_interv ======
22619 <HTML>
22620 <HEAD>
22621 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
22622 </HEAD>
22623 <BODY>
22624 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
22625
22626 This option has no effect unless the feature
22627 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22628 is set, which in turn has no effect unless
22629 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22630 is set.
22631 <P>
22632 This option together with the option
22633 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
22634 specifies, in seconds, how often Alpine will check
22635 for new mail and state changes in Incoming Folders when Incoming Folders
22636 Checking is turned on.
22637 The default for this option is 3 minutes (180).
22638 For folders that are local to this system or
22639 that are accessed using the IMAP protocol
22640 the value of the option
22641 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
22642 is used.
22643 For all other monitored folders, the value of this option is used.
22644 <P>
22645 The reason there are two separate options is because it is usually
22646 less expensive to check local and IMAP folders than it is to check
22647 other types, like POP or NNTP folders.
22648 You may want to set this secondary value to a higher number than
22649 the primary check interval.
22650 <P>
22651 <UL>
22652 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22653 </UL><P>
22654 &lt;End of help on this topic&gt;
22655 </BODY>
22656 </HTML>
22657 ====== h_config_incoming_list ======
22658 <HTML>
22659 <HEAD>
22660 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
22661 </HEAD>
22662 <BODY>
22663 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
22664
22665 This option has no effect unless the feature
22666 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22667 is set, which in turn has no effect unless
22668 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22669 is set.
22670 <P>
22671 When monitoring the Incoming Message Folders for Unseen messages Alpine will
22672 normally monitor all Incoming Folders.
22673 You may use this option to restrict the list of monitored folders to a
22674 subset of all Incoming Folders.
22675 <P>
22676 <UL>
22677 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22678 </UL><P>
22679 &lt;End of help on this topic&gt;
22680 </BODY>
22681 </HTML>
22682 ====== h_config_pers_name ======
22683 <HTML>
22684 <HEAD>
22685 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
22686 </HEAD>
22687 <BODY>
22688 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
22689
22690 This value is used to determine the full name part of the "From" address
22691 on messages you send.
22692 <!--chtml if pinemode="os_windows"-->
22693  PC-Alpine requires that this be set in order to properly construct the "From" address.
22694 <!--chtml else-->
22695  If unset, Unix Alpine will obtain your full name from
22696  the system password file. PC-Alpine, on the other hand, requires that this be set.
22697 <!--chtml endif-->
22698 <P>
22699 If you want to change the value of what gets included in the From header
22700 in messages you send (other than just the Personal Name)
22701 look <A HREF="h_config_change_your_from">here</A> for a description.
22702 <P><UL>
22703 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22704 </UL><P>
22705 &lt;End of help on this topic&gt;
22706 </BODY>
22707 </HTML>
22708 ====== h_config_pruned_folders ======
22709 <html>
22710 <header>
22711 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
22712 </header>
22713 <body>
22714 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
22715
22716 This variable allows you to define a list of one or more folders that
22717 Alpine will offer to prune for you in the same way it automatically offers
22718 to prune your "sent-mail" folder each month.
22719 Each folder in this list must be a folder in your default folder collection
22720 (the first folder collection if you have more than one), and it is just
22721 the relative name of the folder in the collection, not the fully-qualified name.
22722 It is similar to sent-mail.
22723 Instead of something like
22724 <P>
22725 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
22726 <P>
22727 the correct value to use would be
22728 <P>
22729 <CENTER><SAMP>folder</SAMP></CENTER>
22730 <P>
22731 There is an assumption here that your first collection is the folders in
22732 <P>
22733 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
22734 <P>
22735
22736 Once a month, for each folder listed, Alpine will offer to move
22737 the contents of the folder to a new folder of the same name but with
22738 the previous month's date appended.  Alpine will then look for any such
22739 date-appended folder names created for a previous month, and offer each
22740 one it finds for deletion.
22741 <P>
22742
22743 If you decline the first offer, no mail is moved and no new folder is
22744 created.
22745 <P>
22746
22747 The new folders will be created
22748 in your default folder collection.
22749 <P>
22750
22751 <UL>
22752 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22753 </UL><P>
22754 &lt;End of help on this topic&gt;
22755 </body>
22756 </html>
22757 ====== h_config_upload_cmd ======
22758 <HTML>
22759 <HEAD>
22760 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
22761 </HEAD>
22762 <BODY>
22763 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
22764
22765 This option affects the behavior of the Composer's &quot;Read File&quot;
22766 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
22767 commands.  It specifies
22768 a Unix program name, and any necessary command line arguments, that Alpine can
22769 use to transfer files from your personal computer into messages that you are
22770 composing.<P>
22771
22772 <B>Note:</B> this facility is intended for use with serial line transfer
22773 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22774 to work with TCP/IP file transfer programs such as ftp.<P>
22775
22776 If a program is specified, the commands listed above are modified to offer a
22777 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
22778 specified here must match the transfer program or protocol available on the
22779 personal computer.<P>
22780
22781 Alpine expects to exchange uploaded data via a file on your Unix system.  When
22782 the specified upload program finishes, Alpine expects the uploaded data to be
22783 contained in this file.<P>
22784
22785 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
22786 generates a
22787 temporary file name that it will pass to the specified Unix program.  Alpine
22788 will read the resulting uploaded text from this file and then delete it when
22789 the upload command is finished.<P>
22790
22791 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
22792 prompt
22793 you for the name of the file that is to contain the uploaded information that
22794 it is to attach.  Alpine will attach this file to the composition, but will
22795 <B>not</B> delete this file after the upload command is finished.<P>
22796
22797 The special token &quot;_FILE_&quot; may be included among the Unix program's
22798 command
22799 line arguments.  Alpine will replace this symbol with the name of the file
22800 being used to exchange the uploaded information.  This token allows you to
22801 position the file name where it is required in the Unix program's command
22802 line arguments.<P>
22803
22804 If the &quot;_FILE_&quot; token is not present in the specified command, the
22805 temporary file's name is automatically appended to the specified Unix
22806 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22807 <B>last</B> command line argument.
22808 <P><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_upload_prefix ======
22815 <HTML>
22816 <HEAD>
22817 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
22818 </HEAD>
22819 <BODY>
22820 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
22821
22822 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
22823 It defines text to be written to the terminal emulator (via standard output)
22824 immediately prior to starting upload command.  This is useful for
22825 integrated serial line file transfer agents that permit command passing
22826 (e.g., Kermit's APC method).<P>
22827
22828 The special token &quot;_FILE_&quot; may be included in the string specification.
22829 That symbol will be replaced with the (Alpine-created) name of the temporary
22830 file in which Alpine will expect to find the uploaded file.
22831 <P><UL>
22832 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22833 </UL><P>
22834 &lt;End of help on this topic&gt;
22835 </BODY>
22836 </HTML>
22837 ====== h_config_download_cmd ======
22838 <HTML>
22839 <HEAD>
22840 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
22841 </HEAD>
22842 <BODY>
22843 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
22844
22845 This option affects the behavior of the Export command.  It specifies a Unix
22846 program name, and any necessary command line arguments, that Alpine can use to
22847 transfer the exported message to your personal computer's disk.<P>
22848 Note: this facility is intended for use with serial line transfer
22849 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22850 to work with TCP/IP file transfer programs such as ftp.<P>
22851 If a program is specified, the Export command is modified to offer a
22852 subcommand (^V) to activate the transfer (in lieu of saving it to
22853  the machine where Alpine is running).  Obviously, the Unix program
22854 specified here must match the transfer program or protocol available on the
22855 personal computer.<P>
22856
22857 When this subcommand is selected and before Alpine invokes the specified Unix
22858 program, Alpine will create a temporary file containing the text of the
22859 exported message.  Alpine uses this file to pass the exported message text to
22860 the specified Unix program.<P>
22861
22862 The special token &quot;_FILE_&quot; may be included among the Unix program's command
22863 line arguments.  Alpine will replace this symbol with the temporary file's name
22864 before executing the Unix program.  This token allows you to position the
22865 file name where it is required in the Unix program's command line arguments.
22866 <P>
22867 If the &quot;_FILE_&quot; token is not present in the specified command, the
22868 temporary file's name is automatically appended to the specified Unix
22869 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22870 <B>last</B> command line argument.
22871 <P><UL>
22872 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22873 </UL><P>
22874 &lt;End of help on this topic&gt;
22875 </BODY>
22876 </HTML>
22877 ====== h_config_download_prefix ======
22878 <HTML>
22879 <HEAD>
22880 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
22881 </HEAD>
22882 <BODY>
22883 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
22884
22885 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
22886 It defines text to be written to the terminal emulator (via standard output)
22887 immediately prior to starting the download command.  This is useful for
22888 integrated serial line file transfer agents that permit command passing
22889 (e.g., Kermit's APC method).
22890 <P>
22891 The special token &quot;_FILE_&quot; may be included in the string
22892 specification.
22893 That symbol will be replaced with the (Alpine-created) name of the temporary
22894 file into which Alpine will place the message to be downloaded.
22895 <P><UL>
22896 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22897 </UL><P>
22898 &lt;End of help on this topic&gt;
22899 </BODY>
22900 </HTML>
22901 ====== h_config_mailcap_path ======
22902 <HTML>
22903 <HEAD>
22904 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
22905 </HEAD>
22906 <BODY>
22907 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
22908 This variable is used to replace Alpine's default mailcap file search path.
22909 It takes one or more file names (full paths must be specified) in which to
22910 look for mail capability data.  The default search path can be found in this
22911 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
22912 If there is more than one file name listed, list members should be delimited
22913 by
22914 <!--chtml if pinemode="os_windows"-->
22915 a semi-colon (;) under Windows; for example:<PRE>
22916         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
22917 </PRE>
22918 <!--chtml else-->
22919 a colon (:) under UNIX; for example:<PRE>
22920         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
22921 </PRE>
22922 <!--chtml endif-->
22923 <P><UL>
22924 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22925 </UL>
22926 <P>
22927 &lt;End of help on this topic&gt;
22928 </BODY>
22929 </HTML>
22930 ====== h_config_mimetype_path ======
22931 <HTML>
22932 <HEAD>
22933 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
22934 </HEAD>
22935 <BODY>
22936 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
22937
22938 This variable is used to replace Alpine's default mime.types file search path.
22939 It takes one or more file names (full paths must be specified) in which to
22940 look for file-name-extension to MIME type mapping data.  The default search
22941 path can be found in this
22942 <A HREF="h_news_config">Alpine Configuration</A> help.
22943
22944 <P>
22945
22946 If there is more than one file name listed, list members should be delimited
22947 by a colon (:) under UNIX and a semi-colon (;) under Windows.
22948 <P>
22949 &lt;End of help on this topic&gt;
22950 </BODY></HTML>
22951 ====== h_config_system_certs_path ======
22952 <HTML>
22953 <HEAD>
22954 <TITLE>OPTION: <!--#echo var="VAR_system-certs-path"--></TITLE>
22955 </HEAD>
22956 <BODY>
22957 <H1>OPTION: <!--#echo var="VAR_system-certs-path"--></H1>
22958
22959 When Alpine is built to support secure connections to remote servers, a directory
22960 must be reserved in the system to store certificates that will be used to validate
22961 remote servers. This is normally configured at the time that Alpine is built, but
22962 there might be circumstances under which a user might want to use a different
22963 directory. For example, the directory might not be accessible, or has not been
22964 updated and contains old certificates that have expired.
22965
22966 <P>
22967 This variable can be used to list
22968 the directory where such certificates can be found. Alpine will use the first
22969 directory in this list that exists in your system and can be accessed. This
22970 allows for users to be able to use the same pinerc file in different systems.
22971
22972 <P>
22973 Example of values for this option might be:
22974
22975 <PRE>
22976 System CACerts Dir = /etc/ssl/certs
22977                      /usr/local/ssl/certs
22978                      C:\\libressl\\ssl\\certs
22979 <PRE>
22980
22981 <P>
22982 In unix systems, the default location of the certificates for openssl can
22983 be obtained by first executing the command
22984
22985 <PRE>openssl version -d</PRE>
22986
22987 and adding &quot;/certs&quot; to that value. In Windows the default location
22988 for the certificates is C:\\libressl\\ssl\\certs. This value was set by
22989 LibreSSL developers, and this option can be used to override this default.
22990
22991 <P>
22992 &lt;End of help on this topic&gt;
22993 </BODY></HTML>
22994 ====== h_config_system_certs_file ======
22995 <HTML>
22996 <HEAD>
22997 <TITLE>OPTION: <!--#echo var="VAR_system-certs-file"--></TITLE>
22998 </HEAD>
22999 <BODY>
23000 <H1>OPTION: <!--#echo var="VAR_system-certs-file"--></H1>
23001
23002 This option sets the location of the container file that holds
23003 certificate authority (CA) certificates.
23004 Alpine will use the first
23005 container in this list that exists in your system and can be accessed. This
23006 allows for users to be able to use the same pinerc file in different systems.
23007
23008 <P>
23009 Example of values for this option might be:
23010
23011 <PRE>
23012 System CACerts File = /etc/ssl/certs/cert.pem
23013                       /usr/local/ssl/ca-root-nss.crt
23014                       C:\\libressl\\ssl\\certs\\cert.pem
23015 <PRE>
23016
23017 <P>
23018 In unix systems, the default location of the certificates for openssl can
23019 be obtained by first executing the command
23020
23021 <PRE>openssl version -d</PRE>
23022
23023 and adding &quot;/certs&quot; to that value. In Windows the default location
23024 for the certificates is C:\\libressl\\ssl\\certs\\cert.pem. This value was set
23025 by LibreSSL developers, and this option can be used to override this default.
23026
23027 <P>
23028 &lt;End of help on this topic&gt;
23029 </BODY></HTML>
23030 ====== h_config_user_certs_path ======
23031 <HTML>
23032 <HEAD>
23033 <TITLE>OPTION: <!--#echo var="VAR_user-certs-path"--></TITLE>
23034 </HEAD>
23035 <BODY>
23036 <H1>OPTION: <!--#echo var="VAR_user-certs-path"--></H1>
23037
23038 (UNIX ALPINE ONLY)
23039 This directory is used by Alpine to store certificates that a user
23040 trusts. Alpine will use the first directory in this list that exists in your
23041 system and can be accessed. This allows for users to be able to
23042 use the same pinerc file in different systems. The default location
23043 is ~/.alpine-certs.
23044
23045 <P>
23046 In addition to the certificates stored in this directory, Alpine also
23047 trusts certificates saved in the container file referenced in the
23048 configuration variable
23049 <A HREF="h_config_user_certs_file"><!--#echo var="VAR_user-certs-file"--></A>.
23050
23051 <P>
23052 Example of values for this option might be:
23053
23054 <PRE>
23055 User Certs Dir = /home/fred/.alpine-certs
23056                  C:\\Users\\Admin\\alpine-certs
23057 <PRE>
23058
23059 <P>
23060 &lt;End of help on this topic&gt;
23061 </BODY></HTML>
23062 ====== h_config_user_certs_file ======
23063 <HTML>
23064 <HEAD>
23065 <TITLE>OPTION: <!--#echo var="VAR_user-certs-file"--></TITLE>
23066 </HEAD>
23067 <BODY>
23068 <H1>OPTION: <!--#echo var="VAR_user-certs-file"--></H1>
23069
23070 (UNIX ALPINE ONLY)
23071 This option sets the location of a container file that holds certificate
23072 authority (CA) certificates that the user trusts. Its value is the
23073 full path referencing the location of this file. Alpine will use the first
23074 container in this list that exists and can be accessed in your system. This
23075 allows for users to be able to use the same pinerc file in different
23076 systems. The default location is ~/.alpine-certs/certs.pem.
23077
23078 <P>
23079 In addition to the certificates stored in this directory, Alpine also
23080 trusts certificates saved in the directory referenced in the
23081 configuration variable
23082 <A HREF="h_config_user_certs_path"><!--#echo var="VAR_user-certs-path"--></A>.
23083
23084 <P>
23085 Example of values for this option might be:
23086
23087 <PRE>
23088 User Certs File = /home/fred/.alpine-certs/certs.pem
23089                   C:\\libressl\\ssl\\certs\\cert.pem
23090 <PRE>
23091
23092 <P>
23093 &lt;End of help on this topic&gt;
23094 </BODY></HTML>
23095 ====== h_config_ssl_ciphers ======
23096 <HTML>
23097 <HEAD>
23098 <TITLE>OPTION: <!--#echo var="VAR_ssl-ciphers"--></TITLE>
23099 </HEAD>
23100 <BODY>
23101 <H1>OPTION: <!--#echo var="VAR_ssl-ciphers"--></H1>
23102
23103 (UNIX ALPINE ONLY)
23104 This is a colon separated list of ciphers that your openssl or libressl
23105 library supports and should use to negotiate a secure connection with a
23106 remote SSL server.
23107
23108 <P>
23109 The list of ciphers supported by openssl can be obtained with the command
23110 line command
23111
23112 <P>
23113 openssl ciphers
23114
23115 <P>
23116 Consult the manual page of the openssl ciphers command to see more
23117 ways to specify groups of ciphers, such as RSA, or other groups of
23118 ciphers.
23119
23120 <P>
23121 &lt;End of help on this topic&gt;
23122 </BODY></HTML>
23123 ====== h_config_set_att_ansi ======
23124 <HTML><HEAD>
23125 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
23126 </HEAD>
23127 <BODY>
23128 <H1>OPTION: Set printer to attached ansi printer</H1>
23129
23130 Type "S" to set your printer to "attached-to-ansi".<BR>
23131 It is OK to include "attached-to-ansi" in your personal list below.
23132 <P>
23133 &lt;End of help on this topic&gt;
23134 </BODY></HTML>
23135 ====== h_config_set_att_ansi2 ======
23136 <HTML><HEAD>
23137 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
23138 </HEAD>
23139 <BODY>
23140 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
23141
23142 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
23143 It is OK to include "attached-to-ansi-no-formfeed" in your personal
23144 list below.
23145
23146 <P>
23147
23148 This is the same as the "attached-to-ansi" option except that a
23149 formfeed character will not be appended to the end of the print job.
23150 If your printer already ejects the paper by itself at the end of the
23151 job, you may prefer the "no-formfeed" form of this printer so that you
23152 don't get an extra blank page between print jobs.
23153 <P>
23154
23155 &lt;End of help on this topic&gt;
23156 </BODY></HTML>
23157 ====== h_config_set_att_wyse ======
23158 <HTML><HEAD>
23159 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
23160 </HEAD>
23161 <BODY>
23162 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
23163
23164 Type "S" to set your printer to "attached-to-wyse".<BR>
23165 It is OK to include "attached-to-wyse" in your personal list below.
23166 <P>
23167 This is very similar to "attached-to-ansi".
23168 The only difference is in the control characters sent to turn the printer
23169 on and off.
23170 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
23171 to turn on the printer and ESC LEFT_BRACKET 4 i
23172 to turn it off.
23173 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
23174 &lt;End of help on this topic&gt;
23175 </BODY></HTML>
23176 ====== h_config_set_att_wyse2 ======
23177 <HTML><HEAD>
23178 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
23179 </HEAD>
23180 <BODY>
23181 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
23182
23183 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
23184 It is OK to include "attached-to-wyse-no-formfeed" in your personal
23185 list below.
23186
23187 <P>
23188
23189 This is the same as the "attached-to-wyse" option except that a
23190 formfeed character will not be appended to the end of the print job.
23191 If your printer already ejects the paper by itself at the end of the
23192 job, you may prefer the "no-formfeed" form of this printer so that you
23193 don't get an extra blank page between print jobs.
23194 <P>
23195
23196 &lt;End of help on this topic&gt;
23197 </BODY></HTML>
23198 ====== h_config_set_stand_print ======
23199 <HTML>
23200 <HEAD>
23201 <TITLE>OPTION: Set default printer</TITLE>
23202 </HEAD>
23203 <H1>OPTION: Set default printer</H1>
23204 <BODY>
23205 Move to the printer you want and type "S" to set it to be your
23206 default printer.  This list is not modifiable by you and has been
23207 set up by the system administrators.  If there is more than one printer
23208 listed in the Command List, you will be able to cycle through that
23209 whole list at the time you print, starting with your default.
23210 It is OK to include entries from this Standard list in your personal
23211 list below.
23212 <P>
23213 &lt;End of help on this topic&gt;
23214 </BODY>
23215 </HTML>
23216 ====== h_config_set_custom_print ======
23217 <HTML>
23218 <HEAD>
23219 <TITLE>OPTION: Set default printer</TITLE>
23220 </HEAD>
23221 <H1>OPTION: Set default printer</H1>
23222 <BODY>
23223 You may add as many print commands as you want to your personal list.
23224 Specify one of them as your default printer by moving to the printer
23225 you want and typing "S".  If there is more than one printer listed
23226 in the Command List, you will be able to cycle through that list at
23227 the time you print, starting with your default.  It is OK to include
23228 entries from the Standard list above or to include the command
23229 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
23230 "attached-to-wyse-no-formfeed" as one of the entries here.
23231 <P>
23232 &lt;End of help on this topic&gt;
23233 </BODY>
23234 </HTML>
23235 ====== h_config_user_id =====
23236 <HTML>
23237 <HEAD>
23238 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
23239 </HEAD>
23240 <BODY>
23241 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
23242
23243 This value is used as part of the "From" address on messages you send.
23244 It is also the default login name for remote IMAP server access.  Set this
23245 to the username part you want to appear on outgoing email.
23246 <P>
23247 If you want to change the value of what gets included in the From header
23248 in messages you send (other than just the User ID)
23249 look <A HREF="h_config_change_your_from">here</A> for a description.
23250
23251 <P><UL>
23252 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23253 </UL><P>
23254 &lt;End of help on this topic&gt;
23255 </BODY>
23256 </HTML>
23257 ====== h_config_user_dom =====
23258 <HTML>
23259 <HEAD>
23260 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
23261 </HEAD>
23262 <BODY>
23263 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
23264
23265 This value specifies the domain part (right-hand side) of your return
23266 address on outgoing email and is also used as the default domain for email
23267 composed to a local user.
23268 <!--chtml if pinemode="os_windows"-->
23269  This value is required for PC-Alpine. If you are unsure as to what this should be,
23270  contact your local help desk, system administrator, or Internet Service Provider.
23271 <!--chtml else-->
23272  If unset, Unix Alpine will obtain the domain from
23273  the system.  Often this value will be set for your whole site by the
23274  system administrator.<P>
23275 <!--chtml endif-->
23276 If you set this, see also the <A HREF="h_config_quell_local_lookup">
23277 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
23278 <P>
23279 If you want to change the value of what gets included in the From header
23280 in messages you send (other than just the User Domain)
23281 look <A HREF="h_config_change_your_from">here</A> for a description.
23282 <P><UL>
23283 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23284 </UL><P>
23285 &lt;End of help on this topic&gt;
23286 </BODY>
23287 </HTML>
23288 ====== h_config_smtp_server =====
23289 <HTML>
23290 <HEAD>
23291 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
23292 </HEAD>
23293 <BODY>
23294 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
23295 This value specifies the name of one or more SMTP
23296 (Simple Mail Transfer Protocol) servers for sending mail.
23297 <!--chtml if pinemode="os_windows"-->
23298 You must have an SMTP server for use with PC-Alpine.
23299 SMTP servers are
23300 normally set up by a system administrator for use by all members of a given
23301 campus or department.
23302 Contact your local help desk to ask what SMTP
23303 servers you should use.
23304 <!--chtml else-->
23305 Unix Alpine users may not need to set an SMTP server.
23306 Alpine will attempt to execute the program (usually sendmail) that is used
23307 to insert mail into the mail system.
23308 If this works for you, you may leave this option blank.
23309 If there is an SMTP server running on the Unix host you may be able to
23310 improve sending performance slightly by setting the SMTP server option
23311 to &quot;localhost&quot; or to the actual name of the Unix host.
23312 <P>
23313 If the Unix host doesn't work the way Alpine was expecting you will need to
23314 set the value of this option.
23315 SMTP servers are
23316 normally set up by a system administrator for use by all members of a given
23317 campus or department.
23318 Contact your local help desk to ask what SMTP
23319 servers you should use.
23320 <!--chtml endif-->
23321 <P>
23322 Your SMTP server may offer SMTP AUTH authentication.
23323 It may even require it.
23324 If your SMTP server offers SMTP AUTH authentication you may specify a
23325 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
23326 This parameter requires an associated value,
23327 the username identifier with which to establish the server
23328 connection.
23329 An example might be:
23330
23331 <P>
23332 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
23333 <P>
23334
23335 If AUTH authentication is offered by the server, this will cause Alpine to
23336 attempt to use it.
23337 If AUTH authentication is not offered by the server, this will cause Alpine
23338 to fail sending with an error similar to:
23339
23340 <P>
23341 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
23342 <P>
23343
23344 Another type of authentication that is used by some ISPs is called
23345 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
23346 which means that you have to authenticate
23347 yourself to the POP or IMAP server by opening a mailbox before you
23348 can send mail.
23349 To do this, you usually only have to open your INBOX.
23350
23351 <P>
23352 You may tell Alpine to use the
23353 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
23354 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
23355 parameter
23356 in this option.
23357 At this time &quot;/submit&quot; is simply equivalent to specifying
23358 port 587, though it may imply more than that at some point in the future.
23359 Some ISPs are blocking port 25 in order to reduce the amount of spam
23360 being sent to their users.
23361 You may find that the submit option allows you to get around such a block.
23362
23363 <P>
23364 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
23365 <P>
23366
23367 To specify any non-standard port number on the SMTP server you may follow
23368 the hostname with a colon followed by the portnumber.
23369
23370 <P>
23371 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
23372 <P>
23373
23374 Normally, when a connection is made to the Smtp-Server Alpine will attempt
23375 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
23376 If that fails then a non-encrypted connection will be attempted instead.
23377 You may specify that a TLS connection is required if you wish.
23378 If you append &quot;/starttls&quot; to the name then the connection will fail
23379 instead of falling back to a non-secure connection.
23380
23381 <P>
23382 <CENTER><SAMP>smtpserver.example.com/starttls</SAMP></CENTER>
23383 <P>
23384
23385
23386 For more details about server name possibilities see
23387 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
23388 <P>
23389
23390 <UL>
23391 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23392 </UL>
23393 <P>
23394 &lt;End of help on this topic&gt;
23395 </BODY>
23396 </HTML>
23397 ====== h_config_nntp_server =====
23398 <HTML>
23399 <HEAD>
23400 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
23401 <BODY>
23402 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
23403
23404 This value specifies the name of one or more NNTP
23405 (Network News Transfer Protocol)
23406 servers for reading and posting USENET news.
23407 NNTP servers are normally
23408 set up by a system administrator for use by all members of a given campus
23409 or department.
23410 Contact your local help desk to ask what NNTP servers you should use.
23411 <!--chtml if pinemode="os_windows"--><!--chtml else-->
23412 Often Unix Alpine users will find that this variable has been
23413 set for the whole system (and they don't have to worry about it).
23414 <!--chtml endif-->
23415 When you define an NNTP server here, Alpine implicitly defines a news
23416 collection for you, assuming that server as the news server and assuming
23417 that you will use the NNTP protocol and a local newsrc configuration file
23418 for reading news.
23419 For more about reading news with Alpine, see
23420 <A HREF="h_reading_news">how to use Alpine to read news</A>.
23421 <P>
23422 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
23423 or &quot;AUTHINFO USER&quot; authentication.
23424 It may even require it.
23425 If your NNTP server does offer such authentication you may specify a user name
23426 parameter to cause Alpine to attempt to authenticate.
23427 The same is true for the server name in a folder collection that uses NNTP.
23428 This parameter requires an associated value,
23429 the username identifier with which to establish the server connection.
23430 An example might be:
23431
23432 <P>
23433 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
23434 <P>
23435
23436 If authentication is offered by the server, this will cause Alpine to
23437 attempt to use it.
23438 If authentication is not offered by the server, this will cause Alpine
23439 to fail with an error similar to:
23440
23441 <P>
23442 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
23443 <P>
23444 For more details about the server name possibilities see
23445 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
23446 <P><UL>
23447 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23448 </UL><P>
23449 &lt;End of help on this topic&gt;
23450 </BODY>
23451 </HTML>
23452 ====== h_config_inbox_path =====
23453 <HTML>
23454 <HEAD>
23455 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
23456 </HEAD>
23457 <BODY>
23458 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
23459
23460 This value overrides the default value of your INBOX name/path/location.
23461 <!--chtml if pinemode="os_windows"-->
23462 PC-Alpine users must specify an inbox path and it must be a folder on an
23463 IMAP server.
23464 <!--chtml else-->
23465 Unix and VMS Alpine users will often find that this variable
23466 has been pre-configured by your system administrator.
23467 <!--chtml endif-->
23468 You may be able to specify an alternate INBOX that is either a local folder
23469 or a folder on an IMAP server.
23470 <P>
23471 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
23472 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
23473 mail server.
23474 <P>
23475 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23476 details on the syntax of folder definitions.
23477 <P>
23478 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
23479 mail is disappearing.
23480 <P><UL>
23481 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23482 </UL><P>
23483 &lt;End of help on this topic&gt;
23484 </BODY>
23485 </HTML>
23486 ====== h_config_change_your_from =====
23487 <HTML>
23488 <HEAD>
23489 <TITLE>How to Change your From Address</TITLE>
23490 </HEAD>
23491 <BODY>
23492 <H1>How to Change your From Address</H1>
23493
23494 If the From address that Alpine includes in mail that you send is not correct,
23495 you may want to configure a different default value for the From address.
23496 You may follow these directions to change the default:
23497
23498 <P>
23499 <UL>
23500   <LI> Go to the Main Alpine Menu
23501   <LI> From there type the Setup Command
23502   <LI> From there type the Config Command
23503 </UL>
23504
23505 <P>
23506 You've probably already seen this SETUP CONFIGURATION screen.
23507 If not, there are many options you may want to set here.
23508 To set the value of the From header you may use the
23509 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
23510 Find it by scrolling down a few pages or use the WhereIs command to
23511 search for &quot;customized&quot;.
23512 You may want to read the help text associated with the option.
23513 <P>
23514 To add a custom From header, type the Add command and enter the
23515 full header line, including the leading &quot;From:&nbsp;&quot;.
23516 For example:
23517 <P>
23518 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
23519 <P>
23520 Now exit the Setup command and try sending mail to yourself to see
23521 what the From line looks like.
23522 <P>
23523 When you are in the composer you may edit the custom From line by typing
23524 Ctrl-R while your cursor is in the headers of the message and then moving
23525 to the From line and editing.
23526 If you want to leave the default value the same but add the possibility
23527 of being able to edit the header when you compose, add just the header
23528 name without a value.
23529 For example:
23530 <P>
23531 <CENTER><SAMP>From:</SAMP></CENTER>
23532 <P>
23533 If you change your From address you may also find it useful to add the
23534 changed From address to the
23535 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
23536 configuration option.
23537 <P>
23538 <UL>
23539 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23540 </UL><P>
23541 &lt;End of help on this topic&gt;
23542 </BODY>
23543 </HTML>
23544 ====== h_config_default_fcc =====
23545 <HTML>
23546 <HEAD>
23547 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
23548 </HEAD>
23549 <BODY>
23550 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
23551
23552 This value specifies where a copy of outgoing mail should be saved.  If
23553 this is not a path name, it will be in the default collection for saves.
23554 Any valid folder specification, local or IMAP, is allowed.  This default
23555 folder carbon copy only applies when the
23556 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
23557 is set to use the default folder.
23558 <!--chtml if pinemode="os_windows"-->
23559 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
23560 <!--chtml else-->
23561 Unix Alpine default
23562 is normally &quot;sent-mail&quot; in the default folder collection.
23563 <!--chtml endif-->
23564 <P>
23565 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
23566 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
23567 IMAP server (remember that in order to later access this remote folder through Alpine, it
23568 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
23569 for more information). An example:<p>
23570 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
23571 <P>
23572 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
23573 <P>
23574 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23575 details on the syntax of folder definitions.
23576 <P>
23577 <UL>
23578 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23579 </UL><P>
23580 &lt;End of help on this topic&gt;
23581 </BODY>
23582 </HTML>
23583 ====== h_config_def_save_folder =====
23584 <HTML>
23585 <HEAD>
23586 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
23587 </HEAD>
23588 <BODY>
23589 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
23590
23591 This option determines the default folder name for save-message operations
23592 (&quot;saves&quot;).
23593 <P>
23594 If this is not a path name, it will be in the default collection for saves.
23595 Any valid folder specification, local or IMAP, is allowed.  This default
23596 folder only applies when the
23597 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
23598 doesn't override it.
23599 <!--chtml if pinemode="os_windows"-->
23600 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
23601 <!--chtml else-->
23602 Unix Alpine default
23603 is normally &quot;saved-messages&quot; in the default folder collection.
23604 <!--chtml endif-->
23605 If you access your email through an IMAP server, especially if you often switch between Unix
23606 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
23607 IMAP server (remember that in order to later access this remote folder through Alpine, it
23608 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
23609 for more information). An example:<p>
23610 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
23611 <P>
23612 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23613 details on the syntax of folder definitions.
23614 <P>
23615 <UL>
23616 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23617 </UL><P>
23618 &lt;End of help on this topic&gt;
23619 </BODY>
23620 </HTML>
23621 ====== h_config_postponed_folder =====
23622 <HTML>
23623 <HEAD>
23624 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
23625 </HEAD>
23626 <BODY>
23627 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
23628
23629 This value overrides the default name for the folder where postponed
23630 messages are saved.  If this is not a path name, it will be in the default
23631 collection for message Saves.  Any valid folder specification, local or
23632 remote, is allowed.
23633 PC-Alpine default
23634 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
23635 The Unix Alpine default is normally &quot;postponed-msgs&quot;
23636 in the default collection.
23637 <P>
23638 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
23639 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
23640 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
23641 in all Alpine copies you use.
23642 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
23643 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
23644 for more information). An
23645 example:<p>
23646 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
23647 <P>
23648 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23649 details on the syntax of folder definitions.
23650 <P>
23651 <UL>
23652 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23653 </UL><P>
23654 &lt;End of help on this topic&gt;
23655 </BODY>
23656 </HTML>
23657 ====== h_config_read_message_folder =====
23658 <HTML>
23659 <HEAD>
23660 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
23661 </HEAD>
23662 <BODY>
23663 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
23664
23665 By virtue of specifying a folder name here, Alpine will be configured to
23666 save all messages that you have read during a session into the designated
23667 &quot;read messages&quot; folder.  This allows you to more easily distinguish
23668 between your really new email (in your INBOX) and those that you have
23669 already read.  Depending on how you define the
23670 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
23671 setting, you may or may not be asked when you quit
23672 Alpine if you want read messages to be moved to this folder.  In either
23673 case, moving the messages means they will be deleted from your INBOX.
23674 <P>
23675 If this is not a path name, it will be in the default collection for
23676 saves.  Any valid folder specification, local or remote (via IMAP), is
23677 allowed.  There is no default for the name of the read message folder.
23678 <P>
23679 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23680 details on the syntax of folder definitions.
23681 <P>
23682 <UL>
23683 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23684 </UL><P>
23685 &lt;End of help on this topic&gt;
23686 </BODY>
23687 </HTML>
23688 ====== h_config_form_folder =====
23689 <HTML>
23690 <HEAD>
23691 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
23692 </HEAD>
23693 <BODY>
23694 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
23695
23696 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
23697 contain messages that you have composed and that are intended to be
23698 sent in their original form repeatedly.
23699
23700 <P>
23701 Setting this variable will alter Alpine's usual behavior when you
23702 execute the Compose command.  Normally, Alpine offers a chance to
23703 continue a postponed or interrupted message should one or the other
23704 exist.  When this variable is set to a folder name that exists, Alpine
23705 will also offer the chance to select a message from the folder to
23706 insert into the composer (much like when continuing a postponed message).
23707 The difference, however, is that Alpine will not automatically delete
23708 the selected message from the Form Letter Folder.
23709 <P>
23710 Setting this variable will also affect Alpine's behavior when you
23711 Postpone a message from the composer.  Normally, Alpine simply stashes
23712 the message away in your
23713 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
23714 Regardless of the specified folder's existence, Alpine will ask which
23715 folder you intend the message to be stored in.  Choose the
23716 &quot;F&quot; option to store the message in your Form Letter Folder.
23717 This is the most common way to add a message to the folder.
23718
23719 <P>
23720 Another method of adding messages to the folder is via the Alpine
23721 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
23722 you expect to send in the same form again, you can enter the Form
23723 Letter Folder's name in this field.  Alpine, as usual, will copy the
23724 message as it's sent.  Note, when you later select this message from
23725 your Form Letter Folder, it will have the same recipients as the original
23726 message.
23727
23728 <P>
23729 To delete a message from the Form Letter Folder, you can either select
23730 the folder from a suitable FOLDER LIST screen, or use the Delete
23731 command in the MESSAGE INDEX offered when selecting from the folder as
23732 part of the Compose command.  You can delete a Form Letter Folder just
23733 as any other folder from a suitable FOLDER LIST screen.
23734
23735 <P>
23736 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
23737 facility can be used
23738 to replace the Form Letter Folder.
23739
23740 <P>
23741 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23742 details on the syntax of folder definitions.
23743
23744 <P>
23745 <UL>
23746 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23747 </UL><P>
23748 &lt;End of help on this topic&gt;
23749 </BODY>
23750 </HTML>
23751 ====== h_config_archived_folders =====
23752 <HTML>
23753 <HEAD>
23754 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
23755 </HEAD>
23756 <BODY>
23757 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
23758
23759 This is like
23760 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
23761 only more general.  You may archive
23762 any of the folders in your incoming collection.  This is a list of folder
23763 pairs, with the first separated from the second in the pair by a space.
23764 The first folder in a pair is the folder you want to archive, and the
23765 second folder is the folder that read messages from the first should be
23766 moved to.  Depending on how you define the
23767 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
23768 setting, you may or may not be asked when you
23769 leave the first folder if you want read messages to be moved to the
23770 second folder.  In either case, moving the messages means they will be
23771 deleted from the first folder.
23772 <P>
23773 The name of the first folder in each pair can be either the technical
23774 specification of the folder (like what appears in your configuration file)
23775 or (much easier) the nickname that you gave the folder when you made it
23776 an incoming folder.
23777 <p>
23778 For example:<p>
23779 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
23780 <p>or, using nicknames:<p>
23781 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
23782 <P>
23783 If these are not path names, they will be in the default collection for
23784 saves. Any valid folder specification, local or remote (via IMAP), is
23785 allowed. There is no default.
23786 <P>
23787 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23788 details on the syntax of folder definitions.
23789 <P>
23790 <UL>
23791 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23792 </UL><P>
23793 &lt;End of help on this topic&gt;
23794 </BODY>
23795 </HTML>
23796 ====== h_config_newsrc_path ======
23797 <HTML>
23798 <HEAD>
23799 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
23800 </HEAD>
23801 <BODY>
23802 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
23803
23804 This option overrides the default name Alpine uses for your "newsrc" news
23805 status and subscription file.  If set, Alpine will take this value as the
23806 full pathname for the desired newsrc file.<P>
23807
23808 If this option is <B>not</B> set,
23809 <!--chtml if pinemode="os_windows"-->
23810 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
23811 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
23812 directory as your pinerc file for NEWSRC.
23813 <!--chtml else-->
23814 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
23815 your account's home directory).
23816 <!--chtml endif-->
23817 <P><UL>
23818 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23819 </UL>
23820 <P>
23821 &lt;End of help on this topic&gt;
23822 </BODY>
23823 </HTML>
23824 ====== h_config_literal_sig =====
23825 <HTML>
23826 <HEAD>
23827 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
23828 </HEAD>
23829 <BODY>
23830 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
23831
23832 With this option your actual signature, as opposed to
23833 the name of a file containing your signature,
23834 is stored in the Alpine configuration file.
23835 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
23836 <P>
23837
23838 This is simply a different way to store the signature.
23839 The signature is stored inside your Alpine configuration file instead of in
23840 a separate file.
23841 Tokens work the same way they do with the
23842 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
23843 help.
23844 <P>
23845
23846 The Setup/Signature command on Alpine's MAIN MENU will edit
23847 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
23848 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
23849 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
23850 instead.
23851 <P>
23852
23853 The two character sequence &#92;n (backslash followed by
23854 the character n) will be used to signify a line-break in your signature.
23855 You don't have to enter the &#92;n, but it will be visible in the
23856 SETUP CONFIGURATION window after you are done editing the signature.
23857
23858 <P>
23859 <UL>
23860 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23861 </UL><P>
23862 &lt;End of help on this topic&gt;
23863 </BODY>
23864 </HTML>
23865 ====== h_config_signature_file =====
23866 <HTML>
23867 <HEAD>
23868 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
23869 </HEAD>
23870 <BODY>
23871 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
23872
23873 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
23874 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
23875 You can tell that that is the case because the value of the
23876 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
23877 <P>
23878 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
23879 <P>
23880 You may either use all Literal Signatures (signatures stored in your
23881 configuration file) throughout Alpine, or all signature files.
23882 You can't mix the two.
23883 <P>
23884 This is the name of a file that will be automatically inserted into
23885 outgoing messages.
23886 It typically contains information such as your
23887 name, email address and organizational affiliation.
23888 Alpine adds the
23889 signature into the message as soon as you enter the composer so you
23890 can choose to remove it or edit it on a message by message basis.
23891 Signature file placement in message replies is controlled by the
23892 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
23893 setting in the feature list.
23894 <P>
23895
23896 The default file name is
23897 <!--chtml if pinemode="os_windows"-->
23898 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
23899 PINERC file is a local file.
23900 If your PINERC file is remote, then it will be in the directory specified
23901 by the &quot;-aux local_directory&quot; command line option.
23902 <!--chtml else-->
23903 &quot;.signature&quot;.
23904 <!--chtml endif-->
23905 <P>
23906
23907 To create or edit your signature file choose Setup from the MAIN MENU
23908 and then select S for Signature (Main/Setup/Signature).  This puts you
23909 into the Signature Editor where you can enter a <EM>few</EM> lines of
23910 text containing your identity and affiliation.
23911
23912 <P>
23913 If the filename is followed by a vertical bar (|) then instead
23914 of reading the contents of the file the file is assumed to be a
23915 program that will produce the text to be used on its standard output.
23916 The program can't have any arguments and doesn't receive any input from Alpine,
23917 but the rest of the processing works as if the contents came from a file.
23918
23919 <P>
23920 Instead of storing the data in a local file, the
23921 signature data may be stored remotely in an IMAP folder.
23922 In order to do this,
23923 you must use a remote name for the file.
23924 A remote <!--#echo var="VAR_signature-file"--> name might look like:
23925 <P>
23926 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
23927 <P>
23928
23929 The syntax used here is the same as the syntax used for remote configuration
23930 files from the command line.
23931 Note that you may not access an existing signature file remotely,
23932 you have to create a new <EM>folder</EM> that contains the signature data.
23933 If the name you use here for the signature file is a remote name, then when
23934 you edit the file from the Setup/Signature command the data will be stored
23935 remotely in the folder.
23936 You aren't required to do anything special to create the folder, it
23937 gets created automatically if you use a remote name.
23938
23939 <P>
23940 Besides regular text, the signature file may also contain
23941 (or a signature program may produce) tokens that
23942 are replaced with text that usually depends on the message you are replying
23943 to or forwarding.
23944 For example, if the signature file contains the token
23945 <P>
23946 <CENTER><SAMP>_DATE_</SAMP></CENTER>
23947 <P>
23948 anywhere in the text, then that token is replaced by the date
23949 the message you are replying to or forwarding was sent.
23950 If it contains
23951 <P>
23952 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
23953 <P>
23954 that is replaced with the current date.
23955 The first is an example of a token that depends on the message you
23956 are replying to (or forwarding) and the second is an example which
23957 doesn't depend on anything other than the current date.
23958 You have to be a little careful with this facility since tokens that
23959 depend on the message you are replying to or forwarding will be replaced
23960 by nothing in the case where you are composing a new message from scratch.
23961 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
23962 in this respect.
23963 It allows you to use different signature files in different cases.
23964 <P>
23965
23966 The list of tokens available for use in the signature file is
23967 <A HREF="h_index_tokens">here</A>.
23968 <P>
23969
23970 Instead of, or along with the use of &quot;roles&quot; to give you
23971 different signature files in different situations, there is also
23972 a way to conditionally include text based
23973 on whether or not a token would result in specific replacement text.
23974 For example, you could include some text based on whether or not
23975 the _NEWS_ token would result in any newsgroups if it was used.
23976 This is explained in detail
23977 <A HREF="h_reply_token_conditionals">here</A>.
23978 This isn't for the faint of heart.
23979 <P>
23980 In the very unlikely event that you want to include a literal token
23981 in the signature you must precede it with a backslash character.
23982 For example,
23983 <P>
23984 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
23985 <P>
23986 would produce something like
23987 <P>
23988 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
23989 <P>
23990 It is not possible to have a literal backslash followed by an expanded token.
23991 <P>
23992 An alternate method for storing the signature data is available by using the
23993 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
23994 This variable will be used by default.
23995 <P>
23996 <UL>
23997 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23998 </UL><P>
23999 &lt;End of help on this topic&gt;
24000 </BODY>
24001 </HTML>
24002 ====== h_config_init_cmd_list =====
24003 <HTML>
24004 <HEAD>
24005 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
24006 </HEAD>
24007 <BODY>
24008 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
24009
24010 The initial keystroke--or command--list option lets you start Alpine at
24011 any place you like.
24012 Whatever keystrokes you specify here will be executed
24013 by Alpine upon startup as a macro.
24014 The words SPACE, TAB, DOWN, UP, LEFT, and
24015 RIGHT indicate the pressing of those keys.
24016 CR indicates the pressing of the RETURN key.
24017 F1 through F12 represent the function keys, and ^ followed
24018 by a character indicates that key pressed along with the control key (in
24019 other words, ^P means Ctrl-P).
24020 As a shortcut notation, an element of the list may be several characters
24021 surrounded by double-quotes (").
24022 That will be expanded into the individual keystrokes
24023 (excluding the double-quote characters).
24024 For example, the quoted-string
24025
24026 <P><CENTER>"ABC"</CENTER>
24027
24028 <P>
24029 is interpreted the same as the three separate list members
24030
24031 <P><CENTER>A and B and C</CENTER>
24032
24033 <P>
24034 which is also the same as
24035
24036 <P><CENTER>A,B,C</CENTER>
24037
24038 <P>
24039 An example: To view message 1 on startup,
24040 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
24041
24042 <P><CENTER>I,J,1,CR,V</CENTER>
24043
24044 <P>
24045 An equivalent version of this is
24046
24047 <P><CENTER>"IJ1",CR,V</CENTER>
24048
24049 <P>
24050 Restrictions: You cannot pre-type into the composer with the initial
24051 keystroke list, and you cannot mix function key commands with letter
24052 commands.
24053
24054 <P><UL>
24055 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24056 </UL>
24057 <P>
24058 &lt;End of help on this topic&gt;
24059 </BODY>
24060 </HTML>
24061 ====== h_config_comp_hdrs =====
24062 <html>
24063 <header>
24064 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
24065 </header>
24066 <body>
24067 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
24068
24069 You can control which headers you want visible when composing outgoing
24070 email using this option.
24071 You can specify any of the regular set, any
24072 <A HREF="h_compose_richhdr">Rich Header</A>,
24073 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
24074 that you have already defined.
24075 If you use this setting at all, you must specify all the
24076 headers you want to see, you can't just add to the regular header set.
24077 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
24078
24079 Note that the "Newsgroups:" header will be abbreviated in the Composer
24080 display, but should be spelled out in full here.<p>
24081 <UL>
24082 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24083 </UL><P>
24084 &lt;End of help on this topic&gt;
24085 </body>
24086 </html>
24087 ====== h_config_custom_hdrs =====
24088 <HTML>
24089 <HEAD>
24090 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
24091 </HEAD>
24092 <BODY>
24093 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
24094
24095 You may add your own custom headers to outgoing messages.
24096 Each header you specify here must include the header tag
24097 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
24098 and may optionally include a value for that header.
24099 If you want to see these custom headers each time you compose a message,
24100 you must add them to your
24101 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
24102 otherwise they become part
24103 of the rich header set that you only see when you press the
24104 <A HREF="h_compose_richhdr">Rich Header</A>
24105 <!--chtml if pinemode="function_key"-->(F5)
24106 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
24107 (If you are looking for a way to change which headers are <EM>displayed</EM>
24108 when you view a message, take a look at the
24109 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
24110 option instead.)
24111 Here's an example that shows how you might set your From address
24112 <P>
24113 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
24114 <P>
24115 and another showing how you might set a Reply-To address
24116 <P>
24117 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
24118 <P>
24119 You may also set non-standard header values here.
24120 For example, you could add
24121 <P>
24122 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
24123 <P>
24124 or even
24125 <P>
24126 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
24127 <P>
24128 If you include a value after the colon then that header will be included
24129 in your outgoing messages unless you delete it before sending.
24130 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
24131 it will not be included in outgoing messages unless you edit a value
24132 in manually.
24133 For example, if
24134 <P>
24135 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
24136 <P>
24137 is in the list, then the Reply-To header will be available for editing
24138 but won't be included unless a value is added while in the composer.
24139 <P>
24140 It's actually a little more complicated than that.
24141 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
24142 defaults.
24143 If the message you are about to compose already has a value for a header,
24144 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
24145 For example, if you are Replying to a message the Subject field
24146 will already be filled in.
24147 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
24148 custom subject will <EM>NOT</EM> be used.
24149 The subject derived from the subject of the message you are Replying
24150 to will be used instead.
24151 <P>
24152 It is also possible to make header setting even more complicated and more
24153 automatic by using
24154 <A HREF="h_rules_roles">Roles</A>,
24155 but if all you want to do is set a default value for a header, you don't
24156 need to think about Roles.
24157 <P>
24158 If you change your From address you may also find it useful to add the
24159 changed From address to the
24160 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
24161 configuration option.
24162 <P>
24163 Limitation: Because commas are used to separate the list of
24164 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
24165 header contain a comma.
24166 Nor is there currently an &quot;escape&quot; mechanism provided
24167 to make this work.
24168 <P><UL>
24169 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24170 </UL>
24171 <P>
24172 &lt;End of help on this topic&gt;
24173 </BODY>
24174 </HTML>
24175 ====== h_config_viewer_headers =====
24176 <HTML>
24177 <HEAD>
24178 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
24179 </HEAD>
24180 <BODY>
24181 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
24182
24183 You may change the default list of headers that are viewed by listing
24184 the headers you want to view here.  If the headers in your
24185 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
24186 will be shown.  The order of the headers you list will be honored.  If
24187 the special value &quot;all-except&quot; is included as the first
24188 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
24189 message except those in the list will be shown.  The values are all
24190 case insensitive.
24191
24192 <P>
24193 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
24194 then the original default headers are ignored.  So, if you just wanted
24195 to add the header Organization to the list, you would have to list
24196 Organization plus all of the other headers originally in the default
24197 list.  If you just included Organization and nothing else, then you
24198 would see only the Organization header, nothing else.
24199
24200 <P>
24201 The default list of headers includes:
24202 <UL>
24203   <LI>From
24204   <LI>Resent-From
24205   <LI>To
24206   <LI>Resent-To
24207   <LI>Cc
24208   <LI>Resent-cc
24209   <LI>Bcc
24210   <LI>Newsgroups
24211   <LI>Followup-To
24212   <LI>Date
24213   <LI>Resent-Date
24214   <LI>Subject
24215   <LI>Resent-Subject
24216   <LI>Reply-To
24217 </UL>
24218
24219 <P>
24220 If you are looking for a way to control which headers are included in
24221 outgoing mail and are visible or not in the composer, take a look at the
24222 options
24223 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
24224 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
24225 this option.
24226 <P>
24227 <UL>
24228 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24229 </UL><P>
24230 &lt;End of help on this topic&gt;
24231 </BODY>
24232 </HTML>
24233 ====== h_config_viewer_margin_left =====
24234 <HTML>
24235 <HEAD>
24236 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
24237 </HEAD>
24238 <BODY>
24239 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
24240
24241 This variable controls the left-hand vertical margin's width in
24242 Alpine's Message Viewing screen.
24243 Its value is the number of space characters preceding each displayed line.
24244 For consistency with
24245 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
24246 you may specify the column number to start in
24247 (column numbering begins with number 1)
24248 instead of the width of the margin by appending a lower case letter
24249 &quot;c&quot; to the number.
24250 For example, a value of &quot;2c&quot; means to start the text in column two,
24251 which is entirely equivalent to a value of &quot;1&quot;, which means to
24252 leave a margin of 1 space.
24253 <P>
24254 The default is a left margin of 0 (zero).
24255 Misconfigurations (for example, negative values or values with starting
24256 left columns greater than the ending right column)
24257 are silently ignored.
24258 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
24259 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
24260 instead.
24261
24262 <P>
24263 &lt;End of help on this topic&gt;
24264 </BODY>
24265 </HTML>
24266 ====== h_config_viewer_margin_right =====
24267 <HTML>
24268 <HEAD>
24269 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
24270 </HEAD>
24271 <BODY>
24272 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
24273
24274 This variable controls the right-hand vertical margin's width in
24275 Alpine's Message Viewing screen.
24276 Its value is the number of space characters following each displayed line.
24277 You may specify the column number to end the text in
24278 (column numbering begins with number 1)
24279 instead of the width of the margin by appending a lower case letter
24280 &quot;c&quot; to the number.
24281 For example, a value of &quot;76c&quot; means to end the text in column 76.
24282 If the screen is 80 characters wide, this is equivalent to a value
24283 of &quot;4&quot;, which means to leave a margin of 4 spaces.
24284 However, if you use different size screens at different times, then these
24285 two values are not equivalent.
24286 <P>
24287 The default right margin is 4.
24288 Misconfigurations (for example, negative values or values with starting
24289 left columns greater than the ending right column)
24290 are silently ignored.
24291 If the number of columns for text between the
24292 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
24293 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
24294 instead.
24295
24296 <P>
24297 &lt;End of help on this topic&gt;
24298 </BODY>
24299 </HTML>
24300 ====== h_config_quote_suppression =====
24301 <HTML>
24302 <HEAD>
24303 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
24304 </HEAD>
24305 <BODY>
24306 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
24307
24308 This option should be used with care.
24309 It will cause some of the quoted text to be eliminated from the
24310 display when viewing a message in the MESSAGE TEXT screen.
24311 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
24312 value &quot;5&quot;,
24313 this will cause quoted text that is longer than five lines to be truncated.
24314 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
24315 Quoted text of more than six lines will have the first five lines displayed
24316 followed by a line that looks something like
24317 <P>
24318 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
24319 <P>
24320 As a special case, if exactly one line of quoted text would be hidden, the
24321 entire quote will be shown instead.
24322 So for the above example, quoted text that is exactly six lines long will
24323 will be shown in its entirety.
24324 (In other words, instead of hiding a single line and adding a line
24325 that announces that one line was hidden, the line is just shown.)
24326 <P>
24327 If the sender of a message has carefully chosen the quotes that he or she
24328 includes, hiding those quotes may change the meaning of the message.
24329 For that reason, Alpine requires that when you want to set the value of this
24330 variable to something less than four lines, you actually have to set it
24331 to the negative of that number.
24332 So if you want to set this option to &quot;3&quot;, you actually have to
24333 set it to &quot;-3&quot;.
24334 The only purpose of this is to get you to think about whether or not you
24335 really want to do this!
24336 If you want to delete all quoted text you set the value of this option
24337 to the special value &quot;-10&quot;.
24338 <P>
24339 The legal values for this option are
24340 <P>
24341 <TABLE>
24342 <TR>
24343   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
24344   <TD> Default, don't hide anything </TD>
24345 </TR>
24346 <TR>
24347   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
24348   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
24349 </TR>
24350 <TR>
24351   <TD> &nbsp;4,5,6,...&nbsp; </TD>
24352   <TD> Suppress if more than that many lines </TD>
24353 </TR>
24354 <TR>
24355   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
24356   <TD> Suppress all quoted lines </TD>
24357 </TR>
24358 </TABLE>
24359 <P>
24360 If you set this option to a non-default value you may sometimes wish to
24361 view the quoted text that is not shown.
24362 When this is the case, the
24363 <A HREF="h_common_hdrmode">HdrMode Command</A>
24364 may be used to show the hidden text.
24365 Typing the &quot;H&quot; command once will show the hidden text.
24366 Typing a second &quot;H&quot; will also turn on Full Header mode.
24367 The presence or absence of the HdrMode command is determined by the
24368 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
24369 Feature-List option in your Alpine configuration, so you will want to
24370 be sure that is turned on if you use quote suppression.
24371 <P>
24372 For the purposes of this option, a quote is a line that begins with the
24373 character &quot;&gt;&quot;.
24374 <P>
24375 Quotes are only suppressed when displaying a message on the screen.
24376 The entire quote will be left intact when printing or forwarding or something
24377 similar.
24378 <P>
24379 &lt;End of help on this topic&gt;
24380 </BODY>
24381 </HTML>
24382 ====== h_config_saved_msg_name_rule =====
24383 <HTML>
24384 <HEAD>
24385 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
24386 </HEAD>
24387 <BODY>
24388 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
24389
24390 This option determines the default folder name when saving
24391 a message.
24392
24393 <P>
24394 The default option is &quot;default-folder&quot;, which is the folder
24395 called &quot;saved-messages&quot; in Unix Alpine and
24396 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
24397 the Alpine option called
24398 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
24399
24400 <P>
24401 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
24402 get the chosen option's value for the message being saved (or for the
24403 first message being saved if using an aggregrate save).
24404 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
24405 value of who the message came from (i.e. the from address).
24406 Alpine then attempts to save the message to a folder matching that value.
24407 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
24408 &quot;by-sender&quot;.
24409 The opposite is also true.
24410 If &quot;by-recipient&quot; is chosen and the message was posted to a
24411 newsgroup, Alpine will use the newsgroup name.
24412 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
24413 &quot;by-from&quot;.
24414
24415 <P>
24416 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
24417 to use the personal name part of the address instead of the mailbox part.
24418 If any of the &quot;by-nick&quot; options are chosen, the
24419 address is looked up in your address book and if found, the
24420 nickname for that entry is used.
24421 Only simple address book entries are checked, not distribution lists.
24422 Similarly, if any of the
24423 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
24424 address book entry is used.
24425 If by-realname, or the by-nick or by-fcc lookups result in no value,
24426 then if the chosen option ends with the &quot;then-from&quot;,
24427 &quot;then-sender&quot;, &quot;then-replyto&quot;,
24428 or &quot;then-recip&quot; suffix, Alpine
24429 reverts to the same behavior as &quot;by-from&quot;,
24430 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
24431 depending on which option was specified.
24432 If the chosen option doesn't end with one of
24433 the &quot;then-&quot; suffixes, then Alpine reverts to the default
24434 folder when no match is found in the address book.
24435
24436 <P>
24437 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
24438 to save to the folder that you saved to the last time you saved a
24439 message.  The first time you save a message in an Alpine session, Alpine
24440 attempts to save the message to the default folder.
24441
24442 <P>
24443 Here is an example to make some of the options clearer.
24444 If the message is From
24445 <P>
24446 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
24447 <P>
24448 and this rule is set to &quot;by-from&quot;, then the default folder offered
24449 in the save dialog would be &quot;flint&quot;.
24450 <P>
24451 If this rule is set to &quot;by-realname-of-from&quot; then the default would
24452 be &quot;Fred Flintstone&quot;.
24453 <P>
24454 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
24455 for the address &quot;flint@bedrock.org&quot; in your address book.
24456 If an entry is found and it has a nickname associated with it, that nickname
24457 will be offered as the default folder.
24458 If not, the default saved message folder will be offered as the default.
24459 <P>
24460 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
24461 for the address &quot;flint@bedrock.org&quot; in your address book.
24462 If an entry is found and it has an Fcc associated with it, that Fcc
24463 will be offered as the default folder.
24464 If not, the default saved message folder will be offered as the default.
24465 <P>
24466 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
24467 for the address &quot;flint@bedrock.org&quot; in your address book.
24468 If an entry is found and it has a nickname associated with it, that nickname
24469 will be offered as the default folder.
24470 If it is not found (or has no nickname) then the default offered will be
24471 the same as it would be for the &quot;by-from&quot; rule.
24472 That is, it would be &quot;flint&quot;
24473 <P>
24474 <UL>
24475 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24476 </UL><P>
24477 &lt;End of help on this topic&gt;
24478 </BODY>
24479 </HTML>
24480 ====== h_config_fcc_rule =====
24481 <HTML>
24482 <HEAD>
24483 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
24484 </HEAD>
24485 <BODY>
24486 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
24487
24488 This option determines the default name for folder carbon copy. Choose
24489 one:
24490
24491 <DL>
24492 <DT>default-fcc</DT>
24493 <DD>This is the normal default, the value of which is set in the
24494 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
24495 configuration.
24496 </DD>
24497
24498 <DT>last-fcc-used</DT>
24499 <DD> Causes Alpine to use the folder that was last
24500 used in the fcc field
24501 </DD>
24502
24503 <DT>by-nickname</DT>
24504 <DD>Means that Alpine will use the nickname
24505 from your address book that matches the first address in the To line.
24506 If there is no match, it will use the value of the
24507 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
24508 </DD>
24509
24510 <DT>by-recipient</DT>
24511 <DD>Means Alpine will form a folder name
24512 based on the left hand side of the first address in the To line.
24513 </DD>
24514
24515 <DT>by-nick-then-recip</DT>
24516 <DD>Means that it will use the
24517 matching nickname from your address book if there is one, otherwise it
24518 will extract the recipient name from the address and use that (like
24519 by-recipient).
24520 </DD>
24521
24522 <DT>current-folder</DT>
24523 <DD>Causes a copy to be written to
24524 the currently open folder, unless that is the INBOX.  In the case
24525 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
24526 used instead.
24527 </DD>
24528 </DL>
24529
24530 <P>
24531 Note: Whatever the fcc specified by the rule here, it will be
24532 over-ridden by any fcc entries you have in your address book.
24533
24534 <P>
24535 <UL>
24536 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24537 </UL><P>
24538 &lt;End of help on this topic&gt;
24539 </BODY>
24540 </HTML>
24541 ====== h_config_sort_key =====
24542 <HTML>
24543 <HEAD>
24544 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
24545 </HEAD>
24546 <BODY>
24547 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
24548
24549 This option determines the order in which messages will be displayed in
24550 the MESSAGE INDEX screen.  Choose from:
24551 <P>
24552 <UL>
24553  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
24554  <LI> <A HREF="h_index_sort_date">Date</A>
24555  <LI> <A HREF="h_index_sort_subj">Subject</A>
24556  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
24557  <LI> <A HREF="h_index_sort_thread">Thread</A>
24558  <LI> <A HREF="h_index_sort_from">From</A>
24559  <LI> <A HREF="h_index_sort_size">Size</A>
24560  <LI> <A HREF="h_index_sort_score">Score</A>
24561  <LI> <A HREF="h_index_sort_to">To</A>
24562  <LI> <A HREF="h_index_sort_cc">Cc</A>
24563 </UL>
24564
24565 <P>
24566 Each type of sort may also be reversed.
24567 Normal default is by &quot;Arrival&quot;.
24568
24569 <P>
24570 A possible point of confusion arises when you change the configuration
24571 of the <!--#echo var="VAR_sort-key"-->.
24572 The folder will normally be re-sorted when you go back to viewing the
24573 index.
24574 However, if you have manually sorted the folder with the
24575 Sort
24576 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
24577 command, then it will not be re-sorted until the next time it is opened.
24578
24579 <P>
24580 <UL>
24581 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24582 </UL><P>
24583 &lt;End of help on this topic&gt;
24584 </BODY>
24585 </HTML>
24586 ====== h_config_other_startup =====
24587 <HTML>
24588 <HEAD>
24589 <TITLE>OPTION: Set Startup Rule</TITLE>
24590 </HEAD>
24591 <BODY>
24592 <H1>OPTION: Set Startup Rule</H1>
24593
24594 This option determines which message will be the <EM>current message</EM> when
24595 the folder is first opened.
24596 It works the same way that the option
24597 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
24598 works, so look there for help.
24599 It may be used for any folder, not just incoming folders.
24600
24601 <P>
24602 <UL>
24603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24604 </UL><P>
24605 &lt;End of help on this topic&gt;
24606 </BODY>
24607 </HTML>
24608 ====== h_config_perfolder_sort =====
24609 <HTML>
24610 <HEAD>
24611 <TITLE>Set Sort Order</TITLE>
24612 </HEAD>
24613 <BODY>
24614 <H1>Set Sort Order</H1>
24615
24616 This option determines the order in which messages will be displayed in
24617 the MESSAGE INDEX screen when the Current Folder Type set in the
24618 Pattern is a match. Choose from:
24619 <P>
24620 <UL>
24621  <LI> <A HREF="h_index_sort_default">Default</A>
24622  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
24623  <LI> <A HREF="h_index_sort_date">Date</A>
24624  <LI> <A HREF="h_index_sort_subj">Subject</A>
24625  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
24626  <LI> <A HREF="h_index_sort_thread">Thread</A>
24627  <LI> <A HREF="h_index_sort_from">From</A>
24628  <LI> <A HREF="h_index_sort_size">Size</A>
24629  <LI> <A HREF="h_index_sort_score">Score</A>
24630  <LI> <A HREF="h_index_sort_to">To</A>
24631  <LI> <A HREF="h_index_sort_cc">Cc</A>
24632 </UL>
24633
24634 <P>
24635 Each type of sort may also be reversed.
24636 Normal default is by &quot;Arrival&quot;.
24637
24638 <P>
24639 A possible point of confusion arises when you change the configuration
24640 of the Sort Order for the currently open folder.
24641 The folder will normally be re-sorted when you go back to viewing the
24642 index.
24643 However, if you have manually sorted the folder with the
24644 Sort
24645 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
24646 command, then it will not be re-sorted until the next time it is opened.
24647
24648 <P>
24649 <UL>
24650 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24651 </UL><P>
24652 &lt;End of help on this topic&gt;
24653 </BODY>
24654 </HTML>
24655 ====== h_config_fld_sort_rule =====
24656 <HTML>
24657 <HEAD>
24658 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
24659 </HEAD>
24660 <BODY>
24661 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
24662
24663 This option controls the order in which folder list entries will be
24664 presented in the FOLDER LIST screen.  Choose one of the following:
24665
24666 <DL>
24667 <DT>Alphabetical</DT>
24668 <DD>sort by alphabetical name independent of type
24669 </DD>
24670
24671 <DT>Alpha-with-dirs-last</DT>
24672 <DD>sort by alphabetical name grouping directory entries
24673 to the end of the list
24674 </DD>
24675
24676 <DT>Alpha-with-dirs-first</DT>
24677 <DD>sort by alphabetical name grouping directory entries
24678 to the start of the list
24679 </DD>
24680 </DL>
24681
24682 The normal default is &quot;Alphabetical&quot;.
24683
24684 <P>
24685 <UL>
24686 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24687 </UL><P>
24688 &lt;End of help on this topic&gt;
24689 </BODY>
24690 </HTML>
24691 ====== h_config_ab_sort_rule =====
24692 <HTML>
24693 <HEAD>
24694 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
24695 </HEAD>
24696 <BODY>
24697 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
24698
24699 This option controls the order in which address book entries will be
24700 presented.  Choose one of the following:
24701
24702 <DL>
24703 <DT>fullname</DT>
24704 <DD>use fullname field, lists mixed in
24705 </DD>
24706
24707 <DT>fullname-with-lists-last</DT>
24708 <DD>use fullname field, but put lists at end
24709 </DD>
24710
24711 <DT>nickname</DT>
24712 <DD>use nickname field, lists mixed in
24713 </DD>
24714
24715 <DT>nickname-with-lists-last</DT>
24716 <DD>use nickname field, but put lists at end
24717 </DD>
24718
24719 <DT>dont-sort</DT>
24720 <DD>don't change order of file
24721 </DD>
24722 </DL>
24723
24724 <P>
24725 The normal default is &quot;fullname-with-lists-last&quot;.
24726 If you use an address book from more than one computer and those
24727 computers sort the address book differently then the sort order
24728 will be the order where the last change to the address book was
24729 made.
24730 There are two reasons the sorting might be different on different
24731 systems.
24732 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
24733 places.
24734 Second, the collation rules on the two computers may be different.
24735 For example, one system might ignore special characters while the other
24736 doesn't or one may sort upper and lower case letters together while
24737 the other doesn't.
24738 In any case, the order you see is the order on the system where the
24739 last change was made, for example by an address book edit or a
24740 Take Address command.
24741
24742 <P>
24743 <UL>
24744 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24745 </UL><P>
24746 &lt;End of help on this topic&gt;
24747 </BODY>
24748 </HTML>
24749 ====== h_config_post_char_set =====
24750 <HTML>
24751 <HEAD>
24752 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
24753 </HEAD>
24754 <BODY>
24755 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
24756
24757 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
24758 when sending messages.
24759
24760 <P>
24761
24762 When sending a message the text typed in the composer is
24763 labeled with the character set specified by this option.
24764 If the composed text is not fully representable in the
24765 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
24766 instead;
24767
24768 <P>
24769 Attachments are labeled with your
24770 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
24771
24772 <P>
24773 Generally, there should be little need to set this option.
24774 If left unset, the
24775 default behavior is to label composed text as specifically as
24776 possible.  That is, if the composed text has no non-ASCII characters,
24777 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
24778 only ISO-8859-15 characters, it is labeled as such.  Alpine will
24779 attempt to automatically detect a number of character sets including ISO-8859-15,
24780 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
24781 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
24782 If the message contains a mix of character sets,
24783 it is labeled as &quot;UTF-8.&quot;
24784
24785 <P>
24786
24787 This setting is provided to allow you to force a particular character set that
24788 Alpine does not automatically detect. For example, if a message is representable
24789 in more than one character set then Alpine may choose a different default
24790 than you want.
24791 Lastly, by setting this option explicitly to
24792 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
24793 &quot;UTF-8&quot; instead of something more specific.
24794
24795 <P>
24796 In the Setup/Config screen you may choose from a list of all the
24797 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24798
24799 <P>
24800 The options
24801 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
24802 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
24803 are closely related.
24804 Setting the feature
24805 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24806 should cause this option to be ignored.
24807
24808 <P>
24809 <UL>
24810 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24811 </UL><P>
24812 &lt;End of help on this topic&gt;
24813 </BODY>
24814 </HTML>
24815 ====== h_config_unk_char_set =====
24816 <HTML>
24817 <HEAD>
24818 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
24819 </HEAD>
24820 <BODY>
24821 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
24822
24823 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
24824 when reading or replying to messages.
24825
24826 <P>
24827
24828 A text message should either be made up of all US-ASCII characters
24829 or it should contain a charset label which tells the software which
24830 character set encoding to use to interpret the message.
24831 Sometimes a malformed message may be unlabeled but contain non-ascii text.
24832 This message is outside of the standards so any attempt to read it could fail.
24833 When Alpine attempts to read such a message it will try to interpret the
24834 text in the character set you specify here.
24835 For example, if you have correspondents who send you unlabeled messages that
24836 are usually made up of characters from the WINDOWS-1251 character set, setting
24837 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
24838 allow you to read those messages.
24839 Of course, if the unlabeled message is actually in some other character set,
24840 then you may see garbage on your screen.
24841 <P>
24842 Instead of just unlabeled text, this option also affects text which is labeled
24843 with the charsets &quot;X-Unknown&quot;, &quot;MISSING_PARAMETER_VALUE&quot;
24844 or &quot;US-ASCII&quot;.
24845
24846 <P>
24847 In the Setup/Config screen you may choose from a list of all the
24848 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24849
24850 <P>
24851 <UL>
24852 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24853 </UL><P>
24854 &lt;End of help on this topic&gt;
24855 </BODY>
24856 </HTML>
24857 ====== h_config_char_set =====
24858 <HTML>
24859 <HEAD>
24860 <TITLE>OPTION: Display Character Set</TITLE>
24861 </HEAD>
24862 <BODY>
24863 <H1>OPTION: Display Character Set</H1>
24864
24865 The Display Character Set configuration option is used when viewing messages.
24866 <P>
24867 Alpine uses Unicode characters internally and
24868 it is a goal for Alpine to handle email in many different languages.
24869 Alpine will properly display only left-to-right character sets
24870 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
24871 font is in use, in the sense that
24872 characters are assumed to take up zero, one, or two character cell
24873 widths from left to right on the screen. This is true even in PC-Alpine.
24874 <P>
24875
24876 Alpine recognizes some local character sets that are right-to-left
24877 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
24878 (Arabic) and properly converts texts in these character sets to/from
24879 Unicode; however, there are known display bugs with these character
24880 sets.
24881 <P>
24882
24883 There are three possible configuration character settings and some
24884 environment variable settings that can affect how Alpine
24885 handles international characters.
24886 The first two of these are only available in UNIX Alpine.
24887 The three configuration options are
24888 Display Character Set,
24889 Keyboard Character Set, and
24890 <!--#echo var="VAR_posting-character-set"-->.
24891 The Keyboard Character Set defaults to being the same value
24892 as the Display Character Set, and that is usually correct, because
24893 the keyboard almost always produces characters in the same character set
24894 as the display displays.
24895 The Display Character Set is the character set that Alpine
24896 will attempt to use when sending characters to the display.
24897 <P>
24898
24899 By default, the Display Character Set variable is not set and UNIX Alpine
24900 will attempt to get this information from the environment.
24901 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
24902 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
24903 An explicit configuration setting for Display Character Set will,
24904 of course, override any default setting.
24905 <P>
24906 For PC-Alpine the Display Character Set
24907 and the Keyboard Character Set
24908 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
24909 <P>
24910
24911 It is probably best to use UNIX Alpine in a terminal emulator
24912 capable of displaying UTF-8 characters, since that will allow you to
24913 view just about any received text that is correctly formatted (note,
24914 however, the above comments about known index display bugs with certain
24915 character sets). You'll need to have an emulator that uses a UTF-8 font
24916 and you'll need to set up your environment to use a UTF-8 charmap. For
24917 example, on a Linux system you might include
24918 <P>
24919 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
24920 <P>
24921
24922 or something similar in your UNIX startup files.
24923 You'd also have to select a UTF-8 font in your terminal emulator.
24924 <P>
24925
24926 The types of values that the character set variables may be set to are
24927 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
24928 The <CODE>ISO-2022</CODE> character sets are not supported for input or
24929 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
24930 for use only as a <!--#echo var="VAR_posting-character-set"-->.
24931 In the Setup/Config screen you may choose from a list of all the
24932 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24933 Here is a list of many of the possible character sets:
24934
24935 <P>
24936 <TABLE>
24937 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
24938 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
24939 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
24940 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
24941 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
24942 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
24943 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
24944 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
24945 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
24946 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
24947 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
24948 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
24949 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
24950 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
24951 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
24952 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
24953 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
24954 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
24955 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
24956 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukrainian</TD> </TR>
24957 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
24958 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
24959 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
24960 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24961 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24962 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24963 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24964 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24965 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
24966 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
24967 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
24968 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
24969 </TABLE>
24970 <P>
24971
24972 When reading incoming email, Alpine understands many different
24973 character sets and is able to convert the incoming mail into Unicode.
24974 The Unicode will be converted to the Display Character Set
24975 for display on your terminal.
24976 Characters typed at the keyboard will be converted from the
24977 Keyboard Character Set to Unicode for Alpine's internal
24978 use.
24979 You may find that you can read some malformed messages that do not
24980 contain a character set label by setting the option
24981 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
24982 <P>
24983
24984 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
24985 The default behavior obtained by leaving this variable unset is usually
24986 what is wanted. In that default case, Alpine will attempt
24987 to label the message with the most specific character set from the
24988 rather arbitrary set
24989 <P>
24990 US-ASCII, ISO-8859-15,
24991 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
24992 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
24993 <P>
24994
24995 For example, if the message is made up of only US-ASCII characters, it
24996 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
24997 that will be the label. If that doesn't work the same is tried for the
24998 remaining members of the list.
24999
25000 <P>
25001 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
25002 explicit value instead.
25003 For example, if you usually send messages in Greek, setting this
25004 option to ISO-8859-7 will result in messages being labeled as
25005 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
25006 are only Greek characters, or UTF-8 if there are some characters
25007 that aren't representable in ISO-8859-7.
25008 Another possibility is to set this option explicitly to UTF-8.
25009 In that case
25010 Alpine labels only ascii messages as US-ASCII and all other
25011 messages as UTF-8.
25012 <P>
25013
25014 The options
25015 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
25016 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
25017 are closely related to this option.
25018 Setting the feature
25019 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
25020 should cause this option to be ignored.
25021
25022 <P>
25023 When displaying a message, Alpine compares this setting to the character
25024 set specified in the message.  If not all of the
25025 characters in the message can be displayed using the Display Character Set
25026 then Alpine places an editorial
25027 comment in the displayed text (enclosed in square-brackets) indicating
25028 that some characters may not be displayed correctly.
25029 This comment may be eliminated by turning on the option
25030 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
25031
25032 <P>
25033 <UL>
25034 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25035 </UL><P>
25036 &lt;End of help on this topic&gt;
25037 </BODY>
25038 </HTML>
25039 ====== h_config_key_char_set =====
25040 <HTML>
25041 <HEAD>
25042 <TITLE>OPTION: Keyboard Character Set</TITLE>
25043 </HEAD>
25044 <BODY>
25045 <H1>OPTION: Keyboard Character Set</H1>
25046
25047 UNIX Alpine only.
25048 <P>
25049 The Keyboard Character Set identifies the character set of the characters
25050 coming from your keyboard.
25051 It defaults to having the same value as your
25052 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
25053 which in turn defaults to a value obtained from your environment.
25054 It is unlikely that you will need to use this option, because the keyboard
25055 almost always produces the same kind of characters as the display displays.
25056
25057 <P>
25058 This character set is also used when accessing files in your local
25059 file system.
25060 The names of the files are assumed to be in the same character set as
25061 what the keyboard produces, as well as the contents of the files.
25062
25063 <P>
25064 In the Setup/Config screen you may choose from a list of all the
25065 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
25066
25067 <P>
25068 The options
25069 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
25070 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
25071 are closely related.
25072 Setting the feature
25073 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
25074 should cause this option to be ignored.
25075
25076 <P>
25077 <UL>
25078 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25079 </UL><P>
25080 &lt;End of help on this topic&gt;
25081 </BODY>
25082 </HTML>
25083 ====== h_config_editor =====
25084 <HTML>
25085 <HEAD>
25086 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
25087 </HEAD>
25088 <BODY>
25089 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
25090
25091 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
25092 normally an alternative to Alpine's internal composer (Pico).  You could use
25093 this setting to specify an alternate editor to use occasionally or if you
25094 have a favorite editor and want to use it all the time (see the
25095 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
25096 If you specify multiple editors for this option, ^_ will invoke the first one
25097 of those specified that exists and is executable.  When specifying a program
25098 for use here, make sure that the format of the text it saves -- which, when
25099 you exit it, will become the message body in Alpine -- is appropriate
25100 for the body of an email message; avoid proprietary formats that may result in
25101 a message body that the recipient of your message will be unable to decipher.
25102 <P>
25103 <!--chtml if pinemode="os_windows"-->
25104 <!--chtml else-->
25105 If you are in doubt about what editors are available on your system, or which
25106 of them may be appropriate for specification here, ask your local computing
25107 support staff.
25108 <!--chtml endif-->
25109 <P>
25110 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
25111 unset, outgoing text will be set as flowed.  In most cases this will be fine,
25112 but if the editor has a &quot;flowed text&quot; mode, it would be best to
25113 use that.
25114
25115 <P><UL>
25116 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25117 </UL>
25118 <P>
25119 &lt;End of help on this topic&gt;
25120 </BODY>
25121 </HTML>
25122 ====== h_config_speller =====
25123 <HTML>
25124 <HEAD>
25125 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
25126 </HEAD>
25127 <BODY>
25128 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
25129
25130 UNIX Alpine only.
25131 <P>
25132 For PC-Alpine, you must install the aspell library code that you
25133 may get from
25134 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
25135 <P>
25136 This option affects the behavior of the ^T (spell check) command in the
25137 Composer.  It specifies the program invoked by ^T in the Composer.
25138 By default, Alpine uses
25139 <P>
25140 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
25141 <P>
25142 if it knows where to find &quot;aspell&quot;.
25143 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
25144 then the command used is
25145 <P>
25146 <CENTER><SAMP>ispell -l</SAMP></CENTER>
25147 <P>
25148 Otherwise, the ancient &quot;spell&quot; command is used.
25149 <P>
25150 If you specify a value for this command (with full pathname) then that is what
25151 will be used instead of any of the defaults.
25152 When invoking this
25153 spell-checking program, Alpine appends a tempfile name (where the message is
25154 passed) to the command line. Alpine expects the speller to correct the
25155 spelling in that file. When you exit from that program Alpine will read the
25156 tempfile back into the composer.
25157 <P>
25158 Don't set this speller option to the standard Unix spell command.
25159 That won't work because spell works in a different way.
25160
25161 <P>
25162 <UL>
25163 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25164 </UL><P>
25165 &lt;End of help on this topic&gt;
25166 </BODY>
25167 </HTML>
25168 ====== h_config_aspell_dictionary =====
25169 <HTML>
25170 <HEAD>
25171 <TITLE>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></TITLE>
25172 </HEAD>
25173 <BODY>
25174 <H1>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></H1>
25175
25176 PC Alpine only.
25177 <P>
25178 This option specifies a list of dictionaries you will use with
25179 aspell. A sample entry is &quot;en_US&quot; for american english, or
25180 &quot;en_GB&quot; for british english.
25181
25182 <P>
25183 <UL>
25184 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25185 </UL><P>
25186 &lt;End of help on this topic&gt;
25187 </BODY>
25188 </HTML>
25189 ====== h_config_display_filters =====
25190 <HTML>
25191 <HEAD>
25192 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
25193 </HEAD>
25194 <BODY>
25195 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
25196
25197 This option defines a list of text-filtering commands (programs or
25198 scripts) that may be used to filter text portions of received messages
25199 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
25200 display screen, exporting to a text file).
25201 For security reasons, the full path name of the
25202 filter command must be specified.
25203
25204 <P>
25205 The command is executed and the message is piped into its standard input.
25206 The standard output of the command is read back by Alpine.  The
25207 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
25208
25209 <P>
25210 The filter's use is based on the configured &quot;trigger&quot; string.  The
25211 format of a filter definition is:
25212
25213 <P>
25214 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
25215
25216 <P>
25217 You can specify as many filters as you wish, separating them with a comma.
25218 Each filter can have only one trigger and command.  Thus, two trigger
25219 strings that invoke the same command require separate filter
25220 specifications.
25221
25222 <P>
25223 The &quot;trigger&quot; is simply text that, if found in the message,
25224 will invoke the associated command.  If the trigger contains any space
25225 characters, it must be placed within quotes.  Likewise, should you
25226 wish a filter to be invoked unconditionally, define the trigger as the
25227 null string, &quot;&quot; (two consecutive double-quote characters).  If the
25228 trigger string is found anywhere in the text of the message the filter
25229 is invoked.  Placing the trigger text within the tokens defined below
25230 changes where within the text the trigger must be before considering
25231 it a match.
25232
25233 <P>
25234 Trigger Modifying Tokens:
25235 <DL>
25236 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
25237 <DD>This token tells Alpine to invoke the supplied command
25238 if the text is in a character set matching <VAR>string</VAR>
25239 (e.g., ISO-8859-2 or ISO-2022-JP).
25240 </DD>
25241
25242
25243 <DT>_LEADING(<VAR>string</VAR>)_</DT>
25244 <DD>This token tells Alpine to invoke the supplied command
25245 if the enclosed <VAR>string</VAR> is found to be the first
25246 non-whitespace text.
25247 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
25248 the space character.
25249 </DD>
25250
25251 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
25252 <DD>This token tells Alpine to invoke the supplied command
25253 if the enclosed <VAR>string</VAR> is found at the beginning
25254 of any line in the text.
25255 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
25256 the space character.
25257 </DD>
25258 </DL>
25259
25260 <P>
25261 The &quot;command&quot; and &quot;arguments&quot; portion is simply
25262 the command line to be invoked if the trigger string is found.  Below
25263 are tokens that Alpine will recognize and replace with special values
25264 when the command is actually invoked.
25265
25266 <P>
25267 Command Modifying Tokens:
25268
25269 <DL>
25270 <DT>_TMPFILE_</DT>
25271 <DD>When the command is executed, this token is
25272 replaced with the path and name of the temporary
25273 file containing the text to be filtered.  Alpine
25274 expects the filter to replace this data with the
25275 filter's result.
25276
25277 <P>
25278 NOTE: Use of this token implies that the text to
25279 be filtered is not piped into standard input of the
25280 executed command and its standard output is ignored.
25281 Alpine restores the tty modes before invoking the
25282 filter in case the filter interacts with the user
25283 via its own standard input and output.
25284 </DD>
25285
25286 <DT>_RESULTFILE_</DT>
25287 <DD>When the command is executed, this token is
25288 replaced with the path and name of a temporary
25289 file intended to contain a status message from the
25290 filter.  Alpine displays this in the message status
25291 field.
25292 </DD>
25293
25294 <DT>_DATAFILE_</DT>
25295 <DD>When the command is executed, this token is
25296 replaced with the path and name of a temporary
25297 file that Alpine creates once per session and deletes
25298 upon exit.  The file is intended to be used by the
25299 filter to store state information between instances
25300 of the filter.
25301 </DD>
25302
25303 <DT>_PREPENDKEY_</DT>
25304 <DD>When the command is executed, this token indicates that a random
25305 number will be passed down the input stream before the message text.
25306 This number could be used as a session key.  It is sent in this way to
25307 improve security.  The number is unique to the current Alpine session
25308 and is only generated once per session.
25309 </DD>
25310
25311 <DT>_SILENT_</DT>
25312 <DD>When the filter is executed, this token tells Alpine not to repaint
25313 the screen while the command is being executed. This can be used with
25314 filters that do not interact with the user, and therefore repainting
25315 the screen is not necessary.
25316 </DD>
25317 </DL>
25318
25319 <P>
25320 The feature
25321 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
25322 <P>
25323 Performance caveat/considerations:
25324 <BR>
25325 Testing for the trigger and invoking the filter doesn't come for free.
25326 There is overhead associated with searching for the trigger string, testing
25327 for the filter's existence and actually piping the text through the filter.
25328 The impact can be reduced if the Trigger Modifying Tokens above are
25329 employed.
25330 <P>
25331 &lt;End of help on this topic&gt;
25332 </BODY>
25333 </HTML>
25334 ====== h_config_sending_filter =====
25335 <HTML>
25336 <HEAD>
25337 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
25338 </HEAD>
25339 <BODY>
25340 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
25341
25342 This option defines a list of text-filtering commands (programs and
25343 scripts) that may be selectively invoked to process a message just before
25344 it is sent.  If set, the Composer's ^X (Send) command will allow you to
25345 select which filter (or none) to apply to the message before it is sent.
25346 For security reasons, the full path of the filter program must be
25347 specified.
25348
25349 <P>
25350 Command Modifying Tokens:
25351
25352 <DL>
25353 <DT>_RECIPIENTS_</DT>
25354 <DD>When the command is executed, this token is replaced
25355 with the space delimited list of recipients of the
25356 message being sent.
25357 </DD>
25358
25359 <DT>_TMPFILE_</DT>
25360 <DD>
25361 When the command is executed, this token is
25362 replaced with the path and name of the temporary
25363 file containing the text to be filtered.  Alpine
25364 expects the filter to replace this data with the
25365 filter's result.
25366
25367 <P>
25368 NOTE: Use of this token implies that the text to
25369 be filtered is not piped into standard input of the
25370 executed command and its standard output is ignored.
25371 Alpine restores the tty modes before invoking the
25372 filter in case the filter interacts with the user
25373 via its own standard input and output.
25374 </DD>
25375
25376 <DT>_RESULTFILE_</DT>
25377 <DD>When the command is executed, this token is
25378 replaced with the path and name of a temporary
25379 file intended to contain a status message from the
25380 filter.  Alpine displays this in the message status
25381 field.
25382 </DD>
25383
25384 <DT>_DATAFILE_</DT>
25385 <DD>When the command is executed, this token is replaced
25386 in the command line with the path and name of a
25387 temporary file that Alpine creates once per session
25388 and deletes upon exit.  The file is intended to be
25389 used by the filter to store state information between
25390 instances of the filter.
25391 </DD>
25392
25393 <DT>_PREPENDKEY_</DT>
25394 <DD>When the command is executed, this token indicates
25395 that a random number will be passed down the input
25396 stream before the message text.  This number could
25397 be used as a session key.  It is sent in this way
25398 to improve security.  The number is unique to the
25399 current Alpine session and is only generated once per
25400 session.
25401 </DD>
25402
25403 <DT>_INCLUDEALLHDRS_</DT>
25404 <DD>When the command is executed, this token indicates
25405 that the headers of the message will be passed down the input stream
25406 before the message text.
25407 </DD>
25408
25409 <DT>_MIMETYPE_</DT>
25410 <DD>When the command is executed, this token is replaced in the
25411 command name with a temporary file name used to accept any new MIME
25412 Content-Type information necessitated by the output of the filter.
25413 Upon the filter's exit, if the file contains new MIME type
25414 information, Alpine verifies its format and replaces the outgoing
25415 message's MIME type information with that contained in the file. This
25416 is basically a cheap way of sending something other than Text/Plain.
25417 </DD>
25418 </DL>
25419
25420 <P>
25421 NOTE: Only the body text, which is visible in the Composer, is piped
25422 through this filter.  Attachments are not sent to the filter.
25423 <P>
25424 Sending filters are not used if the feature
25425 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
25426 <P>
25427 <UL>
25428 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25429 </UL><P>
25430 &lt;End of help on this topic&gt;
25431 </BODY>
25432 </HTML>
25433 ====== h_config_keywords =====
25434 <HTML>
25435 <HEAD>
25436 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
25437 </HEAD>
25438 <BODY>
25439 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
25440
25441 You may define your own set of keywords and optionally set them on a
25442 message by message basis.
25443 These are similar to the &quot;Important&quot; flag which the user
25444 may set using the Flag command.
25445 The difference is that the Important flag is always present for each folder.
25446 User-defined keywords are chosen by the user.
25447 You may set up the list of possible keywords here, or you may add keywords
25448 from the Flag Details screen that you
25449 can get to after typing the
25450 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
25451 command.
25452 After the keywords have been defined,
25453 then you use the <A HREF="h_common_flag">Flag command</A>
25454 to set or clear the keywords in each message.
25455 The behavior of the flag command may be modified by using the
25456 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
25457 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
25458
25459 <P>
25460 Keywords may be used when Selecting messages (Select Keyword).
25461 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
25462 Filter Rules may be used to set keywords automatically.
25463 Keywords may be displayed as part of the Subject of a message by using
25464 the SUBJKEY or SUBJKEYINIT tokens in the
25465 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
25466 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
25467 option may be used to modify the display of keywords using
25468 SUBJKEY and SUBJKEYINIT slightly.
25469 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
25470 screen by using the KEY or KEYINIT tokens.
25471 It is also possible to color keywords in the index using the
25472 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
25473 Keywords are not supported by all mail servers.
25474
25475 <P>
25476 You may give keywords nicknames if you wish.
25477 If the keyword definition you type in contains a SPACE character, then the
25478 actual value of the keyword is everything after the last SPACE and the
25479 nickname for that keyword is everything before the last SPACE.
25480 For example, suppose you are trying to interoperate with another email program
25481 that uses a particular keyword with an unpleasant name.
25482 Maybe it uses a keyword called
25483 <P>
25484 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
25485 <P>
25486 but for you that keyword means that the message is work-related.
25487 You could define a keyword to have the value
25488 <P>
25489 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
25490 <P>
25491 and then you would use the name &quot;Work&quot; when dealing with
25492 that keyword in Alpine.
25493 If you defined it as
25494 <P>
25495 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
25496 <P>
25497 the nickname would be everything before the last SPACE, that is the nickname
25498 would be &quot;My Work&quot;.
25499 <P>
25500 Some commonly used keywords begin with dollar signs.
25501 This presents a slight complication, because the dollar sign is normally used
25502 to signify
25503 <A HREF="h_news_config">environment variable expansion</A>
25504 in the Alpine configuration.
25505 In order to specify a keyword that begins with a dollar sign you must
25506 precede the dollar sign with a second dollar sign to escape its special
25507 meaning.
25508 For example, if you want to include the keyword
25509 <P>
25510 <CENTER><SAMP>$Label1</SAMP></CENTER>
25511 <P>
25512 as one of your possible keywords, you must enter the text
25513 <P>
25514 <CENTER><SAMP>$$Label1</SAMP></CENTER>
25515 <P>
25516
25517 instead.
25518 <P>
25519 There are a couple limitations.
25520 First, not all servers support keywords.
25521 Second, some servers (including the IMAP server included with Alpine)
25522 have a per folder limit on the number of keywords that may be defined.
25523 This count commonly includes every keyword you have ever used in the
25524 folder, even if it is no longer being used.
25525 In other words, you can add keywords but you cannot remove them easily.
25526 If you have changed keywords over the life of a folder and find that
25527 you have reached such a limit, one possible solution might be to copy
25528 all of the messages to a newly created folder (using Alpine) and then
25529 delete the original and rename the new folder.
25530 The reason this might work is that only the keywords currently set in
25531 any of the messages will be used in the new folder, hopefully putting you
25532 under the limit.
25533
25534 <P>
25535 <UL>
25536 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25537 </UL><P>
25538 &lt;End of help on this topic&gt;
25539 </BODY>
25540 </HTML>
25541 ====== h_config_alt_addresses =====
25542 <HTML>
25543 <HEAD>
25544 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
25545 </HEAD>
25546 <BODY>
25547 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
25548
25549 This option provides a place for you to list alternate email addresses
25550 you may have.
25551 Each address in the list should be the actual email address part of an
25552 address, without the full name field or the angle brackets.
25553 For example:
25554
25555 <P>
25556 <CENTER><SAMP>user@example.com</SAMP></CENTER>
25557 <P>
25558
25559 The matching is case-insensitive, so this would match any of
25560 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
25561 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
25562
25563 <P>
25564 If set, the option affects the behavior of the Reply
25565 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
25566 a message has been addressed specifically to you.
25567
25568 <P>
25569 In the default INDEX display
25570 the personal name (or email address) of
25571 the person listed in the message's &quot;From:&quot; header
25572 field is usually displayed except when that address is yours or one of your
25573 alternate addresses.
25574 In that case you will usually see the name of
25575 the first person specified in the
25576 message's &quot;To:&quot; header field
25577 with the prefix &quot;To: &quot; prepended.
25578
25579 <P>
25580 With respect to Reply, the reply-to-all option will exclude addresses
25581 listed here.
25582
25583 <P>
25584 The feature
25585 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
25586 is somewhat related to this option.
25587
25588 <P>
25589 In addition to a list of actual addresses,
25590 you may use regular expressions (as used with grep -E with the ignore case flag)
25591 to describe the addresses you want to match.
25592 Alpine will somewhat arbitrarily interpret your entry as a regular
25593 expression if it contains any of the characters
25594 *, |, +, ?, {, [, ^, $, or &#92;.
25595 Otherwise, it will be treated literally.
25596 The feature
25597 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
25598 may be used to turn off regular expression processing regardless of whether or not
25599 special characters appear in the entry.
25600
25601 <P>
25602 A description of how regular expressions work is beyond the
25603 scope of this help text, but some examples follow.
25604
25605 <P>
25606 The entry
25607
25608 <P>
25609 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
25610 <P>
25611
25612 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
25613 address with a domain name of <SAMP>example.com</SAMP> (such as
25614 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
25615 one of your alternate addresses.
25616 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
25617 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
25618 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
25619 Complicating things further, the dollar sign
25620 is special in the Alpine configuration (it signifies environment variable expansion)
25621 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
25622 Quotes around the whole expression will not escape the dollar sign successfully.
25623 So this example should look like
25624
25625 <P>
25626 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
25627 <P>
25628
25629 <P>
25630 The entry
25631
25632 <P>
25633 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
25634 <P>
25635
25636 would match
25637 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
25638 as <SAMP>fred@example.com</SAMP>.
25639
25640 <P>
25641 You could match all addresses that look like
25642 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
25643 entry
25644
25645 <P>
25646 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
25647 <P>
25648
25649 Notice that you have to escape the plus sign with a backslash because plus
25650 is a special character in regular expressions.
25651 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
25652 the expression
25653
25654 <P>
25655 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
25656 <P>
25657
25658 would do it, but it would be easier to just add fred@example.com as a
25659 separate entry.
25660
25661 <P>
25662 One more example, a match of all first-level subdomains, is given by
25663
25664 <P>
25665 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
25666 <P>
25667
25668 <P>
25669 Because the regular expression matching is based on an old library
25670 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
25671 but they should be close.
25672
25673 <P>
25674 <UL>
25675 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25676 </UL><P>
25677 &lt;End of help on this topic&gt;
25678 </BODY>
25679 </HTML>
25680 ====== h_config_abook_formats =====
25681 <HTML>
25682 <HEAD>
25683 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
25684 </HEAD>
25685 <BODY>
25686 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
25687
25688 This option specifies the format that address books are displayed in.
25689 Normally, address books are displayed with the nicknames in the first
25690 column, the fullnames in the second column, and addresses in the third
25691 column.  The system figures out reasonable defaults for the widths of
25692 the columns.  An address book may be given a different format by
25693 listing special tokens in the order you want them to display.  The
25694 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
25695 So, for example, to get the default behavior you could list
25696
25697 <P>
25698 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
25699
25700 <P>
25701 (You can also use the token DEFAULT to get the default behavior for
25702 an address book format.)
25703
25704 <P>
25705 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
25706 is a list, so if you have more than one address book you may have a
25707 separate format for each by putting its format at the corresponding
25708 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
25709
25710 <P>
25711
25712 Listed first are the personal address books, then the global address
25713 books.  So, if you have two personal address books and one global
25714 address book, you may have up to three formats in the
25715 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
25716 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
25717 are address books, the last element is used repeatedly.
25718
25719 <P>
25720
25721 Each of the tokens may also be optionally followed by parentheses with
25722 either a number or a percentage inside the parentheses.  For example,
25723 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
25724 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
25725 of the available space (the screen width minus the space for
25726 inter-column spaces) to the fullnames column, while plain
25727 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
25728 reasonable number of columns.
25729
25730 <P>
25731 There are always 2 spaces between every column, so if you use
25732 fixed column widths (like 13) you should remember to take that into
25733 account.
25734
25735 <P>
25736 <UL>
25737 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25738 </UL><P>
25739 &lt;End of help on this topic&gt;
25740 </BODY>
25741 </HTML>
25742 ====== h_config_set_index_format =====
25743 <HTML>
25744 <HEAD>
25745 <TITLE>Set Index Format</TITLE>
25746 </HEAD>
25747 <BODY>
25748 <H1>Set Index Format</H1>
25749
25750 This option is used to customize the content of lines in the
25751 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
25752 This action works exactly like the regular
25753 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
25754 except that you can have a folder-specific value for it if you specify it here.
25755 Consult the help for
25756 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
25757 for more information.
25758
25759 <P>
25760 <UL>
25761 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25762 </UL><P>
25763 &lt;End of help on this topic&gt;
25764 </BODY>
25765 </HTML>
25766 ====== h_config_index_format =====
25767 <HTML>
25768 <HEAD>
25769 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
25770 </HEAD>
25771 <BODY>
25772 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
25773
25774 This option is used to customize the content of lines in the
25775 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
25776 to convey some amount of immediately relevant information about each
25777 message in the current folder.
25778 <P>
25779
25780 Alpine provides a pre-defined set of informational fields with
25781 reasonable column widths automatically computed.  You can, however,
25782 replace this default set by listing special tokens in the order you
25783 want them displayed.
25784 <P>
25785
25786 The list of available tokens is
25787 <A HREF="h_index_tokens">here</A>.
25788 <P>
25789
25790 Spaces are used to separate listed tokens.  Additionally, you can
25791 specify how much of the screen's width the token's associated data
25792 should occupy on the index line by appending to the token a pair of
25793 parentheses enclosing either a number or percentage.  For example,
25794 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
25795 column, and &quot;SUBJECT(20%)&quot; means to
25796 allocate 20% of the available space
25797 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
25798 attempt to figure out a reasonable amount of space.
25799 <P>
25800
25801 There is always one space between every pair of columns, so if you use fixed
25802 column widths (like 13) you should remember to take that into account.
25803 Several of the fields are virtually fixed-width, so it doesn't make
25804 much sense to specify the width for them.  The fields STATUS,
25805 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
25806 and DESCRIPSIZE all fall into that category.
25807 You <EM>may</EM> specify widths for those if you wish, but
25808 you're probably better off letting the system pick those widths.  <P>
25809
25810 <P>
25811 The default is equivalent to:
25812
25813 <P>
25814 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
25815
25816 <P>
25817 This means that the four fields without percentages will be allocated
25818 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
25819 the from and subject fields.  If one of those two fields is specified
25820 as a percentage and the other is left for the system to choose, then
25821 the percentage is taken as an absolute percentage of the screen, not
25822 of the space remaining after allocating the first four columns.  It
25823 doesn't usually make sense to do it that way.  If you leave off all
25824 the widths, then the subject and from fields (if both are present) are
25825 allocated space in a 2 to 1 ratio, which is almost exactly the same as
25826 the default.
25827
25828 <P>
25829 What you are most likely to do with this configuration option is to
25830 specify which fields appear at all, which order they appear in, and the
25831 percentage of screen that is used for the from and subject fields if you
25832 don't like the 2 to 1 default.
25833
25834 <P>
25835 If you want to retain the default format that Pine 4.64 had, use
25836
25837 <P>
25838 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
25839 <P>
25840 <EM>and</EM> set the feature
25841 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
25842 <UL>
25843 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25844 </UL><P>
25845 &lt;End of help on this topic&gt;
25846 </BODY>
25847 </HTML>
25848 ====== h_config_reply_intro =====
25849 <HTML>
25850 <HEAD>
25851 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
25852 </HEAD>
25853 <BODY>
25854 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
25855
25856 This option is used to customize the content of the introduction line
25857 that is included when replying to a message and including the original
25858 message in the reply.
25859 The normal default (what you will get if you delete this variable) looks
25860 something like:
25861 <P>
25862 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
25863 <P>
25864 where the day of the week is only included if it is available in the
25865 original message.
25866 You can replace this default with text of your own.
25867 The text may contain tokens that are replaced with text
25868 that depends on the message you are replying to.
25869 For example, the default is equivalent to:
25870 <P>
25871 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25872 <P>
25873
25874 Since this variable includes regular text mixed with special tokens
25875 the tokens have to be surrounded by underscore characters.
25876 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
25877 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
25878 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
25879 <P>
25880 The list of available tokens is
25881 <A HREF="h_index_tokens">here</A>.
25882
25883 <P>
25884 By default, the text is all on a single line and is followed by a blank line.
25885 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
25886 than 80 characters when replying to a particular message, it is shortened.
25887 However, if you use the token
25888 <P>
25889 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
25890 <P>
25891
25892 anywhere in the value, no end of line or blank line is appended, and no
25893 shortening is done.
25894 The _NEWLINE_ token may be used to get rid of the blank line following
25895 the text, to add more blank lines, or to form a multi-line
25896 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25897 To clarify how _NEWLINE_ works recall that the default value is:
25898 <P>
25899 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25900 <P>
25901
25902 That is equivalent to
25903 <P>
25904 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
25905 <P>
25906
25907 In the former case, two newlines are added automatically because
25908 no _NEWLINE_ token appears in the value of the option (for backwards
25909 compatibility). In the latter case, the newlines are explicit.
25910 If you want to remove the blank line that follows the
25911 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
25912 _NEWLINE_ token like
25913 <P>
25914 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
25915 <P>
25916
25917 Because of the backwards compatibility problem, it is not possible to
25918 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
25919 and that will cause the automatic adding of two newlines!
25920 If you want, you may embed newlines in the middle of the text, as well,
25921 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25922
25923 <P>
25924 By default, no attempt is made to localize the date.
25925 If you prefer a localized form you may find that one of the tokens
25926 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
25927 If you want more control one of the many other date tokens, such as _DATEISO_,
25928 might be better.
25929
25930 <P>
25931 For the adventurous, there is a way to conditionally include text based
25932 on whether or not a token would result in specific replacement text.
25933 For example, you could include some text based on whether or not
25934 the _NEWS_ token would result in any newsgroups if it was used.
25935 It's explained in detail
25936 <A HREF="h_reply_token_conditionals">here</A>.
25937
25938 <P>
25939 In the very unlikely event that you want to include a literal token
25940 in the introduction line you must precede it with a backslash character.
25941 For example,
25942 <P>
25943 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
25944 <P>
25945 would produce something like
25946 <P>
25947 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
25948 <P>
25949 It is not possible to have a literal backslash followed by an expanded token.
25950 <P>
25951 <UL>
25952 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25953 </UL><P>
25954 &lt;End of help on this topic&gt;
25955 </BODY>
25956 </HTML>
25957 ====== h_config_remote_abook_history =====
25958 <HTML>
25959 <HEAD>
25960 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
25961 </HEAD>
25962 <BODY>
25963 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
25964
25965 Sets how many extra copies of
25966 remote address book
25967 data will be kept in each remote address book folder.
25968 The default is three.
25969 These extra copies are simply old versions of the data. Each time a change
25970 is made a new copy of the address book data is appended to the folder. Old
25971 copies are trimmed, if possible, when Alpine exits.
25972 An old copy can be put back into use by
25973 deleting and expunging newer versions of the data from the folder.
25974 Don't delete the first message from the folder. It is a special header
25975 message for the remote address book and it must be there.
25976 This is to prevent regular folders from being used as remote address book
25977 folders and having their data destroyed.
25978 <P>
25979 This option is also used to determine how many extra copies of remote
25980 Alpine configuration files are kept.
25981 <P>
25982 <UL>
25983 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25984 </UL><P>
25985 &lt;End of help on this topic&gt;
25986 </BODY>
25987 </HTML>
25988 ====== h_config_remote_abook_validity =====
25989 <HTML>
25990 <HEAD>
25991 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
25992 </HEAD>
25993 <BODY>
25994 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
25995
25996 Sets the minimum number of minutes that a
25997 remote address book will be considered up to date.
25998 Whenever an entry contained in a remote address book is used,
25999 if more than this many minutes have
26000 passed since the last check the remote server will be queried to see if the
26001 address book has changed.
26002 If it has changed, the local copy is updated.
26003 The default value is five minutes.
26004 The special value of -1 means never check.
26005 The special value of zero means only check when the address book is first
26006 opened.
26007 <P>
26008 No matter what the value, the validity check is always done when the
26009 address book is about to be changed by the user.
26010 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
26011 while in the address book maintenance screen for the remote address book.
26012 <P>
26013 <UL>
26014 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26015 </UL><P>
26016 &lt;End of help on this topic&gt;
26017 </BODY>
26018 </HTML>
26019 ====== h_config_user_input_timeo =====
26020 <HTML>
26021 <HEAD>
26022 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
26023 </HEAD>
26024 <BODY>
26025 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
26026
26027 If this is set to an integer greater than zero, then this is the number
26028 of <EM>hours</EM> to wait for user input before Alpine times out.
26029 If Alpine is
26030 in the midst of composing a message or is waiting for user response to
26031 a question, then it will not timeout.
26032 However, if Alpine is sitting idle waiting for
26033 the user to tell it what to do next and the user does not give any
26034 input for this many hours, Alpine will exit.
26035 No expunging or moving of read
26036 messages will take place.
26037 It will exit similarly to the way it would exit
26038 if it received a hangup signal.
26039 This may be useful for cleaning up unused Alpine sessions that have been
26040 forgotten by their owners.
26041 The Alpine developers envision system administrators
26042 setting this to a value of several hours (24?) so that it won't surprise
26043 a user who didn't want to be disconnected.
26044 <P>
26045 <UL>
26046 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26047 </UL><P>
26048 &lt;End of help on this topic&gt;
26049 </BODY>
26050 </HTML>
26051 ====== h_config_ssh_open_timeo =====
26052 <HTML>
26053 <HEAD>
26054 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
26055 </HEAD>
26056 <BODY>
26057 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
26058
26059 Sets the time in seconds that Alpine will
26060 attempt to open a UNIX secure shell connection.
26061 The default is 15, the minimum non-zero value is 5,
26062 and the maximum is unlimited. If this is set to zero ssh connections
26063 will be completely disabled.
26064 <P>
26065 <UL>
26066 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26067 </UL><P>
26068 &lt;End of help on this topic&gt;
26069 </BODY>
26070 </HTML>
26071 ====== h_config_rsh_open_timeo =====
26072 <HTML>
26073 <HEAD>
26074 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
26075 </HEAD>
26076 <BODY>
26077 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
26078
26079 Sets the time in seconds that Alpine will
26080 attempt to open a UNIX remote shell connection.
26081 The default is 15, the minimum non-zero value is 5,
26082 and the maximum is unlimited. If this is set to zero rsh connections
26083 will be completely disabled.
26084 This might be useful if rsh connections will never work in your environment
26085 but are causing delays due to firewalls or some other reason.
26086 <P>
26087 <UL>
26088 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26089 </UL><P>
26090 &lt;End of help on this topic&gt;
26091 </BODY>
26092 </HTML>
26093 ====== h_config_tcp_open_timeo =====
26094 <HTML>
26095 <HEAD>
26096 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
26097 </HEAD>
26098 <BODY>
26099 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
26100
26101 Sets the time in seconds that Alpine will
26102 attempt to open a network connection. The default is 30, the minimum is 5,
26103 and the maximum is system defined (typically 75). If a connection has not
26104 completed within this many seconds Alpine will give up and consider it a
26105 failed connection.
26106 <P>
26107 <UL>
26108 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26109 </UL><P>
26110 &lt;End of help on this topic&gt;
26111 </BODY>
26112 </HTML>
26113 ====== h_config_tcp_readwarn_timeo =====
26114 <HTML>
26115 <HEAD>
26116 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
26117 </HEAD>
26118 <BODY>
26119 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
26120
26121 Sets the time in seconds that Alpine will
26122 wait for a network read before warning you that things are moving slowly
26123 and possibly giving you the option to break the connection.
26124 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
26125 1000 seconds.
26126 <P>
26127 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
26128 <P>
26129 <UL>
26130 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26131 </UL><P>
26132 &lt;End of help on this topic&gt;
26133 </BODY>
26134 </HTML>
26135 ====== h_config_tcp_writewarn_timeo =====
26136 <HTML>
26137 <HEAD>
26138 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
26139 </HEAD>
26140 <BODY>
26141 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
26142
26143 Sets the time in seconds that Alpine will
26144 wait for a network write before warning you that things are moving slowly
26145 and possibly giving you the option to break the connection.
26146 The default is 0 which means it is unset. If set to a non-zero value, the
26147 minimum is 5 and the maximum is 1000.
26148 <P>
26149 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
26150 <P>
26151 <UL>
26152 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26153 </UL><P>
26154 &lt;End of help on this topic&gt;
26155 </BODY>
26156 </HTML>
26157 ====== h_config_tcp_query_timeo =====
26158 <HTML>
26159 <HEAD>
26160 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
26161 </HEAD>
26162 <BODY>
26163 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
26164
26165 When Alpine times out a network read or write it will normally just display
26166 a message saying &quot;Still waiting&quot;.
26167 However, if enough time has elapsed since it started waiting it will offer
26168 to let you break the connection.
26169 That amount of time is set by this option, which defaults to 60 seconds,
26170 has a minimum of 5 seconds, and a maximum of 1000 seconds.
26171 <P>
26172 <UL>
26173 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26174 </UL><P>
26175 &lt;End of help on this topic&gt;
26176 </BODY>
26177 </HTML>
26178 ====== h_config_quit_query_timeo =====
26179 <HTML>
26180 <HEAD>
26181 <TITLE>OPTION: <!--#echo var="VAR_close-connection-timeout"--></TITLE>
26182 </HEAD>
26183 <BODY>
26184 <H1>OPTION: <!--#echo var="VAR_close-connection-timeout"--></H1>
26185
26186 The original purpose of this option was to close a connection after this
26187 much time has elapsed without response from the server. The problem this
26188 generates is that a server might not reply on time due to a slow operation
26189 (for example, sorting a large folder, or filtering messages, etc.) In those
26190 situations it is desirable to wait for the server, even when this takes
26191 a long time.
26192
26193 <P>
26194 In order to have a good compromise so that a user can distinguish between
26195 when a connection is closed, therefore
26196 we do not need to wait for it, and the operation that the user is waiting
26197 for takes a long time, this option only applies to the
26198 &quot;NOOP&quot; IMAP command. So, if a NOOP command has been issued,
26199 and the connection does not return after the number of seconds configured
26200 here, which must be at least the amount configured in the option
26201 <a href="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></a>,
26202 then Alpine will close the connection.
26203
26204 <P>
26205 Closing connections that have connectivity problems is a good idea. In an ideal
26206 world, one would like all connections to be fast and reliable, so the amount
26207 of time and effort put into parsing a folder to report its state when it is
26208 opened is not wasted, so keeping connections alive is good, but the problem
26209 with this is that waiting for a user to reply to a &quot;keep connection
26210 alive?&quot; question can take a long time, and that might affect other
26211 connections that could be closed because Alpine is not pinging them while it
26212 is waiting for a reply from a user for a different connection. Therefore
26213 setting this value helps to keep other connections alive, in case
26214 you have several incoming folders in other servers.
26215
26216 <P>
26217 The default value for this option is 0, which means that no connections will
26218 be closed automatically, so if you want connections to be closed automatically
26219 you must set this option to a positive number bigger or equal than the
26220 value of the option <!--#echo var="VAR_tcp-query-timeout"-->.
26221 <P>
26222 <UL>
26223 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26224 </UL><P>
26225 &lt;End of help on this topic&gt;
26226 </BODY>
26227 </HTML>
26228 ====== h_config_incoming_folders =====
26229 <HTML>
26230 <HEAD>
26231 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
26232 </HEAD>
26233 <BODY>
26234 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
26235
26236 This is a list of one or more folders other than <EM>INBOX</EM> that
26237 may receive new messages.
26238 It is related to the
26239 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
26240 feature.
26241 This variable is normally manipulated with the Add, Delete, and Rename
26242 commands in the FOLDER LIST for the Incoming Message Folders collection.
26243 <P>
26244 <UL>
26245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26246 </UL><P>
26247 &lt;End of help on this topic&gt;
26248 </BODY>
26249 </HTML>
26250 ====== h_config_folder_spec =====
26251 <HTML>
26252 <HEAD>
26253 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
26254 </HEAD>
26255 <BODY>
26256 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
26257
26258 This is a list of one or more collections where saved mail is stored.
26259 The first collection in this list is the default
26260 collection for <EM>Save</EM>s,
26261 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
26262 <P>
26263 This variable is normally manipulated using the Setup/collectionList screen.
26264 <P>
26265 <UL>
26266 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26267 </UL><P>
26268 &lt;End of help on this topic&gt;
26269 </BODY>
26270 </HTML>
26271 ====== h_config_news_spec =====
26272 <HTML>
26273 <HEAD>
26274 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
26275 </HEAD>
26276 <BODY>
26277 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
26278
26279 This is a list of collections where news folders are located.
26280 <P>
26281 This variable is normally manipulated using the Setup/collectionList screen.
26282 <P>
26283 <UL>
26284 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26285 </UL><P>
26286 &lt;End of help on this topic&gt;
26287 </BODY>
26288 </HTML>
26289 ====== h_config_address_book =====
26290 <HTML>
26291 <HEAD>
26292 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
26293 </HEAD>
26294 <BODY>
26295 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
26296
26297 A list of personal address books.
26298 Each entry in the list is an
26299 optional nickname followed by a pathname or file name relative to the home
26300 directory.
26301 The nickname is separated from the rest of the line with whitespace.
26302 Instead of a local pathname or file name, a remote folder name can be given.
26303 This causes the address book to
26304 be a Remote address book.
26305 <P>
26306 Use the Setup/AddressBook screen to modify this variable.
26307 <P>
26308 <UL>
26309 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26310 </UL><P>
26311 &lt;End of help on this topic&gt;
26312 </BODY>
26313 </HTML>
26314 ====== h_config_glob_addrbook =====
26315 <HTML>
26316 <HEAD>
26317 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
26318 </HEAD>
26319 <BODY>
26320 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
26321
26322 A list of shared address books.  Each entry in the list is an
26323 optional nickname followed by a pathname or file name relative to the home
26324 directory.
26325 A SPACE character separates the nickname from the rest of the line.
26326 Instead of a local pathname or file name, a remote folder name can be given.
26327 This causes the address book to
26328 be a Remote address book.
26329 Global address books are
26330 defined to be ReadOnly.
26331 <P>
26332 Use the Setup/AddressBook screen to modify this variable.
26333 <P>
26334 <UL>
26335 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26336 </UL><P>
26337 &lt;End of help on this topic&gt;
26338 </BODY>
26339 </HTML>
26340 ====== h_config_last_vers =====
26341 <HTML>
26342 <HEAD>
26343 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
26344 </HEAD>
26345 <BODY>
26346 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
26347
26348 This is set automatically by Alpine.
26349 It is used to keep track of the last version of Alpine that
26350 was run by the user.
26351 Whenever the version number increases, a new version message is printed out.
26352 This may not be set in the system-wide configuration files.
26353 <P>
26354 <UL>
26355 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26356 </UL><P>
26357 &lt;End of help on this topic&gt;
26358 </BODY>
26359 </HTML>
26360 ====== h_config_printer =====
26361 <HTML>
26362 <HEAD>
26363 <TITLE>OPTION: Printer</TITLE>
26364 </HEAD>
26365 <BODY>
26366 <H1>OPTION: Printer</H1>
26367
26368 Your default printer selection.
26369 <P>
26370 Use the Setup/Printer screen to modify this variable.
26371 <P>
26372 <UL>
26373 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26374 </UL><P>
26375 &lt;End of help on this topic&gt;
26376 </BODY>
26377 </HTML>
26378 ====== h_config_print_cat =====
26379 <HTML>
26380 <HEAD>
26381 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
26382 </HEAD>
26383 <BODY>
26384 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
26385
26386 This is an internal Alpine variable.
26387 It will be equal to 1, 2, or 3 depending on whether the default printer is
26388 attached, standard, or a personal print command.
26389 <P>
26390 Use the Setup/Printer screen to modify this variable.
26391 <P>
26392 <UL>
26393 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26394 </UL><P>
26395 &lt;End of help on this topic&gt;
26396 </BODY>
26397 </HTML>
26398 ====== h_config_print_command =====
26399 <HTML>
26400 <HEAD>
26401 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
26402 </HEAD>
26403 <BODY>
26404 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
26405
26406 List of personal print commands.
26407 <P>
26408 Use the Setup/Printer screen to modify this variable.
26409 <P>
26410 <UL>
26411 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26412 </UL><P>
26413 &lt;End of help on this topic&gt;
26414 </BODY>
26415 </HTML>
26416 ====== h_config_pat_old =====
26417 <HTML>
26418 <HEAD>
26419 <TITLE>OPTION: Patterns</TITLE>
26420 </HEAD>
26421 <BODY>
26422 <H1>OPTION: Patterns</H1>
26423
26424 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
26425 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
26426 and Patterns-Other.
26427 Patterns-Scores and Patterns-Filters have been replaced since then by
26428 Patterns-Scores2 and Patterns-Filters2.
26429 <P>
26430 Use the Setup/Rules screens to modify these variable.
26431 <P>
26432 <UL>
26433 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26434 </UL><P>
26435 &lt;End of help on this topic&gt;
26436 </BODY>
26437 </HTML>
26438 ====== h_config_pat_roles =====
26439 <HTML>
26440 <HEAD>
26441 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
26442 </HEAD>
26443 <BODY>
26444 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
26445
26446 List of rules used for roles.
26447 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
26448 other options.
26449 <P>
26450 Use the Setup/Rules/Roles screen to modify this variable.
26451 <P>
26452 <UL>
26453 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26454 </UL><P>
26455 &lt;End of help on this topic&gt;
26456 </BODY>
26457 </HTML>
26458 ====== h_config_pat_filts =====
26459 <HTML>
26460 <HEAD>
26461 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
26462 </HEAD>
26463 <BODY>
26464 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
26465
26466 List of rules used for filters.
26467 <P>
26468 Use the Setup/Rules/Filters screen to modify this variable.
26469 <P>
26470 <UL>
26471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26472 </UL><P>
26473 &lt;End of help on this topic&gt;
26474 </BODY>
26475 </HTML>
26476 ====== h_config_pat_scores =====
26477 <HTML>
26478 <HEAD>
26479 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
26480 </HEAD>
26481 <BODY>
26482 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
26483
26484 List of rules used for scoring.
26485 <P>
26486 Use the Setup/Rules/SetScores screen to modify this variable.
26487 <P>
26488 <UL>
26489 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26490 </UL><P>
26491 &lt;End of help on this topic&gt;
26492 </BODY>
26493 </HTML>
26494 ====== h_config_pat_other =====
26495 <HTML>
26496 <HEAD>
26497 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
26498 </HEAD>
26499 <BODY>
26500 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
26501
26502 List of rules used for miscellaneous configuration.
26503 <P>
26504 Use the Setup/Rules/Other screen to modify this variable.
26505 <P>
26506 <UL>
26507 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26508 </UL><P>
26509 &lt;End of help on this topic&gt;
26510 </BODY>
26511 </HTML>
26512 ====== h_config_pat_incols =====
26513 <HTML>
26514 <HEAD>
26515 <TITLE>OPTION: patterns-indexcolors</TITLE>
26516 </HEAD>
26517 <BODY>
26518 <H1>OPTION: patterns-indexcolors</H1>
26519
26520 List of rules used for coloring lines in the index.
26521 <P>
26522 Use the Setup/Rules/Indexcolor screen to modify this variable.
26523 <P>
26524 <UL>
26525 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26526 </UL><P>
26527 &lt;End of help on this topic&gt;
26528 </BODY>
26529 </HTML>
26530 ====== h_config_pat_srch =====
26531 <HTML>
26532 <HEAD>
26533 <TITLE>OPTION: patterns-search</TITLE>
26534 </HEAD>
26535 <BODY>
26536 <H1>OPTION: patterns-search</H1>
26537
26538 List of rules used only for searching with the Select command in the MESSAGE INDEX.
26539 <P>
26540 Use the Setup/Rules/searCh screen to modify this variable.
26541 <P>
26542 <UL>
26543 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26544 </UL><P>
26545 &lt;End of help on this topic&gt;
26546 </BODY>
26547 </HTML>
26548 ====== h_config_font_name =====
26549 <HTML>
26550 <HEAD>
26551 <TITLE>OPTION: Font Name</TITLE>
26552 </HEAD>
26553 <BODY>
26554 <H1>OPTION: Font Name</H1>
26555
26556 PC-Alpine only.
26557 <P>
26558 Name of normal font.
26559 <P>
26560 Use the pulldown Config menu to modify this variable.
26561 <P>
26562 <UL>
26563 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26564 </UL><P>
26565 &lt;End of help on this topic&gt;
26566 </BODY>
26567 </HTML>
26568 ====== h_config_font_size =====
26569 <HTML>
26570 <HEAD>
26571 <TITLE>OPTION: Font Size</TITLE>
26572 </HEAD>
26573 <BODY>
26574 <H1>OPTION: Font Size</H1>
26575
26576 PC-Alpine only.
26577 <P>
26578 Size of normal font.
26579 <P>
26580 Use the pulldown Config menu to modify this variable.
26581 <P>
26582 <UL>
26583 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26584 </UL><P>
26585 &lt;End of help on this topic&gt;
26586 </BODY>
26587 </HTML>
26588 ====== h_config_font_style =====
26589 <HTML>
26590 <HEAD>
26591 <TITLE>OPTION: Font Style</TITLE>
26592 </HEAD>
26593 <BODY>
26594 <H1>OPTION: Font Style</H1>
26595
26596 PC-Alpine only.
26597 <P>
26598 Style of normal font.
26599 <P>
26600 Use the pulldown Config menu to modify this variable.
26601 <P>
26602 <UL>
26603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26604 </UL><P>
26605 &lt;End of help on this topic&gt;
26606 </BODY>
26607 </HTML>
26608 ====== h_config_font_char_set =====
26609 <HTML>
26610 <HEAD>
26611 <TITLE>OPTION: Font Character Set</TITLE>
26612 </HEAD>
26613 <BODY>
26614 <H1>OPTION: Font Character Set</H1>
26615
26616 PC-Alpine only.
26617 <P>
26618 Character set of normal font.
26619 <P>
26620 Use the pulldown Config menu to modify this variable.
26621 <P>
26622 <UL>
26623 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26624 </UL><P>
26625 &lt;End of help on this topic&gt;
26626 </BODY>
26627 </HTML>
26628 ====== h_config_print_font_name =====
26629 <HTML>
26630 <HEAD>
26631 <TITLE>OPTION: Print-Font-Name</TITLE>
26632 </HEAD>
26633 <BODY>
26634 <H1>OPTION: Print-Font-Name</H1>
26635
26636 PC-Alpine only.
26637 <P>
26638 Name of printer font.
26639 <P>
26640 Use the pulldown Config menu to modify this variable.
26641 <P>
26642 <UL>
26643 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26644 </UL><P>
26645 &lt;End of help on this topic&gt;
26646 </BODY>
26647 </HTML>
26648 ====== h_config_print_font_size =====
26649 <HTML>
26650 <HEAD>
26651 <TITLE>OPTION: Print-Font-Size</TITLE>
26652 </HEAD>
26653 <BODY>
26654 <H1>OPTION: Print-Font-Size</H1>
26655
26656 PC-Alpine only.
26657 <P>
26658 Size of printer font.
26659 <P>
26660 Use the pulldown Config menu to modify this variable.
26661 <P>
26662 <UL>
26663 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26664 </UL><P>
26665 &lt;End of help on this topic&gt;
26666 </BODY>
26667 </HTML>
26668 ====== h_config_print_font_style =====
26669 <HTML>
26670 <HEAD>
26671 <TITLE>OPTION: Print-Font-Style</TITLE>
26672 </HEAD>
26673 <BODY>
26674 <H1>OPTION: Print-Font-Style</H1>
26675
26676 PC-Alpine only.
26677 <P>
26678 Style of printer font.
26679 <P>
26680 Use the pulldown Config menu to modify this variable.
26681 <P>
26682 <UL>
26683 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26684 </UL><P>
26685 &lt;End of help on this topic&gt;
26686 </BODY>
26687 </HTML>
26688 ====== h_config_print_font_char_set =====
26689 <HTML>
26690 <HEAD>
26691 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
26692 </HEAD>
26693 <BODY>
26694 <H1>OPTION: Print-Font-Char-Set</H1>
26695
26696 PC-Alpine only.
26697 <P>
26698 Character set of printer font.
26699 <P>
26700 Use the pulldown Config menu to modify this variable.
26701 <P>
26702 <UL>
26703 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26704 </UL><P>
26705 &lt;End of help on this topic&gt;
26706 </BODY>
26707 </HTML>
26708 ====== h_config_window_position =====
26709 <HTML>
26710 <HEAD>
26711 <TITLE>OPTION: Window-Position</TITLE>
26712 </HEAD>
26713 <BODY>
26714 <H1>OPTION: Window-Position</H1>
26715
26716 PC-Alpine only.
26717 <P>
26718 Position on the screen of the Alpine window.
26719 <P>
26720 Alpine normally maintains this variable itself, and it is set automatically.
26721 This variable is provided to those who wish to use the same window position
26722 across different machines from the same configuration.
26723 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
26724 must also be set for this setting to be used.
26725 <P>
26726 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
26727 C is the number of columns, R is the number of rows, and X and Y specify the
26728 top left corner of the window.
26729 <P>
26730 <UL>
26731 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26732 </UL><P>
26733 &lt;End of help on this topic&gt;
26734 </BODY>
26735 </HTML>
26736 ====== h_config_cursor_style =====
26737 <HTML>
26738 <HEAD>
26739 <TITLE>OPTION: Cursor Style</TITLE>
26740 </HEAD>
26741 <BODY>
26742 <H1>OPTION: Cursor Style</H1>
26743
26744 PC-Alpine only.
26745 <P>
26746 Cursor style.
26747 <P>
26748 Use the pulldown Config menu to modify this variable.
26749 <P>
26750 <UL>
26751 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26752 </UL><P>
26753 &lt;End of help on this topic&gt;
26754 </BODY>
26755 </HTML>
26756 ====== h_config_ldap_servers =====
26757 <HTML>
26758 <HEAD>
26759 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
26760 </HEAD>
26761 <BODY>
26762 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
26763
26764 List of LDAP servers and associated data.
26765 <P>
26766 Use the Setup/Directory screen to modify this variable.
26767 <P>
26768 <UL>
26769 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26770 </UL><P>
26771 &lt;End of help on this topic&gt;
26772 </BODY>
26773 </HTML>
26774 ====== h_config_sendmail_path =====
26775 <HTML>
26776 <HEAD>
26777 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
26778 </HEAD>
26779 <BODY>
26780 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
26781
26782 This names the path to an
26783 alternative program, and any necessary arguments, to be used in posting
26784 mail messages. See the Technical notes for more information.
26785 <P>
26786 <UL>
26787 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26788 </UL><P>
26789 &lt;End of help on this topic&gt;
26790 </BODY>
26791 </HTML>
26792 ====== h_config_oper_dir =====
26793 <HTML>
26794 <HEAD>
26795 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
26796 </HEAD>
26797 <BODY>
26798 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
26799
26800 This names the root of the
26801 tree to which you are restricted when reading and writing folders and
26802 files. It is usually used in the system-wide,
26803 <EM>fixed</EM> configuration file.
26804 <P>
26805 <UL>
26806 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26807 </UL><P>
26808 &lt;End of help on this topic&gt;
26809 </BODY>
26810 </HTML>
26811 ====== h_config_rshpath =====
26812 <HTML>
26813 <HEAD>
26814 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
26815 </HEAD>
26816 <BODY>
26817 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
26818
26819 Sets the name of the command used to open a UNIX remote shell
26820 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
26821 <P>
26822 <UL>
26823 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26824 </UL><P>
26825 &lt;End of help on this topic&gt;
26826 </BODY>
26827 </HTML>
26828 ====== h_config_rshcmd =====
26829 <HTML>
26830 <HEAD>
26831 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
26832 </HEAD>
26833 <BODY>
26834 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
26835
26836 Sets the format of the command used to
26837 open a UNIX remote shell connection. The default is
26838 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26839 provided command. The first is for the command's pathname, the second is
26840 for the host to connect to, the third is for the user to connect as, and
26841 the fourth is for the connection method (typically <CODE>imap</CODE>).
26842 <P>
26843 <UL>
26844 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26845 </UL><P>
26846 &lt;End of help on this topic&gt;
26847 </BODY>
26848 </HTML>
26849 ====== h_config_sshpath =====
26850 <HTML>
26851 <HEAD>
26852 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
26853 </HEAD>
26854 <BODY>
26855 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
26856
26857 Sets the name of the command used to open a UNIX secure shell
26858 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
26859 <P>
26860 <UL>
26861 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26862 </UL><P>
26863 &lt;End of help on this topic&gt;
26864 </BODY>
26865 </HTML>
26866 ====== h_config_sshcmd =====
26867 <HTML>
26868 <HEAD>
26869 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
26870 </HEAD>
26871 <BODY>
26872 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
26873
26874 Sets the format of the command used to
26875 open a UNIX secure shell connection. The default is
26876 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26877 provided command. The first is for the command's pathname, the second is
26878 for the host to connect to, the third is for the user to connect as, and
26879 the fourth is for the connection method (typically <CODE>imap</CODE>).
26880 <P>
26881 <UL>
26882 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26883 </UL><P>
26884 &lt;End of help on this topic&gt;
26885 </BODY>
26886 </HTML>
26887 ====== h_config_new_ver_quell =====
26888 <HTML>
26889 <HEAD>
26890 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
26891 </HEAD>
26892 <BODY>
26893 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
26894
26895 When a new version of Alpine is run for the first time it offers a
26896 special explanatory screen to the user upon startup.  This option
26897 helps control when and if that special screen appears for users that
26898 have previously run Alpine.  It takes as its value an Alpine version
26899 number.  Alpine versions less than the specified value will suppress this
26900 special screen while versions equal to or greater than that specified
26901 will behave normally.
26902 <P>
26903 <UL>
26904 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26905 </UL><P>
26906 &lt;End of help on this topic&gt;
26907 </BODY>
26908 </HTML>
26909 ====== h_config_disable_drivers =====
26910 <HTML>
26911 <HEAD>
26912 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
26913 </HEAD>
26914 <BODY>
26915 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
26916
26917 This variable is a list of mail drivers that will be disabled.
26918 The candidates for disabling are listed below.
26919 There may be more in the future if you compile Alpine with
26920 a newer version of the c-client library.
26921 <P>
26922
26923 <UL>
26924 <LI> mbox
26925 <LI> mbx
26926 <LI> mh
26927 <LI> mmdf
26928 <LI> mtx
26929 <LI> mx
26930 <LI> news
26931 <LI> phile
26932 <LI> tenex
26933 <LI> unix
26934 </UL>
26935 <P>
26936
26937 The <EM>mbox</EM> driver enables the following behavior: if there is a
26938 file called <CODE>mbox</CODE>
26939 in your home directory, and if that file is either empty or in Unix mailbox
26940 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
26941 will automatically transfer mail from the system mail spool directory into the
26942 <CODE>mbox</CODE> file and
26943 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
26944 this will not happen.
26945 <P>
26946
26947 It is not recommended to disable the driver that supports the system default
26948 mailbox format. On most non-SCO systems, that driver is the
26949 <EM>unix</EM> driver.
26950 On most SCO systems, it is the <EM>mmdf</EM> driver.
26951 The system default driver may be
26952 configured to something else on your system; check with your system manager
26953 for additional information.
26954 <P>
26955
26956 It is most likely not very useful for you to disable any of the drivers other
26957 than possibly <EM>mbox</EM>.
26958 You could disable some of the others if you know for
26959 certain that you don't need them but the performance gain in doing so
26960 is very modest.
26961 <P>
26962 <UL>
26963 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26964 </UL><P>
26965 &lt;End of help on this topic&gt;
26966 </BODY>
26967 </HTML>
26968 ====== h_config_disable_auths =====
26969 <HTML>
26970 <HEAD>
26971 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
26972 </HEAD>
26973 <BODY>
26974 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
26975
26976 This variable is a list of SASL (Simple Authentication and Security
26977 Layer) authenticators that will be disabled.
26978 SASL is a mechanism for
26979 authenticating to IMAP, POP3, SMTP, and other network servers.
26980 <P>
26981
26982 Alpine matches its list of supported authenticators with the server to
26983 determine the most secure authenticator that is supported by both.
26984 If no matching authenticators are found, Alpine will revert to plaintext
26985 login (or, in the case of SMTP, will be unable to authenticate at all).
26986 <P>
26987 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
26988 <P>
26989
26990 Normally, you will not disable any authenticators.
26991 There are two exceptions:
26992 <P>
26993 <OL>
26994 <LI> You use a broken server that advertises an authenticator,
26995 but does not actually implement it.
26996 <LI> You have a Kerberos-capable version of Alpine and the server is
26997 also Kerberos-capable, but you can not obtain Kerberos
26998 credentials on the server machine, thus you desire to disable
26999 GSSAPI (which in turn disables Alpine's Kerberos support).
27000 </OL>
27001 <P>
27002 It is never necessary to disable authenticators, since Alpine will try
27003 other authenticators before giving up.
27004 However, disabling the relevant authenticator avoids annoying error messages.
27005 <P>
27006 <UL>
27007 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27008 </UL><P>
27009 &lt;End of help on this topic&gt;
27010 </BODY>
27011 </HTML>
27012 ====== h_config_encryption_range =====
27013 <HTML>
27014 <HEAD>
27015 <TITLE>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></TITLE>
27016 </HEAD>
27017 <BODY>
27018 <H1>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></H1>
27019
27020 This option sets a range of encryption protocols that can be attempted when
27021 Alpine will try to establish a secure connection using the SSL or TLS
27022 protocols.
27023
27024 <P>
27025 Before a secure connection to an external server is established, Alpine and the
27026 server will attempt to negotiate a secure connection. This part is known as the
27027 &quot;ClientHello&quot;. At that time Alpine will announce the version of
27028 encryption that it would like to establish. The server can reject that, and announce
27029 a different version of encryption. Once both the server and Alpine have found
27030 a version of encryption that they both agree on, they will both use it to start
27031 a secure connection.
27032
27033 <P>
27034 The use of the /ssl parameter in the definition of the server will make Alpine
27035 attempt the highest encryption protocol that it can use, in agreement with the
27036 server. However, using this option, you will set limits to the versions of
27037 the protocols that are used. This would, for example, allow you to disable the use
27038 of ssl3, in favor of more modern protocols.
27039
27040 <P>
27041 For purposes of this option, the protocols are sorted
27042 as follows
27043
27044 <P>
27045 <CENTER>
27046 no_min < ssl3 < tls1 < tls1_1 < tls1_2 < tls1_3 < no_max
27047 </CENTER>
27048
27049 <P>
27050 For example, if you want to disable ssl3, all you have to do is to set the minimum
27051 version to tls1, or any higher protocol.
27052
27053 <P>The name of the parameters used to configure this option is the same as the
27054 parameters that are added to the definition of a server to make it a secure
27055 connection, and they are listed above for your reference.
27056
27057 <P>
27058 The special values &quot;no_min&quot; and &quot;no_max&quot; do not set values
27059 for the minimum and maximum protocol versions, and Alpine will use the maximum
27060 and minimum values of encryption protocols built into your SSL library.
27061
27062 <P>
27063 <UL>
27064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27065 </UL><P>
27066 &lt;End of help on this topic&gt;
27067 </BODY>
27068 </HTML>
27069 ====== h_config_abook_metafile =====
27070 <HTML>
27071 <HEAD>
27072 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
27073 </HEAD>
27074 <BODY>
27075 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
27076
27077 This is usually set by Alpine and is the name of a file
27078 that contains data about
27079 remote address books and remote configuration files.
27080 <P>
27081 <UL>
27082 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27083 </UL><P>
27084 &lt;End of help on this topic&gt;
27085 </BODY>
27086 </HTML>
27087 ====== h_config_composer_wrap_column =====
27088 <HTML>
27089 <HEAD>
27090 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
27091 </HEAD>
27092 <BODY>
27093 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
27094
27095
27096 This option specifies an aspect of Alpine's Composer.  This gives the
27097 maximum width that auto-wrapped lines will have.  It's also the maximum
27098 width of lines justified using the <A HREF="h_compose_justify">^J
27099 Justify</A> command.  The normal default
27100 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
27101 in order to
27102 prevent very long lines from being sent in outgoing mail.  When the mail
27103 is actually sent, trailing spaces will be stripped off of each line.
27104
27105 <P>
27106 <UL>
27107 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27108 </UL><P>
27109 &lt;End of help on this topic&gt;
27110 </BODY>
27111 </HTML>
27112 ====== h_config_deadlets =====
27113 <HTML>
27114 <HEAD>
27115 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
27116 </HEAD>
27117 <BODY>
27118 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
27119
27120
27121 This option affects Alpine's behavior when you cancel a message being
27122 composed.  Alpine's usual behavior is to write the canceled message to
27123 a file named
27124 <!--chtml if pinemode="os_windows"-->
27125 &quot;DEADLETR&quot;,
27126 <!--chtml else-->
27127 &quot;dead.letter&quot; in your home directory,
27128 <!--chtml endif-->
27129 overwriting any previous message.
27130 <P>
27131 If you set this option to a value higher than one, then that many copies
27132 of dead letter files will be saved.
27133 For example, if you set this option to &quot;3&quot; then you may have
27134 files named
27135 <!--chtml if pinemode="os_windows"-->
27136 &quot;DEADLETR&quot;,
27137 &quot;DEADLETR2&quot;, and
27138 &quot;DEADLETR3&quot;.
27139 <!--chtml else-->
27140 &quot;dead.letter&quot;,
27141 &quot;dead.letter2&quot;, and
27142 &quot;dead.letter3&quot; in your home directory.
27143 <!--chtml endif-->
27144 In this example, the most recently cancelled message will be in
27145 <!--chtml if pinemode="os_windows"-->
27146 &quot;DEADLETR&quot;,
27147 <!--chtml else-->
27148 &quot;dead.letter&quot;,
27149 <!--chtml endif-->
27150 and the third most recently cancelled message will be in
27151 <!--chtml if pinemode="os_windows"-->
27152 &quot;DEADLETR3&quot;.
27153 <!--chtml else-->
27154 &quot;dead.letter3&quot;.
27155 <!--chtml endif-->
27156 The fourth most recently cancelled message will no longer be saved.
27157
27158 <P>
27159 If you set this option to zero, then NO record of canceled messages is
27160 maintained.
27161 <P>
27162 If the feature
27163 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
27164 is set, that overrides whatever you set for this option.
27165 If this option had existed at the time, then the Quell feature would not
27166 have been added, but it is still there for backwards compatibility.
27167 So, in order for this option to have the desired effect, make sure the
27168 Quell feature is turned off.
27169
27170 <P>
27171 <UL>
27172 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27173 </UL><P>
27174 &lt;End of help on this topic&gt;
27175 </BODY>
27176 </HTML>
27177 ====== h_config_maxremstream =====
27178 <HTML>
27179 <HEAD>
27180 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
27181 </HEAD>
27182 <BODY>
27183 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
27184
27185 This option affects low-level behavior of Alpine.
27186 The default value for this option is <EM>3</EM>.
27187 If your INBOX is accessed using the IMAP protocol
27188 from an IMAP server, that connection is kept open throughout the
27189 duration of your Alpine session, independent of the value of this option.
27190 The same is true of any
27191 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
27192 you have defined.
27193 This option controls Alpine's behavior when connecting to remote IMAP folders
27194 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
27195 It specifies the maximum number of remote IMAP connections (other than
27196 those mentioned above) that Alpine will use for accessing the rest of your
27197 folders.
27198 If you set this option to zero, you will turn off most remote connection
27199 re-use.
27200 It's difficult to understand exactly what this option does, and it is usually
27201 fine to leave it set to its default value.
27202 It is probably more likely that you will be interested in setting the
27203 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
27204 instead of changing the value of this option.
27205 A slightly longer explanation of what is going on with this option
27206 is given in the next paragraphs.
27207
27208 <P>
27209 There are some time costs involved in opening and closing remote IMAP
27210 folders, the main costs being the time you have to wait for the connection
27211 to the server and the time for the folder to open.
27212 Opening a folder may involve not only the time the server takes to do its
27213 processing but time that Alpine uses to do filtering.
27214 These times can vary widely.
27215 They depend on how loaded the server is, how large
27216 the folder being opened is, and how you set up filtering, among other things.
27217 Once Alpine has opened a connection to a particular folder, it will attempt
27218 to keep that connection open in case you use it again.
27219 In order to do this,
27220 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
27221 this option) IMAP connections you have allotted for this purpose.
27222 <P>
27223 For example, suppose the value of this option is set to &quot;2&quot;.
27224 If your INBOX is accessed on a remote server using the IMAP protocol, that
27225 doesn't count as one of the remote connections but it is always kept open.
27226 If you then open another IMAP folder, that would be your first
27227 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
27228 If you open a third folder the second will be left open, in case you
27229 return to it.
27230 You won't be able to tell it has been left open.
27231 It will appear to be closed when you leave the folder but the connection
27232 will remain in the background.
27233 Now suppose you go back to the second folder (the first folder after the
27234 INBOX).
27235 A connection to that folder is still open so you won't have to wait
27236 for the startup time to open it.
27237 Meanwhile, the connection to the third folder will be left behind.
27238 Now, if you open a fourth folder, you will bump into the
27239 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
27240 than INBOX and you have the option set to &quot;2&quot;.
27241 The connection that is being used for
27242 the third folder will be re-used for this new fourth folder.
27243 If you go back to the third folder after this, it is no longer already
27244 connected when you get there.
27245 You'll still save some time since Alpine will re-use the connection to the
27246 fourth folder and you have already logged in on that connection,
27247 but the folder will have to be re-opened from scratch.
27248 <P>
27249 If a folder is large and the startup cost is dominated by the time it takes
27250 to open that folder or to run filters on it, then it will pay to make the
27251 value of this option large enough to keep it open.
27252 On the other hand, if you only revisit a handful of folders or if
27253 the folders are small, then it might
27254 make more sense to keep this number small so that the reconnect
27255 time (the time to start up a new connection and authenticate)
27256 is eliminated instead.
27257 <P>
27258 You may also need to consider the impact on the server.
27259 On the surface, a larger number here may cause a larger impact on the
27260 server, since you will have more connections open to the server.
27261 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
27262 associated with reopening a folder, but the <EM>server</EM> will be
27263 avoiding those costs as well.
27264 <P>
27265 When twenty five minutes pass without any active use of an IMAP connection
27266 being saved for possible re-use, that connection will be shut down,
27267
27268 <P>
27269 <UL>
27270 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27271 </UL><P>
27272 &lt;End of help on this topic&gt;
27273 </BODY>
27274 </HTML>
27275 ====== h_config_permlocked =====
27276 <HTML>
27277 <HEAD>
27278 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
27279 </HEAD>
27280 <BODY>
27281 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
27282
27283 This option affects low-level behavior of Alpine.
27284 There is no default value for this option.
27285 It is related to the options
27286 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
27287 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
27288 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
27289
27290 <P>
27291 Note: changes made to this list take effect the next time you open a
27292 folder in the list.
27293
27294 <P>
27295 This is a list of folders that will be permanently kept open once they
27296 are first opened.
27297 The names in this list may be either the nickname of an Incoming folder
27298 or the full technical specification of a folder.
27299 The folders in this list need not be remote IMAP folders, they could usefully
27300 be local folders, as well.
27301 If a folder in the list is a newsgroup or is not accessed either locally
27302 or via IMAP, then the entry will be ignored.
27303 For example, folders accessed via NNTP or POP3 will not be kept open, since
27304 the way that new mail is found with those protocols involves closing and
27305 reopening the connection.
27306 <P>
27307 Once a Stay Open folder has been opened, new-mail checking will continue
27308 to happen on that folder for the rest of the Alpine session.
27309 Your INBOX is always implicitly included in this Stay-Open list and doesn't
27310 need to be added explicitly.
27311 <P>
27312 Another difference that you may notice between a Stay Open folder and a
27313 non-Stay Open folder is which message is selected as the current message
27314 when you enter the folder index.
27315 Normally, the starting position for an incoming folder (which most Stay Open
27316 folders will likely be) is controlled by the
27317 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
27318 However, if a folder is a Stay Open folder, when you re-enter the folder
27319 after the first time the current message will be the same as it was when
27320 you left the folder.
27321 An exception is made if you use the TAB command to get to the folder.
27322 In that case, the message number will be incremented by one from what it
27323 was when you left the folder.
27324 <P>
27325 The above special behavior is thought to be useful.
27326 However, it is special and different from what you might at first expect.
27327 The feature
27328 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
27329 may be used to turn off this special treatment.
27330 <P>
27331 If the message that was current when you left the folder no longer exists,
27332 then the regular startup rule will be used instead.
27333
27334 <P>
27335 <UL>
27336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27337 </UL><P>
27338 &lt;End of help on this topic&gt;
27339 </BODY>
27340 </HTML>
27341 ====== h_config_viewer_overlap =====
27342 <html>
27343 <header>
27344 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
27345 </header>
27346 <body>
27347 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
27348
27349 This option specifies an aspect of Alpine's Message Viewing screen.  When
27350 the space bar is used to page forward in a message, the number of lines
27351 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
27352 bottom of the screen.  That is, if this was set to two lines, then the
27353 bottom two lines of the screen would be repeated on the top of the next
27354 screen.  The normal default value is "2".<p>
27355 <UL>
27356 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27357 </UL><P>
27358 &lt;End of help on this topic&gt;
27359 </body>
27360 </html>
27361 ====== h_config_scroll_margin =====
27362 <HTML>
27363 <HEAD>
27364 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
27365 </HEAD>
27366 <BODY>
27367 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
27368
27369 This option controls when Alpine's line-by-line scrolling occurs.
27370 Typically, when a selected item is at the top or bottom screen edge
27371 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
27372 displayed items are scrolled down or up by a single line.
27373
27374 <P>
27375 This option allows you to tell Alpine the number of lines from the top and
27376 bottom screen edge that line-by-line paging should occur.  For example,
27377 setting this value to one (1) will cause Alpine to scroll the display
27378 vertically when you move to select an item on the display's top or
27379 bottom edge.
27380
27381 <P>
27382 By default, this variable is zero, indicating that scrolling happens
27383 when you move up or down to select an item immediately off the display's
27384 top or bottom edge.
27385
27386 <P>
27387 <UL>
27388 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27389 </UL><P>
27390 &lt;End of help on this topic&gt;
27391 </BODY>
27392 </HTML>
27393 ====== h_config_wordseps =====
27394 <HTML>
27395 <HEAD>
27396 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
27397 </HEAD>
27398 <BODY>
27399 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
27400
27401 This option affects how a &quot;word&quot; is defined in the composer.
27402 The definition of a word is used when using the Forward Word and Backward
27403 Word commands in the composer, as well as when using the spell checker.
27404 Whitespace is always considered a word separator.
27405 Punctuation (like question marks, periods, commas, and so on) is always
27406 a word separator if it comes at the end of a word.
27407 By default, a punctuation character that is in the middle of a word does
27408 not break up that word as long as the character before and the character
27409 after it are both alphanumeric.
27410 If you add a character to this option it will be considered a
27411 word separator even when it occurs in the middle of an alphanumeric word.
27412 For example, if you want to skip through each part of an address instead
27413 of skipping the whole address at once you might want to include &quot;@&quot;
27414 and &quot;.&quot; in this list.
27415 If you want the word-skipper to stop on each part of a UNIX filename you
27416 could add &quot;/&quot; to the list.
27417 The equal sign and dash are other possibilities you might find helpful.
27418 <P>
27419 <UL>
27420 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27421 </UL><P>
27422 &lt;End of help on this topic&gt;
27423 </BODY>
27424 </HTML>
27425 ====== h_config_reply_indent_string =====
27426 <HTML>
27427 <HEAD>
27428 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
27429 </HEAD>
27430 <BODY>
27431 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
27432
27433 This option specifies an aspect of Alpine's Reply command.
27434 When a message is replied to and the text of the message is included, the
27435 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
27436 to each line indicating it is quoted text.
27437 (In case you haven't seen this before, &quot;string&quot; is a technical term
27438 that means chunk of text.)
27439
27440 <P>
27441 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
27442 in 1999 and its wide-spread adoption since then, you will usually be better off if you
27443 use one of the standard values,
27444 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
27445
27446 <P>
27447 This option specifies a different value for that string.
27448 If you wish to use a string that begins or ends with a space,
27449 enclose the string in double quotes.
27450
27451 <P>
27452 Besides simple text, the prepended string can be based
27453 on the message being replied to.
27454 The following tokens are substituted for the message's corresponding value:
27455
27456 <DL>
27457 <DT>_FROM_</DT>
27458 <DD>This token gets replaced with the message sender's &quot;username&quot;.
27459 If the name is longer than six characters, only the first six characters are
27460 used.
27461 </DD>
27462
27463 <DT>_NICK_</DT>
27464 <DD>This token gets replaced with the nickname of the message sender's
27465 address as found in your addressbook.
27466 If no addressbook entry is found,
27467 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
27468 If the nickname is longer than six characters, only the first six characters are
27469 used.
27470 </DD>
27471
27472 <DT>_INIT_</DT>
27473 <DD>This token gets replaced with the initials of the sender of the message.
27474 </DD>
27475
27476 </DL>
27477
27478 NOTE: When the
27479 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
27480 feature is enabled, you are given the opportunity to edit the string, whether
27481 it is the default or one automatically generated using the above tokens.
27482 <P>
27483 If you change your <!--#echo var="VAR_reply-indent-string"-->
27484 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
27485 quoted text will not be flowed
27486 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
27487 when you reply.
27488 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
27489 set to the default value.
27490 <P>
27491 <UL>
27492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27493 </UL><P>
27494 &lt;End of help on this topic&gt;
27495 </BODY>
27496 </HTML>
27497 ====== h_config_quote_replace_string =====
27498 <HTML>
27499 <HEAD>
27500 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
27501 </HEAD>
27502 <BODY>
27503 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
27504
27505 This option specifies what string to use as a quote when <b>viewing</b> a
27506 message.  The standard way of quoting messages when replying is the string
27507 &quot;&gt;&nbsp;&quot; (quote space).
27508 With this variable set, viewing a message will
27509 replace occurrences of
27510 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
27511 This setting works best when
27512 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
27513 or the equivalent setting in your correspondents' mail programs
27514 is set to the default
27515 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
27516 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
27517 <P>
27518 By default, this setting will only work on messages that are flowed, which is
27519 the default way of sending messages for many mail clients including
27520 Alpine.  Enable the feature
27521 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
27522 to also have quote-replacement performed on non-flowed messages.
27523 <P>
27524
27525 Setting this option will replace  &quot;&gt;&quot; and
27526 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
27527 spaces. To preserve those spaces enclose the full string in double quotes.
27528 <P>
27529 No padding to separate the text of the message from the quote string is
27530 added. This means that if you do not add trailing spaces to the value of
27531 this variable, text will be displayed right next to the quote string,
27532 which may be undesirable. This can be avoided by adding a new string
27533 separated by a space from your selection of quote string replacement. This
27534 last string will be used for padding. For example, setting this variable to
27535 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
27536 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
27537 a space from the last quote string to make it more readable.
27538 <P>
27539 One possible setting for this variable could be
27540 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
27541 would have the effect of indenting each level of quoting four spaces and
27542 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
27543 more discernible by setting colors for quoted text.
27544 <P>
27545 Replying to or forwarding the viewed message will preserve the original
27546 formatting of the message, so quote-replacement will not be performed on
27547 messages that are being composed.
27548 <P>
27549 <UL>
27550 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27551 </UL><P>
27552 &lt;End of help on this topic&gt;
27553 </BODY>
27554 </HTML>
27555 ====== h_config_empty_hdr_msg =====
27556 <HTML>
27557 <HEAD>
27558 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
27559 </HEAD>
27560 <BODY>
27561 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
27562
27563 When sending, if both the To and Cc fields are empty and you
27564 are sending the message to a Bcc,
27565 Alpine will put a special address in the To line.  The default value is:
27566
27567 <P>
27568 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
27569
27570 <P>
27571 The reason for this is to avoid embarrassment caused by some Internet
27572 mail transfer software that interprets a &quot;missing&quot;
27573 <SAMP>To:</SAMP> header as an error and replaces it with an
27574 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
27575 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
27576 Bcc.  You may change the part of this message that comes before the
27577 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
27578 variable to something else.
27579
27580 <P>
27581 The normal default is &quot;undisclosed-recipients&quot;.
27582
27583 <P>
27584 <UL>
27585 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27586 </UL><P>
27587 &lt;End of help on this topic&gt;
27588 </BODY>
27589 </HTML>
27590 ====== h_config_status_msg_delay =====
27591 <HTML>
27592 <HEAD>
27593 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
27594 </HEAD>
27595 <BODY>
27596 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
27597
27598 This option has evolved over time, causing the possible values to be
27599 counter-intuitive.
27600 Read carefully before you set this option.
27601 First we explain what the option does, then there is a longer discussion
27602 following that.
27603 <P>
27604 If this is set to zero, the default value, it has <EM>no</EM> effect.
27605 Positive and negative values serve two similar, but different purposes.
27606 <P>
27607 If it is set to a positive number, it causes the cursor to move to the
27608 status line whenever a status message is printed and pause there for this
27609 many seconds.
27610 It will probably only be useful if the
27611 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
27612 also turned on.
27613 Setting this option to a positive number can only be used to
27614 <EM>increase</EM> the status message delay.
27615 This may be useful for Braille displays, or other non-traditional displays.
27616 <P>
27617 If it is set to a negative number the interpretation is a bit complicated.
27618 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
27619 allow you to read important status messages.
27620 Of course, this may cause you to miss some important messages.
27621 If you see a message flash by but miss what it says you can use the
27622 Journal command from the MAIN MENU to read it.
27623 If you set this option to a negative value, the delay will be
27624 no more than one second less than the absolute value
27625 of the value you set.
27626 So if you set it to -1, the delay will be no more than zero seconds, no
27627 delay at all.
27628 If you set it to -2, the delay will be no more than 1 second.
27629 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
27630 If the delay that Alpine would have used by default is less than this delay,
27631 then the smaller delay set by Alpine will be used.
27632 Setting this option to a negative value can only reduce the amount of
27633 delay, never increase it.
27634 <P>
27635 Here is a more detailed explanation.
27636 Status messages are the messages that show up spontaneously in the
27637 status message line, usually the third line from the bottom of the screen.
27638 By default, Alpine assigns each status message it produces a minimum
27639 display time.
27640 Some status messages have a minimum display time of zero.
27641 You can see an example of such a message by paging up in this help text
27642 until you reach the top of the screen.
27643 If you try to page past the top you will see the message
27644 <P>
27645 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
27646 <P>
27647 in the status line.
27648 If there is another more important use of the status message line this message
27649 might be replaced quickly, or it even might not be shown at all.
27650 However, if there is no reason to get rid of the message, it might stay
27651 there for several seconds while you read the help.
27652 An example where it is replaced immediately happens when you page up in
27653 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
27654 command right after paging up.
27655 The message will disappear immediately without causing a delay (unless you
27656 have set this option to a positive value) to allow you to type input for
27657 the &quot;WhereIs&quot; command.
27658 Since it isn't a very important message, Alpine has set its minimum display
27659 time to zero seconds.
27660 <P>
27661 Other messages have minimum display times of three or more seconds.
27662 These are usually error messages that Alpine thinks you ought to see.
27663 For example, it might be a message about a failed Save or a failed folder open.
27664 It is often the case that this minimum display time won't delay you in
27665 any way because the status message line is not needed for another reason.
27666 However, there are times when Alpine has to delay what it is doing in
27667 order to display a status message for the minimum display time.
27668 This happens when a message is being displayed and Alpine wants to ask
27669 for input from the keyboard.
27670 For example, when you Save a message you use the status message line.
27671 You get a prompt there asking for the name of the folder to save to.
27672 If there is a status message being displayed that has not
27673 yet displayed for its minimum
27674 time Alpine will display that status message surrounded with the characters
27675 &gt; and &lt; to show you that it is delaying.
27676 That might happen, for example, if you tried to save to a folder that
27677 caused an error, then followed that immediately with another Save command.
27678 You might find yourself waiting for a status message like
27679 <P>
27680 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
27681 <P>
27682 to finish displaying for three seconds.
27683 If that is something you find happening to you frequently, you may use
27684 negative values of this option to decrease or eliminate that delay, at
27685 the risk of missing the message.
27686 <P>
27687 <UL>
27688 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27689 </UL><P>
27690 &lt;End of help on this topic&gt;
27691 </BODY>
27692 </HTML>
27693 ====== h_config_active_msg_interval =====
27694 <HTML>
27695 <HEAD>
27696 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
27697 </HEAD>
27698 <BODY>
27699 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
27700
27701 When Alpine is delayed for some reason it usually shows that
27702 something is happening with a small animated display in the status
27703 message line near the bottom of the screen.
27704 This option sets how frequently the characters (for example, a spinning bar)
27705 in the active status message lines are updated.
27706 At most, it can be set to be updated 20 times per second.
27707
27708 <P>
27709 Setting this value to zero will prevent display of the animations
27710 altogether.
27711
27712 <P>
27713 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
27714 can be used to remove the randomness from this animated display.
27715
27716 <P>
27717 <UL>
27718 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27719 </UL><P>
27720 &lt;End of help on this topic&gt;
27721 </BODY>
27722 </HTML>
27723 ====== h_config_mailchecknoncurr =====
27724 <HTML>
27725 <HEADER>
27726 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
27727 </HEADER>
27728 <BODY>
27729 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
27730
27731 This option is closely related to the
27732 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27733 option, as well as the
27734 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
27735 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
27736 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
27737 new-mail checking is disabled and this option will have no effect.
27738 <P>
27739 Normally this option is set to zero, which means that the value used will be
27740 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
27741 If you set this option to a value different from zero
27742 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
27743 then that is the check interval that will be used
27744 for folders that are not the currently open folder or the INBOX.
27745 You may not even have any folders that are noncurrent and not the INBOX.
27746 If you do, it is likely that they are due to
27747 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
27748 you have configured.
27749 This option also affects the rate of mail checking done on cached
27750 connections to folders you previously had open but are no longer actively
27751 using.
27752 You aren't expected to understand that last sentence, but if you are interested
27753 take a look at
27754 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
27755 and the related options.
27756 <P>
27757 <UL>
27758 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27759 </UL><P>
27760 &lt;End of help on this topic&gt;
27761 </BODY>
27762 </HTML>
27763 ====== h_config_fifopath =====
27764 <HTML>
27765 <HEADER>
27766 <TITLE>OPTION: NewMail FIFO Path</TITLE>
27767 </HEADER>
27768 <BODY>
27769 <H1>OPTION: NewMail FIFO Path</H1>
27770
27771 This option is only available in UNIX Alpine.
27772 However, there is a very similar feature built in to PC-Alpine.
27773 In PC-Alpine's Config menu at the top of the screen
27774 is an option called &quot;New Mail Window&quot;.
27775 <P>
27776 You may have Alpine create a FIFO special file (also called a named pipe) where
27777 it will send a one-line message each time a new message is received in
27778 the current folder, the INBOX, or any open
27779 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
27780 To protect against two different Alpines both writing to the same FIFO, Alpine
27781 will only create the FIFO and write to it if it doesn't already exist.
27782 <P>
27783 A possible way to use this option would be to have a separate window
27784 on your screen running the command
27785 <P>
27786 <CENTER><SAMP>cat filename</SAMP></CENTER>
27787 <P>
27788 where &quot;filename&quot; is the name of the file given for this option.
27789 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
27790 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
27791 You may be tempted to use &quot;tail -f filename&quot; to view the new
27792 mail log.
27793 However, the common implementations of the tail command will not do what you
27794 are hoping.
27795 <P>
27796 The width of the messages produced for the FIFO may be altered with the
27797 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
27798 <P>
27799 On some systems, fifos may only be created in a local filesystem.
27800 In other words, they may not be in NFS filesystems.
27801 This requirement is not universal.
27802 If the system you are using supports it, it should work.
27803 (It is often the case that your home directory is in an NFS filesystem.
27804 If that is the case, you might try using a file in the &quot;/tmp&quot;
27805 filesystem, which is usually a local filesystem.)
27806 Even when it is possible to use an NFS-mounted filesystem as a place to name
27807 the fifo (for example, your home directory), it will still be the case that
27808 the reader (probably the &quot;cat&quot; command) and the
27809 writer (Alpine) of the fifo must be running on the same system.
27810 <P>
27811 <UL>
27812 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27813 </UL><P>
27814 &lt;End of help on this topic&gt;
27815 </BODY>
27816 </HTML>
27817 ====== h_config_newmailwidth =====
27818 <HTML>
27819 <HEADER>
27820 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
27821 </HEADER>
27822 <BODY>
27823 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
27824
27825 For UNIX Alpine, this option is only useful if you have turned on the
27826 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
27827 That option causes new mail messages to be sent to a fifo file.
27828 Those messages will be 80 characters wide by default.
27829 You can change the width of those messages by changing this option.
27830 For example, if you are reading those messages in another window you might
27831 want to set this width to the width of that other window.
27832 <P>
27833 If you are using PC-Alpine, it has an option in the Config menu to turn
27834 on the &quot;New Mail Window&quot;.
27835 This present option also controls the width of that window.
27836 <P>
27837 <UL>
27838 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27839 </UL><P>
27840 &lt;End of help on this topic&gt;
27841 </BODY>
27842 </HTML>
27843 ====== h_config_mailcheck =====
27844 <HTML>
27845 <HEADER>
27846 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
27847 </HEADER>
27848 <BODY>
27849 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
27850
27851 This option specifies, in seconds,
27852 how often Alpine will check for new mail.
27853 If set to zero, new-mail checking is disabled.
27854 (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
27855 current message is the last message of the folder.)
27856 There is a minimum value for this option, normally 15 seconds.
27857 The default value is normally 150 seconds.
27858 The higher you set this option, the easier it is on the server.
27859 <P>
27860 There are some situations where automatic new-mail checking does not work.
27861 See the discussion about new-mail checking in
27862 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
27863 <P>
27864 The new-mail checking will not happen exactly at the frequency that you specify.
27865 For example, Alpine may elect to defer a non-INBOX mail check if you
27866 are busy typing.
27867 Or, it may check more frequently than you have specified if that is
27868 thought to be necessary to keep the server from closing the connection
27869 to the folder due to inactivity.
27870 If Alpine checks for new mail as a side effect of another command, it will reset
27871 the timer, so that new-mail checking may seem to happen irregularly instead of
27872 every X seconds like clockwork.
27873 <P>
27874 If you are anxious to know about new mail as soon as possible, set the check
27875 interval low, and you'll know about the new mail by approximately
27876 that amount of time after it arrives.
27877 If you aren't so worried about knowing right away, set this option to a
27878 higher value.
27879 That will save the server some processing time and may save you some of
27880 the time you spend waiting for new-mail checks to happen if you are
27881 dealing with a slow server or slow network connection.
27882 <P>
27883 If you suspect that new-mail checking is causing slow downs for you,
27884 you may want to look into the options
27885 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
27886 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
27887 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
27888 which refine when mail checking is done.
27889 <P>
27890 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
27891 there is a minimum time
27892 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
27893 between new-mail checks.
27894 Because of this minimum you may notice that new mail does not
27895 appear promptly when you expect it.
27896 The reason for this is to protect the server from over-zealous opening and
27897 closing of the Mail Drop folder, since that is a costly operation.
27898 <P>
27899 <UL>
27900 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27901 </UL><P>
27902 &lt;End of help on this topic&gt;
27903 </BODY>
27904 </HTML>
27905 ====== h_config_quell_checks_comp =====
27906 <HTML>
27907 <HEAD>
27908 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
27909 </HEAD>
27910 <BODY>
27911 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
27912
27913 This option is closely related to the
27914 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27915 option, the
27916 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27917 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
27918 <P>
27919 If this option is set, then the normal new-mail checking that happens
27920 while you are composing will not happen for folders other than your
27921 INBOX (which depends on the setting
27922 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
27923 <P>
27924 You might want to set this option if you are experiencing delays while
27925 composing that you think might be related to the speed of the new-mail
27926 checks.
27927 <P>
27928 Even with this option turned on, an occasional new-mail check may be done
27929 in order to keep the server from killing the connection to the folder.
27930 For example, IMAP servers may remove a connection to a folder if there
27931 has been no activity on the connection for 30 minutes or more.
27932 Instead of letting that happen, Alpine will check for new mail before the
27933 30 minutes is up even though you have turned on this feature to quell
27934 those checks.
27935 <P>
27936 Besides new-mail checks, checkpoint operations on the folders
27937 will also be quelled when you set this option.
27938 The purpose of checkpointing is to write the changes to a folder out to
27939 disk periodically in order to avoid losing those changes when system or
27940 software problems occur.
27941 New-mail checking and checkpointing while you are not composing are not
27942 affected by this option.
27943
27944 <P>
27945 &lt;End of help on this topic&gt;
27946 </BODY>
27947 </HTML>
27948 ====== h_config_quell_checks_comp_inbox =====
27949 <HTML>
27950 <HEAD>
27951 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
27952 </HEAD>
27953 <BODY>
27954 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
27955
27956 This option is closely related to the
27957 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27958 option, the
27959 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27960 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
27961 <P>
27962 If this option is set, then the normal new-mail checking that happens
27963 while you are composing will not happen for your INBOX.
27964 Checking of other folders is controlled in a similar way with the
27965 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
27966 <P>
27967 You might want to set this option if you are experiencing delays while
27968 composing that you think might be related to the speed of the new-mail
27969 checks.
27970 <P>
27971 Even with this option turned on, an occasional new-mail check may be done
27972 in order to keep the server from killing the connection to the folder.
27973 For example, IMAP servers may remove a connection to a folder if there
27974 has been no activity on the connection for 30 minutes or more.
27975 Instead of letting that happen, Alpine will check for new mail before the
27976 30 minutes is up even though you have turned on this feature to quell
27977 those checks.
27978 <P>
27979 Besides new-mail checks, checkpoint operations on the INBOX
27980 will also be quelled when you set this option.
27981 The purpose of checkpointing is to write the changes to a folder out to
27982 disk periodically in order to avoid losing those changes when system or
27983 software problems occur.
27984 New-mail checking and checkpointing while you are not composing are not
27985 affected by this option.
27986 <P>
27987 &lt;End of help on this topic&gt;
27988 </BODY>
27989 </HTML>
27990 ====== h_config_maildropcheck =====
27991 <HTML>
27992 <HEADER>
27993 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
27994 </HEADER>
27995 <BODY>
27996 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
27997
27998 New-mail checking for a
27999 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
28000 mail checking for a regular folder.
28001 One of the differences is that the connection to the Mail Drop is not
28002 kept open and so the cost of checking
28003 (delay for you and additional load for the server) may be significant.
28004 Because of this additional cost we set a minimum time that
28005 must pass between checks.
28006 This minimum only applies to the automatic checking done by Alpine.
28007 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
28008 at the end of a folder index, then the check is done right away.
28009 <P>
28010 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
28011 new-mail checks.
28012 You may want to set this minimum high in order to avoid experiencing some
28013 of the delays associated with the checks.
28014 Note that the time between checks is still controlled by the regular
28015 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
28016 When Alpine is about to do an automatic check for new mail (because
28017 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
28018 new-mail check
28019 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
28020 the Mail Drop is checked for new mail as well.
28021 Therefore, it is only useful to set this option to a value that is higher
28022 than the <!--#echo var="VAR_mail-check-interval"-->.
28023 <P>
28024 If this option is set to zero, automatic Mail Drop new-mail
28025 checking is disabled.
28026 There is a minimum value, normally 60 seconds.
28027 The default value is normally 60 seconds as well.
28028 This applies to the INBOX and to the currently open folder if that is
28029 different from the INBOX.
28030
28031 <P>
28032 <UL>
28033 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28034 </UL><P>
28035 &lt;End of help on this topic&gt;
28036 </BODY>
28037 </HTML>
28038 ====== h_config_nntprange =====
28039 <HTML>
28040 <HEADER>
28041 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
28042 </HEADER>
28043 <BODY>
28044 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
28045
28046 This option applies only to newsgroups accessed using the NNTP protocol.
28047 It does not, for example,
28048 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
28049
28050 <P>
28051 When you open a connection to a News server using the NNTP protocol, you
28052 normally have access to all of the articles in each newsgroup.
28053 If a server keeps a large backlog of messages it may speed performance
28054 some to restrict attention to only the newer messages in a group.
28055 This option allows you to set how many article numbers should be checked
28056 when opening a newsgroup.
28057 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
28058 of messages you ever want to see.
28059 For example, if you only ever wanted to look at the last 500 messages in each
28060 newsgroup you could set this option to 500.
28061 In actuality, it isn't quite that.
28062 Instead, for performance reasons, it specifies the range of article
28063 numbers to be checked, beginning
28064 with the highest numbered article and going backwards from there.
28065 If there are messages that have been canceled or deleted
28066 their article numbers are still counted as part of the range.
28067 <P>
28068 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
28069 numbers
28070 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
28071 <P>
28072 to be considered when reading a newsgroup.
28073 The number of messages that show up in your index will be less than or equal
28074 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
28075
28076 <P>
28077 The purpose of this option is simply to speed up access when reading news.
28078 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
28079 numbers, and can avoid downloading any information about the ignored articles.
28080 There is a cost you pay for this speedup.
28081 That cost is that there is no way for you to see those ignored articles.
28082 The articles that come before the range you specify are invisible to you and
28083 to Alpine, as if they did not exist at all.
28084 There is no way to see those messages using, for example, an unexclude command
28085 or something similar.
28086 The only way to see those articles is to set this option high enough (or
28087 set it to zero) and then to reopen the newsgroup.
28088
28089 <P>
28090 If this option is set to 0 (which is also the default),
28091 then the range is unlimited.
28092 This option applies globally to all NNTP servers and to all newsgroups
28093 on those servers.
28094 There is no way to set different values for different newsgroups or servers.
28095
28096 <P>
28097 <UL>
28098 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28099 </UL><P>
28100 &lt;End of help on this topic&gt;
28101 </BODY>
28102 </HTML>
28103 ====== h_config_news_active =====
28104 <html>
28105 <header>
28106 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
28107 </header>
28108 <body>
28109 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
28110
28111 This option tells Alpine where to look for the "active file" for newsgroups
28112 when accessing news locally, rather than via NNTP.  The default path is
28113 usually "/usr/lib/news/active".<p>
28114 <UL>
28115 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28116 </UL><P>
28117 &lt;End of help on this topic&gt;
28118 </body>
28119 </html>
28120 ====== h_config_news_spool =====
28121 <html>
28122 <header>
28123 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
28124 </header>
28125 <body>
28126 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
28127
28128 This option tells Alpine where to look for the "news spool" for newsgroups
28129 when accessing news locally, rather than via NNTP.  The default path is
28130 usually "/var/spool/news".<p>
28131 <UL>
28132 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28133 </UL><P>
28134 &lt;End of help on this topic&gt;
28135 </body>
28136 </html>
28137 ====== h_config_image_viewer =====
28138 <html>
28139 <header>
28140 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
28141 </header>
28142 <body>
28143 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
28144 <body>
28145 This option specifies the program Alpine should call to view MIME
28146 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
28147 no longer needed, but remains for backward compatibility.  The more
28148 general method for associating external printing and viewing programs with
28149 specific MIME data types is to use the system's (or your personal)
28150 "mailcap" configuration file.<p>
28151 <UL>
28152 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28153 </UL><P>
28154 &lt;End of help on this topic&gt;
28155 </body>
28156 </html>
28157 ====== h_config_domain_name =====
28158 <HTML>
28159 <HEAD>
28160 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
28161 </HEAD>
28162 <BODY>
28163 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
28164
28165 This option is used only if the
28166 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
28167 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
28168 strips the hostname from your return (&quot;From&quot;) address and when
28169 completing unqualified addresses that you enter into the composer.
28170 <P>
28171 If you set this, see also the <A HREF="h_config_quell_local_lookup">
28172 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
28173
28174
28175 <!--chtml if pinemode="os_windows"-->
28176 <P>This option is not applicable to PC-Alpine.
28177 <!--chtml else-->
28178 <P>
28179 <!--chtml endif-->
28180 <UL>
28181 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28182 </UL>
28183 <P>
28184 &lt;End of help on this topic&gt;
28185 </BODY>
28186 </HTML>
28187 ====== h_config_prune_date =====
28188 <HTML>
28189 <HEAD>
28190 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
28191 </HEAD>
28192 <BODY>
28193 <H1>OPTION: Last-Time-Prune Question</H1>
28194
28195 This value records the last time you were asked about deleting old
28196 sent-mail.
28197 It is set automatically by Alpine at the beginning of each month.
28198 In the past, if you wished to suppress the monthly sent-mail
28199 pruning feature, you could set this to a date in the future.
28200 This value is relative to the year 1900, so
28201 to set this, for example, to October 2005, use 105.10.
28202 <P>
28203 You can still do that if you wish, or you can use the
28204 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
28205 a little more convenient to use.
28206 <P>
28207 <UL>
28208 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28209 </UL><P>
28210 &lt;End of help on this topic&gt;
28211 </BODY>
28212 </HTML>
28213 ====== h_config_goto_default =====
28214 <HTML>
28215 <HEAD>
28216 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
28217 </HEAD>
28218 <BODY>
28219 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
28220
28221 This value affects Alpine's behavior when you use the Goto command.
28222 Alpine's usual behavior has two parts.  If your current folder is
28223 &quot;Inbox&quot;, Alpine will offer the last open folder as the
28224 default.  If the current folder is other than &quot;Inbox&quot;,
28225 &quot;Inbox&quot; is offered as the default.
28226
28227 <P>
28228 The available options include:
28229
28230 <DL>
28231
28232  <DT>folder-in-first-collection</DT>
28233
28234  <DD> Alpine will offer the most recently visited folder in the default
28235 collection found in the &quot;Collection List&quot; screen as the default.
28236 </DD>
28237
28238  <DT> inbox-or-folder-in-first-collection</DT>
28239
28240  <DD> If the current folder is &quot;Inbox&quot;,
28241 Alpine will offer the most recently visited folder in the
28242 default collection found in the &quot;Collection List&quot; screen.
28243 If the current folder is other than &quot;Inbox&quot;,
28244 &quot;Inbox&quot; is offered as the default.
28245 </DD>
28246
28247  <DT> inbox-or-folder-in-recent-collection</DT>
28248
28249  <DD> This is Alpine's default behavior.
28250 If the current folder is &quot;Inbox&quot;,
28251 Alpine will offer the last open
28252 folder as the default.
28253 If the current folder is other than &quot;Inbox&quot;,
28254 &quot;Inbox&quot; is offered as the default.
28255 </DD>
28256
28257  <DT> first-collection-with-inbox-default</DT>
28258
28259  <DD> Instead of offering the most recently visited folder in the default
28260 collection, the default collection is offered but with &quot;Inbox&quot; as
28261 the default folder.
28262 If you type in a folder name it will be in the default collection.
28263 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
28264 </DD>
28265
28266  <DT> most-recent-folder</DT>
28267
28268  <DD> The last accepted value simply causes the most recently opened
28269 folder to be offered as the default regardless of the currently opened
28270 folder.
28271 </DD>
28272 </DL>
28273
28274 <P>
28275 NOTE: The default while a newsgroup is open remains the same; the last
28276 open newsgroup.
28277
28278 <P>
28279 <UL>
28280 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28281 </UL><P>
28282 &lt;End of help on this topic&gt;
28283 </BODY>
28284 </HTML>
28285 ====== h_config_thread_lastreply_char =====
28286 <HTML>
28287 <HEAD>
28288 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
28289 </HEAD>
28290 <BODY>
28291 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
28292
28293 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
28294 INDEX display when using a
28295 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
28296 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
28297 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
28298 The value of this option is a single character.
28299 This character is used instead of the vertical line character when there are
28300 no more replies directly to the parent of the current message.
28301 It can be used to &quot;round-off&quot; the bottom of the vertical line
28302 by setting it to a character such as a backslash (&#92;) or
28303 a backquote (&#96;).
28304 The default value of this option is the backslash character (&#92;).
28305 This option may not be set to the Empty Value.
28306 In that case, the default will be used instead.
28307
28308 <P>
28309 <UL>
28310 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28311 </UL><P>
28312 &lt;End of help on this topic&gt;
28313 </BODY>
28314 </HTML>
28315 ====== h_config_thread_indicator_char =====
28316 <HTML>
28317 <HEAD>
28318 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
28319 </HEAD>
28320 <BODY>
28321 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
28322
28323 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
28324 INDEX display when using a
28325 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
28326 than &quot;none&quot; and sorting by Threads or OrderedSubject.
28327 The value of this option is a single character.
28328 This character is used to indicate that part of a thread (a conversation) is
28329 hidden beneath a message.
28330 The message could be expanded
28331 if desired with the &quot;/&quot; Collapse/Expand command.
28332 By default, the value of this option is the greater than sign (&gt;).
28333 <P>
28334 If this option is set to the Empty Value, then the column (and the following
28335 blank column) will be deleted from the display.
28336
28337 <P>
28338 This option is closely related to the
28339 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
28340 Another similar option that affects the thread display is the
28341 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
28342
28343 <P>
28344 <UL>
28345 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28346 </UL><P>
28347 &lt;End of help on this topic&gt;
28348 </BODY>
28349 </HTML>
28350 ====== h_config_thread_exp_char =====
28351 <HTML>
28352 <HEAD>
28353 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
28354 </HEAD>
28355 <BODY>
28356 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
28357
28358 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
28359 INDEX display when using a
28360 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
28361 than &quot;none&quot;.
28362 The value of this option is a single character.
28363 This character is used to indicate that part of a thread has been expanded
28364 and could be collapsed if desired with
28365 the &quot;/&quot; Collapse/Expand command.
28366 By default, the value of this option is a dot (.).
28367 <P>
28368 If this option is set to the Empty Value, then the column (and the following
28369 blank column) will be deleted from the display.
28370
28371 <P>
28372 This option is closely related to the
28373 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
28374 Another similar option that affects the thread display is the
28375 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
28376
28377 <P>
28378 <UL>
28379 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28380 </UL><P>
28381 &lt;End of help on this topic&gt;
28382 </BODY>
28383 </HTML>
28384 ====== h_config_thread_index_style =====
28385 <HTML>
28386 <HEAD>
28387 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
28388 </HEAD>
28389 <BODY>
28390 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
28391
28392 When a folder is sorted by Threads or OrderedSubject,
28393 this option will affect the INDEX displays.
28394 <P>
28395
28396 The possible values for this option are:
28397
28398 <DL>
28399 <DT>regular-index-with-expanded-threads</DT>
28400 <DD>This is the default display.
28401 If the configuration option
28402 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
28403 is set to something other than &quot;none&quot;, then this setting
28404 will cause Alpine to start off with a MESSAGE INDEX with all of
28405 the threads expanded.
28406 That is, each message will have a line in the MESSAGE INDEX display.
28407 The Collapse/Expand command (/) may be used to manually collapse or
28408 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
28409 <P>
28410 This setting affects the display when the folder is first threaded.
28411 The collapsed state may also be re-initialized by re-sorting the folder manually
28412 using the SortIndex command ($).
28413 After re-sorting the threads will once again all be expanded, even if you
28414 have previously collapsed some of them.
28415 <P>
28416 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
28417 the display will be the regular default Alpine MESSAGE INDEX, but sorted
28418 in a different order.
28419 </DD>
28420
28421 <DT>regular-index-with-collapsed-threads</DT>
28422 <DD>If the configuration option
28423 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
28424 is set to something other than &quot;none&quot;, then this setting
28425 will cause Alpine to start out with all of the threads collapsed instead of
28426 starting out with all of the threads expanded.
28427 The Collapse/Expand command (/) may be used to manually collapse or
28428 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
28429 <P>
28430 This setting affects the display when the folder is first threaded.
28431 The collapsed state may also be re-initialized by re-sorting the folder manually
28432 using the SortIndex command ($).
28433 After re-sorting the threads will once again all be collapsed, even if you
28434 have previously expanded some of them.
28435 </DD>
28436
28437 <DT>separate-index-screen-always</DT>
28438 <DD>With this setting and the next, you will see an index of threads
28439 instead of an
28440 index of messages, provided you have sorted by Threads or OrderedSubject.
28441 <P>
28442 The THREAD INDEX contains a '*' in the first column if any message in the thread
28443 is marked Important.
28444 If not, it contains a '+' if any message in the thread is to you.
28445 The second column is blank. The third column contains a 'D' if all of the
28446 messages in the thread are deleted.
28447 Otherwise, it contains an 'N' if any of the messages in the thread are New.
28448 <P>
28449 When you view a particular thread from the THREAD INDEX you will be
28450 in the MESSAGE INDEX display
28451 but the index will only contain messages from the thread you are viewing.
28452 </DD>
28453
28454 <DT>separate-index-screen-except-for-single-messages</DT>
28455 <DD>This is very similar to the option above.
28456 When you are in the THREAD INDEX, one of the available commands
28457 is &quot;ViewThd&quot;.
28458 With the setting &quot;separate-index-screen-always&quot; (the option above)
28459 when you view a particular thread you will be in the
28460 MESSAGE INDEX display and the index will only contain messages from
28461 the thread you are viewing.
28462 If the thread you are viewing consists of a single message, the MESSAGE INDEX
28463 will be an index with only one message in it.
28464 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
28465 setting instead, then that index that contains a single message
28466 will be skipped and you will go directly from the THREAD INDEX into the
28467 MESSAGE TEXT screen.
28468 </DD>
28469
28470 </DL>
28471
28472 <P>
28473 <UL>
28474 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28475 </UL><P>
28476 &lt;End of help on this topic&gt;
28477 </BODY>
28478 </HTML>
28479 ====== h_config_thread_disp_style =====
28480 <HTML>
28481 <HEAD>
28482 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
28483 </HEAD>
28484 <BODY>
28485 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
28486
28487 When a folder is sorted by Threads or OrderedSubject,
28488 this option will affect the MESSAGE INDEX display.
28489 By default, Alpine will display the MESSAGE INDEX in the
28490 &quot;show-thread-structure&quot; style if a folder is sorted
28491 by Threads or OrderedSubject.
28492 <P>
28493
28494 The possible values for this option are:
28495
28496 <DL>
28497 <DT>none</DT>
28498 <DD>Regular index display.
28499 The same index line as would be displayed without threading is used.
28500 The only difference will be in the order of the messages.
28501 </DD>
28502
28503 <DT>show-thread-structure</DT>
28504 <DD>Threaded Subjects will be indented and vertical bars and horizontal
28505 lines will be added to make it easier to see the relationships among
28506 the messages in a thread (a conversation).
28507 </DD>
28508
28509 <DT>mutt-like</DT>
28510 <DD>This is the same as the option above except that the Subject
28511 is suppressed (is blank) if it matches the previous Subject in the thread.
28512 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
28513 Here is an example of what a mutt-like index might look like.
28514 In this example, the first column represents the message number, the
28515 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
28516 is set to &quot;regular-index-with-expanded-threads&quot;, and the
28517 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
28518 is set to a backslash:
28519 <PRE>
28520 &nbsp;&nbsp;&nbsp;1    Some topic
28521 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
28522 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
28523 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
28524 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
28525 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
28526 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
28527 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
28528 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
28529 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
28530 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
28531 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
28532 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
28533 &nbsp;&nbsp;&nbsp;14    Next topic
28534 </PRE>
28535 </DD>
28536
28537 <DT>indent-subject-1</DT>
28538 <DD>Threaded Subjects will be indented one space per level of the conversation.
28539 The bars and lines that show up in the show-thread-structure display will
28540 not be there with this style.
28541 </DD>
28542
28543 <DT>indent-subject-2</DT>
28544 <DD>Same as above but indent two spaces per level instead of one space.
28545 </DD>
28546
28547 <DT>indent-from-1</DT>
28548 <DD>Similar to indent-subject-1, except that instead of indenting the
28549 Subject field one space the From field of a thread will be indented one
28550 space per level of the conversation.
28551 </DD>
28552
28553 <DT>indent-from-2</DT>
28554 <DD>Same as above but indent two spaces per level instead of one space.
28555 </DD>
28556
28557 <DT>show-structure-in-from</DT>
28558 <DD>The structure of the thread is illustrated with indenting, vertical bars,
28559 and horizontal lines just like with the show-thread-structure option, but
28560 the From field is used to show the relationships instead of the Subject field.
28561 </DD>
28562
28563 </DL>
28564
28565 <P>
28566 <UL>
28567 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28568 </UL><P>
28569 &lt;End of help on this topic&gt;
28570 </BODY>
28571 </HTML>
28572 ====== h_config_pruning_rule =====
28573 <HTML>
28574 <HEAD>
28575 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
28576 </HEAD>
28577 <BODY>
28578 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
28579
28580 By default, Alpine will ask at the beginning of each month whether or not
28581 you want to rename your sent-mail folder to a name like sent-mail-month-year.
28582 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
28583 change the format of the folder to sent-mail-yyyy-mm.)
28584 It will also ask whether you would like to delete old sent-mail folders.
28585 If you have defined
28586 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
28587 or
28588 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
28589 Alpine will also ask about pruning those folders.
28590 <P>
28591
28592 With this option you may provide an automatic answer to these questions.
28593 The default value is to ask you what you'd like to do.
28594 <P>
28595
28596 The six possible values for this option are:
28597
28598 <DL>
28599 <DT>ask about rename, ask about deleting</DT>
28600 <DD>This is the default.
28601 Alpine will ask whether you want to rename the folders and whether you
28602 want to delete each of the old folders.
28603 </DD>
28604
28605 <DT>ask about rename, don't delete</DT>
28606 <DD>Alpine will ask whether you want to rename the folders, but won't
28607 ask about or delete old folders.
28608 </DD>
28609
28610 <DT>always rename, ask about deleting</DT>
28611 <DD>This means you want to always answer yes and have Alpine automatically
28612 rename the folder if possible.
28613 You will also be asked about deleting old folders.
28614 </DD>
28615
28616 <DT>always rename, don't delete</DT>
28617 <DD>This means you want to always answer yes and have Alpine automatically
28618 rename the folder if possible.
28619 There will be no deleting of old folders.
28620 </DD>
28621
28622 <DT>don't rename, ask about deleting</DT>
28623 <DD>This means you want to always answer no.
28624 Alpine will not rename the folder.
28625 You will be asked about deleting old folders.
28626 </DD>
28627
28628 <DT>don't rename, don't delete</DT>
28629 <DD>This means you want to always answer no.
28630 Alpine will not rename the folder.
28631 There will be no deleting of old folders, either.
28632 </DD>
28633 </DL>
28634
28635 <P>
28636 <UL>
28637 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28638 </UL><P>
28639 &lt;End of help on this topic&gt;
28640 </BODY>
28641 </HTML>
28642 ====== h_config_reopen_rule =====
28643 <HTML>
28644 <HEAD>
28645 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
28646 </HEAD>
28647 <BODY>
28648 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
28649
28650 Alpine normally checks for new mail in the currently open folder
28651 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
28652
28653 <P>
28654 There are some situations where automatic new-mail checking does not work.
28655 For example, if a mail folder is opened using the POP protocol or a newsgroup
28656 is being read using the NNTP protocol, then new-mail checking is disabled.
28657
28658 <P>
28659 It may be possible to check for new mail in these cases by reopening the
28660 folder.
28661 Alpine does not do this for you automatically, but you may do the commands
28662 manually to cause this to happen.
28663 You reopen by going back to the folder list screen from the message
28664 index screen with the &quot;&lt;&quot; command,
28665 and then going back into the message index screen with
28666 the &quot;&gt;&quot; command.
28667 (Actually, any method you would normally use to open a folder will work the
28668 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
28669 For example, the GoTo Folder command will work, or you may use L to go to the
28670 Folder List screen and Carriage Return to reopen the folder.)
28671
28672 <P>
28673 There are some cases where Alpine knows that reopening the folder should
28674 be useful as a way to discover new mail.
28675 At the time of this writing, connections made using the POP protocol,
28676 news reading using the NNTP protocol, local news reading, and local
28677 ReadOnly folders that are in the traditional UNIX or the MMDF format all
28678 fall into this category.
28679 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
28680 has no way of knowing, so it might also just be an exercise in futility.
28681 All remote, ReadOnly folders other than those listed just above fall into this
28682 category.
28683 The setting of this option together with the type of folder
28684 controls how Alpine will react to the apparent attempt to reopen a folder.
28685
28686 <P>
28687 If you don't reopen, then you will just be back in
28688 the message index with no change.
28689 You left the index and came back, but the folder remained &quot;open&quot;
28690 the whole time.
28691 However, if you do reopen the folder, the folder is closed and then reopened.
28692 In this case, the current state of the open folder is lost.
28693 The New status, Important and Answered flags,
28694 selected state, Zoom state, collapsed or expanded state of threads,
28695 current message number,
28696 and any other temporary state is all lost when the reopen happens.
28697 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
28698
28699 <P>
28700 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
28701 several places.
28702 That really implies the case where Alpine knows it is a good way to discover
28703 new mail, which is more than just POP and NNTP, but POP and NNTP are
28704 the cases of most interest.
28705 This option probably has more possible values than it deserves. They are:
28706
28707 <DL>
28708 <DT>Always reopen</DT>
28709 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
28710 whenever you type a command that implies a reopen, regardless of the
28711 access method.
28712 In other words, it is assumed you would always answer Yes if asked
28713 about reopening.
28714 </DD>
28715
28716 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
28717 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
28718 will ask you whether to reopen other remote folders,
28719 with a default answer of Yes.
28720 </DD>
28721
28722 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
28723 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
28724 will ask you whether to reopen other remote folders,
28725 with a default answer of No.
28726 </DD>
28727
28728 <DT>Yes for POP/NNTP, No for other remote</DT>
28729 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
28730 will assume a No answer for all other remote folders.
28731 </DD>
28732
28733 <DT>Always ask [Yes]</DT>
28734 <DD>Alpine will not differentiate based on access method.
28735 It will always ask for all remote folders, with a default answer of Yes.
28736 </DD>
28737
28738 <DT>Always ask [No]</DT>
28739 <DD>Alpine will not differentiate based on access method.
28740 It will always ask for all remote folders, with a default answer of No.
28741 </DD>
28742
28743 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
28744 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
28745 of Yes.
28746 It will never attempt to reopen other remote folders.
28747 </DD>
28748
28749 <DT>Ask about POP/NNTP [No], No for other remote</DT>
28750 <DD>This is the default.
28751 Alpine will ask if the access method is POP or NNTP, with a default answer
28752 of No.
28753 It will never attempt to reopen other remote folders.
28754 </DD>
28755
28756 <DT>Never reopen</DT>
28757 <DD>Alpine will never attempt to reopen already open folders.
28758 </DD>
28759 </DL>
28760
28761 <P>
28762 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
28763 any of the other situations where it is likely that reopening is a good way
28764 to discover new mail.
28765
28766 <P>
28767 There is an alternative that may be of useful in some situations.
28768 Instead of manually checking for new mail you can set up a
28769 <A HREF="h_maildrop">Mail Drop</A>
28770 and automatically check for new mail.
28771
28772 <P>
28773 <UL>
28774 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28775 </UL><P>
28776 &lt;End of help on this topic&gt;
28777 </BODY>
28778 </HTML>
28779 ====== h_config_inc_startup =====
28780 <HTML>
28781 <HEAD>
28782 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
28783 </HEAD>
28784 <BODY>
28785 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
28786
28787 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
28788 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
28789 It determines which message will be the <EM>current message</EM> when
28790 the folder is first opened.
28791 The default value is &quot;first-unseen&quot;.
28792
28793 <P>
28794 The seven possible values for this option are:
28795
28796 <DL>
28797 <DT>first-unseen</DT>
28798 <DD>The current message is set to the first
28799 unseen message that has not been marked deleted, or the last message if
28800 all of the messages have been seen previously.
28801 Messages which have not been seen or which have been seen but re-marked
28802 as New are considered unseen messages.
28803 See the note at the bottom of this help about newsgroups.
28804 </DD>
28805
28806 <DT>first-recent</DT>
28807 <DD>Similar to the default, but rather than starting on the first
28808 unseen message Alpine starts on the first <EM>recent</EM> message.
28809 A message is recent if it arrived since the last time the folder was
28810 open.  This value causes the current message to be set to the first
28811 recent message if there is one, otherwise to the last
28812 message in the folder.
28813 </DD>
28814
28815 <DT>first-important</DT>
28816 <DD>This will result in the current message being set to the first
28817 message marked Important (but not Deleted).
28818 If no messages are marked Important, then it will be the last message.
28819 Messages are marked Important by <EM>you</EM>, not by the sender, using
28820 the
28821 <A HREF="h_common_flag">Flag command</A>.
28822 Or they may be marked Important by an Alpine
28823 <A HREF="h_mainhelp_filtering">Filter</A>
28824 that you have set up.
28825 </DD>
28826
28827 <DT>first-important-or-unseen</DT>
28828 <DD>This selects the first of the first unseen and the first important
28829 messages.
28830 </DD>
28831
28832 <DT>first-important-or-recent</DT>
28833 <DD>This selects the first of the first recent and the first important
28834 messages.
28835 </DD>
28836
28837 <DT>first</DT>
28838 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
28839 If all messages are deleted you start on the last message.
28840 </DD>
28841
28842 <DT>last</DT>
28843 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
28844 If all messages are deleted you start on the last message.
28845 </DD>
28846 </DL>
28847
28848 <P>
28849 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
28850 &quot;first-recent&quot; are the same and are affected by whether or not the
28851 feature
28852 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
28853 is turned on.
28854 Also, there is no permanent storage in news for an Important flag.
28855 This means that no messages will be marked Important when a newsgroup is
28856 first opened.
28857
28858 <P>
28859 <UL>
28860 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28861 </UL><P>
28862 &lt;End of help on this topic&gt;
28863 </BODY>
28864 </HTML>
28865 ====== h_config_browser =====
28866 <HTML>
28867 <HEAD>
28868 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
28869 </HEAD>
28870 <BODY>
28871 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
28872 <!--chtml if pinemode="os_windows"-->
28873 PC-Alpine users do not need to enter anything here, unless:<UL>
28874 <LI> they want to override, for use with Alpine, the application defined
28875 in the Windows operating system for handling URLs; or
28876 <LI> they are (planning on) using the same configuration file with
28877 Unix Alpine.
28878 </UL>
28879 <P>
28880 Note that if using a viewer that has a space in its path, you should
28881 use the DOS name for that directory or file. Example:
28882 <PRE>
28883 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
28884 </PRE>
28885 <HR><P>
28886 <!--chtml endif-->
28887 This option affects Alpine's handling of URLs that are found in
28888 messages you read.  Normally, only URLs Alpine can handle directly
28889 are automatically offered for selection in the &quot;Message
28890 Text&quot; screen.  When one or more applications
28891 capable of deciphering URLs on their command line are added here, Alpine
28892 will choose the first available to display URLs it cannot handle directly.
28893 A viewer's availability is based on its being specified with a <B>full
28894 directory path</B> and the evaluation of any optionally supplied
28895 parameters described below.
28896
28897 <P>
28898 Additionally, to support various connection methods and applications, each
28899 entry in this list can optionally begin with one or more of
28900 the following special tokens.  The allowed tokens include:
28901
28902 <P>
28903 <DL>
28904 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
28905 <DD>
28906 The <VAR>test-string</VAR> is a shell command that Alpine will run to
28907 evaluate a viewer's availability.  The command specified by the test
28908 string is run and if its resulting exit status is non-zero, Alpine will
28909 not consider the associated viewer for use.
28910 </DD>
28911
28912 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
28913 <DD>
28914 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
28915 URL schemes that are to be used with the associated viewer.  This is
28916 the way to configure Alpine to recognize URLs other than the built-in set.
28917 <P>
28918 It can also be used to override Alpine's built-in handlers.
28919 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
28920 and Alpine would use (provided it passed all other criteria) the associated
28921 viewer when it encountered a URL of the form &quot;news:comp.mail.pine&quot;.
28922
28923 </DD>
28924 </DL>
28925
28926 <P>
28927 By default, Alpine will simply append a space character followed by the
28928 selected URL prior to launching the command in your specified SHELL.  You can
28929 optionally specify where in the command the selected URL should appear
28930 by using the &quot;_URL_&quot; token.  All occurrences found in the command
28931 will be replaced with the selected URL before the command is handed
28932 to the shell.  If such replacement occurs, the default appending of the
28933 selected URL does not take place.
28934
28935 <P>
28936 NOTE: If the viewer you specify has any command-line arguments,
28937 including the &quot;_URL_&quot; token, you will need to add a
28938 double-quote character before the command path and after the last
28939 argument (see the &quot;lynx&quot; example below).
28940
28941 <P>
28942 So, here are some example entries:
28943 <PRE>
28944 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/bin/firefox
28945               &quot;/usr/bin/lynx _URL_&quot;
28946               C:&#92;BIN&#92;FIREFOX.BAT
28947 </PRE>
28948 <P>
28949 This example shows that for the first viewer in the list to be used
28950 the environment variable &quot;DISPLAY&quot; must be defined.  If it
28951 is, then the path and file &quot;/usr/bin/firefox&quot; must exist.
28952 If neither condition is met,
28953 then the path and file &quot;/usr/bin/lynx&quot; must exist.
28954 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
28955 If the path to &quot;lynx&quot; is invalid,
28956 then the final path and file C:&#92;BIN&#92;FIREFOX.BAT must exist.
28957 Note that the last
28958 entry is a DOS/Windows path.  This is one way to support Alpine running
28959 on more than one architecture with the same configuration file.<P>
28960 <P>
28961 <!--chtml if pinemode="os_windows"-->
28962 <!--chtml else-->
28963 Note that depending on the type of browser used and the method of
28964 its invocation (such as whether it will open in a separate window) from
28965 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
28966 the MESSAGE TEXT screen, and you will have to quit the browser to return to
28967 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
28968 In other words, launching the browser from Alpine may make Alpine
28969 &quot;disappear&quot; (although it is still &quot;running&quot;)
28970 until you close the browser again.<P>
28971 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
28972 environment: for advanced users and  systems administrators</A>
28973 </UL>
28974 <!--chtml endif-->
28975 <P>If you are unsure what browsers are available on your system or how to
28976 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
28977 local computing support staff.
28978 <P><UL>
28979 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28980 </UL>
28981 <P>
28982 &lt;End of help on this topic&gt;
28983 </BODY>
28984 </HTML>
28985 ====== h_config_history =====
28986 <HTML>
28987 <HEAD>
28988 <TITLE>OPTION: <!--#echo var="VAR_default-directories"--></TITLE>
28989 </HEAD>
28990 <BODY>
28991 <H1>OPTION: <!--#echo var="VAR_default-directories"--></H1>
28992 <P>
28993 This option allows you to input a list of directories that Alpine will offer
28994 for you to use when you are saving or exporting attachments. This is useful
28995 when navigating to specific directories becomes too tedious, or when you
28996 need to do this on a daily basis, and want Alpine to remember this on a
28997 permanent basis.
28998 <P>
28999 The list of directories saved here can be accessed using the ^Y and ^V commands
29000 in the save prompt for attachments, or the export command.
29001
29002 <P><UL>
29003 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29004 </UL>
29005 <P>
29006 &lt;End of help on this topic&gt;
29007 </BODY>
29008 </HTML>
29009 ====== h_config_browser_xterm =====
29010 <HTML>
29011 <HEAD>
29012 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
29013 </HEAD>
29014 <BODY>
29015 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
29016 environment: for advanced users and  systems administrators</H1>
29017 If you are using Alpine with an X-terminal (emulator) and want to define an
29018 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
29019 you may want to do so in a manner that causes any <B>already</B>
29020 invoked viewer application to be used for viewing URLs you select from Alpine
29021 messages, and a <B>new</B> URL-viewer process to be
29022 started <B>only</B> if the same application has <B>not already</B>
29023 been launched -- for one reason, to avoid file-locking contentions among
29024 multiple invocations of the same URL-viewer application.
29025 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
29026 option does not do this.)  A method of doing that would be:<OL>
29027 <LI> use
29028 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
29029 check (using commands appropriate for your Unix shell
29030 in place of <VAR>test-string</VAR>) for the presence of a
29031 lockfile created by the URL-viewer application -- which implies that the
29032 application is already running, though this is not foolproof.
29033 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
29034 application with its appropriate command line option(s) to
29035 show the URL selected from the Alpine message in an already open window of
29036 that application, or perhaps in a new window of that application.
29037
29038 <LI> In the
29039 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
29040 application without those command line options, but this time using the
29041 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
29042 is defined.
29043 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
29044 windows environment (for instance, using VT-100 terminal emulation), you
29045 may wish to specify a non-X windows URL-viewer application such as Lynx
29046 as the last entry.
29047 </OL><BR>
29048 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
29049 the command shell, the URL-viewer application(s), and possibly the specific
29050 version of the latter, you are using.
29051 <P>
29052 Relevant command line options for firefox can be found at
29053 <P>
29054
29055 <CENTER><A HREF="https://wiki.mozilla.org/Firefox/CommandLineOptions">https://wiki.mozilla.org/Firefox/CommandLineOptions</A></CENTER>
29056
29057 <P>(If the URL-viewer application is
29058 <B>not</B> running on the same host as Alpine, but being launched from an
29059 applications server, you may not be able to use the command line options for
29060 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
29061 <UL>
29062 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29063 </UL><P>
29064 &lt;End of help on this topic&gt;
29065 </BODY>
29066 </HTML>
29067 ====== h_config_enable_full_hdr =====
29068 <HTML>
29069 <HEAD>
29070 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
29071 </HEAD>
29072 <BODY>
29073 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
29074
29075 This feature enables the &quot;H Full Headers&quot; command which toggles between
29076 the display of all headers in the message and the normal edited view of
29077 headers.  The Full Header command also controls which headers are included
29078 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
29079 Full Header mode will respect the
29080 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
29081 feature setting.)
29082 <P>
29083 If Full Header mode is turned on and you Forward a message, you will
29084 be asked if you'd like to forward the message as an attachment, as opposed
29085 to including the text of the message in the body of your new message.
29086 <P>
29087 If you have also turned on the
29088 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
29089 option then the Full Headers command actually rotates through three states
29090 instead of just two.
29091 The first is the normal view with long quotes suppressed.
29092 The second is the normal view but with the long quotes included.
29093 The last enables the display of all headers in the message.
29094 When using Export, Pipe, Print, Forward, or Reply the quotes are
29095 never suppressed, so the first two states are identical.
29096 <P>
29097 Normally, the Header Mode will reset
29098 to the default behavior when moving to a new message.
29099 The mode can be made to persist from message to message by setting the feature
29100 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
29101 <P>
29102 <UL>
29103 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29104 </UL><P>
29105 &lt;End of help on this topic&gt;
29106 </BODY>
29107 </HTML>
29108 ====== h_config_enable_full_hdr_and_text =====
29109 <HTML>
29110 <HEAD>
29111 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
29112 </HEAD>
29113 <BODY>
29114 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
29115
29116 This feature affects how the &quot;H Full Headers&quot; command displays
29117 message text.  If set, the raw message text will be displayed.  This
29118 especially affects MIME formatted email, where the entire MIME format
29119 will be displayed.  This feature similarly affects how messages are
29120 included for the Export, Pipe, Print, Forward, and Reply functions.
29121 <P>
29122 When viewing a raw message that has attachments with this feature set,
29123 you will not be able to view attachments without first leaving full
29124 headers mode.  This is because MIME parsing is not done on the raw message.
29125 <P>
29126 <UL>
29127 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29128 </UL><P>
29129 &lt;End of help on this topic&gt;
29130 </BODY>
29131 </HTML>
29132 ====== h_config_enable_pipe =====
29133 <HTML>
29134 <HEAD>
29135 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
29136 </HEAD>
29137 <BODY>
29138 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
29139
29140 This feature enables the "| Pipe" command that sends the current message
29141 to the specified command for external processing.
29142 <P>
29143
29144 A short description of how the pipe command works is given
29145 <A HREF="h_pipe_command">here</A>.
29146
29147 <P>
29148 <UL>
29149 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29150 </UL><P>
29151 &lt;End of help on this topic&gt;
29152 </BODY>
29153 </HTML>
29154 ====== h_config_quell_full_hdr_reset =====
29155 <HTML>
29156 <HEAD>
29157 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
29158 </HEAD>
29159 <BODY>
29160 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
29161
29162 The <A HREF="h_common_hdrmode">HdrMode Command</A>
29163 normally resets to the default state when switching to a new message.
29164 For example, if you've used the &quot;H&quot; command to turn on Full
29165 Headers for a message you are viewing, and then you type the Next command
29166 to look at the next message, the full headers will no longer be shown.
29167 Setting this feature disables that reset.
29168 Instead, the Header Mode remains the same from message to message.
29169
29170 <P>
29171 The presence or absence of the HdrMode command is determined by the
29172 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
29173 Feature-List option.
29174 <P>
29175 <UL>
29176 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29177 </UL><P>
29178 &lt;End of help on this topic&gt;
29179 </BODY>
29180 </HTML>
29181 ====== h_config_enable_tab_complete =====
29182 <HTML>
29183 <HEAD>
29184 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
29185 </HEAD>
29186 <BODY>
29187 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
29188
29189 This feature enables the TAB key when at a prompt for a filename. In this
29190 case, TAB will cause the partial name already entered to be automatically
29191 completed, provided the partial name is unambiguous.
29192 This feature is on by default.
29193 <P>
29194 Similarly, this feature also enables TAB completion of address book
29195 nicknames when at a prompt for a nickname,
29196 when typing in an address field in the composer,
29197 or when selecting messages based on <A HREF="h_select_rule">rules</A> or <A HREF="h_mainhelp_keywords">keywords</A>.
29198 <P>
29199 &lt;End of help on this topic&gt;
29200 </BODY>
29201 </HTML>
29202 ====== h_config_quit_wo_confirm =====
29203 <HTML>
29204 <HEAD>
29205 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
29206 </HEAD>
29207 <BODY>
29208 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
29209
29210 This feature controls whether or not Alpine will ask for confirmation when a
29211 Quit command is received.
29212 <P>
29213 &lt;End of help on this topic&gt;
29214 </BODY>
29215 </HTML>
29216 ====== h_config_quote_replace_noflow =====
29217 <HTML>
29218 <HEAD>
29219 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
29220 </HEAD>
29221 <BODY>
29222 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
29223
29224 This feature, which is only active when
29225 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
29226 also set,
29227 enables quote-replacement on non-flowed messages.  It is off
29228 by default because a non-flowed message is more dependent on its format,
29229 and thus quote-replacement may cause less-than-pleasing results.
29230 Setting this feature will cause quote-replacement similar to that of flowed
29231 messages, but with the added possibility of long lines being wrapped
29232 into new lines if the Quote-Replacement-String is longer than the string
29233 it is replacing, which is &quot;&gt;&nbsp;&quot;.
29234 <P>
29235 &lt;End of help on this topic&gt;
29236 </BODY>
29237 </HTML>
29238 ====== h_config_enable_jump =====
29239 <HTML>
29240 <HEAD>
29241 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
29242 </HEAD>
29243 <BODY>
29244 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
29245
29246 When this feature is set you may enter a number (followed by RETURN)
29247 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
29248 screens.  In other words, it obviates the need for typing the "J" for the
29249 Jump command.
29250 <P>
29251 &lt;End of help on this topic&gt;
29252 </BODY>
29253 </HTML>
29254 ====== h_config_enable_alt_ed =====
29255 <HTML>
29256 <HEAD>
29257 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
29258 </HEAD>
29259 <BODY>
29260 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
29261
29262 If this feature is set (the default), and the
29263 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
29264 <B>is not</B> set, entering
29265 the ^_ (Ctrl-underscore) key while composing a message will prompt you
29266 for the name of the editor you would like to use.
29267 <P>
29268 If the environment variable $EDITOR is set, its value will be offered as
29269 a default.
29270 <P>
29271 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
29272 <B>is</B> set, the ^_ key will activate the specified
29273 editor without prompting, in which case it is not necessary to
29274 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
29275 <P>
29276 <UL>
29277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29278 </UL><P>
29279 &lt;End of help on this topic&gt;
29280 </BODY>
29281 </HTML>
29282 ====== h_config_alt_ed_now =====
29283 <HTML>
29284 <HEAD>
29285 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
29286 </HEAD>
29287 <BODY>
29288 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
29289
29290 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
29291 variable are both set, Alpine will
29292 automatically activate the specified editor when the cursor is moved from
29293 the header of the message being composed into the message text.  For
29294 replies, the alternate editor will be activated immediately.  If this
29295 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
29296 automatically ask for the name of an alternate editor when the cursor
29297 is moved out of the header being composed, or if a reply is being done.
29298
29299 <P><UL>
29300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29301 </UL>
29302 <P>
29303 &lt;End of help on this topic&gt;
29304 </BODY>
29305 </HTML>
29306 ====== h_config_enable_bounce =====
29307 <HTML>
29308 <HEAD>
29309 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
29310 </HEAD>
29311 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
29312 <BODY>
29313
29314 Setting this feature enables the "B Bounce" command, which will prompt
29315 for an address and *remail* the message to the new recipient.  This command
29316 is used to re-direct messages that you have received in error, or need to
29317 be redirected for some other reason (e.g. list moderation).  The final
29318 recipient will see a header indicating that you have Resent the msg, but
29319 the message's From: header will show the original author of the message,
29320 and replies to it will go back to that author, and not to you.
29321 <P>
29322 &lt;End of help on this topic&gt;
29323 </BODY>
29324 </HTML>
29325 ====== h_config_enable_agg_ops =====
29326 <HTML>
29327 <HEAD>
29328 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
29329 </HEAD>
29330 <BODY>
29331 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
29332
29333 When this feature is set you may use the commands and subcommands that relate to
29334 performing operations on more than one message at a time.  We call these
29335 &quot;aggregate operations&quot;.  In particular, the
29336 <!--chtml if pinemode="function_key"-->&quot;F5
29337 <!--chtml else-->&quot;;
29338 <!--chtml endif--> Select&quot;,
29339
29340 <!--chtml if pinemode="function_key"-->
29341 &quot;F6
29342 <!--chtml else-->
29343 &quot;A
29344 <!--chtml endif-->
29345 Apply&quot;, and
29346 <!--chtml if pinemode="function_key"-->
29347 &quot;F4
29348 <!--chtml else-->
29349 &quot;Z
29350 <!--chtml endif-->
29351 Zoom&quot; commands are enabled by this feature.  Select is used to
29352 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
29353 then be used to apply any message command to all of the selected/tagged
29354 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
29355 view between just those Selected and all messages in the folder.
29356 <P>
29357 This feature also enables the
29358 <!--chtml if pinemode="function_key"-->
29359 &quot;F7&quot;
29360 <!--chtml else-->
29361 &quot;^X&quot;
29362 <!--chtml endif-->
29363
29364 subcommand in the MESSAGE INDEX
29365 WhereIs command that causes all messages matching the WhereIs argument to
29366 become selected; and the Select, Select Current, and ZoomMode commands in the
29367 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
29368 <P>
29369 Some related help topics are
29370 <UL>
29371 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29372 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29373 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
29374 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29375 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29376 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29377 </UL>
29378 <P>
29379 <UL>
29380 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29381 </UL><P>
29382 &lt;End of help on this topic&gt;
29383 </BODY>
29384 </HTML>
29385
29386 ====== h_config_enable_flag =====
29387 <HTML>
29388 <HEAD>
29389 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
29390 </HEAD>
29391 <BODY>
29392 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
29393
29394 Setting this feature enables the
29395 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
29396 command that allows you to
29397 manipulate the status flags associated with a message.  By default, Flag
29398 will set the "Important" flag, which results in an asterisk being
29399 displayed in column one of the MESSAGE INDEX for such messages.
29400 <P>
29401 &lt;End of help on this topic&gt;
29402 </BODY>
29403 </HTML>
29404 ====== h_config_flag_screen_default =====
29405 <HTML>
29406 <HEAD>
29407 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
29408 </HEAD>
29409 <BODY>
29410 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
29411
29412 The feature modifies the behavior of the
29413 <a href="h_common_flag">Flag</a>
29414 command (provided it too is
29415 <A HREF="h_config_enable_flag">enabled</A>).
29416 By default, when the "* Flag" command is selected,
29417 Alpine offers a prompt to set one of several flags and also offers the
29418 option of entering the detailed flag manipulation screen via the "^T"
29419 key. Enabling this feature causes Alpine to immediately enter the detailed
29420 flag screen rather than first offer the simple prompt.
29421 The
29422 <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.
29423 <P>
29424 &lt;End of help on this topic&gt;
29425 </BODY>
29426 </HTML>
29427 ====== h_config_flag_screen_kw_shortcut =====
29428 <HTML>
29429 <HEAD>
29430 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
29431 </HEAD>
29432 <BODY>
29433 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
29434
29435 This feature modifies the behavior of the
29436 <a href="h_common_flag">Flag</a> command
29437 and the <A HREF="h_index_cmd_select">Select</A> command.
29438 This feature is set by default.
29439 When this feature is not set, when the "* Flag" command is selected,
29440 Alpine offers a prompt to set one of several flags and also offers the
29441 option of entering the detailed flag manipulation screen via the "^T"
29442 key.
29443 If you have
29444 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
29445 defined, then enabling this feature adds a shortcut way to set or unset
29446 keywords.
29447 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
29448 a keyword if you've given it a nickname) and that will set the keyword.
29449 <P>
29450 An example is easier to understand than the explanation.
29451 The flag command can always be used to set the system flags.
29452 For example, to set the Answered flag you would type
29453 <P>
29454 <CENTER><SAMP>* A</SAMP></CENTER>
29455 <P>
29456 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
29457 option in the Config screen.
29458 By default, to set a keyword like &quot;Work&quot; you would usually
29459 have to go to the Flag Details screen using
29460 the &quot;^T To Flag Details&quot; command.
29461 Instead, if you have enabled this feature, you may type
29462 <P>
29463 <CENTER><SAMP>* W</SAMP></CENTER>
29464 <P>
29465 to set the Work flag, or
29466 <P>
29467 <CENTER><SAMP>* ! W</SAMP></CENTER>
29468 <P>
29469 to unset it.
29470 Just like for the other flag setting commands, the case of the letter does
29471 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
29472 keyword.
29473 <P>
29474 Notice that you can only use this trick for one keyword that begins
29475 with &quot;W&quot;.
29476 If you happen to have a &quot;Work&quot; keyword and another keyword that is
29477 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
29478 your list of keywords.
29479 Also, there are five letters that are reserved for system
29480 flags and the NOT command.
29481 If you type &quot;* A&quot; it will always set the Answered flag, not
29482 your &quot;Aardvark&quot; keyword.
29483 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
29484 the Flag Details screen.
29485 <P>
29486 Because enabling the
29487 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
29488 option causes Alpine to skip directly to the Flag Details screen when the
29489 Flag command is used,
29490 setting it will cause this feature to have no effect at all.
29491 <P>
29492 Similarly, when Selecting by Keyword, setting this option will allow you
29493 to use Keyword initials instead of full keywords.
29494 <P>
29495 &lt;End of help on this topic&gt;
29496 </BODY>
29497 </HTML>
29498 ====== h_config_can_suspend =====
29499 <HTML>
29500 <HEAD>
29501 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
29502 </HEAD>
29503 <BODY>
29504 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
29505
29506 Setting this feature will allow you to type ^Z (Control Z) to
29507 <!--chtml if pinemode="os_windows"-->
29508 minimize Alpine into its icon, bringing into focus whatever
29509 application is running behind the PC-Alpine window.
29510 <!--chtml else-->
29511 temporarily suspend Alpine.
29512
29513 <P>
29514 This does not exit Alpine, but puts it in the background to watch
29515 for new mail and such.  Normally, you type a command, such
29516 as &quot;fg&quot; at your system prompt to return to your Alpine session.
29517
29518 <P>
29519 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
29520 adjusts whether Alpine is placed into the background of the shell its
29521 running in or starts a news shell.
29522 <!--chtml endif-->
29523
29524 <P>
29525 <UL>
29526 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29527 </UL><P>
29528 &lt;End of help on this topic&gt;
29529 </BODY>
29530 </HTML>
29531 ====== h_config_take_lastfirst ======
29532 <HTML>
29533 <HEAD>
29534 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
29535 </HEAD>
29536 <BODY>
29537 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
29538
29539 Normally, when TakeAddr is used to copy an address from a message into
29540 an address book entry, Alpine will attempt to rewrite the full name of the
29541 address in the form
29542 <P>
29543
29544 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
29545
29546 instead of<P>
29547
29548 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
29549
29550 <P>
29551 It does this because many people find it useful to sort by Last name
29552 instead of First name.  If this feature is set, then the TakeAddr command
29553 will not attempt to reverse the name in this manner.
29554 <P>
29555 &lt;End of help on this topic&gt;
29556 </BODY></HTML>
29557 ====== h_config_disable_regex ======
29558 <HTML>
29559 <HEAD>
29560 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
29561 </HEAD>
29562 <BODY>
29563 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
29564
29565 Normally, the
29566 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
29567 option is interpreted as a regular expression.
29568 One type of address that might cause trouble is an address that
29569 contains a plus sign.
29570 If you want to have an address with a plus as one of your
29571 <!--#echo var="VAR_alt-addresses"-->
29572 and you don't want to use regular expressions, then setting this
29573 feature will cause Alpine to treat the addresses you list literally instead.
29574 <P>
29575 &lt;End of help on this topic&gt;
29576 </BODY></HTML>
29577 ====== h_config_take_fullname ======
29578 <HTML>
29579 <HEAD>
29580 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
29581 </HEAD>
29582 <BODY>
29583 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
29584
29585 Normally, when TakeAddr is used to copy an address or addresses
29586 from a message into an address book entry, Alpine will try to preserve
29587 the full name associated with each address in the list of addresses.
29588 The reason for this is so that if the entry is a list or later becomes a
29589 list, then information about the individual addresses in the list
29590 is preserved.
29591 If you would rather just have the simple addresses in the list of addresses,
29592 set this feature. For example, with the default setting you might
29593 see something like this in the ADDRESS BOOK editor after you type TakeAddr
29594 <P>
29595 <PRE>
29596  Nickname  : nick
29597  Fullname  : Bedrock Elders
29598  Fcc       :
29599  Comment   :
29600  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
29601              Barney Rubble &lt;rubble@bedrock.org&gt;
29602 </PRE>
29603 <P>
29604 but with this feature set it would look like
29605 <P>
29606 <PRE>
29607  Nickname  : nick
29608  Fullname  : Bedrock Elders
29609  Fcc       :
29610  Comment   :
29611  Addresses : flint@bedrock.org,
29612              rubble@bedrock.org
29613 </PRE>
29614 <P>
29615 instead. Note the difference in the Addresses field.
29616 <P>
29617 &lt;End of help on this topic&gt;
29618 </BODY></HTML>
29619 ====== h_config_print_from ======
29620 <HTML>
29621 <HEAD>
29622 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
29623 </HEAD>
29624 <BODY>
29625 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
29626
29627 If this feature is set, then the Berkeley-mail style From line is included
29628 at the start of each message that is printed.  This line looks something
29629 like the following, with the address replaced by the address from the
29630 From line of the message being printed:
29631 <P>
29632 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
29633 14:11:06 1998
29634 <P>
29635 &lt;End of help on this topic&gt;
29636 </BODY>
29637 </HTML>
29638 ====== h_config_expanded_distlists ======
29639 <HTML>
29640 <HEAD>
29641 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
29642 </HEAD>
29643 <BODY>
29644 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
29645 If this feature is set, then distribution lists in the address book
29646 screen will always be expanded automatically.
29647 <P>
29648 &lt;End of help on this topic&gt;
29649 </BODY>
29650 </HTML>
29651 ====== h_config_compose_news_wo_conf ======
29652 <HTML>
29653 <HEAD>
29654 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
29655 </HEAD>
29656 <BODY>
29657 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
29658 This feature controls one aspect of Alpine's Composer.  If you enter the
29659 composer while reading a newsgroup, you will normally be prompted to
29660 determine whether you intend the new message to be posted to the current
29661 newsgroup or not.  If this feature is set, Alpine will not prompt you
29662 in this situation, and will assume that you do indeed wish to post
29663 to the newsgroup you are reading.
29664 <P>
29665 &lt;End of help on this topic&gt;
29666 </BODY>
29667 </HTML>
29668 ====== h_config_compose_rejects_unqual ======
29669 <HTML>
29670 <HEAD>
29671 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
29672 </HEAD>
29673 <BODY>
29674 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
29675
29676 This feature controls one aspect of the message composer; in particular,
29677 what happens when an unqualified name is entered into an address header.
29678 If set, unqualified names entered as addresses will be treated as errors
29679 unless they match an addressbook nickname.  Alpine will not attempt to turn
29680 them into complete addresses by adding your local domain.<P>
29681
29682 A complete (fully qualified) address is one containing a username followed
29683 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
29684 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
29685 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
29686
29687 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
29688
29689 <P>
29690
29691 When you enter a fully qualified address, Alpine does not interpret or
29692 modify it, but simply passes it on to the mail-transport-agent (MTA) for
29693 your system.  Alpine conforms to the Internet standards governing message
29694 headers and will not send an unqualifed name to the MTA.  Therefore, when
29695 you enter an unqualified name, Alpine will normally attempt to turn it into
29696 a fully qualified address, first by checking to see if you have entered a
29697 matching nickname in your addressbook, or failing that, by simply adding
29698 your own domain to the name entered.  So if your address is
29699 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
29700 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
29701 that into &quot;fred@example.com&quot;.<P>
29702
29703 There are situations where it is not desirable for Alpine to interpret such
29704 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
29705 turned out to be a typo (intended to be an addressbook nickname), but
29706 there actually was a &quot;fred&quot; in your local domain, the message might
29707 be mis-delivered without your realizing it.  In order to reduce the likelihood
29708 of such accidents, setting this feature will cause Alpine to treat such
29709 addresses as errors, and require that you explicitly enter the full local
29710 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
29711 matches an address book nickname.<P>
29712
29713 Consider this a safety feature against mis-directed mail.
29714 <P>
29715 <UL>
29716 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29717 </UL><P>
29718 &lt;End of help on this topic&gt;
29719 </BODY>
29720 </HTML>
29721 ====== h_config_quell_local_lookup ======
29722 <HTML>
29723 <HEAD>
29724 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
29725 </HEAD>
29726 <BODY>
29727 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
29728
29729 This feature controls an aspect of Alpine's Composer, and if needed, will
29730 usually be set by your system manager in Alpine's system-wide configuration
29731 file. Specifically, if this feature is set, Alpine will not attempt to look
29732 in the system password file to find a Full Name for the entered address.
29733 <P>
29734 Normally, names you enter into address fields (e.g. To: or Cc:) are
29735 checked against your address book(s) to see if they match an address book
29736 nickname.  Failing that, (in Unix Alpine) the name is then checked against
29737 the Unix password file.  If the entered name matches a username in the
29738 system password file, Alpine extracts the corresponding Full Name information
29739 for that individual, and adds that to the address being entered.
29740 <P>
29741 However, password file matching can have surprising (incorrect) results if
29742 other users of the system do not receive mail at the domain you are using.
29743 That is, if either the
29744 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
29745 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
29746 option
29747 is set such that the administrative domain of other users on the system
29748 isn't accurately reflected, Alpine should be told that a passwd file match
29749 is coincidental, and Full Name info will be incorrect.  For example, a
29750 personal name from the password file could get falsely paired with the
29751 entered name as it is turned into an address in the configured domain.
29752 <P>
29753 If you are seeing this behavior, enabling this feature will prevent Unix
29754 Alpine from looking up names in the password file to find the Full Name
29755 for incomplete addresses you enter.<P>
29756 <UL>
29757 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29758 </UL>
29759 <P>
29760 &lt;End of help on this topic&gt;
29761 </BODY>
29762 </HTML>
29763 ====== h_config_tab_checks_recent ======
29764 <HTML>
29765 <HEAD>
29766 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
29767 </HEAD>
29768 <BODY>
29769 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
29770
29771 In a FOLDER LIST screen, the TAB key usually just changes which
29772 folder is highlighted.
29773 If this feature is set, then the TAB key will cause the number of
29774 recent messages and the total number of messages in the highlighted folder
29775 to be displayed instead.
29776
29777 <P>
29778 &lt;End of help on this topic&gt;
29779 </BODY>
29780 </HTML>
29781 ====== h_config_maildrops_preserve_state ======
29782 <HTML>
29783 <HEAD>
29784 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
29785 </HEAD>
29786 <BODY>
29787 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
29788
29789 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
29790 Normally, when mail is moved from a Mail Drop folder to a destination
29791 folder, it is delivered as new mail.
29792 Any Seen/New, Answered, Important/Flagged state that has changed will be
29793 ignored.
29794 All of the mail will be considered unSeen, unAnswered, and unImportant after
29795 it is moved.
29796 <P>
29797 If this feature is set, then the state changes that have been made
29798 to the messages in the Mail Drop folder will be preserved.
29799 <P>
29800 In any case, messages that are already marked Deleted when the
29801 mail is to be moved from the Mail Drop will be ignored.
29802 <P>
29803 &lt;End of help on this topic&gt;
29804 </BODY>
29805 </HTML>
29806 ====== h_config_preopen_stayopens ======
29807 <HTML>
29808 <HEAD>
29809 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
29810 </HEAD>
29811 <BODY>
29812 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
29813
29814 This feature is related to the option
29815 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29816 Normally, Stay Open folders are only opened on demand, when the user
29817 asks to open them.
29818 From then on they are kept open for the duration of the session.
29819 However, if this feature is set, then the Stay Open folders will all be
29820 opened at startup, at the same time that the INBOX is opened.
29821
29822 <P>
29823 &lt;End of help on this topic&gt;
29824 </BODY>
29825 </HTML>
29826 ====== h_config_expunge_inbox ======
29827 <HTML>
29828 <HEAD>
29829 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
29830 </HEAD>
29831 <BODY>
29832 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
29833
29834 The INBOX is normally treated differently from regular folders in several
29835 ways.
29836 One of the differences is that the normal &quot;close&quot; sequence of
29837 events is deferred until Alpine is exited, instead of happening when you
29838 leave the INBOX to view another folder.
29839 The &quot;close&quot; sequence normally includes the Expunging
29840 of deleted messages
29841 (either automatically or after a prompt, controlled by the features
29842 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29843 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29844 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29845 handling of the
29846 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
29847
29848 <P>
29849 If this feature is set the &quot;close&quot; sequence handling will take
29850 place every time you leave the INBOX.
29851 The INBOX will still be kept open, but the offer to Expunge and the archiving
29852 to the <!--#echo var="VAR_read-message-folder"-->
29853 will take place each time you leave the INBOX instead of only once at the
29854 end of the session.
29855
29856 <P>
29857 &lt;End of help on this topic&gt;
29858 </BODY>
29859 </HTML>
29860 ====== h_config_expunge_stayopens ======
29861 <HTML>
29862 <HEAD>
29863 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
29864 </HEAD>
29865 <BODY>
29866 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
29867
29868 This feature is related to the option
29869 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29870 Stay Open folders are treated differently from regular folders in several
29871 ways.
29872 One of the differences is that the normal &quot;close&quot; sequence of
29873 events is deferred until Alpine is exited, instead of happening when you
29874 leave the folder to view another folder.
29875 The &quot;close&quot; sequence normally includes the Expunging
29876 of deleted messages
29877 (either automatically or after a prompt, controlled by the features
29878 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29879 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29880 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29881 handling of
29882 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
29883
29884 <P>
29885 If this feature is set the &quot;close&quot; sequence handling will take
29886 place when you leave the Stay Open folder.
29887 The folder will still be kept open, but the offer to Expunge and the archiving
29888 will take place each time you leave the folder instead of only once at the
29889 end of the session.
29890 This feature does not affect the INBOX, which will still only be processed
29891 when you exit Alpine.
29892 However, there is a similar feature that affects only the INBOX called
29893 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
29894
29895 <P>
29896 &lt;End of help on this topic&gt;
29897 </BODY>
29898 </HTML>
29899 ====== h_config_preserve_start_stop ======
29900 <HTML>
29901 <HEAD>
29902 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
29903 </HEAD>
29904 <BODY>
29905 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
29906
29907 This feature controls how special control key characters, typically
29908 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
29909 are known as the "stop" and "start" characters and are sometimes used in
29910 communications paths to control data flow between devices that operate at
29911 different speeds.
29912
29913 <P>
29914
29915 By default, Alpine turns the system's handling of these special characters
29916 off except during printing.  However, if you see Alpine reporting input errors
29917 such as:
29918 <P>
29919 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
29920 <P>
29921 and, at the same time, see your display become garbled, then it is likely
29922 that setting this option will solve the problem.  Be aware, though, that
29923 enabling this feature will also cause Alpine to ostensibly "hang"
29924 whenever the Ctrl-S key combination is entered as the system is now
29925 interpreting such input as a "stop output" command.  To "start
29926 output"  again, simply type Ctrl-Q.
29927 <P>
29928 &lt;End of help on this topic&gt;
29929 </BODY>
29930 </HTML>
29931 ====== h_config_enable_incoming ======
29932 <HTML>
29933 <HEAD>
29934 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
29935 </HEAD>
29936 <BODY>
29937 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
29938
29939 Alpine's Incoming Message Folders collection
29940 provides a convenient way to access multiple incoming folders.
29941 It is also useful if you have accounts on multiple computers.
29942 <P>
29943
29944 If set, this feature defines a pseudo-folder collection called
29945 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
29946 in this collection will be your INBOX, which will no longer show up in
29947 your Default folder collection.
29948 <P>
29949
29950 You may add more folders to the Incoming Message Folders collection by
29951 using the
29952 <!--chtml if pinemode="function_key"-->
29953 &quot;F10
29954 <!--chtml else-->
29955 &quot;A
29956 <!--chtml endif-->
29957 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
29958 the host the folder is stored on (which defaults to the same host used
29959 for your INBOX), a nickname, and the actual folder name.  Once a set
29960 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
29961 or MESSAGE TEXT screens) may be used to scan the folders for those
29962 with Recent messages.  If you add more folders to
29963 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
29964 no effect.
29965 <P>
29966 NOTE: Normally the software that actually delivers mail (the stuff that happens
29967 before Alpine is involved) is in a better position to do delivery filtering
29968 than is Alpine itself.
29969 If possible, you may want to look at programs such as
29970 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
29971 filtering programs.
29972 If you'd prefer to have Alpine do the filtering for you, you may set that
29973 up.
29974 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
29975 <P>
29976 <UL>
29977 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29978 </UL><P>
29979 &lt;End of help on this topic&gt;
29980 </BODY>
29981 </HTML>
29982 ====== h_config_enable_incoming_checking ======
29983 <HTML>
29984 <HEAD>
29985 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
29986 </HEAD>
29987 <BODY>
29988 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
29989
29990 This feature is only operational if you have enabled the optional
29991 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
29992 If you do have Incoming Message Folders and you also set this feature,
29993 then the number of Unseen messages in each folder will be displayed
29994 in the FOLDER LIST screen for the Incoming Message Folders.
29995 The number of Unseen messages in a folder will be displayed in parentheses
29996 to the right of the name of each folder.
29997 If there are no Unseen messages in a folder then only the name
29998 is displayed, not a set of parentheses with zero inside them.
29999 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
30000 the Incoming Message Folders to cause an immediate update.
30001 <P>
30002 If a check for Unseen messages fails for a particular folder then Alpine
30003 will no longer attempt to check that folder for the duration of the
30004 session and this will be indicated by a question mark inside the
30005 parentheses.
30006 <P>
30007 The features
30008 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
30009 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
30010 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
30011 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
30012 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
30013 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
30014 all affect how this feature behaves.
30015 <P>
30016 <UL>
30017 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30018 </UL><P>
30019 &lt;End of help on this topic&gt;
30020 </BODY>
30021 </HTML>
30022 ====== h_config_incoming_checking_total ======
30023 <HTML>
30024 <HEAD>
30025 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
30026 </HEAD>
30027 <BODY>
30028 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
30029
30030 This option has no effect unless the feature
30031 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
30032 is set, which in turn has no effect unless
30033 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
30034 is set.
30035 <P>
30036 When incoming folder checking is turned on the default is to display
30037 the number of unseen messages in each folder.
30038 More precisely, it is the number of undeleted unseen messages.
30039 Using this option you may also display the total number of messages
30040 in each folder.
30041 Instead of a single number representing the number of unseen messages
30042 you will get two numbers separated by a slash character.
30043 The first is the number of unseen messages and the second is the
30044 total number of messages.
30045 <P>
30046 You may also use the recent message count instead of the unseen message
30047 count by turning on the feature
30048 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
30049 <P>
30050 <UL>
30051 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30052 </UL><P>
30053 &lt;End of help on this topic&gt;
30054 </BODY>
30055 </HTML>
30056 ====== h_config_incoming_checking_recent ======
30057 <HTML>
30058 <HEAD>
30059 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
30060 </HEAD>
30061 <BODY>
30062 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
30063
30064 This option has no effect unless the feature
30065 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
30066 is set, which in turn has no effect unless
30067 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
30068 is set.
30069 <P>
30070 When incoming folder checking is turned on the default is to display
30071 the number of unseen messages in each folder.
30072 More precisely, it is the number of undeleted unseen messages.
30073 Using this option you may display the number of recent messages instead
30074 of the number of unseen messages.
30075 A message is only counted as recent if this is the first session to
30076 see it, so the recent count might be less than the unseen count.
30077 The difference between the two would be accounted for by the unseen messages
30078 in the folder which were there previously but have not been looked at yet.
30079 <P>
30080 If you simultaneously run more than one email client at a time
30081 (for example, you run more than one Alpine in parallel) then turning
30082 this feature on can cause some confusion.
30083 The confusion stems from the fact that each message is only considered to be
30084 recent in one session.
30085 That means that the counts of new messages may be different in the two
30086 Alpines running side by side, because each incoming message will only be
30087 counted as recent in one of the two sessions.
30088 <P>
30089 You may also display the total number of messages
30090 in each folder by using the
30091 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
30092 option.
30093 <P>
30094 <UL>
30095 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30096 </UL><P>
30097 &lt;End of help on this topic&gt;
30098 </BODY>
30099 </HTML>
30100 ====== h_config_attach_in_reply ======
30101 <HTML>
30102 <HEAD>
30103 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
30104 </HEAD>
30105 <BODY>
30106 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
30107
30108 This feature controls an aspect of Alpine's Reply command. If set, any MIME
30109 attachments that were part of the original message will automatically be
30110 included in the Reply.
30111 <P>
30112 &lt;End of help on this topic&gt;
30113 </BODY>
30114 </HTML>
30115 ====== h_config_include_header =====
30116 <HTML>
30117 <HEAD>
30118 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
30119 </HEAD>
30120 <BODY>
30121 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
30122
30123 This feature controls an aspect of Alpine's Reply command. If set, and the
30124 original message is being included in the reply, then headers from that
30125 message will also be part of the reply.
30126 <P>
30127 &lt;End of help on this topic&gt;
30128 </HEAD>
30129 </HTML>
30130 ====== h_config_sig_at_bottom =====
30131 <HTML>
30132 <HEAD>
30133 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
30134 </HEAD>
30135 <BODY>
30136 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
30137
30138 This feature controls an aspect of Alpine's Reply command.  If this feature
30139 is set, and the original message is being included in the reply, then the
30140 contents of your signature file (if any) will be inserted after the included
30141 message.
30142 <P>
30143 This feature does not affect the results of a Forward command.
30144 <P>
30145 &lt;End of help on this topic&gt;
30146 </BODY>
30147 </HTML>
30148 ====== h_config_sigdashes =====
30149 <HTML>
30150 <HEAD>
30151 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
30152 </HEAD>
30153 <BODY>
30154 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
30155
30156 This feature enables support for the common USENET news convention
30157 of preceding a message signature with the special line consisting of
30158 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
30159
30160 <P>
30161 When enabled and a
30162 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
30163 Alpine will insert the special line before including the file's text (unless
30164 the special line already exists somewhere in the file's text).
30165
30166 <P>
30167 In addition, when you Reply or Followup to a message containing one of
30168 these special lines and choose to include its text, Alpine will observe
30169 the convention of not including text beyond the special line in your
30170 reply.
30171 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
30172 mode is enabled and turned on, then Alpine <EM>will</EM>
30173 include the text beyond the special line regardless of the setting of
30174 this feature.
30175
30176 <P>
30177 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
30178 for a related feature.
30179
30180 <P>
30181 <UL>
30182 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30183 </UL><P>
30184 &lt;End of help on this topic&gt;
30185 </BODY>
30186 </HTML>
30187 ====== h_config_new_thread_blank_subject =====
30188 <HTML>
30189 <HEAD>
30190 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
30191 </HEAD>
30192 <BODY>
30193 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
30194
30195 When this feature is enabled (the default) Alpine will create a new thread
30196 every time that the subject line becomes empty at any time during composition.
30197
30198 <P>
30199 This behavior is particularly useful in case you are replying to a message.
30200 Replying to a message causes the message to be in the same thread than the
30201 original message that is being replied to. However, many authors want to create
30202 a new message (in a different thread) while replying to a message, and they do
30203 this by changing the full subject, by first deleting the original subject and
30204 typing the new subject of the current message.
30205
30206 <P>
30207 Enabling this feature causes that any time that the subject is deleted, the
30208 message being composed will be considered the first message of a new thread.
30209
30210 <P>
30211 <UL>
30212 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30213 </UL><P>
30214 &lt;End of help on this topic&gt;
30215 </BODY>
30216 </HTML>
30217 ====== h_config_strip_sigdashes =====
30218 <HTML>
30219 <HEAD>
30220 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
30221 </HEAD>
30222 <BODY>
30223 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
30224
30225 This feature doesn't do anything if the feature
30226 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
30227 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
30228 then turning on this feature enables support for the convention
30229 of not including text beyond the sigdashes line when Replying or Following
30230 up to a message and including the text of that message.
30231 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
30232 mode is enabled and turned on, then Alpine <EM>will</EM>
30233 include the text beyond the special line regardless of the setting of
30234 this feature.
30235 <P>
30236 In other words, this is a way to turn on the signature stripping behavior
30237 without also turning on the dashes-adding behavior.
30238 <P>
30239 <UL>
30240 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30241 </UL><P>
30242 &lt;End of help on this topic&gt;
30243 </BODY>
30244 </HTML>
30245 ====== h_config_forward_as_attachment =====
30246 <HTML>
30247 <HEAD>
30248 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
30249 </HEAD>
30250 <BODY>
30251 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
30252
30253 This feature affects the way forwarded message text is handled.  When set, rather than
30254 include the text of the forwarded message below any additional text you provide in the
30255 composer, the forwarded message is attached in its entirety to the message you send.
30256 <P>
30257 This is useful in that it keeps the text you provide in the composer distinct from the
30258 text of the forwarded message.  Similarly, it allows the recipient to
30259 conveniently operate on the forwarded message.  For example, they might reply directly to
30260 the sender of the forwarded message, or process it as part of a spam report.
30261 <UL>
30262 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30263 </UL><P>
30264 &lt;End of help on this topic&gt;
30265 </BODY>
30266 </HTML>
30267 ====== h_config_preserve_field =====
30268 <HTML>
30269 <HEAD>
30270 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
30271 </HEAD>
30272 <BODY>
30273 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
30274
30275 This feature affects Alpine's behavior when one replies to a message.
30276 When you receive a message, some or all of the recipients of the message
30277 have been added to the To: and Cc: fields. If you reply to such message,
30278 and this feature is disabled, then the original sender of the message is
30279 added to the To: field, and all other recipients are added to the Cc:
30280 field, while your address is added to the From: field.
30281
30282 <P>
30283 However, if this feature is enabled, then Alpine will preserve the
30284 original fields as sent in the original message, so the Cc: and To:
30285 fields will be preserved. The sender's address will be added to the To:
30286 field, while your address is added to the From: field.
30287
30288 <P>
30289 The behavior of this feature is that replies to all messages will behave
30290 in the way described above. If you only intend this to happen on a per
30291 message basis, then keep this feature disabled, and when replying to a
30292 message you will see a new option in the menu for the &quot;Reply to all
30293 recipients?&quot; question. In this case, pressing &quot;p&quot; will
30294 make Alpine toggle its question so you can preserve the To: and Cc:
30295 fields for that message only.
30296
30297 <UL>
30298 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30299 </UL><P>
30300 &lt;End of help on this topic&gt;
30301 </BODY>
30302 </HTML>
30303 ====== h_config_sub_lists =====
30304 <HTML>
30305 <HEAD>
30306 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
30307 </HEAD>
30308 <BODY>
30309 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
30310
30311 This feature affects the subcommands available when Saving,
30312 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
30313 available. This command allows you to type in a substring of the folder
30314 you are looking for and when you type ^X it will display all folders
30315 that contain that substring in their names.
30316 This feature is set by default.
30317
30318 <P>
30319 &lt;End of help on this topic&gt;
30320 </BODY>
30321 </HTML>
30322 ====== h_config_scramble_message_id =====
30323 <HTML>
30324 <HEAD>
30325 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
30326 </HEAD>
30327 <BODY>
30328 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
30329
30330 If this feature is set, the message-id header value
30331 will be transformed with a simple Rot13 transformation.
30332 The result will still have the correct syntax for a Message-ID but the
30333 part of the MessageID that is often a domain name will not be an actual
30334 domain name because the letters will be scrambled.
30335 <P>
30336 It is possible (but unlikely?) that some spam detection
30337 software will use that as a reason to reject the mail as spam.
30338 It has also been reported that some spam detection software uses the
30339 fact that there are no dots after the &quot;@&quot; as a reason to reject
30340 messages.
30341 If your PC-Alpine Message-ID is using a name without a dot that is because
30342 that is what Windows thinks is your &quot;Full computer name&quot;.
30343 The method used to set this varies from one type of Windows to another but
30344 check under Settings -> Control Panel -> System and
30345 look for Network Identification or Computer Name or something similar.
30346 How to set it is beyond the scope of Alpine.
30347
30348 <P>
30349 &lt;End of help on this topic&gt;
30350 </BODY>
30351 </HTML>
30352 ====== h_downgrade_multipart_to_text =====
30353 <HTML>
30354 <HEAD>
30355 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
30356 </HEAD>
30357 <BODY>
30358 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
30359
30360 <P>
30361 This feature affects Alpine's behavior when sending mail.  Internet
30362 standards require Alpine to translate all non-ASCII characters in
30363 messages that it sends using MIME encoding.  This encoding can be
30364 ostensibly broken for recipients if any agent between Alpine and the
30365 recipient, such as an email list expander, appends text to the
30366 message, such as list information or advertising.  When sending such
30367 messages Alpine attempts to protect such encoding by placing extra
30368 MIME boundaries around the message text.
30369 <P>
30370 These extra boundaries are invisible to recipients that
30371 use MIME-aware email programs (the vast majority).  However, if
30372 you correspond with users of email programs that are not MIME-aware,
30373 or do not handle the extra boundaries gracefully, you can
30374 use this feature to prevent Alpine from including the extra
30375 MIME information.  Of course, it will increase the likelihood
30376 that non-ASCII text you send may appear corrupt to the recipient.
30377 <P>
30378 &lt;End of help on this topic&gt;
30379 </BODY>
30380 </HTML>
30381 ====== h_config_show_sort =====
30382 <HTML>
30383 <HEAD>
30384 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
30385 </HEAD>
30386 <BODY>
30387 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
30388
30389 If this feature is set and there is sufficient space on the screen,
30390 a short indication of the current sort order will be
30391 added in the titlebar (the top line on the screen), before the name
30392 of the folder.
30393 For example, with the default Arrival sort in effect,
30394 the display would have the characters
30395
30396 <P><CENTER>[A]</CENTER><P>
30397
30398 added between the title of the screen and the folder name.
30399 The letters are the same as the letters you may type to manually
30400 sort a folder with the SortIndex command ($).
30401 The letters in the table below are the ones that may show
30402 up in the titlebar line.
30403 <P>
30404 <TABLE>
30405 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
30406 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
30407 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
30408 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
30409 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
30410 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
30411 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
30412 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
30413 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
30414 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
30415 </TABLE>
30416 <P>
30417 If the sort order is Reversed, the letter above will be preceded by the letter
30418 &quot;R&quot;, for example
30419
30420 <P><CENTER>[RS]</CENTER><P>
30421
30422 means that a Reverse Subject sort is in effect.
30423 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
30424 left out, and just an &quot;R&quot; is shown.
30425
30426 <P><CENTER>[R]</CENTER>
30427
30428 <P>
30429 &lt;End of help on this topic&gt;
30430 </BODY>
30431 </HTML>
30432 ====== h_config_disable_reset_disp =====
30433 <HTML>
30434 <HEAD>
30435 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
30436 </HEAD>
30437 <BODY>
30438 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
30439
30440 UNIX Alpine only.
30441 <P>
30442 This feature affects Alpine's behavior when using
30443 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
30444 Normally, before the display filter is run, the terminal mode is reset
30445 to what it was before you started Alpine.
30446 This may be necessary if the filter requires the use of the terminal.
30447 For example, it may need to interact with you.
30448 If you set this feature, then the terminal mode will not be reset.
30449 One thing that turning on this feature should fix is the coloring of
30450 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
30451 breaks because the terminal reset resets the color state of the terminal.
30452
30453 <P>
30454 &lt;End of help on this topic&gt;
30455 </BODY>
30456 </HTML>
30457 ====== h_config_disable_sender =====
30458 <HTML>
30459 <HEAD>
30460 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
30461 </HEAD>
30462 <BODY>
30463 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
30464
30465 This feature affects Alpine's generation of the &quot;Sender:&quot; or
30466 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
30467 header fields.
30468 Prior to version 2.24, Alpine generated such a header in situations where the
30469 username or domain were not the same as
30470 the &quot;From:&quot; header on the message.
30471 With this feature set,
30472 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
30473 This may be desirable on a system that is virtually hosting many domains,
30474 and the sysadmin has other methods available for tracking a message to
30475 its originator.
30476 <P>
30477 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
30478
30479 <P>
30480 &lt;End of help on this topic&gt;
30481 </BODY>
30482 </HTML>
30483 ====== h_config_use_sender_not_x =====
30484 <HTML>
30485 <HEAD>
30486 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
30487 </HEAD>
30488 <BODY>
30489 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
30490
30491 Normally Alpine adds a header line
30492 labeled &quot;X-X-Sender&quot;, if the sender is
30493 different from the From: line.
30494 The standard specifies that this header
30495 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
30496 Setting this feature causes
30497 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
30498 <P>
30499 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
30500
30501 <P>
30502 &lt;End of help on this topic&gt;
30503 </BODY>
30504 </HTML>
30505 ====== h_config_use_fk =====
30506 <HTML>
30507 <HEAD>
30508 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
30509 </HEAD>
30510 <BODY>
30511 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
30512
30513 This feature specifies that Alpine will respond to function keys instead of
30514 the normal single-letter commands. In this mode, the key menus at the
30515 bottom of each screen will show function key designations instead of the
30516 normal mnemonic key.
30517
30518 <P>
30519 &lt;End of help on this topic&gt;
30520 </BODY>
30521 </HTML>
30522 ====== h_config_cancel_confirm =====
30523 <HTML>
30524 <HEAD>
30525 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
30526 </HEAD>
30527 <BODY>
30528 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
30529
30530 This feature affects what happens when you type ^C to cancel a composition.
30531 By default, if you attempt to cancel a composition by typing ^C, you will be
30532 asked to confirm the cancellation by typing a &quot;C&quot;
30533 for <EM>C</EM>onfirm.
30534 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
30535 risky because the &quot;^C Y&quot; needed to cancel a message
30536 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
30537 <P>
30538 If this feature is set the confirmation asked for
30539 will be a &quot;<EM>Y</EM>es&quot;
30540 instead of a &quot;<EM>C</EM>onfirm&quot; response.
30541
30542 <P>
30543 &lt;End of help on this topic&gt;
30544 </BODY>
30545 </HTML>
30546 ====== h_config_compose_maps_del =====
30547 <HTML>
30548 <HEAD>
30549 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
30550 </HEAD>
30551 <BODY>
30552 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
30553
30554 This feature affects the behavior of the DELETE key.
30555 If set, Delete will be equivalent to ^D, and delete
30556 the current character.  Normally Alpine defines the Delete key
30557 to be equivalent to ^H, which deletes the <EM>previous</EM>
30558 character.
30559
30560 <P>
30561 &lt;End of help on this topic&gt;
30562 </BODY>
30563 </HTML>
30564 ====== h_config_compose_bg_post =====
30565 <HTML>
30566 <HEAD>
30567 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
30568 </HEAD>
30569 <BODY>
30570 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
30571
30572 This feature affects the behavior of Alpine's mail sending.  If set, this
30573 feature enables a subcommand in the composer's "Send?" confirmation
30574 prompt.  The subcommand allows you to tell Alpine to handle the actual
30575 posting in the background.  While this feature usually allows posting
30576 to appear to happen very fast, it has no affect on the actual delivery
30577 time it takes a message to arrive at its destination.
30578
30579 <P>
30580 Please Note:
30581 <OL>
30582  <LI>This feature will have no effect if the feature
30583        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
30584        is set.
30585  <LI>This feature isn't supported on all systems.  All DOS and Windows,
30586        as well as several Unix ports, do not recognize this feature.
30587  <LI>Error handling is significantly different when this feature is
30588         enabled.  Any message posting failure results in the message
30589         being appended to your &quot;Interrupted&quot; mail folder.  When you
30590         type the <A HREF="h_common_compose">C</A>ompose command,
30591         Alpine will notice this folder and
30592         offer to extract any messages contained.  Upon continuing a
30593         failed message, Alpine will display the nature of the failure
30594         in the status message line.
30595  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
30596         for message data to
30597         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
30598         if you typically run close to any sort of disk-space limits or quotas.
30599 </OL>
30600 <P>
30601 &lt;End of help on this topic&gt;
30602 </BODY>
30603 </HTML>
30604 ====== h_config_compose_dsn =====
30605 <HTML>
30606 <HEAD>
30607 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
30608 </HEAD>
30609 <BODY>
30610 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
30611
30612 This feature affects the behavior of Alpine's mail sending.  If set, this
30613 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
30614 prompt.  The subcommand allows you to tell Alpine to request the type of
30615 Delivery Status Notification (DSN) that you would like.  Most users will
30616 be happy with the default, and need not enable this feature.
30617 <P>
30618 If the feature
30619 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
30620 then this feature has no effect and the type of DSN is not selectable.
30621
30622 <P>
30623 Turning on this feature and then turning on the DSNOpts from the send
30624 prompt reveals four on-off toggles at the bottom of the screen.
30625 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
30626 that no notification be returned to you, even if there is a delivery
30627 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
30628 server that you are willing (or not) to receive delay notifications, which
30629 happen when there is an unusual delay at some mail server (in that mail
30630 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
30631 Success requests that you be sent a DSN message when the message is
30632 successfully delivered to the recipients mailbox.  Setting NoErrRets will
30633 automatically turn off Delay and Success notification, and will flip the
30634 toggles to show that.  Similarly, turning on Delay and/or Success will
30635 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
30636 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
30637 the full message be returned in any failed DSN.  RetHdrs requests that
30638 only the headers be returned in any failed DSN.  Notice that this command
30639 applies only to failed delivery status reports.  For delay or success
30640 reports, the full message is never returned, only the headers are returned.
30641
30642 <P>
30643 If you don't enable the DSN feature or if you don't turn it on for a
30644 particular message, the default is that you will be notified about failures,
30645 you might be notified about delays, and you won't be notified about
30646 successes.  You will usually receive the full message back when there is
30647 a failure.
30648
30649 <P>
30650 If you turn on the DSNOpts the default is to return as much information as
30651 possible to you.  That is, by default, the Success and Delay options are
30652 turned on and the full message will be returned on failure.
30653
30654 <P>
30655 The sending prompt will display the current DSN request (if any) in a
30656 shorthand form.  It will be:
30657
30658 <P><CENTER>[Never]</CENTER>
30659
30660 <P>
30661 if you have requested NoErrRets.  Otherwise, it will look something like:
30662
30663 <P><CENTER>[FDS-Hdrs]</CENTER>
30664
30665 <P>
30666 The &quot;F&quot; will always be there, indicating that you will be notified
30667 of failures.  (Alpine doesn't provide a way to request no failure notification
30668 and at the same time request either success or delay notification.  The only
30669 way to request no failure notifications is to request no notifications at
30670 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
30671 requested Delay and/or Success notification.  If one of those is missing,
30672 that means you are requesting no notification of the corresponding type.
30673 After the dash it will say either Hdrs or Full.  Hdrs means to return only
30674 the headers and Full means to return the full message (applies to
30675 failure notifications only).
30676
30677 <P>
30678 NOTE: This feature relies on your system's mail transport agent or
30679 configured
30680 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
30681 having the negotiation mechanism introduced in
30682 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
30683 &quot;Delivery Status Notification&quot; (DSN).  If the mail transport agent you
30684 are using doesn't support DSN, a short warning will be shown to you on
30685 the message line at the bottom of the screen after you send your message,
30686 but your message will have been sent anyway.
30687
30688 <P>
30689 Note that DSNs don't provide a mechanism to request read receipts.  That
30690 is, if you request notification on success you are notified when the
30691 message is delivered to the mailbox, not when the message is read.
30692
30693 <P>
30694 ESMTP allows for graceful migration to upgraded mail transfer agents, but
30695 it is possible that this feature might cause problems for some servers.
30696
30697 <P>
30698 &lt;End of help on this topic&gt;
30699 </BODY>
30700 </HTML>
30701 ====== h_config_auto_zoom =====
30702 <HTML>
30703 <HEAD>
30704 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
30705 </HEAD>
30706 <BODY>
30707 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
30708
30709 This feature affects the behavior of the Select command.
30710 If set, the select command will automatically perform a zoom
30711 after the select is complete.
30712 This feature is set by default.
30713 <P>
30714 Some related help topics are
30715 <UL>
30716 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30717 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30718 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30719 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
30720 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
30721 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30722 </UL>
30723
30724 <P>
30725 &lt;End of help on this topic&gt;
30726 </BODY>
30727 </HTML>
30728 ====== h_config_auto_unzoom =====
30729 <HTML>
30730 <HEAD>
30731 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
30732 </HEAD>
30733 <BODY>
30734 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
30735
30736 This feature affects the behavior of the Apply command.  If set, and if
30737 you are currently looking at a Zoomed Index view of selected messages,
30738 the Apply command will do the operation you specify, but then will
30739 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
30740 the normal Index view after the Apply.
30741 This feature is set by default.
30742
30743 <P>
30744 Some related help topics are
30745 <UL>
30746 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30747 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30748 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30749 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
30750 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
30751 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30752 </UL>
30753 <P>
30754 &lt;End of help on this topic&gt;
30755 </BODY>
30756 </HTML>
30757 ====== h_config_auto_unselect =====
30758 <HTML>
30759 <HEAD>
30760 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
30761 </HEAD>
30762 <BODY>
30763 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
30764
30765 This feature affects the behavior of the Apply command.  If set,
30766 the Apply command will do the operation you specify, but then will
30767 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
30768 the normal Index view after the Apply.
30769
30770 <P>
30771 Some related help topics are
30772 <UL>
30773 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30774 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30775 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30776 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
30777 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
30778 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30779 </UL>
30780 <P>
30781 &lt;End of help on this topic&gt;
30782 </BODY>
30783 </HTML>
30784 ====== h_config_fast_recent =====
30785 <HTML>
30786 <HEAD>
30787 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
30788 </HEAD>
30789 <BODY>
30790 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
30791
30792 This feature controls the behavior of the TAB key when traversing folders
30793 in the optional
30794 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
30795 collection or in optional <!--#echo var="VAR_news-collections"-->.
30796
30797 <P>
30798 When the TAB
30799 (<A HREF="h_common_nextnew">NextNew</A>)
30800 key is pressed, the default behavior is to
30801 explicitly examine the status of the folder for the number of recent
30802 messages (messages delivered since the last time it was viewed).
30803 Depending on the size and number of messages in the folder, this test
30804 can be time consuming.
30805
30806 <P>
30807 Enabling this feature will cause Alpine to only test for the existence of
30808 any recent messages rather than to obtain the count.  This is much faster
30809 in many cases.  The downside is that you're not given the number of recent
30810 messages when prompted to view the next folder.
30811 If the feature
30812 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
30813 is turned on, then the present feature will have no effect.
30814
30815 <P>
30816 <UL>
30817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30818 </UL><P>
30819 &lt;End of help on this topic&gt;
30820 </BODY>
30821 </HTML>
30822 ====== h_config_arrow_nav =====
30823 <HTML>
30824 <HEAD>
30825 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
30826 </HEAD>
30827 <BODY>
30828 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
30829
30830 This feature controls the behavior of the left and right arrow keys.
30831 If set, the left and right arrow keys will operate like the usual
30832 navigation keys &lt; and &gt;.
30833 This feature is set by default.
30834
30835 <P>
30836 If you set this feature, and do not like the changed behavior of the up/down
30837 arrow
30838 keys when navigating through the FOLDER LIST screen --
30839 <B>first</B> from column to column, if more than one folder is
30840 displayed per row,
30841 and <B>then</B> from row to row -- you may either also wish to set the feature
30842 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
30843 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
30844 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
30845 folders in each column.
30846 <P>
30847 <UL>
30848 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30849 </UL><P>
30850 &lt;End of help on this topic&gt;
30851 </BODY>
30852 </HTML>
30853 ====== h_config_relaxed_arrow_nav =====
30854 <HTML>
30855 <HEAD>
30856 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
30857 </HEAD>
30858 <BODY>
30859 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
30860
30861 This feature controls the behavior of the left, right, up and down
30862 arrow keys in the FOLDER LIST screen when the &quot;<A
30863 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
30864 set.
30865 This feature is set by default.
30866
30867 <P>
30868
30869 When this feature is set, the left and right
30870 arrow keys in the FOLDER LIST screen
30871 move the highlight bar to the left or right, and the up and
30872 down arrows move it up or down.
30873
30874 <P>
30875 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
30876 feature is not set;
30877 the left and right arrow keys in the Folder List screen strictly
30878 track the commands bound to the '&lt;' and '&gt;' keys, and the up
30879 and down arrow keys move the highlight bar to the previous and next
30880 folder or directory name.
30881
30882 <P>
30883 <UL>
30884 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30885 </UL><P>
30886 &lt;End of help on this topic&gt;
30887 </BODY>
30888 </HTML>
30889 ====== h_config_alt_compose_menu =====
30890 <HTML>
30891 <HEAD>
30892 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
30893 </HEAD>
30894 <BODY>
30895 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
30896
30897 This feature controls the menu that is displayed when Compose is selected.
30898 If set, a list of options will be presented, with each option representing
30899 the type of composition that could be used. This feature is most useful for
30900 users who want to avoid being prompted with each option separately, or who
30901 want to avoid the checking of remote postponed or form letter folders.
30902 The possible types of composition are:
30903
30904 <P>
30905 New, for starting a new composition. Note that if New is selected and roles
30906 are set, roles are checked for matches and applied according to the setting
30907 of the matching role.
30908
30909 <P>
30910 Interrupted, for continuing an interrupted composition. This option is only
30911 offered if an interrupted message folder is detected.
30912
30913 <P>
30914 Postponed, for continuing postponed compositions. This option is offered
30915 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
30916 the postponed folder actually exists. This option is especially handy
30917 for avoiding having to check for the existence of a remote postponed folder.
30918
30919 <P>
30920 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
30921 is set in the config, and is not checked for existence for reasons similar
30922 to those explained by the postponed option.
30923
30924 <P>
30925 setRole, for selecting a role to apply to a composition.
30926
30927 <P>
30928 &lt;End of help on this topic&gt;
30929 </BODY>
30930 </HTML>
30931 ====== h_config_alt_role_menu =====
30932 <HTML>
30933 <HEAD>
30934 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
30935 </HEAD>
30936 <BODY>
30937 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
30938
30939 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
30940 a role and compose a new message using that role.
30941 When this feature is set, the role command will first ask whether you want to
30942 Compose a new message, Forward the current message, Reply to the
30943 current message, or Bounce the current message.
30944 If you are not in the MESSAGE INDEX and are not viewing a message,
30945 then there is no current message and the question will be skipped.
30946 After you have chosen to Compose, Forward, Reply, or Bounce you will
30947 then choose the role to be used.
30948 <P>
30949 When Bouncing the &quot;Set From&quot; address is used for the
30950 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
30951 provided that the option
30952 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
30953 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
30954 set.
30955 Other actions of the role are ignored when Bouncing.
30956
30957 <P>
30958 &lt;End of help on this topic&gt;
30959 </BODY>
30960 </HTML>
30961 ====== h_config_always_spell_check =====
30962 <HTML>
30963 <HEAD>
30964 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
30965 </HEAD>
30966 <BODY>
30967 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
30968 <P>
30969 When this feature is set, every composed message will be spell-checked before
30970 being sent.
30971 <P>
30972 &lt;End of help on this topic&gt;
30973 </BODY>
30974 </HTML>
30975 ====== h_config_quell_asterisks =====
30976 <HTML>
30977 <HEAD>
30978 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
30979 </HEAD>
30980 <BODY>
30981 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
30982 <P>
30983 When you are running Alpine you will sometimes be asked for a password
30984 in a prompt on the third line from the bottom of the screen.
30985 Normally each password character you type will cause an asterisk to echo
30986 on the screen. That gives you some feedback to know that your typing is
30987 being recognized.
30988 There is a very slight security risk in doing it this way because someone
30989 watching over your shoulder might be able to see how many characters there
30990 are in your password.
30991 If you'd like to suppress the echoing of the asterisks set this feature.
30992 <P>
30993 &lt;End of help on this topic&gt;
30994 </BODY>
30995 </HTML>
30996 ====== h_config_quell_flowed_text =====
30997 <HTML>
30998 <HEAD>
30999 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
31000 </HEAD>
31001 <BODY>
31002 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
31003 <P>
31004 Alpine generates flowed text where possible.
31005 The method for generating flowed text is defined by
31006 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
31007 the benefit of doing so is
31008 to send message text that can properly be viewed both on normal width displays
31009 and on displays with smaller or larger than normal screen widths.
31010 With flowed text, a space at the end of a line tells the receiving mail
31011 client that the following line belongs to the same paragraph.
31012 Quoted text will also be affected, with only the innermost
31013 level of &quot;&gt;&quot; quoting being followed by a space.
31014 However, if you have changed the
31015 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
31016 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
31017 quoted text will not be flowed.
31018 For this reason, we recommend that you leave your
31019 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
31020 <P>
31021 This feature turns off the generation of flowed text, as it might be
31022 desired to more tightly control how a message is displayed on the receiving end.
31023 <P>
31024 If this feature is <EM>not</EM> set, you can control on a message by message
31025 basis whether or not flowed text is generated.
31026 You do this by typing ^V at the Send confirmation prompt that you get
31027 after typing ^X to send a message.
31028 ^V is a toggle that turns flowing off and back on if typed again.
31029 If for some reason flowing cannot be done on a particular message, then the
31030 ^V command will not be available.
31031 This would be the case, for example, if this feature was set, or if your
31032 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
31033 If the feature
31034 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
31035 then the opportunity to control on a message by message basis
31036 whether or not flowed text is generated is lost.
31037 <P>
31038 When this feature is not set and you have typed ^V to turn off flowing,
31039 the Send confirmation prompt will change to look like
31040 <P>
31041 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
31042 <P>
31043 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
31044 also turn off the sending of flowed text messages, but it differs in that
31045 it also trims all trailing white space from a message before sending it.
31046 <P>
31047 If alternate editors are used extensively, be aware that a message will still
31048 be sent flowed if this feature is unset.  In most cases this will be fine,
31049 but if the editor has a &quot;flowed text&quot; mode, it would be best to
31050 use that.
31051 <P>
31052 &lt;End of help on this topic&gt;
31053 </BODY>
31054 </HTML>
31055 ====== h_config_strip_ws_before_send =====
31056 <HTML>
31057 <HEAD>
31058 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
31059 </HEAD>
31060 <BODY>
31061 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
31062 <P>
31063 By default, trailing whitespace is not stripped from
31064 a message before sending.  Trailing whitespace should have no effect on an
31065 email message, and in flowed text can aid in delimiting paragraphs.
31066 However, the old behavior of stripping trailing whitespace was in place
31067 to better deal with older clients that couldn't handle certain types of
31068 text encodings.  This feature restores the old behavior
31069 <P>
31070 Trailing whitespace is of aid to flowed-text-formatted messages, which are
31071 generated by default but can be turned off via the
31072 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
31073 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
31074 of flowed text.
31075 <P>
31076 &lt;End of help on this topic&gt;
31077 </BODY>
31078 </HTML>
31079 ====== h_config_alt_reply_menu =====
31080 <HTML>
31081 <HEAD>
31082 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></TITLE>
31083 </HEAD>
31084 <BODY>
31085 <H1>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></H1>
31086
31087 Note that if this option is enabled, then the option
31088 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
31089 is ignored. See below to understand why.
31090 <P>
31091 When you reply to a message, a series of questions are asked that
31092 determines how your reply will be handled by Alpine. This feature only
31093 affects the result of the first question you are asked, and its purpose is
31094 to set values that could override defaults set in Alpine's main
31095 configuration screen. As a result, this menu allows you to configure even
31096 more features than you would be able to do without this option. For
31097 example, this menu always allows you to override or select a <A
31098 HREF="h_rules_roles">Role</A> if you have defined one, or allows you to
31099 override your indent string, regardless of if you have enabled
31100 <A HREF="h_config_prefix_editing"><!--#echo var="FEAT_enable-reply-indent-string-editing"--></A>.
31101 The full list of options can be found below.
31102 <P>
31103 Here is an example of how this option works. After you press Reply,
31104 if you see &quot;A Inc Attach&quot; in the menu, it means that
31105 if you press &quot;A&quot;, then Alpine will include the attachments
31106 of the original message, and the default is not to include them.
31107 Conversely, if you see &quot;A No Attach&quot;
31108 then by pressing &quot;A&quot; Alpine will not include
31109 attachments in your reply, and the default is that Alpine will
31110 include them in your reply. The value that you see when you
31111 start your reply is controlled by the option
31112 <A HREF="h_config_attach_in_reply">
31113 <!--#echo var="FEAT_include-attachments-in-reply"-->
31114 </A>. If the feature is enabled, then Alpine will display
31115 &quot;A No Attach&quot; to override the default behavior. You can
31116 toggle between the two values of this option by pressing &quot;A&quot;.
31117 Remember that the value that you see in the menu is the action that will
31118 be done when you press the associated command.
31119 <P>
31120 Below are your options:
31121 <OL>
31122 <LI><B>A</B>: This determines if Alpine will include or not the
31123 attachments sent to you in the message that you are replying to. The default
31124 is to use the value of the configuration option
31125 <A HREF="h_config_attach_in_reply"><!--#echo var="FEAT_include-attachments-in-reply"--></A> and can be overridden by using this command.
31126
31127 <LI><B>H</B>: This command determines if the headers of a message are
31128 included in the body of the message that is being replied to. By default
31129 Alpine will use the value of the configuration option
31130 <A HREF="h_config_include_header"><!--#echo var="FEAT_include-header-in-reply"--></A>.
31131 Observe that by toggling this option to include headers, text will be toggled
31132 to be included by default.
31133
31134 <LI><B>R</B>: Can be used to set a role different from the default.
31135
31136 <LI><B>S</B>: Determines if Alpine will strip the signature from a
31137 message. The default is to strip the signature when the message is not
31138 viewed in headers mode, and you either have enabled
31139 <A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>
31140 or
31141 <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>.
31142
31143 <LI><B>Ctrl-R</B>: Can be used to edit the
31144 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>.
31145 </OL>
31146 <P>
31147 In order to include the text of the original message in the reply
31148 you either need to press 'y' to include the original text, or 'n' to
31149 exclude it from the reply. Pressing return will execute the default
31150 action, which is to include text only if the option
31151 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
31152 is enabled. However, notice that the default is to include text if you edit the
31153 reply indent string or if you explicitly set through this menu that you
31154 want headers included in the reply message.
31155
31156 <P>
31157 &lt;End of help on this topic&gt;
31158 </BODY>
31159 </HTML>
31160 ====== h_config_del_from_dot =====
31161 <HTML>
31162 <HEAD>
31163 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
31164 </HEAD>
31165 <BODY>
31166 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
31167
31168 This feature controls the behavior of the Ctrl-K command in the composer.
31169 If set, ^K will cut from the current cursor position to the end of the line,
31170 rather than cutting the entire line.
31171
31172 <P>
31173 &lt;End of help on this topic&gt;
31174 </BODY>
31175 </HTML>
31176 ====== h_config_print_index =====
31177 <HTML>
31178 <HEAD>
31179 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
31180 </HEAD>
31181 <BODY>
31182 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
31183
31184 This feature controls the behavior of the Print command when in the
31185 MESSAGE INDEX screen.  If set, the print command will give you a prompt
31186 asking if you wish to print the message index, or the currently highlighted
31187 message. If not set, the message will be printed.
31188
31189 <P>
31190 &lt;End of help on this topic&gt;
31191 </BODY>
31192 </HTML>
31193 ====== h_config_allow_talk =====
31194 <HTML>
31195 <HEAD>
31196 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
31197 </HEAD>
31198 <BODY>
31199 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
31200
31201 UNIX Alpine only.
31202 <P>
31203 By default, permission for others to &quot;talk&quot; to your terminal is turned
31204 off when you are running Alpine.  When this feature is set, permission is
31205 instead turned on.  If enabled, you may see unexpected messages in the
31206 middle of your Alpine screen from someone attempting to contact you via the
31207 &quot;talk&quot; program.
31208
31209 <P>
31210 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
31211 talk daemon on your system will attempt to print a message on your screen
31212 when someone else is trying to contact you.  If you wish to see these
31213 messages while you are running Alpine, you should enable this feature.
31214
31215 <P>
31216 If you do enable this feature and see a &quot;talk&quot; message, you must
31217 suspend or quit Alpine before you can respond.
31218
31219 <P>
31220 &lt;End of help on this topic&gt;
31221 </BODY>
31222 </HTML>
31223 ====== h_config_send_filter_dflt =====
31224 <HTML>
31225 <HEAD>
31226 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
31227 </HEAD>
31228 <BODY>
31229 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
31230 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
31231 configured, setting this feature will cause
31232 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
31233 instead of unfiltered, the usual default.
31234 <P>
31235 <UL>
31236 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31237 </UL><P>
31238 &lt;End of help on this topic&gt;
31239 </BODY>
31240 </HTML>
31241 ====== h_config_custom_print =====
31242 <HTML>
31243 <HEAD>
31244 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
31245 </HEAD>
31246 <BODY>
31247 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
31248
31249 When this feature is set, the print command will have an additional
31250 subcommand called "C CustomPrint".  If selected, you will have
31251 the opportunity to enter any system print command --instead of being
31252 restricted to using those that have been previously configured in the
31253 printer setup menu.
31254 <P>
31255
31256 &lt;End of help on this topic&gt;
31257 </BODY>
31258 </HTML>
31259 ====== h_config_enable_dot_files =====
31260 <HTML>
31261 <HEAD>
31262 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
31263 </HEAD>
31264 <BODY>
31265 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
31266
31267 When this feature is set, files beginning with dot (".") will be
31268 visible in the file browser.  For example, you'll be able to select them
31269 when using the browser to add an attachment to a message.
31270 <P>
31271 &lt;End of help on this topic&gt;
31272 </BODY>
31273 </HTML>
31274 ====== h_config_enable_dot_folders =====
31275 <HTML>
31276 <HEAD>
31277 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
31278 </HEAD>
31279 <BODY>
31280 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
31281
31282 When this feature is set, folders beginning with dot (".") may be added
31283 and viewed.
31284 <P>
31285 &lt;End of help on this topic&gt;
31286 </BODY>
31287 </HTML>
31288 ====== h_config_ff_between_msgs =====
31289 <HTML>
31290 <HEAD>
31291 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
31292 </HEAD>
31293 <BODY>
31294 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
31295
31296 Setting this feature causes a formfeed to be printed between messages when
31297 printing multiple messages (with Apply Print command).
31298 <P>
31299 &lt;End of help on this topic&gt;
31300 </BODY>
31301 </HTML>
31302 ====== h_config_blank_keymenu =====
31303 <HTML>
31304 <HEAD>
31305 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
31306 </HEAD>
31307 <BODY>
31308 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
31309
31310 If this feature is set the command key menu that normally appears on the
31311 bottom two lines of the screen will not usually be there.  Asking for
31312 help with ^G or ? will cause the key menu to appear instead of causing
31313 the help message to come up.  If you want to actually see the help text,
31314 another ^G or ? will show it to you.  After the key menu has popped
31315 up with the help key it will remain there for an O for Other command but
31316 disappear if any other command is typed.
31317 <P>
31318 &lt;End of help on this topic&gt;
31319 </BODY>
31320 </HTML>
31321 ====== h_config_enable_mouse =====
31322 <HTML>
31323 <HEAD>
31324 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
31325 </HEAD>
31326 <BODY>
31327 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
31328
31329 This feature controls whether or not an X terminal mouse can be used with
31330 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
31331 being used, the left mouse button on the mouse can be used to select text
31332 or commands.
31333 Clicking on a command at the bottom of the screen will behave as if you had
31334 typed that command.
31335 Clicking on an index line will move the current message highlight to
31336 that line.
31337 Double-clicking on an index line will view the message.
31338 Double-clicking on a link will view the link.
31339 <P>
31340 This type of mouse support will also work in some terminal emulators which are
31341 not actually X terminals, but which have extra code to support the xterm
31342 style mouse.
31343 For those emulators you not only need to turn this feature on but you also
31344 have to set the $DISPLAY environment variable even though it isn't needed
31345 for your terminal.
31346 That will cause Alpine to think that it is an xterm and to properly interpret the
31347 escape sequences sent by the mouse.
31348 <P>
31349 Note: if this feature is set, the behavior of X terminal cut-and-paste is
31350 also modified.  It is sometimes possible to hold the shift key down while clicking
31351 left or middle mouse buttons for the normal xterm cut/paste operations.
31352 There is also an Alpine command to toggle this mode on or off.
31353 The command is Ctrl-&#92; (Control-backslash).
31354 <P>
31355 &lt;End of help on this topic&gt;
31356 </BODY>
31357 </HTML>
31358 ====== h_config_enable_xterm_newmail =====
31359 <HTML>
31360 <HEAD>
31361 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
31362 </HEAD>
31363 <BODY>
31364 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
31365
31366 This feature controls whether or not Alpine will attempt to announce new
31367 mail arrival when it is running in an X terminal window and that window
31368 is iconified.  If set, and the $DISPLAY variable indicates that an X
31369 terminal is being used, Alpine will send appropriate escape sequences to
31370 the X terminal to modify the label on Alpine's icon to indicate that new
31371 mail has arrived. Alpine will also modify the Alpine window's title to
31372 indicate new mail.
31373 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
31374 <P>
31375 &lt;End of help on this topic&gt;
31376 </BODY></HTML>
31377 ====== h_config_enable_newmail_short_text =====
31378 <HTML>
31379 <HEAD>
31380 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
31381 </HEAD>
31382 <BODY>
31383 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
31384
31385 This feature controls the text to be displayed in an icon in the event
31386 of a new message arrival.  Normally, the message will
31387 be the one that is displayed on the screen.  This feature shortens the
31388 message to a count of the number of new messages in brackets.  This may be
31389 more useful for those who use the window's title bar in the task bar as a
31390 new mail indicator.  This feature is only useful if the
31391 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
31392 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
31393 feature, this feature is only relevant when run in an xterm environment.
31394 <P>
31395 &lt;End of help on this topic&gt;
31396 </BODY></HTML>
31397 ====== h_config_copy_to_to_from =====
31398 <HTML>
31399 <HEAD>
31400 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
31401 </HEAD>
31402 <BODY>
31403 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
31404
31405 This feature affects the From address used when Replying to a message.
31406 It is probably only useful if you have some
31407 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
31408 defined.
31409 When enabled, it checks to see if any of the addresses in the To or Cc
31410 fields of the message you are replying to is one of your addresses.
31411 If it is, and there is only one of them, then that address is used as
31412 the From address in the message you are composing.
31413 In other words, you will be using a From address that is the same
31414 as the To address that was used to get the mail to you in the first place.
31415
31416 <P>
31417 If a role is being used and it has a From address defined, that From address will
31418 be used rather than the one derived from this feature.
31419
31420 <P>
31421 <UL>
31422 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31423 </UL><P>
31424 &lt;End of help on this topic&gt;
31425 </BODY>
31426 </HTML>
31427 ====== h_config_prefix_editing =====
31428 <HTML>
31429 <HEAD>
31430 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
31431 </HEAD>
31432 <BODY>
31433 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
31434
31435 This feature affects the Reply command's &quot;Include original message
31436 in Reply?&quot; prompt.  When enabled, it causes the
31437 &quot;Edit Indent String&quot; sub-command to appear which allows
31438 you to edit the string Alpine would otherwise use to denote included
31439 text from the message being replied to.<P>
31440
31441 Thus, you can change Alpine's default message quote character (usually
31442 an angle bracket) on a per message basis. So you could change your quoted message to
31443 look, for example, like this:<p>
31444
31445 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
31446
31447 John: I just wanted to say hello and to congratulate you
31448 John: on a job well done!</pre><p>
31449
31450 The configuration option
31451 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
31452 may be used to change what appears as the default string to be edited.
31453 <P>
31454 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
31455 currently being replied to.
31456 <P>
31457 If you change your <!--#echo var="VAR_reply-indent-string"-->
31458 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
31459 quoted text will not be flowed
31460 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
31461 when you reply.
31462 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
31463 set to the default value.
31464 <P>
31465 <UL>
31466 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31467 </UL><P>
31468 &lt;End of help on this topic&gt;
31469 </BODY>
31470 </HTML>
31471 ====== h_config_enable_search_and_repl =====
31472 <HTML>
31473 <HEAD>
31474 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
31475 </HEAD>
31476 <BODY>
31477 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
31478
31479 This feature modifies the behavior of Alpine's composer.  Setting this
31480 feature causes Alpine to offer the "^R Replace" subcommand, which
31481 allows you to search and replace text strings in a message you are composing,
31482 inside the "^W Where is" command.
31483
31484 <P>
31485
31486 To search and replace text, first enter the text to be replaced at the
31487 "Search: " prompt.  Then, rather than pressing Enter to just search for that
31488 text, press ^R, which turns the prompt into
31489
31490 <P>
31491
31492 Search (to replace):
31493
31494 <P>
31495
31496 and then press Enter.  The cursor will highlight the first occurrence
31497 of the text string you entered, and the prompt will show:
31498
31499 <P>
31500
31501 Replace "<your text string>" with :
31502
31503 <P>
31504
31505 where <your text string> is what you entered at the previous prompt;
31506 here, enter the replacement text.  To only replace the highlighted
31507 occurrence, simply press Enter now; to replace all occurrences in the
31508 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
31509 each replacement.
31510
31511 <P>
31512
31513 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
31514 ^X toggles between "Replace All" and "Replace One."
31515
31516 <P>
31517
31518 If you previously searched for text in a message, it will be offered for
31519 re-use as part of the prompt, shown in [ ] brackets.
31520
31521 <P>
31522 &lt;End of help on this topic&gt;
31523 </BODY>
31524 </HTML>
31525 ====== h_config_enable_view_attach =====
31526 <HTML>
31527 <HEAD>
31528 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
31529 </HEAD>
31530 <BODY>
31531 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
31532
31533 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31534 Setting this feature causes Alpine to present attachments in boldface.
31535 The first available attachment is displayed in inverse.  This is the
31536 "selected" attachment.  Pressing RETURN will cause Alpine to display
31537 the selected attachment.  Use the arrow keys to change which of the
31538 attachments displayed in boldface is the current selection.
31539
31540 <P>
31541
31542 Speaking of arrow keys, the Up and Down Arrows will select the next
31543 and previous attachments if one is available on the screen for selection.
31544 Otherwise, they will simply adjust the viewed text one line up or down.
31545
31546 <P>
31547
31548 Similarly, when selectable items are present in a message, the Ctrl-F key
31549 can be used to select the next item in the message independent of which
31550 portion of the viewed message is currently displayed. The Ctrl-B key can
31551 be used to select the previous item in the same way.
31552 <P>
31553 &lt;End of help on this topic&gt;
31554 </BODY>
31555 </HTML>
31556 ====== h_config_enable_y_print =====
31557 <HTML>
31558 <HEAD>
31559 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
31560 </HEAD>
31561 <BODY>
31562 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
31563
31564 This feature modifies the behavior of Alpine's Print command.
31565 <P>
31566 By default, Alpine's print command is available by pressing the "%" key.
31567 (This command is a substantial change from Pine versions before 4.00 --
31568 where the print command was "Y" -- based on numerous complaints about
31569 printing being invoked inadvertently, since Y also means "Yes.")
31570
31571 <P>
31572
31573 This feature is supplied to mitigate any disruption or anxiety users
31574 might feel as a result of this change.
31575
31576 <P>
31577
31578 Enabling this feature will cause Alpine to recognize both the old
31579 command, "Y" for Prynt, as well the new "%" method for invoking
31580 printing.  Note, key menu labels are not changed as a result of
31581 enabling this feature.
31582
31583 <P>
31584
31585 &lt;End of help on this topic&gt;
31586 </BODY>
31587 </HTML>
31588 ====== h_config_enable_lessthan_exit =====
31589 <HTML>
31590 <HEAD>
31591 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
31592 </HEAD>
31593 <BODY>
31594 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
31595
31596 If this feature is set, then on screens where there is an Exit command
31597 but no < command, the < key will perform the same function as the Exit
31598 command.
31599 This feature is set by default.
31600 <P>
31601 &lt;End of help on this topic&gt;
31602 </BODY>
31603 </HTML>
31604 ====== h_config_enable_view_url =====
31605 <HTML>
31606 <HEAD>
31607 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
31608 </HEAD>
31609 <BODY>
31610 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
31611 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31612 When this feature is set (the default) Alpine will select possible URLs from the
31613 displayed text and display them in boldface for selection.
31614 <P>
31615 The first available URL is displayed in inverse.  This is the
31616 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
31617 the selected URL via either built-in means as with mailto:, imap:,
31618 news:, and nntp:, or via an external application as defined
31619 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
31620 variable.
31621 <P>
31622 Use the arrow keys to change which of the URLs displayed in boldface
31623 is the current selection.
31624 <P>
31625 Speaking of arrow keys, the Up and Down Arrows will select the next
31626 and previous URL if one is available on the screen for selection (unless
31627 you have set the feature
31628 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
31629 Otherwise, they will simply adjust the viewed text one line up or down.
31630 <P>
31631 Similarly, when selectable items are present in a message, the Ctrl-F
31632 key can be used to select the next item in the message independent
31633 of which portion of the viewed message is currently displayed. The
31634 Ctrl-B key can be used to select the previous item in the same way.
31635 <P>
31636 <UL>
31637 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31638 </UL><P>
31639 &lt;End of help on this topic&gt;
31640 </BODY>
31641 </HTML>
31642 ====== h_config_enable_view_web_host =====
31643 <HTML>
31644 <HEAD>
31645 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
31646 </HEAD>
31647 <BODY>
31648 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
31649
31650 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31651 When this feature is set (the default) Alpine will select possible web hostnames
31652 from the displayed text and display them in boldface for selection.
31653 This can be useful when you receive messages referencing World Wide Web
31654 sites without the use of complete URLs; for example, specifying only
31655 &quot;www.some.site.com&quot; (which will <B>not</B> become a
31656 selectable
31657 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
31658 rather than explicitly
31659 &quot;http://www.some.site.com&quot;.
31660 <P>
31661 The first available hostname is displayed in inverse.  This is the
31662 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
31663 the selected hostname via an external application as defined
31664 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
31665 variable.
31666 <P>
31667 Use the arrow keys (unless you have set the feature
31668 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
31669 to change which of the hostnames displayed in
31670 boldface is the current selection.
31671 <P>
31672 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
31673 key can be used to select the next web hostname in the message independent
31674 of which portion of the viewed message is currently displayed. The
31675 Ctrl-B key can be used to select the previous web hostnames in the same way.
31676 <P>
31677 <UL>
31678 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31679 </UL><P>
31680 &lt;End of help on this topic&gt;
31681 </BODY>
31682 </HTML>
31683 ====== h_config_enable_view_addresses =====
31684 <HTML>
31685 <HEAD>
31686 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
31687 </HEAD>
31688 <BODY>
31689 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
31690
31691 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31692 Setting this feature causes Alpine to select possible email addresses
31693 from the displayed text and display them in boldface for selection.
31694
31695 <P>
31696 The first available email address is displayed in inverse.  This is the
31697 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
31698 the message composition screen with the To: field filled in with the
31699 selected address.
31700 <P>
31701 Use the arrow keys (unless you have set the feature
31702 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
31703 to change which of the hostnames displayed in
31704 boldface is the current selection.
31705 <P>
31706 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
31707 key can be used to select the next web hostname in the message independent
31708 of which portion of the viewed message is currently displayed. The
31709 Ctrl-B key can be used to select the previous web hostnames in the same way.
31710 <P>
31711 <UL>
31712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31713 </UL><P>
31714 &lt;End of help on this topic&gt;
31715 </BODY>
31716 </HTML>
31717 ====== h_external_loads_inline_images_only =====
31718 <HTML>
31719 <HEAD>
31720 <TITLE>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></TITLE>
31721 </HEAD>
31722 <BODY>
31723 <H1>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></H1>
31724
31725 Alpine allows you to pass a HTML message to the browser that you have configured in your
31726 <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A> variable. This allows
31727 you to read a message outside of Alpine. This is desirable when Alpine does not display
31728 html correctly, or when you wish to read the message and see the inline images in the message.
31729
31730 <P>
31731 An inline image is one that comes with the message and is necessary for the correct display of
31732 the message. However, there are instances in which the source of an image will come from
31733 external servers. If this feature is enabled (the default) then Alpine will only pass inline
31734 images to the browser and will remove the link to external images, so only inline images will
31735 be used to display the message, and no external image will be loaded. Alpine does this to protect
31736 your privacy and security.
31737
31738 <P>
31739 Please note that messages are usually formatted by the sender so that they display correctly once
31740 all images have been loaded. Enabling this feature might cause the message not to be correctly
31741 displayed by your browser.
31742
31743 <P>
31744 Also consider security and privacy implications of opening an HTML message in a browser. You are
31745 always protected when you do not use this feature, but you might not have the same level of
31746 protection if you try to open a spam or scam using the html view. Also commercial email is
31747 normally embedded with links to external images that let them, their partners, and your internet
31748 service provider (which could be your employer or school)  know that you opened their message or
31749 connected to a web site, violating your privacy.
31750
31751 <P>
31752 If you are worried about your privacy and security, do not use an external viewer to open
31753 html files, and keep using the internal mechanisms that Alpine provides to read messages.
31754
31755 <P>
31756 &lt;End of help on this topic&gt;
31757 </BODY>
31758 <HTML>
31759 ====== h_config_enable_view_arrows =====
31760 <HTML>
31761 <HEAD>
31762 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
31763 </HEAD>
31764 <BODY>
31765 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
31766
31767 This feature modifies Up and Down arrow key behavior in Alpine's
31768 MESSAGE TEXT screen when selectable Attachments, URL's, or
31769 web-hostnames are presented. Alpine's usual behavior is to move to
31770 the next or previous selectable item if currently displayed or
31771 simply to adjust the screen view by one line.
31772
31773 <P>
31774
31775 Setting this feature causes the UP and Down arrow key to behave as
31776 if no selectable items were present in the message.
31777
31778 <P>
31779
31780 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
31781 item) functionality is unchanged.
31782 <P>
31783
31784 &lt;End of help on this topic&gt;
31785 </BODY>
31786 <HTML>
31787 ====== h_config_quell_charset_warning =====
31788 <HTML>
31789 <HEAD>
31790 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
31791 </HEAD>
31792 <BODY>
31793 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
31794
31795 By default, if the message you are viewing contains characters that are
31796 not representable in your
31797 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
31798 then Alpine will
31799 add a warning to the start of the displayed text.
31800 If this option is set, then that editorial message will be suppressed.
31801 <P>
31802 Setting this feature also suppresses the comment about the character set
31803 in header lines.
31804 For example, when viewing a message you might see
31805 <P>
31806 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
31807 <P>
31808 in the From header if your Character-Set is something other than ISO-8859-2.
31809 If you set this feature, the comment about the character set will
31810 no longer be there.
31811 <P>
31812 &lt;End of help on this topic&gt;
31813 </BODY>
31814 </HTML>
31815 ====== h_config_quell_host_after_url =====
31816 <HTML>
31817 <HEAD>
31818 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
31819 </HEAD>
31820 <BODY>
31821 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
31822
31823 By default, links in HTML text are displayed with the host the link
31824 references appended, within square brackets, to the link text.  Alpine
31825 does this to help indicate where a link will take you, particularly when
31826 the link text might suggest a different destination.
31827
31828 <P>
31829 Setting this feature will prevent the server name from being appended
31830 to the displayed text.
31831
31832 <P>
31833 &lt;End of help on this topic&gt;
31834 </BODY>
31835 </HTML>
31836 ====== h_config_prefer_plain_text =====
31837 <HTML>
31838 <HEAD>
31839 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
31840 </HEAD>
31841 <BODY>
31842 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
31843
31844 A message being viewed may contain alternate versions of the same content.
31845 Those alternate versions are supposed to be ordered by the sending software such that the
31846 first alternative is the least preferred and the last alternative is the
31847 most preferred. Alpine will normally display the most-preferred version that
31848 it knows how to display. This is most often encountered where the two
31849 alternate versions are a plain text version and an HTML version, with the
31850 HTML version listed last as the most preferred.
31851 <P>
31852 If this option is set, then any plain text version will be preferred to
31853 all other versions.
31854 <P>
31855 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
31856 which will temporarily change the sense of this option.
31857 If this option is set you will first see the plain text version of a
31858 message.
31859 If you then type the &quot;A&quot; command, you will see the most preferred version,
31860 most likely HTML, instead.
31861 Typing the &quot;A&quot; command a second time will switch it back.
31862 Alternatively, if the present option is not set you will originally see
31863 the most preferred version of the message and typing &quot;A&quot; will switch to
31864 the plain text version.
31865 <P>
31866 &lt;End of help on this topic&gt;
31867 </BODY>
31868 </HTML>
31869 ====== h_config_pass_control =====
31870 <HTML>
31871 <HEAD>
31872 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
31873 </HEAD>
31874 <BODY>
31875 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
31876
31877 It is probably not useful to set this option.
31878 This is a legacy option left behind &quot;just in case&quot;.
31879 Multi-byte characters that have an octet that has the same
31880 value as a control character are permitted through whether or not
31881 this option is turned on.
31882 <P>
31883 This feature controls how certain characters contained in messages are
31884 displayed.
31885 If set, all characters in a message will be sent to the
31886 screen. Normally, control characters are displayed as shown below to
31887 avoid a garbled screen and to
31888 avoid inadvertently changing terminal setup parameters.
31889 Control characters are usually displayed as two character sequences like
31890 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
31891 for Control-C,
31892 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
31893 for ESCAPE,
31894 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
31895 for DELETE, and
31896 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
31897 for the character with value 133 (0x85).
31898 (The DEL character is displayed as ^?, regular control characters are displayed
31899 as the character ^ followed by the character obtained by adding the
31900 five low-order bits of the character to 0x40, and the C1
31901 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
31902 character obtained by adding the
31903 five low-order bits of the character to 0x40.)
31904 Sometimes, in cases where changing a single control character into a
31905 two-character sequence would confuse Alpine's display routines,
31906 a question mark is substituted for the control character.
31907 <P>
31908 If you wish to filter out regular control characters but pass the
31909 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31910 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.
31911 <P>
31912 &lt;End of help on this topic&gt;
31913 </BODY>
31914 </HTML>
31915 ====== h_config_pass_c1_control =====
31916 <HTML>
31917 <HEAD>
31918 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
31919 </HEAD>
31920 <BODY>
31921 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
31922
31923 It is probably not useful to set this option.
31924 This is a legacy option left behind &quot;just in case&quot;.
31925 Multi-byte characters that have an octet that has the same
31926 value as a control character are permitted through whether or not
31927 this option is turned on.
31928 <P>
31929 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31930 is set, then this feature has no effect.
31931 However, if you wish to filter out regular control characters but pass the
31932 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31933 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31934 unset and set this feature.
31935 <P>
31936 &lt;End of help on this topic&gt;
31937 </BODY>
31938 </HTML>
31939 ====== h_config_fcc_on_bounce =====
31940 <HTML>
31941 <HEAD>
31942 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
31943 </HEAD>
31944 <BODY>
31945 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
31946
31947 This feature controls an aspect of Alpine's behavior when bouncing a
31948 message. If set, normal FCC ("File Carbon Copy") processing will be
31949 done, just as if you had composed a message to the address you are
31950 bouncing to.  If not set, no FCC of the message will be saved.
31951 <P>
31952 &lt;End of help on this topic&gt;
31953 </BODY>
31954 </HTML>
31955 ====== h_config_show_cursor =====
31956 <HTML>
31957 <HEAD>
31958 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
31959 </HEAD>
31960 <BODY>
31961 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
31962
31963 This feature controls an aspect of Alpine's displays.  If set, the system
31964 cursor will move to convenient locations in the displays.  For example,
31965 to the beginning of the status field of the highlighted index line, or
31966 to the highlighted word after a successful WhereIs command.  It is intended
31967 to draw your attention to an "interesting" spot on the screen.
31968 <P>
31969 &lt;End of help on this topic&gt;
31970 </BODY>
31971 </HTML>
31972 ====== h_config_sort_fcc_alpha =====
31973 <HTML>
31974 <HEAD>
31975 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
31976 </HEAD>
31977 <BODY>
31978 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
31979
31980 This feature controls an aspect of Alpine's FOLDER LIST screen.
31981 If set, the default Fcc folder will be sorted alphabetically with the other
31982 folders instead of appearing right after the INBOX.
31983 <P>
31984 &lt;End of help on this topic&gt;
31985 </BODY>
31986 </HTML>
31987 ====== h_config_sort_save_alpha =====
31988 <HTML>
31989 <HEAD>
31990 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
31991 </HEAD>
31992 <BODY>
31993 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
31994
31995 This feature controls an aspect of Alpine's FOLDER LIST screen.
31996 If set, the default save folder will be sorted alphabetically with the other
31997 folders instead of appearing right after the INBOX (and default FCC folder).
31998 <P>
31999 &lt;End of help on this topic&gt;
32000 </BODY>
32001 </HTML>
32002 ====== h_config_single_list =====
32003 <HTML>
32004 <HEAD>
32005 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
32006 </HEAD>
32007 <BODY>
32008 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
32009
32010 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
32011 the folders will be listed one per line instead of several per line
32012 in the FOLDER LIST display.
32013 <P>
32014 &lt;End of help on this topic&gt;
32015 </BODY>
32016 </HTML>
32017 ====== h_config_vertical_list =====
32018 <HTML>
32019 <HEAD>
32020 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
32021 </HEAD>
32022 <BODY>
32023 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
32024
32025 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
32026 the folders will be listed alphabetically down the columns rather
32027 than across the columns as is the default.
32028 <P>
32029 &lt;End of help on this topic&gt;
32030 </BODY>
32031 </HTML>
32032 ====== h_config_verbose_post =====
32033 <HTML>
32034 <HEAD>
32035 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
32036 </HEAD>
32037 <BODY>
32038 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
32039 This feature controls an aspect of Alpine's message sending.  When enabled,
32040 Alpine will send a VERB (i.e., VERBose) command early in the posting process
32041 intended to cause the SMTP server to provide a more detailed account of
32042 the transaction.  This feature is typically only useful to system
32043 administrators and other support personnel as an aid in troubleshooting
32044 problems.
32045 <P>
32046 Note, this feature relies on a specific capability of the system's mail
32047 transport agent or configured
32048 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
32049 It is possible that this
32050 feature will cause problems for some transport agents, and may result in
32051 sending failure.  In addition, as the verbose output comes from the mail
32052 transport agent, it is likely to vary from one system to another.
32053 <P><UL>
32054 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32055 </UL><P>
32056 &lt;End of help on this topic&gt;
32057 </BODY>
32058 </HTML>
32059 ====== h_config_auto_reply_to =====
32060 <HTML>
32061 <HEAD>
32062 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
32063 </HEAD>
32064 <BODY>
32065 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
32066
32067 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
32068 will not prompt when a message being replied to contains a "Reply-To:"
32069 header value, but will simply use its value (as opposed to using the
32070 "From:" field's value).
32071
32072 <P>
32073
32074 Note: Using the "Reply-To:" address is usually the preferred behavior,
32075 however, some mailing list managers choose to place the list's address in
32076 the "Reply-To:" field of any message sent out to the list.  In such
32077 cases, this feature makes it all too easy for personal replies to be
32078 inadvertently sent to the entire mail list, so be careful!
32079 <P>
32080 &lt;End of help on this topic&gt;
32081 </BODY>
32082 </HTML>
32083 ====== h_config_del_skips_del =====
32084 <HTML>
32085 <HEAD>
32086 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
32087 </HEAD>
32088 <BODY>
32089 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
32090
32091 This feature controls an aspect of Alpine's Delete command.  If set, this
32092 feature will cause the Delete command to advance past following messages that
32093 are marked deleted.  In other words, pressing "D" will both mark the
32094 current message deleted and advance to the next message that is not marked
32095 deleted.
32096 This feature is set by default.
32097 <P>
32098 &lt;End of help on this topic&gt;
32099 </BODY></HTML>
32100 ====== h_config_expunge_manually =====
32101 <HTML>
32102 <HEAD>
32103 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
32104 </HEAD>
32105 <BODY>
32106 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
32107
32108 Normally, when you close a folder that contains deleted messages you are
32109 asked if you want to expunge those messages from the folder permanently.
32110 If this feature is set, you won't be asked and the deleted messages will
32111 remain in the folder.
32112 If you choose to set this feature you will have to expunge the
32113 messages manually using the eXpunge command, which you can use while
32114 in the MESSAGE INDEX screen.
32115 If you do not expunge deleted messages the size of your
32116 folder will continue to increase until you are out of disk space.
32117 <P>
32118 <UL>
32119 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32120 </UL><P>
32121 &lt;End of help on this topic&gt;
32122 </BODY>
32123 </HTML>
32124 ====== h_config_auto_expunge =====
32125 <HTML>
32126 <HEAD>
32127 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
32128 </HEAD>
32129 <BODY>
32130 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
32131
32132 This features controls an aspect of Alpine's eXpunge command.  If set, you
32133 will <B>not</B> be prompted to confirm your intent before the expunge takes
32134 place.
32135 Actually, this is only true for the INBOX folder and for folders in the
32136 Incoming Folders collection. See the feature
32137 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
32138 <P>
32139 <UL>
32140 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32141 </UL><P>
32142 &lt;End of help on this topic&gt;
32143 </BODY>
32144 </HTML>
32145 ====== h_config_full_auto_expunge =====
32146 <HTML>
32147 <HEAD>
32148 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
32149 </HEAD>
32150 <BODY>
32151 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
32152
32153 This features controls an aspect of Alpine's eXpunge command.  If set, you
32154 will <B>not</B> be prompted to confirm your intent before the expunge
32155 takes place.  This feature sets this behavior for all folders, unlike the
32156 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
32157 feature that works only for incoming folders.
32158 <P>
32159 <UL>
32160 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32161 </UL><P>
32162 &lt;End of help on this topic&gt;
32163 </BODY>
32164 </HTML>
32165 ====== h_config_auto_read_msgs =====
32166 <HTML>
32167 <HEAD>
32168 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
32169 </HEAD>
32170 <BODY>
32171 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
32172 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
32173 and the
32174 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
32175 option is also set, then Alpine will
32176 automatically transfer all read messages to the designated folder and mark
32177 them as deleted in the INBOX.  Messages in the INBOX marked with an
32178 &quot;N&quot; (meaning New, or unseen) are not affected.
32179 <P>
32180 <UL>
32181 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32182 </UL><P>
32183 &lt;End of help on this topic&gt;
32184 </BODY>
32185 </HTML>
32186 ====== h_config_auto_fcc_only =====
32187 <HTML>
32188 <HEAD>
32189 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
32190 </HEAD>
32191 <BODY>
32192 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
32193 This features controls an aspect of Alpine's composer.
32194 The only time this feature will be used is if you attempt to send mail
32195 that has no recipients but does have an Fcc.
32196 Normally, Alpine will ask if you really mean to copy the message only to
32197 the Fcc.
32198 That is, it asks if you really meant to have no recipients.
32199 If this feature is set, you
32200 will <B>not</B> be prompted to confirm your intent to make only a copy
32201 of a message with no recipients.
32202 <P>
32203 This feature is closely related to
32204 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
32205 The difference between this feature and that feature is that this feature
32206 considers a Bcc to be a recipient while that feature will ask for confirmation
32207 even if there is a Bcc when there is no To, Cc, or Newsgroup.
32208 The default values also differ. This feature defaults to asking the question
32209 and you have to turn it off.
32210 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
32211 unless you turn it on.
32212 <P>
32213
32214 <UL>
32215 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32216 </UL><P>
32217 &lt;End of help on this topic&gt;
32218 </BODY>
32219 </HTML>
32220 ====== h_config_mark_fcc_seen =====
32221 <HTML>
32222 <HEAD>
32223 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
32224 </HEAD>
32225 <BODY>
32226 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
32227
32228 This features controls the way Fccs (File carbon copies) are
32229 made of the messages you send.
32230
32231 <P>
32232 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
32233 copy will be marked as Unseen.
32234 When you look at the folder it was saved in the message will appear to
32235 be a New message until you read it.
32236 When this feature is enabled, the message will be marked as having
32237 been Seen.
32238
32239 <P>
32240 <UL>
32241 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32242 </UL><P>
32243 &lt;End of help on this topic&gt;
32244 </BODY>
32245 </HTML>
32246 ====== h_config_no_fcc_attach =====
32247 <HTML>
32248 <HEAD>
32249 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
32250 </HEAD>
32251 <BODY>
32252 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
32253
32254 This features controls the way Fcc's (File carbon copies) are
32255 made of the messages you send.
32256
32257 <P>
32258 Normally, Alpine saves an exact copy of your message as it was sent.
32259 When this feature is enabled, the &quot;body&quot; of the message
32260 you send (the text you type in the composer) is preserved in the
32261 copy as before, however all attachments are replaced with text
32262 explaining what had been sent rather than the attachments themselves.
32263
32264 <P>
32265 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
32266 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
32267 allows you to interactively set whether or not attachments are saved
32268 to the Fcc'd copy.
32269
32270 <P>
32271 <UL>
32272 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32273 </UL><P>
32274 &lt;End of help on this topic&gt;
32275 </BODY>
32276 </HTML>
32277 ====== h_config_read_in_newsrc_order =====
32278 <HTML>
32279 <HEAD>
32280 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
32281 </HEAD>
32282 <BODY>
32283 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
32284
32285 This feature controls the order in which newsgroups will be presented.  If
32286 set, they will be presented in the same order as they occur in your
32287 <!--chtml if pinemode="os_windows"-->
32288 &quot;NEWSRC&quot;
32289 <!--chtml else-->
32290 &quot;.newsrc&quot;
32291 <!--chtml endif-->
32292 file (the default location of which can be changed with the
32293 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
32294 <P>
32295 If not set, the newsgroups will be presented in alphabetical order.
32296 <P>
32297 <UL>
32298 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32299 </UL><P>
32300 &lt;End of help on this topic&gt;
32301 </BODY>
32302 </HTML>
32303 ====== h_config_quell_tz_comment =====
32304 <HTML>
32305 <HEAD>
32306 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
32307 </HEAD>
32308 <BODY>
32309 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
32310
32311 Normally, when Alpine generates a Date header for outgoing mail,
32312 it will try to include the symbolic timezone at the end of the
32313 header inside parentheses.
32314 The symbolic timezone is often three characters long, but on
32315 some operating systems, it may be longer.
32316 Apparently there are some SMTP servers in the world that will reject an
32317 incoming message if it has a Date header longer than about 80 characters.
32318 If this feature is set, the symbolic timezone normally generated by
32319 Alpine will not be included.
32320 You probably don't need to worry about this feature unless you run into
32321 the problem described above.
32322
32323 <P>
32324 &lt;End of help on this topic&gt;
32325 </BODY>
32326 </HTML>
32327 ====== h_config_post_wo_validation =====
32328 <HTML>
32329 <HEAD>
32330 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
32331 </HEAD>
32332 <BODY>
32333 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
32334
32335 This feature controls whether the NNTP server is queried as newsgroups
32336 are entered for posting.  Validation over slow links (e.g. dialup using
32337 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
32338 <P>
32339 &lt;End of help on this topic&gt;
32340 </BODY>
32341 </HTML>
32342 ====== h_config_send_wo_confirm =====
32343 <HTML>
32344 <HEAD>
32345 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
32346 </HEAD>
32347 <BODY>
32348 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
32349
32350 By default, when you send or post a message you will be asked to confirm
32351 with a question that looks something like:
32352
32353 <P>
32354 <CENTER><SAMP>Send message?</SAMP></CENTER>
32355 <P>
32356
32357 If this feature is set, you
32358 will <B>not</B> be prompted to confirm your intent to send
32359 and your message will be sent.
32360 <P>
32361 If this feature is set it disables some possibilities and renders some
32362 other features meaningless.
32363 You will not be able to use
32364 <A HREF="h_config_sending_filter">Sending Filters</A>,
32365 Verbose sending mode,
32366 <A HREF="h_config_compose_bg_post">Background Sending</A>,
32367 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
32368 or ^V to turn off the generation of flowed text for this message.
32369 These options are normally available as suboptions in the Send prompt, but
32370 with no Send prompt the options are gone.
32371
32372 <P>
32373 A somewhat related feature is
32374 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
32375 which may be used to eliminate the extra confirmation
32376 question when posting to a newsgroup.
32377 <P>
32378 <UL>
32379 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32380 </UL><P>
32381 &lt;End of help on this topic&gt;
32382 </BODY>
32383 </HTML>
32384 ====== h_config_quell_filtering_done_message =====
32385 <HTML>
32386 <HEAD>
32387 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
32388 </HEAD>
32389 <BODY>
32390 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
32391
32392 If you use Filter Rules that move messages or set status of messages
32393 you sometimes see a message from Alpine that looks like
32394
32395 <P>
32396 <CENTER><SAMP>filtering done</SAMP></CENTER>
32397 <P>
32398
32399 If this feature is set, this message will be suppressed.
32400 If the feature
32401 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
32402 is set then this message will be suppressed regardless.
32403
32404 <P>
32405 <UL>
32406 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32407 </UL><P>
32408 &lt;End of help on this topic&gt;
32409 </BODY>
32410 </HTML>
32411 ====== h_config_quell_filtering_messages =====
32412 <HTML>
32413 <HEAD>
32414 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
32415 </HEAD>
32416 <BODY>
32417 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
32418
32419 If you use Filter Rules that move messages or set status of messages
32420 you sometimes see messages from Alpine that look like
32421
32422 <P>
32423 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
32424 <P>
32425
32426 or
32427
32428 <P>
32429 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
32430 <P>
32431
32432 or
32433
32434 <P>
32435 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
32436 <P>
32437
32438 If this feature is set, these messages will be suppressed.
32439 The feature
32440 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
32441 is related.
32442
32443 <P>
32444 <UL>
32445 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32446 </UL><P>
32447 &lt;End of help on this topic&gt;
32448 </BODY>
32449 </HTML>
32450 ====== h_config_quell_post_prompt =====
32451 <HTML>
32452 <HEAD>
32453 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
32454 </HEAD>
32455 <BODY>
32456 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
32457
32458 By default, when you post a message to a newsgroup you are asked to confirm
32459 that you want to post with the question
32460
32461 <P>
32462 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
32463 <P>
32464
32465 If this feature is set, you
32466 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
32467 and your message will be posted.
32468
32469 <P>
32470 <UL>
32471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32472 </UL><P>
32473 &lt;End of help on this topic&gt;
32474 </BODY>
32475 </HTML>
32476 ====== h_config_check_mail_onquit =====
32477 <HTML>
32478 <HEAD>
32479 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
32480 </HEAD>
32481 <BODY>
32482 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
32483
32484 If this feature is set, Alpine will check for new mail after you give the
32485 Quit command.
32486 If new mail has arrived since the previous check, you will be notified
32487 and given the choice of quitting or not quitting.
32488 <P>
32489 <UL>
32490 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32491 </UL><P>
32492 &lt;End of help on this topic&gt;
32493 </BODY>
32494 </HTML>
32495 ====== h_config_inbox_no_confirm =====
32496 <HTML>
32497 <HEAD>
32498 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
32499 </HEAD>
32500 <BODY>
32501 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
32502
32503 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
32504 command and there are no more folders or newsgroups to visit, you are asked
32505 if you want to return to the INBOX.
32506 If this feature is set you will not be asked.
32507 It will be assumed that you do want to return to the INBOX.
32508 <P>
32509 <UL>
32510 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32511 </UL><P>
32512 &lt;End of help on this topic&gt;
32513 </BODY>
32514 </HTML>
32515 ====== h_config_dates_to_local =====
32516 <HTML>
32517 <HEAD>
32518 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
32519 </HEAD>
32520 <BODY>
32521 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
32522
32523 Normally, the message dates that you see in the
32524 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
32525 For example, if a message was sent to you from a few timezones to the east
32526 it might appear that it was sent from the future;
32527 or if it was sent from somewhere to the west it might appear
32528 as if it is from yesterday even though it was sent only a few minutes ago.
32529 If this feature is set an attempt will be made to convert the dates
32530 to your local timezone to be displayed.
32531 <P>
32532 Note that this does not affect the results of Select by Date or of
32533 anything else other than these displayed dates.
32534 When viewing the message you may look at the original unconverted value of the Date
32535 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
32536 <P>
32537 <UL>
32538 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32539 </UL><P>
32540 &lt;End of help on this topic&gt;
32541 </BODY>
32542 </HTML>
32543 ====== h_config_tab_no_prompt =====
32544 <HTML>
32545 <HEAD>
32546 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
32547 </HEAD>
32548 <BODY>
32549 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
32550
32551 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
32552 command and there is a problem checking a folder, you are asked
32553 whether you want to continue with the search in the following folder or not.
32554 This question gives you a chance to stop the NextNew processing.
32555 (The checking problem might be caused by the fact that the folder does not
32556 exist, or by an authentication problem, or by a server problem
32557 of some sort.)
32558 <P>
32559
32560 If this feature is set you will not be asked.
32561 It will be assumed that you do want to continue.
32562 <P>
32563 <UL>
32564 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32565 </UL><P>
32566 &lt;End of help on this topic&gt;
32567 </BODY>
32568 </HTML>
32569 ====== h_config_input_history =====
32570 <HTML>
32571 <HEAD>
32572 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
32573 </HEAD>
32574 <BODY>
32575 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
32576
32577 Many of the prompts that ask for input in the status line near the
32578 bottom of the screen will respond to Up Arrow and Down Arrow
32579 with the history of previous entries.
32580 For example, in the MESSAGE INDEX screen when you use the WhereIs
32581 command the text you entered will be remembered and can be recalled
32582 by using the Up Arrow key.
32583 Another example, when saving a message the folders saved to will
32584 be remembered and can be recalled using the arrow keys.
32585 <P>
32586 In the Save prompt, some users prefer that the Up and Down arrow keys
32587 be used for the Previous Collection and Next Collection commands
32588 instead of for a history of previous saves.
32589 If this option is set the Up and Down arrow keys will become synonyms for the
32590 Previous Collection and Next Collection (^P and ^N) commands in the
32591 prompt for the name of a folder to Save to or in the prompt for the
32592 name of a folder to GoTo.
32593 When this feature is not set (the default), ^P and ^N will change the
32594 collection and the arrow keys will show the history.
32595 <P>
32596 <UL>
32597 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32598 </UL><P>
32599 &lt;End of help on this topic&gt;
32600 </BODY>
32601 </HTML>
32602 ====== h_config_confirm_role =====
32603 <HTML>
32604 <HEAD>
32605 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
32606 </HEAD>
32607 <BODY>
32608 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
32609
32610 If you have roles, when you Reply to or Forward a message, or Compose
32611 a new message, Alpine
32612 will search through your roles for one that matches.
32613 Normally, if no matches are found you will be placed into the composer
32614 with no opportunity to select a role.
32615 If this feature is set, then you will be asked to confirm that you don't
32616 want a role.
32617 This will give you the opportunity to select a role (with the ^T command).
32618 If you confirm no role with a Return, you will be placed in
32619 the composer with no role.
32620 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
32621 These behave the same as if you pressed the Return.
32622 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
32623 match what you might type if there was a role match.)
32624 <P>
32625 If you are using the alternate form of the Compose command called
32626 &quot;Role&quot;, then all of your roles will be available to you,
32627 independent of the value of this feature and of the values set for all of
32628 Reply Use, Forward Use, and Compose Use.
32629 <P>
32630 <UL>
32631 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32632 </UL><P>
32633 &lt;End of help on this topic&gt;
32634 </BODY>
32635 </HTML>
32636 ====== h_config_news_cross_deletes =====
32637 <HTML>
32638 <HEAD>
32639 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
32640 </HEAD>
32641 <BODY>
32642 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
32643
32644 This feature controls what Alpine does when you delete a message in a
32645 newsgroup that appears in more than one newsgroup.  Such a message
32646 is sometimes termed a &quot;crossposting&quot; in that it was posted
32647 across several newsgroups.
32648
32649 <P>
32650 Alpine's default behavior when you delete such a message is to remove
32651 only the copy in the current newsgroup from view when you use the
32652 &quot;Exclude&quot; command or the next time you visit the newsgroup.
32653
32654 <P>
32655 Enabling this feature causes Alpine to remove every occurrence of the
32656 message from all newsgroups it appears in and to which you are
32657 subscribed.
32658
32659 <P>
32660 NOTE: As currently implemented, enabling this feature may increase the
32661 time it takes the Expunge command and newsgroup closing to complete.
32662
32663 <P>
32664 <UL>
32665 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32666 </UL><P>
32667 &lt;End of help on this topic&gt;
32668 </BODY>
32669 </HTML>
32670 ====== h_config_news_catchup =====
32671 <HTML>
32672 <HEAD>
32673 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
32674 </HEAD>
32675 <BODY>
32676 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
32677
32678 This feature controls what Alpine does as it closes a newsgroup.
32679 When set, Alpine will offer to delete all messages from the newsgroup
32680 as you are quitting Alpine or opening a new folder.
32681
32682 <P>
32683 This feature is useful if you typically read all the interesting messages
32684 in a newsgroup each time you open it.  This feature saves you from
32685 having to delete each message in a newsgroup as you read it or from
32686 selecting all the messages and doing an
32687 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
32688 move on to the next folder or newsgroup.
32689
32690 <P>
32691 <UL>
32692 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32693 </UL><P>
32694 &lt;End of help on this topic&gt;
32695 </BODY>
32696 </HTML>
32697 ====== h_config_next_thrd_wo_confirm =====
32698 <HTML>
32699 <HEAD>
32700 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
32701 </HEAD>
32702 <BODY>
32703 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
32704
32705 This feature controls an aspect of Alpine's Next and Prev commands in
32706 the case where you are using one of the
32707 &quot;separate-index-screen&quot; styles for the configuration option
32708 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
32709 and currently have the folder sorted by a Threaded or OrderedSubject sort.
32710 When you are Viewing a particular thread you have a
32711 MESSAGE INDEX of only the messages in that thread.
32712 If you press the Next command with the last message in the thread highlighted
32713 you will normally be asked if you want to &quot;View next thread?&quot;,
32714 assuming there is a next thread to view.
32715 If this feature is set it will be assumed that you always want to view the
32716 next thread and you won't be asked to confirm that.
32717 Similarly, if the first message of the thread is highlighted and you
32718 press the Prev command, this feature will prevent the question
32719 &quot;View previous thread&quot;.
32720 <P>
32721 This feature only has an effect in the MESSAGE INDEX screen.
32722 If you then view a particular message from that screen and press the
32723 Next command, you will be sent to the next thread without being asked,
32724 independent of the setting of this feature.
32725 <P>
32726 The feature
32727 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
32728 <P>
32729 &lt;End of help on this topic&gt;
32730 </BODY>
32731 </HTML>
32732 ====== h_config_kw_braces =====
32733 <HTML>
32734 <HEAD>
32735 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
32736 </HEAD>
32737 <BODY>
32738 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
32739
32740 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
32741 TEXT screens.
32742 If you have modified the
32743 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
32744 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
32745 are used to display keywords or their initials along with the Subject; then
32746 this option may be used to modify the resulting display slightly.
32747 By default, the keywords or initials displayed for these tokens will be
32748 surrounded with curly braces ({ and }) and a trailing space.
32749 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
32750 a message, the &quot;SUBJKEY&quot; token will normally look like
32751 <P>
32752 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
32753 <P>
32754 and the SUBJKEYINIT token would look like
32755 <P>
32756 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
32757 <P>
32758 The default character before the keywords is the left brace ({) and the
32759 default after the keywords is the right brace followed by a space (} ).
32760 <P>
32761 This option allows you to change that.
32762 You should set it to two values separated by a space.
32763 The values may be quoted if they include space characters.
32764 So, for example, the default value could be specified explicitly by setting this
32765 option to
32766 <P>
32767 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
32768 <P>
32769 The first part wouldn't need to be quoted (but it doesn't hurt).
32770 The second part does need the quotes because it includes a space character.
32771 If you wanted to change the braces to brackets you could use
32772 <P>
32773 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
32774 <P>
32775 Inside the quotes you can use backslash quote to mean quote, so
32776 <P>
32777 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
32778 <P>
32779 would produce
32780 <P>
32781 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
32782 <P>
32783 It is also possible to color keywords in the index using the
32784 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
32785 <P>
32786 It is not possible to change the fact that a space character is used to
32787 separate the keywords if more than one keyword is set for a message.
32788 It is also not possible to change the fact that there are no separators
32789 between the keyword initials if more than one keyword is set.
32790 <P>
32791 &lt;End of help on this topic&gt;
32792 </BODY>
32793 </HTML>
32794 ====== h_config_opening_sep =====
32795 <HTML>
32796 <HEAD>
32797 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
32798 </HEAD>
32799 <BODY>
32800 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
32801
32802 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
32803 With some setups the text of the subject is followed
32804 by the opening text of the message if there is any room available in the index line.
32805 If you have configured your
32806 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32807 to include one of the Subject tokens that causes this behavior
32808 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
32809 to modify what is displayed slightly.
32810 By default, the Subject is separated from the opening text of the message by
32811 the three characters space dash space;
32812 <P>
32813 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
32814 <P>
32815 Use this option to set it to something different.
32816 The value must be quoted if it includes any space characters.
32817 For example, the default value could be specified explicitly by setting this
32818 option to
32819 <P>
32820 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
32821 <P>
32822 &lt;End of help on this topic&gt;
32823 </BODY>
32824 </HTML>
32825 ====== h_config_select_wo_confirm =====
32826 <HTML>
32827 <HEAD>
32828 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
32829 </HEAD>
32830 <BODY>
32831 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
32832
32833 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
32834 These commands all take text input to specify the name of the folder or
32835 file to be used, but allow you to press ^T for a list of possible names.
32836 If set, the selected name will be used immediately, without further
32837 opportunity to confirm or edit the name.
32838 <P>
32839 Some related help topics are
32840 <UL>
32841 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
32842 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
32843 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
32844 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
32845 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
32846 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
32847 </UL>
32848 <P>
32849 &lt;End of help on this topic&gt;
32850 </BODY>
32851 </HTML>
32852 ====== h_config_save_part_wo_confirm =====
32853 <HTML>
32854 <HEAD>
32855 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
32856 </HEAD>
32857 <BODY>
32858 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
32859
32860 This feature controls an aspect of Alpine's Save command.
32861 By default, when you Save a message that has some deleted parts, you will
32862 be asked to confirm that you want to Save with a prompt that looks like:
32863 <P>
32864 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
32865 <P>
32866 If this feature is set, you will not be asked.
32867 <P>
32868 &lt;End of help on this topic&gt;
32869 </BODY>
32870 </HTML>
32871 ====== h_config_use_resentto =====
32872 <HTML>
32873 <HEAD>
32874 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
32875 </HEAD>
32876 <BODY>
32877 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
32878
32879 This feature is turned off by default because turning it on causes problems
32880 with some deficient IMAP servers.
32881 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
32882 <A HREF="h_rule_patterns">Pattern</A>
32883 contains a To header pattern and this feature is turned on,
32884 then a check is made in the message to see
32885 if a Resent-To header is present, and that is used instead of the To header.
32886 If this feature is not turned on, then the regular To header will always
32887 be used.
32888
32889 <P>
32890 &lt;End of help on this topic&gt;
32891 </BODY>
32892 </HTML>
32893 ====== h_config_use_reg_start_for_stayopen =====
32894 <HTML>
32895 <HEAD>
32896 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
32897 </HEAD>
32898 <BODY>
32899 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
32900
32901 This feature affects which message is selected as the current message
32902 when you enter a
32903 <A HREF="h_config_permlocked">Stay Open</A> folder.
32904 <P>
32905 Normally, the starting position for an incoming folder (which most Stay Open
32906 folders will likely be) is controlled by the
32907 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
32908 However, if a folder is a Stay Open folder, when you re-enter the folder
32909 after the first time the current message will be the same as it was when
32910 you left the folder.
32911 An exception is made if you use the TAB command to get to the folder.
32912 In that case, the message number will be incremented by one from what it
32913 was when you left the folder.
32914 <P>
32915 The above special behavior is thought to be useful.
32916 However, it is special and different from what you might at first expect.
32917 If this feature is set, then Stay Open folders will not be treated specially
32918 as far as the startup rule is concerned.
32919
32920 <P>
32921 &lt;End of help on this topic&gt;
32922 </BODY>
32923 </HTML>
32924 ====== h_config_use_current_dir =====
32925 <HTML>
32926 <HEAD>
32927 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
32928 </HEAD>
32929 <BODY>
32930 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
32931
32932 This feature controls an aspect of several commands.
32933 If set, your &quot;current working directory&quot;
32934 <!--chtml if pinemode="running"-->
32935 (which, at least for your current Alpine &quot;session,&quot;
32936 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
32937 <!--chtml endif-->
32938 will be used instead of your home directory
32939 <!--chtml if pinemode="running"-->
32940 (which, in the present configuration of your system, is
32941  &quot;<!--#echo var="HOME_DIR"-->&quot;)
32942 <!--chtml endif-->
32943 for all of the following operations:<UL>
32944     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
32945     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
32946     <LI> <!--chtml if pinemode="function_key"-->F4
32947          <!--chtml else-->Ctrl-R
32948          <!--chtml endif--> file inclusion in the COMPOSER
32949     <LI> <!--chtml if pinemode="function_key"-->F5
32950          <!--chtml else-->Ctrl-J
32951          <!--chtml endif--> file attachment in the COMPOSER
32952 </UL>
32953 <!--chtml if pinemode="os_windows"-->
32954 <P>
32955 If you are starting PC-Alpine from a desktop icon or the Start menu,
32956 you can set the &quot;current drive&quot;
32957 by specifying it in the &quot;Start in:&quot;
32958 box found in the Shortcut tab of the Properties.
32959 <!--chtml endif-->
32960 <P>
32961 <UL>
32962 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32963 </UL>
32964
32965 <P>
32966 &lt;End of help on this topic&gt;
32967 </BODY>
32968 </HTML>
32969 ====== h_config_save_wont_delete =====
32970 <HTML>
32971 <HEAD>
32972 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
32973 </HEAD>
32974 <BODY>
32975 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
32976
32977 This feature controls one aspect of the Save command.  If set, Save will
32978 not mark the message &quot;deleted&quot; (its default behavior) after
32979 it has been copied to the designated folder.
32980
32981 <P>
32982 &lt;End of help on this topic&gt;
32983 </BODY>
32984 </HTML>
32985 ====== h_config_use_boring_spinner =====
32986 <HTML>
32987 <HEAD>
32988 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
32989 </HEAD>
32990 <BODY>
32991 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
32992
32993 When Alpine is delayed for some reason it usually shows that
32994 something is happening with a small animated display in the status
32995 message line near the bottom of the screen.
32996 Setting this feature will cause that animation to be the same
32997 each time instead of having Alpine choose a random animation.
32998 You may turn the animation off altogether by setting the
32999 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
33000 option to zero.
33001
33002 <P>
33003 &lt;End of help on this topic&gt;
33004 </BODY>
33005 </HTML>
33006 ====== h_config_unsel_wont_advance =====
33007 <HTML>
33008 <HEAD>
33009 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
33010 </HEAD>
33011 <BODY>
33012 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
33013
33014 This feature controls one aspect of the Unselect Current message command.
33015 Normally, when the Unselect current message command (:) is typed when the
33016 current message is selected, the message will be unselected and the next
33017 message will become the current message.
33018 If this feature is set, the cursor will not advance to the next message.
33019 Instead, the current message will remain the current message after
33020 unselecting.
33021
33022 <P>
33023 &lt;End of help on this topic&gt;
33024 </BODY>
33025 </HTML>
33026 ====== h_config_prune_uses_iso =====
33027 <HTML>
33028 <HEAD>
33029 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
33030 </HEAD>
33031 <BODY>
33032 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
33033
33034 By default, Alpine asks monthly whether or not you would like to rename
33035 some folders to a new name containing the date.
33036 It also asks whether or not you would like to delete some old folders.
33037 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
33038 explanation.
33039
33040 <P>
33041 By default, the name used when renaming a folder looks like
33042 <P>
33043 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
33044 <P>
33045 For example, the first time you run Alpine in May of 2004,
33046 the folder &quot;sent-mail&quot; might be renamed to
33047 <P>
33048 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
33049 <P>
33050 If this feature is set, the name used will be of the form
33051 <P>
33052 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
33053 <P>
33054 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
33055 month (01, 02, ..., 12).
33056 For the April, 2004 example above, it would instead be
33057 <P>
33058 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
33059 <P>
33060 because April is the 4th month of the year.
33061 A reason you might want to set this feature is so that the folders
33062 will sort in chronological order.
33063
33064 <P>
33065 &lt;End of help on this topic&gt;
33066 </BODY>
33067 </HTML>
33068 ====== h_config_save_advances =====
33069 <HTML>
33070 <HEAD>
33071 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
33072 </HEAD>
33073 <BODY>
33074 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
33075
33076 This feature controls one aspect of the Save command.  If set, Save will
33077 (in addition to copying the current message to the designated folder) also
33078 advance to the next message.
33079
33080 <P>
33081 &lt;End of help on this topic&gt;
33082 </BODY>
33083 </HTML>
33084 ====== h_config_force_arrow =====
33085 <HTML>
33086 <HEAD>
33087 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
33088 </HEAD>
33089 <BODY>
33090 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
33091
33092 This feature affects Alpine's MESSAGE INDEX display routine.
33093 If set, the normal inverse-video cursor will be
33094 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
33095 second column of the index display.
33096 <P>
33097 This is the same index cursor you get if you turn on
33098 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
33099 line coloring will still be present if this feature is turned on and
33100 <!--#echo var="FEAT_assume-slow-link"--> is off.
33101 <P>
33102 An alternative version of the Arrow cursor is available by including the
33103 <A HREF="h_config_index_arrow_color">ARROW</A>
33104 token in the
33105 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
33106 <P>
33107 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
33108 but that is not implemented.
33109
33110 <P>
33111 &lt;End of help on this topic&gt;
33112 </BODY>
33113 </HTML>
33114 ====== h_config_ignore_size =====
33115 <HTML>
33116 <HEAD>
33117 <TITLE>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></TITLE>
33118 </HEAD>
33119 <BODY>
33120 <H1>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></H1>
33121
33122 When you have an account residing in an IMAP server, Alpine records the
33123 size of each message as reported by the server. However, when Alpine saves
33124 a message in such IMAP server, Alpine will compute the size of the message
33125 independently, from the data it received. If these two numbers do not
33126 match for a message, Alpine asks you if you still want to take the risk of
33127 saving such message, since data corruption or loss of data could result
33128 from this save.
33129
33130 <P>
33131 Sometimes the root of this problem is that the IMAP server does not
33132 compute sizes correctly, and there will not be loss of information when
33133 saving such message. Enabling this feature will make Alpine ignore such
33134 error and continue saving the message without producing any warnings or
33135 ever stopping the process, as if there had not been any error. This option
33136 applies to all IMAP servers that you use, so if you enable this feature,
33137 size discrepancy warnings will not be given for any IMAP server you
33138 connect to.
33139
33140 <P>
33141 Example of a server where you could reproduce this problem is the Gmail
33142 IMAP server. Another example can be found in some versions of the Exchange
33143 server.
33144
33145 <P>
33146 It is recommended that this feature be disabled most of the time and only
33147 enabled when you find a server which you can determine that has the above
33148 mentioned defect, but be disabled again after making the save operation
33149 succeed.
33150
33151 <P>
33152 &lt;End of help on this topic&gt;
33153 </BODY>
33154 </HTML>
33155 ====== h_config_force_low_speed =====
33156 <HTML>
33157 <HEAD>
33158 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
33159 </HEAD>
33160 <BODY>
33161 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
33162
33163 UNIX Alpine only.
33164 <P>
33165 This feature affects Alpine's display routines.  If set, the normal
33166 inverse-video cursor (used to highlight the current item in a list) will be
33167 replaced by an &quot;arrow&quot; cursor and other
33168 screen update optimizations for
33169 low-speed links (e.g. 2400 bps dialup connections) will be activated.
33170 One of the optimizations is that colored index lines (set up with Indexcolor
33171 Rules) will not be colored.
33172 If you are just turning this feature on because you like using
33173 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
33174 coloring by turning this feature off and the
33175 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
33176
33177 <P>
33178 &lt;End of help on this topic&gt;
33179 </BODY>
33180 </HTML>
33181 ====== h_config_show_delay_cue =====
33182 <HTML>
33183 <HEAD>
33184 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
33185 </HEAD>
33186 <BODY>
33187 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
33188
33189 If set, this feature will cause an asterisk to appear in the upper
33190 left-hand corner of the screen whenever Alpine checks for new mail.
33191 Two asterisks whenever Alpine saves (checkpoints) the state of the current
33192 mailbox to disk.
33193
33194 <!--chtml if pinemode="os_windows"-->
33195 <P>
33196 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
33197 it is trying to open a network connection (e.g, to open your INBOX
33198 on an IMAP
33199 server) or read from the network connection.  A greater-than symbol,
33200 will be displayed when PC-Alpine is trying to write to the network
33201 connection (e.g, sending a command to your IMAP server).
33202 <!--chtml endif-->
33203
33204 <P>
33205 &lt;End of help on this topic&gt;
33206 </BODY>
33207 </HTML>
33208 ====== h_config_color_style =====
33209 <HTML>
33210 <HEAD>
33211 <TITLE>OPTION: Color Style</TITLE>
33212 </HEAD>
33213 <BODY>
33214 <H1>OPTION: Color Style</H1>
33215
33216 UNIX Alpine only.
33217 <P>
33218 If the terminal or terminal emulator you are using is capable of displaying
33219 colors, this option controls whether or not color will be used in Alpine.
33220 If you turn color on and things are set up correctly,
33221 you should see color appear on the screen immediately.
33222 Modern terminal emulators are usually capable of displaying colors.
33223 <P>
33224 The available options include:
33225 <P>
33226
33227 <DL>
33228 <DT>no-color</DT>
33229 <DD>Don't use color.
33230 </DD>
33231
33232 <DT>use-termdef</DT>
33233 <DD>In order to decide if your terminal is capable of color, Alpine looks in
33234 the terminal capabilities database, TERMINFO or TERMCAP, depending on
33235 how Alpine was compiled.
33236 This is a good option to choose if you switch between a color and a non-color
33237 terminal with the same Alpine configuration.
33238 Alpine will know to use color on the color terminal because it is described
33239 in the termcap entry, and Alpine will know to use black and white on the
33240 non-color terminal.
33241 The Alpine Technical Notes, distributed with the source code of Alpine
33242 have more information on configuring a TERMCAP or TERMINFO
33243 entry for color Alpine.
33244 This is usually something a system administrator does.
33245 </DD>
33246
33247 <DT>force-ansi-8color</DT>
33248 <DD>This is probably the setting that most people should use.
33249 Because setting up a termcap entry is confusing and because the
33250 terminal capabilities database is often not correctly configured for color,
33251 this choice and the next may be easier for you to use.
33252 If your terminal emulator responds to ANSI color escape sequences, which
33253 many do, this option will cause Alpine to believe your terminal will respond
33254 to the escape sequences that produce eight different foreground and background
33255 colors.
33256 The escape sequences used to set the foreground colors are
33257
33258   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
33259
33260 where the color_number is an ASCII digit between 0 and 7.
33261 The numbers 0 through 7 should correspond to the colors black, red, green,
33262 yellow, blue, magenta, cyan, and white.
33263 Some terminal emulators use a pre-ANSI scheme that swaps
33264 the colors blue and red and the colors yellow and cyan.
33265 This will cause the default colors to be different, but other than that
33266 things should work fine.
33267 There is also a 9th color available, the last one shown, which is the default
33268 color from the terminal emulator.
33269 When used as a background color some people refer to this color as
33270 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
33271 shown in the color swatch of the SETUP COLOR screen.
33272 The foreground transparent color is shown as
33273 the color of the &quot;TRAN&quot; text.
33274 (The transparent color will not work correctly in a PC-Alpine configuration.)
33275 The escape sequences used to set the background colors are the same
33276 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
33277 The escape sequences for foreground and background default colors (transparent)
33278 are 39m and 49m.
33279 <P>
33280 Note: With the Tera Term terminal emulator this setting works well.
33281 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
33282 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
33283 menu, in the &quot;Window&quot; submenu.
33284 </DD>
33285
33286 <DT>force-ansi-16color</DT>
33287 <DD>Many terminal emulators know about the same eight colors above
33288 plus eight more.
33289 This option attempts to use all 16 colors.
33290 The same escape sequences as for the eight-color terminal are used
33291 for the first eight colors.
33292 The escape sequences used to set foreground colors 8-15 are the same as
33293 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
33294 The background color sequences for colors 8-15 are the same as for 0-7
33295 except the &quot;4&quot; is replaced with &quot;10&quot;.
33296 You can tell if the 16 colors are working by turning on this option
33297 and then going into one of the color configuration screens, for example,
33298 the configuration screen for Normal Color.
33299 If you see 16 different colors to select from (plus a 17th for
33300 the transparent color), it's working.
33301 </DD>
33302
33303 <DT>force-xterm-256color</DT>
33304 <DD>Some versions of xterm (and some other terminal emulators)
33305 have support for 256 colors.
33306 The escape sequences used to set the foreground colors are
33307
33308   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
33309
33310 where the color_number is an ASCII digit between 0 and 255.
33311 Background colors are the same with the 38 replaced with a 48.
33312 The numbers 0 through 15 are probably similar to the 16 color version
33313 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
33314 The terminal default (transparent) color is the 257th color at the bottom.
33315 Some terminal emulators will misinterpret these escape sequences causing
33316 the terminal to blink or overstrike characters or to do something else
33317 undesirable.
33318 <P>
33319 The PuTTY terminal emulator has an option called &quot;Allow terminal to
33320 use xterm 256-colour mode&quot; which allows PuTTY to work well with
33321 this 256-color setting.
33322
33323 </DD>
33324 </DL>
33325
33326 <P>
33327 The normal default is &quot;no-color&quot;.
33328 <P>
33329
33330 Once you've turned on color you may set the
33331 colors of many objects on the screen individually.
33332 For example, you may add colors to the status letters on the MESSAGE
33333 INDEX page.
33334 Most categories of color that Alpine supports are configurable here.
33335 For example, &quot;Normal Color&quot;
33336 is the color used to display most of the text in Alpine, and
33337 &quot;Reverse Color&quot; is used to display highlighted text, such as the
33338 current message in the MESSAGE INDEX.
33339 <P>
33340 Lines in the MESSAGE INDEX may also be colored.
33341 Use Setup Rules to get to the Indexcolor configuration screen.
33342 <P>
33343
33344 <UL>
33345 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33346 </UL><P>
33347 &lt;End of help on this topic&gt;
33348 </BODY>
33349 </HTML>
33350 ====== h_config_disable_index_locale_dates =====
33351 <HTML>
33352 <HEAD>
33353 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
33354 </HEAD>
33355 <BODY>
33356 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
33357
33358 This feature affects the display of dates in the MESSAGE INDEX.
33359 Normally an attempt is made to localize the dates
33360 used in the MESSAGE INDEX display to your locale.
33361 This is controlled with the
33362 LC_TIME locale setting on a UNIX system.
33363 On Windows the Regional Options control panel may be used to set the date format.
33364 At the programming level, Alpine is using the strftime routine
33365 to print the parts of a date.
33366 <P>
33367 If this feature is set, dates are displayed in English and
33368 with the conventions of the United States.
33369 <P>
33370
33371 <UL>
33372 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33373 </UL><P>
33374 &lt;End of help on this topic&gt;
33375 </BODY>
33376 </HTML>
33377 ====== h_config_auto_open_unread =====
33378 <HTML>
33379 <HEAD>
33380 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
33381 </HEAD>
33382 <BODY>
33383 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
33384
33385 This feature controls the behavior of the TAB key when traversing folders
33386 in the optional
33387 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
33388 collection or in optional <!--#echo var="VAR_news-collections"-->.
33389 <P>
33390 When the TAB
33391 (<A HREF="h_common_nextnew">NextNew</A>)
33392 key is pressed, and there
33393 are no more unseen messages in the current (incoming message or news)
33394 folder, Alpine will search the list of folders in the current collection for
33395 one containing New or Recent (new since the last time the folder was
33396 opened) messages.
33397 This behavior may be modified slightly with the
33398 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
33399 feature that causes Alpine to look for Unseen messages instead of Recent
33400 messages.
33401 Normally, when such a folder is found, Alpine will ask
33402 whether you wish to open the folder.  If this feature is set, Alpine will
33403 automatically open the folder without prompting.
33404 <P>
33405 This feature also affects some other similar situations.
33406 If you have a
33407 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
33408 that is equal to one of the &quot;separate-&quot; values, and you are
33409 viewing a thread; then when you type the NextNew command and are at the
33410 end of the current thread you will automatically go to the next thread
33411 if this feature is set.
33412 By default, you would be asked if you want to view the next thread.
33413 You will also be asked at times whether or not you want to view the next
33414 thread after you delete the last message in the thread.
33415 Setting this feature will also cause that question to be skipped.
33416 <P>
33417
33418 <UL>
33419 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33420 </UL><P>
33421 &lt;End of help on this topic&gt;
33422 </BODY>
33423 </HTML>
33424 ====== h_config_auto_include_reply =====
33425 <HTML>
33426 <HEAD>
33427 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
33428 </HEAD>
33429 <BODY>
33430 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
33431
33432 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
33433 will ask whether you wish to include the original message in your reply.
33434 If this feature is set and the feature
33435 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
33436 is <EM>not</EM> set, then the original message will be included in the reply
33437 automatically, without prompting.
33438 <P>
33439 &lt;End of help on this topic&gt;
33440 </BODY>
33441 </HTML>
33442 ====== h_config_select_in_bold =====
33443 <HTML>
33444 <HEAD>
33445 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
33446 </HEAD>
33447 <BODY>
33448 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
33449
33450 This feature controls an aspect of Alpine's
33451 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
33452 commands; in
33453 particular, the Select and WhereIs commands. Select and WhereIs (with the
33454 ^X subcommand) will search the current folder for messages meeting a
33455 specified criteria, and &quot;tag&quot; the resulting messages with an
33456 &quot;X&quot; in the
33457 first column of the applicable lines in the MESSAGE INDEX.  If this feature
33458 is set, instead of using the &quot;X&quot; to denote a selected message,
33459 Alpine will
33460 attempt to display those index lines in boldface. Whether this is
33461 preferable to the &quot;X&quot; will depend on personal taste and the type of
33462 terminal being used.
33463 <P>
33464 <UL>
33465 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33466 </UL><P>
33467 &lt;End of help on this topic&gt;
33468 </BODY>
33469 </HTML>
33470 ====== h_config_alt_auth =====
33471 <HTML>
33472 <HEAD>
33473 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
33474 </HEAD>
33475 <BODY>
33476 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
33477
33478 This feature affects how Alpine connects to IMAP servers.
33479 Its utility has largely been overtaken by events,
33480 but it may still be useful in some circumstances.
33481 If you only connect to modern IMAP servers that support
33482 &quot;STARTTLS&quot; you can ignore this feature.
33483
33484 <P>
33485 Details:
33486
33487 <P>
33488 By default, Alpine will attempt to connect to an IMAP server on the
33489 normal IMAP service port (143), and if the server offers &quot;Transport Layer
33490 Security&quot; (STARTTLS) and Alpine has been compiled with encryption capability,
33491 then a secure (encrypted) session will be negotiated.
33492
33493 <P>
33494 With this feature enabled, before connecting on the normal IMAP port, Alpine
33495 will first attempt to connect to an alternate IMAP service port (993) used
33496 specifically for encrypted IMAP sessions via the Secure Sockets Layer
33497 (SSL) or Transport Layer Security (TLS) method.
33498 If the SSL attempt fails, Alpine will then try the default
33499 behavior described in the previous paragraph.
33500
33501 <P>
33502 STARTTLS negotiation on the normal port is preferred, and supersedes the use of
33503 SSL on port 993, but older servers may not provide STARTTLS support.
33504 This feature may be convenient when accessing IMAP servers that do not support
33505 STARTTLS, but do support SSL or TLS connections on port 993.
33506 However, it is important to understand that with this feature enabled,
33507 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
33508 but it will proceed to make an insecure connection if that is the only
33509 option offered by the server, or if the Alpine in question has been built
33510 without encryption capability.
33511
33512 <P>
33513 Note that this feature specifies a per-user (or system-wide) default
33514 behavior, but host/folder specification flags may be used to control the
33515 behavior of any specific connection.
33516 This feature interacts with some of
33517 the possible host/folder path specification flags as follows:
33518
33519 <P>
33520 The <SAMP>/starttls</SAMP> host flag, for example,
33521
33522 <P>
33523 <CENTER><SAMP>{foo.example.com/starttls}INBOX</SAMP></CENTER>
33524 <P>
33525 will over-ride this feature for the specified host by bypassing the
33526 SSL or TLS connection attempt.
33527 Moreover, with <SAMP>/starttls</SAMP> specified,
33528 the connection attempt will fail if the
33529 service on port 143 does not offer TLS support.
33530
33531 <P>
33532 The <SAMP>/ssl</SAMP> host flag, for example,
33533
33534 <P>
33535 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
33536 <P>
33537 will insist on an SSL or TLS connection for the specified host,
33538 and will fail if the SSL or TLS service on port 993 is not available.
33539 Alpine will not subsequently retry a connection
33540 on port 143 if <SAMP>/ssl</SAMP> is specified.
33541
33542 <P>
33543 <UL>
33544 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33545 </UL><P>
33546 &lt;End of help on this topic&gt;
33547 </BODY>
33548 </HTML>
33549 ====== h_config_file_dir ======
33550 <HTML>
33551 <HEAD>
33552 <TITLE>OPTION: File Directory</TITLE>
33553 </HEAD>
33554 <BODY>
33555 <H1>OPTION: File Directory</H1>
33556
33557 PC-Alpine only.
33558 <P>
33559 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
33560 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
33561 Message Index's &quot;E&nbsp;Export&quot; command.
33562
33563 <P>
33564 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
33565 component, Alpine assumes the file exists in the user's home directory.
33566 Under Windows operating systems, this definition isn't always clear.  This
33567 feature allows you to explicitly set where Alpine should look for files
33568 without a leading path.
33569
33570 <P>
33571 NOTE: this feature's value is ignored if either
33572 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
33573 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
33574
33575 <P>
33576 <UL>
33577 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33578 </UL><P>
33579 &lt;End of help on this topic&gt;
33580 </BODY>
33581 </HTML>
33582 ====== h_config_quote_all_froms =====
33583 <HTML>
33584 <HEAD>
33585 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
33586 </HEAD>
33587 <BODY>
33588 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
33589
33590 This feature controls an aspect of the Save command (and also the way
33591 outgoing messages are saved to an FCC folder).  If set, Alpine will add
33592 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
33593 when they are saved to another folder, including lines syntactically
33594 distinguishable from the type of message separator line commonly used on
33595 Unix systems.
33596
33597 <P>
33598 The default behavior is that a &quot;>&quot; will be prepended only to lines
33599 beginning with &quot;From &quot; that might otherwise be confused with a message
33600 separator line on Unix systems.  If pine is the only mail program you use,
33601 this default is reasonable.  If another program you use has trouble
33602 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
33603 enable this feature.  This feature only applies to the common Unix mailbox
33604 format that uses message separator lines beginning with &quot;From &quot;.  If
33605 Alpine has been configured to use a different mailbox format (possibly
33606 incompatible with other mail programs), then this issue does not arise,
33607 and the feature is irrelevant.
33608
33609 <P>
33610 &lt;End of help on this topic&gt;
33611 </BODY>
33612 </HTML>
33613 ====== h_config_normal_color =====
33614 <HTML>
33615 <HEAD>
33616 <TITLE>OPTION: Normal Color</TITLE>
33617 </HEAD>
33618 <BODY>
33619 <H1>OPTION: Normal Color</H1>
33620
33621 Sets the color Alpine normally uses.
33622 The foreground color is the color of the actual character and the
33623 background color is the color of the area behind the character.
33624 By default this color is black characters on a white background.
33625 <P>
33626 <A HREF="h_color_setup">Descriptions of the available commands</A>
33627 <P>
33628 Look <A HREF="h_edit_nav_cmds">here</A>
33629 to see the available Editing and Navigation commands.
33630 <P>
33631 &lt;End of help on this topic&gt;
33632 </BODY>
33633 </HTML>
33634 ====== h_config_reverse_color =====
33635 <HTML>
33636 <HEAD>
33637 <TITLE>OPTION: Reverse Color</TITLE>
33638 </HEAD>
33639 <BODY>
33640 <H1>OPTION: Reverse Color</H1>
33641
33642 Sets the color Alpine uses for reverse video characters.
33643 The foreground color is the color of the actual character and the
33644 background color is the color of the area behind the character.
33645 <P>
33646 <A HREF="h_color_setup">Descriptions of the available commands</A>
33647 <P>
33648 Look <A HREF="h_edit_nav_cmds">here</A>
33649 to see the available Editing and Navigation commands.
33650 <P>
33651 &lt;End of help on this topic&gt;
33652 </BODY>
33653 </HTML>
33654 ====== h_config_title_color =====
33655 <HTML>
33656 <HEAD>
33657 <TITLE>OPTION: Title Color</TITLE>
33658 </HEAD>
33659 <BODY>
33660 <H1>OPTION: Title Color</H1>
33661
33662 Sets the color Alpine uses for the titlebar (the top line on the screen).
33663 The foreground color is the color of the actual character and the
33664 background color is the color of the area behind the character.
33665 By default, the Title Color is black characters on a yellow background.
33666 <P>
33667 The actual titlebar color may be different from the Title Color if
33668 the option
33669 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
33670 is set to some value other than the default.
33671 It may also be different if the current folder is closed and the
33672 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
33673 color is set to something different from the Title Color.
33674 <P>
33675 <A HREF="h_color_setup">Descriptions of the available commands</A>
33676 <P>
33677 Look <A HREF="h_edit_nav_cmds">here</A>
33678 to see the available Editing and Navigation commands.
33679 <P>
33680 &lt;End of help on this topic&gt;
33681 </BODY>
33682 </HTML>
33683 ====== h_config_titleclosed_color =====
33684 <HTML>
33685 <HEAD>
33686 <TITLE>OPTION: Title Closed Color</TITLE>
33687 </HEAD>
33688 <BODY>
33689 <H1>OPTION: Title Closed Color</H1>
33690
33691 Sets the color Alpine uses for the titlebar (the top line on the screen)
33692 when the current folder is closed.
33693 The foreground color is the color of the actual character and the
33694 background color is the color of the area behind the character.
33695 By default, the Title Color Closed Color is white characters on a red background.
33696 <P>
33697 By setting this color to something noticeable you will be alerted to the
33698 fact that the current folder is closed, perhaps unexpectedly.
33699 <P>
33700 &lt;End of help on this topic&gt;
33701 </BODY>
33702 </HTML>
33703 ====== h_config_status_color =====
33704 <HTML>
33705 <HEAD>
33706 <TITLE>OPTION: Status Color</TITLE>
33707 </HEAD>
33708 <BODY>
33709 <H1>OPTION: Status Color</H1>
33710
33711 Sets the color Alpine uses for status messages written to the message
33712 line near the bottom of the screen.
33713 The foreground color is the color of the actual character and the
33714 background color is the color of the area behind the character.
33715 By default, the Status Color is the same as the Reverse Color.
33716 <P>
33717 <A HREF="h_color_setup">Descriptions of the available commands</A>
33718 <P>
33719 Look <A HREF="h_edit_nav_cmds">here</A>
33720 to see the available Editing and Navigation commands.
33721 <P>
33722 &lt;End of help on this topic&gt;
33723 </BODY>
33724 </HTML>
33725 ====== h_config_index_opening_color =====
33726 <HTML>
33727 <HEAD>
33728 <TITLE>OPTION: Index Opening Color</TITLE>
33729 </HEAD>
33730 <BODY>
33731 <H1>OPTION: Index Opening Color</H1>
33732
33733 With some setups the text of the subject is followed
33734 by the opening text of the message if there is any room available in the index line.
33735 If you have configured your
33736 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
33737 to include one of the Subject tokens that causes this behavior
33738 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
33739 this opening text with this option.
33740 This coloring takes place for all but the current index line, and the Opening
33741 Color appears to be in front of any color from an Index Color Rule.
33742 <P>
33743 By default the Index Opening Color is gray characters on a white background.
33744
33745 <P>
33746 <A HREF="h_color_setup">Descriptions of the available commands</A>
33747 <P>
33748 Look <A HREF="h_edit_nav_cmds">here</A>
33749 to see the available Editing and Navigation commands.
33750 <P>
33751 &lt;End of help on this topic&gt;
33752 </BODY>
33753 </HTML>
33754 ====== h_config_index_pri_color =====
33755 <HTML>
33756 <HEAD>
33757 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
33758 </HEAD>
33759 <BODY>
33760 <H1>OPTION: Index Priority Symbol Colors</H1>
33761
33762 The X-Priority header is a non-standard header that is used in a
33763 somewhat standard way by many mail programs.
33764 Alpine expects the value of this header to be a digit with a value
33765 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
33766 Alpine can be made to display an indication of this priority in
33767 messages by use of one of the tokens
33768 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
33769 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
33770 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
33771
33772 <P>
33773 You may set the color used to draw these tokens by use of the colors
33774 Index High Priority Symbol Color and Index Low Priority Symbol Color.
33775 This coloring takes place for all but the current index line, and the Priority
33776 Color appears to be in front of any color from an Index Color Rule.
33777 If the priority has a value of 1 or 2 the High Priority color will be
33778 used,
33779 and if the value is 4 or 5 the Low Priority color will be used.
33780 <P>
33781 If you don't set these colors the index line will be colored in the same color as
33782 the bulk of the index line.
33783
33784 <P>
33785 <A HREF="h_color_setup">Descriptions of the available commands</A>
33786 <P>
33787 Look <A HREF="h_edit_nav_cmds">here</A>
33788 to see the available Editing and Navigation commands.
33789 <P>
33790 &lt;End of help on this topic&gt;
33791 </BODY>
33792 </HTML>
33793 ====== h_config_index_subject_color =====
33794 <HTML>
33795 <HEAD>
33796 <TITLE>OPTION: Index Subject Color</TITLE>
33797 </HEAD>
33798 <BODY>
33799 <H1>OPTION: Index Subject Color</H1>
33800
33801 You may set the color used to draw the Subject part of the index line.
33802 This coloring takes place for all but the current index line, and the Subject
33803 Color appears to be in front of any color from an Index Color Rule.
33804 <P>
33805 If you don't set this color it will be colored in the same color as
33806 the bulk of the index line.
33807
33808 <P>
33809 <A HREF="h_color_setup">Descriptions of the available commands</A>
33810 <P>
33811 Look <A HREF="h_edit_nav_cmds">here</A>
33812 to see the available Editing and Navigation commands.
33813 <P>
33814 &lt;End of help on this topic&gt;
33815 </BODY>
33816 </HTML>
33817 ====== h_config_index_from_color =====
33818 <HTML>
33819 <HEAD>
33820 <TITLE>OPTION: Index From Color</TITLE>
33821 </HEAD>
33822 <BODY>
33823 <H1>OPTION: Index From Color</H1>
33824
33825 You may set the color used to draw the From part of the index line.
33826 This coloring takes place for all but the current index line, and the From
33827 Color appears to be in front of any color from an Index Color Rule.
33828 <P>
33829 If you don't set this color it will be colored in the same color as
33830 the bulk of the index line.
33831
33832 <P>
33833 <A HREF="h_color_setup">Descriptions of the available commands</A>
33834 <P>
33835 Look <A HREF="h_edit_nav_cmds">here</A>
33836 to see the available Editing and Navigation commands.
33837 <P>
33838 &lt;End of help on this topic&gt;
33839 </BODY>
33840 </HTML>
33841 ====== h_config_index_arrow_color =====
33842 <HTML>
33843 <HEAD>
33844 <TITLE>OPTION: Index Arrow Color</TITLE>
33845 </HEAD>
33846 <BODY>
33847 <H1>OPTION: Index Arrow Color</H1>
33848
33849 If you have configured your
33850 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
33851 to include the &quot;ARROW&quot; token, you may set the color of
33852 the arrow displayed with this option.
33853 If you don't set the color it will be colored in the same color as
33854 the bulk of the index line.
33855
33856 <P>
33857 <A HREF="h_color_setup">Descriptions of the available commands</A>
33858 <P>
33859 Look <A HREF="h_edit_nav_cmds">here</A>
33860 to see the available Editing and Navigation commands.
33861 <P>
33862 &lt;End of help on this topic&gt;
33863 </BODY>
33864 </HTML>
33865 ====== h_config_index_color =====
33866 <HTML>
33867 <HEAD>
33868 <TITLE>OPTION: Index Colors</TITLE>
33869 </HEAD>
33870 <BODY>
33871 <H1>OPTION: Index Colors</H1>
33872
33873 You may add color to the single character symbols that give the status
33874 of each message in the MESSAGE INDEX.
33875 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
33876 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
33877 screen depending on whether the message is addressed to you, and whether
33878 the message is marked Important, is Deleted, is Answered, or is New.
33879 The color for each of those characters may be specified by setting the
33880 &quot;Index-to-me&quot; Symbol Color,
33881 the &quot;Index-important&quot; Symbol Color,
33882 the &quot;Index-deleted&quot; Symbol Color,
33883 the &quot;Index-answered&quot; Symbol Color,
33884 and the &quot;Index-new&quot; Symbol Color.
33885 There are also two other symbol colors called &quot;Index-recent&quot;
33886 and &quot;Index-unseen&quot;.
33887 These two colors will only be used if you have configured your
33888 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
33889 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
33890 <P>
33891 The default colors for these symbols are:
33892 <TABLE>
33893 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
33894 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
33895 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33896 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
33897 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
33898 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33899 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33900 </TABLE>
33901 <P>
33902 Besides coloring the message status symbols, you may also color the
33903 entire index line.
33904 This is done by using the
33905 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
33906 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
33907 When the entire line is colored that color will be &quot;behind&quot; the
33908 status symbol colors talked about in the paragraph above.
33909 <P>
33910 You may also color
33911 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33912 in the index using the
33913 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
33914 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
33915 the Subject using
33916 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
33917 the From field using
33918 <A HREF="h_config_index_from_color">Index From Color</A>;
33919 and the
33920 <A HREF="h_config_index_opening_color">Index Opening</A> text.
33921 <P>
33922 <A HREF="h_color_setup">Descriptions of the available commands</A>
33923 <P>
33924 Look <A HREF="h_edit_nav_cmds">here</A>
33925 to see the available Editing and Navigation commands.
33926 <P>
33927 &lt;End of help on this topic&gt;
33928 </BODY>
33929 </HTML>
33930 ====== h_config_metamsg_color =====
33931 <HTML>
33932 <HEAD>
33933 <TITLE>OPTION: Meta-Message Color</TITLE>
33934 </HEAD>
33935 <BODY>
33936 <H1>OPTION: Meta-Message Color</H1>
33937
33938 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
33939 that aren't part of the message itself.
33940 For example, an attachment that isn't shown might produce a meta
33941 message something like:
33942 <P>
33943 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
33944 <P>
33945 If you set the
33946 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
33947 option you might see
33948 <P>
33949 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
33950 <P>
33951 Warnings about suspicious looking URLs in HTML will also be colored
33952 with this color.
33953 <P>
33954 The foreground color is the color of the actual character and the
33955 background color is the color of the area behind the character.
33956 By default, the Meta-Message Color is black characters on a yellow background.
33957 <P>
33958 <A HREF="h_color_setup">Descriptions of the available commands</A>
33959 <P>
33960 Look <A HREF="h_edit_nav_cmds">here</A>
33961 to see the available Editing and Navigation commands.
33962 <P>
33963 &lt;End of help on this topic&gt;
33964 </BODY>
33965 </HTML>
33966 ====== h_config_keylabel_color =====
33967 <HTML>
33968 <HEAD>
33969 <TITLE>OPTION: KeyLabel Color</TITLE>
33970 </HEAD>
33971 <BODY>
33972 <H1>OPTION: KeyLabel Color</H1>
33973
33974 Sets the color Alpine uses for the labels of the keys in the two-line
33975 menu at the bottom of the screen.
33976 For example, some of the screens have a &quot;P PrevMsg&quot; command.
33977 This option sets the color used when displaying &quot;PrevMsg&quot;.
33978 The foreground color is the color of the actual character and the
33979 background color is the color of the area behind the character.
33980 By default, the KeyLabel Color is the same as the Normal Color.
33981 <P>
33982 WARNING: Some terminal emulators have the property that the screen will scroll
33983 down one line whenever a character is written to the character cell in the
33984 lower right corner of the screen.
33985 Alpine can usually avoid writing a character in that corner of the screen.
33986 However, if you have defined a KeyLabel Color then Alpine does have to write
33987 a character in that cell in order to color the cell correctly.
33988 If you find that your display sometimes scrolls up a line this could be
33989 the problem.
33990 The most obvious symptom is probably that the titlebar at the top of the
33991 screen scrolls off the screen.
33992 Try setting KeyLabel Color to Default to see if that fixes the problem.
33993 <P>
33994 <A HREF="h_color_setup">Descriptions of the available commands</A>
33995 <P>
33996 Look <A HREF="h_edit_nav_cmds">here</A>
33997 to see the available Editing and Navigation commands.
33998 <P>
33999 &lt;End of help on this topic&gt;
34000 </BODY>
34001 </HTML>
34002 ====== h_config_keyname_color =====
34003 <HTML>
34004 <HEAD>
34005 <TITLE>OPTION: KeyName Color</TITLE>
34006 </HEAD>
34007 <BODY>
34008 <H1>OPTION: KeyName Color</H1>
34009
34010 Sets the color Alpine uses for the names of the keys in the two-line
34011 menu at the bottom of the screen.
34012 For example, some of the screens have a &quot;P PrevMsg&quot; command.
34013 This option sets the color used when displaying the &quot;P&quot;.
34014 The foreground color is the color of the actual character and the
34015 background color is the color of the area behind the character.
34016 By default, the KeyName Color is the same as the Reverse Color.
34017 <P>
34018 <A HREF="h_color_setup">Descriptions of the available commands</A>
34019 <P>
34020 Look <A HREF="h_edit_nav_cmds">here</A>
34021 to see the available Editing and Navigation commands.
34022 <P>
34023 &lt;End of help on this topic&gt;
34024 </BODY>
34025 </HTML>
34026 ====== h_config_slctbl_color =====
34027 <HTML>
34028 <HEAD>
34029 <TITLE>OPTION: Selectable Item Color</TITLE>
34030 </HEAD>
34031 <BODY>
34032 <H1>OPTION: Selectable Item Color</H1>
34033
34034 Sets the color Alpine uses for selectable items, such as URLs.
34035 The foreground color is the color of the actual character and the
34036 background color is the color of the area behind the character.
34037 By default, the Selectable Item Color is the same as the Normal Color,
34038 except that it is bold.
34039 <P>
34040 <A HREF="h_color_setup">Descriptions of the available commands</A>
34041 <P>
34042 Look <A HREF="h_edit_nav_cmds">here</A>
34043 to see the available Editing and Navigation commands.
34044 <P>
34045 &lt;End of help on this topic&gt;
34046 </BODY>
34047 </HTML>
34048 ====== h_config_quote_color =====
34049 <HTML>
34050 <HEAD>
34051 <TITLE>OPTION: Quote Colors</TITLE>
34052 </HEAD>
34053 <BODY>
34054 <H1>OPTION: Quote Colors</H1>
34055
34056 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
34057 screen.
34058 If a line begins with a &gt; character (or space followed by &gt;)
34059 it is considered a quote.
34060 That line will be given the Quote1 Color (first level quote).
34061 If there is a second level of quoting then the Quote2 Color will be used.
34062 Alpine considers there to be a second level of quoting if that first &gt; is
34063 followed by another &gt; (or space followed by &gt;).
34064 If there are characters other than whitespace and &gt; signs, then it isn't
34065 considered another level of quoting.
34066 Similarly, if there is a third level of quoting the Quote3 Color will be
34067 used.
34068 If there are more levels after that the Quote Colors are re-used.
34069 If you define all three colors then it would repeat like Color1, Color2, Color3,
34070 Color1, Color2, Color3, ...
34071 If you only define the first two it would be
34072 Color1, Color2, Color1, Color2, ...
34073 If you define only the Quote1 Color, then the entire quote would be that
34074 color regardless of the quoting levels.
34075 By default, the Quote1 Color is black characters on a greenish-blue background;
34076 the Quote2 Color is black characters on a dull yellow background; and
34077 the Quote3 Color is black characters on a green background.
34078 <P>
34079 <A HREF="h_color_setup">Descriptions of the available commands</A>
34080 <P>
34081 Look <A HREF="h_edit_nav_cmds">here</A>
34082 to see the available Editing and Navigation commands.
34083 <P>
34084 &lt;End of help on this topic&gt;
34085 </BODY>
34086 </HTML>
34087 ====== h_config_folder_color =====
34088 <HTML>
34089 <HEAD>
34090 <TITLE>OPTION: Folder Color</TITLE>
34091 </HEAD>
34092 <BODY>
34093 <H1>OPTION: Folder Color</H1>
34094
34095 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
34096 screen. By default, the Folder Color is the normal text color.
34097
34098 <P>
34099 If you set a color for this feature, other than the normal color
34100 (the default), or a color for
34101 <A HREF="h_config_directory_color">Directory Color</A>, then directories
34102 will be colored according to the color specified in the
34103 <A HREF="h_config_directory_color">Directory Color</A> option. In this
34104 case, the color will be the only indication that the colored name
34105 refers to a directory. The normal behavior is that Alpine
34106 indicates that a name refers to a directory by appending a
34107 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
34108 the folder.
34109
34110 <P>
34111 If a folder is a directory, then the folder name will be painted
34112 according to the color defined by this variable, and a separator
34113 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
34114 to the name. That
34115 indicator will be painted according to the color defined in the
34116 <A HREF="h_config_directory_color">Directory Color</A> option.
34117
34118 <P>
34119 &lt;End of help on this topic&gt;
34120 </BODY>
34121 </HTML>
34122 ====== h_config_directory_color =====
34123 <HTML>
34124 <HEAD>
34125 <TITLE>OPTION: Directory Color</TITLE>
34126 </HEAD>
34127 <BODY>
34128 <H1>OPTION: Directory Color</H1>
34129
34130 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
34131 screen. By default, the Folder Color is the normal text color.
34132 <P>
34133 If you set a color for this feature, other than the normal color
34134 (the default), or a color for
34135 <A HREF="h_config_folder_color">Folder Color</A>, then folders
34136 will be colored according to the color specified in the
34137 <A HREF="h_config_folder_color">Folder Color</A> option. In this
34138 case, the color will be the only indication that the colored name
34139 refers to a directory. The normal behavior is that Alpine
34140 indicates that a name refers to a directory by appending a
34141 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
34142 the folder.
34143 <P>
34144 If a folder is a directory, then the folder name will be painted
34145 according to the color defined by the option
34146 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
34147 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
34148 after the name. That
34149 indicator will be painted according to the color defined in this
34150 option.
34151 <P>
34152 &lt;End of help on this topic&gt;
34153 </BODY>
34154 </HTML>
34155 ====== h_config_folder_list_color =====
34156 <HTML>
34157 <HEAD>
34158 <TITLE>OPTION: Folder-List Color</TITLE>
34159 </HEAD>
34160 <BODY>
34161 <H1>OPTION: Folder-List Color</H1>
34162
34163 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
34164 screen. By default, the Folder-List Color is the normal text color.
34165 <P>
34166 This text refers to the informative text that Alpine displays so you
34167 can recognize each collection. The color of the content of each collection
34168 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
34169 and <A HREF="h_config_directory_color">Directory Color</A>.
34170 <P>
34171 Unlike the options
34172 <A HREF="h_config_folder_color">Folder Color</A>
34173 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
34174 this option does not affect the way that Alpine reports folders,
34175 directories and folders that are directories.
34176 <P>
34177 &lt;End of help on this topic&gt;
34178 </BODY>
34179 </HTML>
34180 ====== h_config_incunseen_color =====
34181 <HTML>
34182 <HEAD>
34183 <TITLE>OPTION: Incoming Unseen Color</TITLE>
34184 </HEAD>
34185 <BODY>
34186 <H1>OPTION: Incoming Unseen Color</H1>
34187
34188 If the option
34189 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
34190 is turned on it is possible to highlight the folders that contain
34191 unseen messages by coloring them with this color.
34192 By default, this is the same as the Normal Color and no highlighting is done.
34193 <P>
34194 Usually the &quot;current&quot; folder (the folder the cursor is on)
34195 is highlighted using reverse video.
34196 If the current folder is colored because it contains unseen messages then
34197 the color used to show that it is also the current folder is controlled
34198 by the
34199 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
34200 feature at the top of the SETUP COLOR screen.
34201 <P>
34202 <A HREF="h_color_setup">Descriptions of the available commands</A>
34203 <P>
34204 Look <A HREF="h_edit_nav_cmds">here</A>
34205 to see the available Editing and Navigation commands.
34206 <P>
34207 &lt;End of help on this topic&gt;
34208 </BODY>
34209 </HTML>
34210 ====== h_config_signature_color =====
34211 <HTML>
34212 <HEAD>
34213 <TITLE>OPTION: Signature Color</TITLE>
34214 </HEAD>
34215 <BODY>
34216 <H1>OPTION: Signature Color</H1>
34217
34218 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
34219 screen. According to USENET conventions, the signature is defined as the
34220 paragraph following the &quot;sigdashes&quot;, that is, the special line
34221 consisting of the three characters
34222 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
34223 empty line right after the sigdashes to be considered as part of the
34224 signature.
34225 By default, the Signature Color is blue characters on a white background.
34226 <P>
34227 <A HREF="h_color_setup">Descriptions of the available commands</A>
34228 <P>
34229 Look <A HREF="h_edit_nav_cmds">here</A>
34230 to see the available Editing and Navigation commands.
34231 <P>
34232 &lt;End of help on this topic&gt;
34233 </BODY>
34234 </HTML>
34235 ====== h_config_prompt_color =====
34236 <HTML>
34237 <HEAD>
34238 <TITLE>OPTION: Prompt Color</TITLE>
34239 </HEAD>
34240 <BODY>
34241 <H1>OPTION: Prompt Color</H1>
34242
34243 Sets the color Alpine uses for confirmation prompts and questions that
34244 appear in the status line near the bottom of the screen.
34245 The foreground color is the color of the actual character and the
34246 background color is the color of the area behind the character.
34247 By default, the Prompt Color is the same as the Reverse Color.
34248 <P>
34249 <A HREF="h_color_setup">Descriptions of the available commands</A>
34250 <P>
34251 Look <A HREF="h_edit_nav_cmds">here</A>
34252 to see the available Editing and Navigation commands.
34253 <P>
34254 &lt;End of help on this topic&gt;
34255 </BODY>
34256 </HTML>
34257 ====== h_config_header_general_color =====
34258 <HTML>
34259 <HEAD>
34260 <TITLE>OPTION: Header General Color</TITLE>
34261 </HEAD>
34262 <BODY>
34263 <H1>OPTION: Header General Color</H1>
34264
34265 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
34266 screen.
34267 The foreground color is the color of the actual character and the
34268 background color is the color of the area behind the character.
34269 By default, this is the same as the Normal Color.
34270 <P>
34271 It is also possible to set the colors for specific header fields, for
34272 example the Subject, using
34273 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
34274 If both a Header General Color and a specific Viewer Header Color are set
34275 the specific color will override the general color, as you would expect.
34276 <P>
34277 <A HREF="h_color_setup">Descriptions of the available commands</A>
34278 <P>
34279 Look <A HREF="h_edit_nav_cmds">here</A>
34280 to see the available Editing and Navigation commands.
34281 <P>
34282 &lt;End of help on this topic&gt;
34283 </BODY>
34284 </HTML>
34285 ====== h_config_incol =====
34286 <HTML>
34287 <HEAD>
34288 <TITLE>Index Line Color</TITLE>
34289 </HEAD>
34290 <BODY>
34291 <H1>Index Line Color</H1>
34292
34293 This option is used to set the color of a line in the index when the
34294 message for that line matches the Pattern.
34295 This colors the whole index line, except possibly the status letters,
34296 which may be colored separately using the
34297 <A HREF="h_color_setup">Setup Kolor</A> screen.
34298 The foreground color is the color of the actual characters and the
34299 background color is the color of the area behind the characters.
34300 <P>
34301 <A HREF="h_color_setup">Descriptions of the available commands</A>
34302 <P>
34303 Look <A HREF="h_edit_nav_cmds">here</A>
34304 to see the available Editing and Navigation commands.
34305 <P>
34306 &lt;End of help on this topic&gt;
34307 </BODY>
34308 </HTML>
34309 ====== h_config_usetransparent_color =====
34310 <HTML>
34311 <HEAD>
34312 <TITLE>OPTION: Use Transparent Color</TITLE>
34313 </HEAD>
34314 <BODY>
34315 <H1>OPTION: Use Transparent Color</H1>
34316
34317 This is a special color supported by some terminal emulators.
34318 It is intended to result in the default foreground or background color
34319 from the terminal emulator.
34320 This is the color the terminal was displaying characters in before you started Alpine.
34321 The reason it is called Transparent is because you could set the foreground color
34322 to some specific color, like Red, and then set the background color to the
34323 Transparent Color. If it works as expected, the background color from the terminal
34324 window in which Alpine is running will show through but with the Red characters
34325 in the foreground.
34326 <P>
34327 <A HREF="h_color_setup">Descriptions of the available commands</A>
34328 <P>
34329 Look <A HREF="h_edit_nav_cmds">here</A>
34330 to see the available Editing and Navigation commands.
34331 <P>
34332 &lt;End of help on this topic&gt;
34333 </BODY>
34334 </HTML>
34335 ====== h_config_usenormal_color =====
34336 <HTML>
34337 <HEAD>
34338 <TITLE>OPTION: Use Normal Color</TITLE>
34339 </HEAD>
34340 <BODY>
34341 <H1>OPTION: Use Normal Color</H1>
34342
34343 When you use this color value, the actual color used will be the same
34344 as the corresponding Normal Color.
34345 For example if your Normal Color is black on white and you set both
34346 the foreground and background colors here to use the Normal Color, you'll
34347 get black on white. If you later change the Normal Color to red on blue
34348 this color will also change to red on blue.
34349 <P>
34350 <A HREF="h_color_setup">Descriptions of the available commands</A>
34351 <P>
34352 Look <A HREF="h_edit_nav_cmds">here</A>
34353 to see the available Editing and Navigation commands.
34354 <P>
34355 &lt;End of help on this topic&gt;
34356 </BODY>
34357 </HTML>
34358 ====== h_config_usenone_color =====
34359 <HTML>
34360 <HEAD>
34361 <TITLE>OPTION: Use None Color</TITLE>
34362 </HEAD>
34363 <BODY>
34364 <H1>OPTION: Use None Color</H1>
34365
34366 This is a special color that simply means to leave the color alone.
34367 It is useful for Index symbols and for Keyword Colors used in the Subject
34368 field of an index line.
34369 The most likely use is to set an explicit foreground color and then set
34370 the background color to the None Color.
34371 That will cause the symbol or keyword to be drawn in the foreground color
34372 with a background equal to whatever color the rest of the index line is already
34373 drawn in.
34374 You will see no visible effect unless you have assigned Indexcolor Rules to
34375 color index lines or you have set an actual color for the Reverse Color.
34376 <P>
34377 <A HREF="h_color_setup">Descriptions of the available commands</A>
34378 <P>
34379 Look <A HREF="h_edit_nav_cmds">here</A>
34380 to see the available Editing and Navigation commands.
34381 <P>
34382 &lt;End of help on this topic&gt;
34383 </BODY>
34384 </HTML>
34385 ====== h_config_dflt_color =====
34386 <HTML>
34387 <HEAD>
34388 <TITLE>OPTION: Default Color</TITLE>
34389 </HEAD>
34390 <BODY>
34391 <H1>OPTION: Default Color</H1>
34392
34393 Setting default will cause the color to be the default color.
34394 Unsetting default is normally done by choosing a color, but in some cases
34395 you may want to declare the current default color to be your non-default
34396 choice.
34397 For example, the default Keyname Color is the same as the Reverse Color.
34398 Whenever the Reverse Color changes the Keyname Color will also change, unless
34399 you've changed it or unset the default box.
34400 <P>
34401 <A HREF="h_color_setup">Descriptions of the available commands</A>
34402 <P>
34403 Look <A HREF="h_edit_nav_cmds">here</A>
34404 to see the available Editing and Navigation commands.
34405 <P>
34406 &lt;End of help on this topic&gt;
34407 </BODY>
34408 </HTML>
34409 ====== h_config_bold_slctbl =====
34410 <HTML>
34411 <HEAD>
34412 <TITLE>OPTION: Bold</TITLE>
34413 </HEAD>
34414 <BODY>
34415 <H1>OPTION: Bold</H1>
34416
34417 The color for this particular section may have the Bold attribute turned
34418 on or off.
34419 Setting bold will cause the characters to be bold.
34420 <P>
34421 <A HREF="h_color_setup">Descriptions of the available commands</A>
34422 <P>
34423 Look <A HREF="h_edit_nav_cmds">here</A>
34424 to see the available Editing and Navigation commands.
34425 <P>
34426 &lt;End of help on this topic&gt;
34427 </BODY>
34428 </HTML>
34429 ====== h_config_kw_color =====
34430 <HTML>
34431 <HEAD>
34432 <TITLE>OPTION: Keyword Colors</TITLE>
34433 </HEAD>
34434 <BODY>
34435 <H1>OPTION: Keyword Colors</H1>
34436
34437 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
34438 Keywords are displayed as part of the Subject by default.
34439 They are also displayed as part of the Subject if the tokens
34440 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
34441 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
34442 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
34443 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
34444 <P>
34445 For example, you might have set up a Keyword
34446 &quot;Work&quot; using the
34447 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
34448 You could cause that Keyword to show up as a special color
34449 by setting up the Keyword Color using this option, and then including it
34450 in the MESSAGE INDEX screen using one of the tokens listed above in the
34451 <!--#echo var="VAR_index-format"-->.
34452 <P>
34453 <A HREF="h_color_setup">Descriptions of the available commands</A>
34454 <P>
34455 Look <A HREF="h_edit_nav_cmds">here</A>
34456 to see the available Editing and Navigation commands.
34457 <P>
34458 &lt;End of help on this topic&gt;
34459 </BODY>
34460 </HTML>
34461 ====== h_config_customhdr_color =====
34462 <HTML>
34463 <HEAD>
34464 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
34465 </HEAD>
34466 <BODY>
34467 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
34468
34469 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
34470 For example, you may set the color of the Subject header or the From header.
34471 The foreground color is the color of the actual character and the
34472 background color is the color of the area behind the character.
34473 <P>
34474 In addition to setting the colors for particular headers (like the Subject)
34475 you may also set a color to be used for all headers unless overridden by a
34476 more specific Viewer Header Color.
34477 To do this use the
34478 <A HREF="h_config_header_general_color">Header General Color</A>.
34479 <P>
34480 For Header Colors,
34481 there is an additional line on the
34482 screen labeled &quot;Pattern to match&quot;.
34483 If you leave that blank, then the whole field for that header will
34484 be colored.
34485 However, if you give a pattern to match, the coloring will only take place
34486 if there is a match for that pattern in the value of the field.
34487 For example, if you are working on a color for the Subject header and
34488 you fill in a pattern of &quot;important&quot;, then only Subjects that
34489 contain the word &quot;important&quot; will be colored.
34490 <P>
34491 If the pattern you enter is a comma-separated list of patterns, then coloring
34492 happens if any of those patterns matches.
34493 <P>
34494 <A HREF="h_color_setup">Descriptions of the available commands</A>
34495 <P>
34496 Look <A HREF="h_edit_nav_cmds">here</A>
34497 to see the available Editing and Navigation commands.
34498 <P>
34499 &lt;End of help on this topic&gt;
34500 </BODY>
34501 </HTML>
34502 ====== h_config_indextoken_color =====
34503 <HTML>
34504 <HEAD>
34505 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
34506 </HEAD>
34507 <BODY>
34508 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
34509
34510 This option allows you to set up the color in which any token, not specified by the
34511 previous options, will be colored in the MESSAGE INDEX screen.
34512 <P>
34513 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
34514 a token that can be used in the index format.
34515 The list of available tokens is <A HREF="h_index_tokens">here</A>.
34516 <P>
34517 If you fail to enter a valid token your entry will be ignored, and you will be asked to
34518 enter a new one. Once you have entered a valid token, a line will be added to the
34519 configuration screen that you can use to set up the colors in which that token will
34520 be painted. This is done in the same way that you configure colors for other
34521 variables.
34522
34523 <A HREF="h_color_setup">Descriptions of the available commands</A>
34524 <P>
34525 Look <A HREF="h_edit_nav_cmds">here</A>
34526 to see the available Editing and Navigation commands.
34527 <P>
34528 &lt;End of help on this topic&gt;
34529 </BODY>
34530 </HTML>
34531 ====== h_config_customhdr_pattern =====
34532 <HTML>
34533 <HEAD>
34534 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
34535 </HEAD>
34536 <BODY>
34537 <H1>OPTION: Viewer Header Color Pattern</H1>
34538
34539 If you leave this blank, then the whole field for the header will
34540 be colored.
34541 If you give a pattern to match, the coloring will only take place
34542 if there is a match for that pattern in the value of the field.
34543 For example, if you are working on a color for the Subject header and
34544 you fill in a pattern of &quot;important&quot;, then only Subjects that
34545 contain the word &quot;important&quot; will be colored.
34546 <P>
34547 For address headers (like From and To) and for the Newsgroups header,
34548 a pattern match will cause only the matched addresses or newsgroups to be
34549 colored.
34550 If there is no pattern to match, then all of the addresses or newsgroups
34551 in the relevant header will be colored.
34552 <P>
34553 The matching pattern may be a comma-separated list of patterns to match
34554 instead of a single pattern.
34555 For example, you could use the pattern &quot;important,urgent&quot; which would
34556 cause a match if either the word &quot;important&quot; or the word
34557 &quot;urgent&quot; appeared in the value of the header.
34558 You could list several comma-separated email addresses in the Header
34559 From Color pattern so that those addresses will be colored when any of
34560 them appear in the From header.
34561 <P>
34562 To add a new matching pattern or change the existing pattern use the
34563 <!--chtml if pinemode="function_key"-->
34564 &quot;F4&quot;
34565 <!--chtml else-->
34566 &quot;C&quot;
34567 <!--chtml endif-->
34568 &quot;Change&quot; command that is available when the &quot;Pattern to
34569 match&quot; line is highlighted.
34570 The
34571 <!--chtml if pinemode="function_key"-->
34572 &quot;F10&quot;
34573 <!--chtml else-->
34574 &quot;D&quot;
34575 <!--chtml endif-->
34576 &quot;Delete&quot; command may be used to quickly remove all patterns
34577 for a particular header.
34578 <P>
34579 &lt;End of help on this topic&gt;
34580 </BODY>
34581 </HTML>
34582 ====== h_color_setup =====
34583 <HTML>
34584 <HEAD>
34585 <TITLE>SETUP COLOR COMMANDS</TITLE>
34586 </HEAD>
34587 <BODY>
34588 <H1>SETUP COLOR COMMANDS</H1>
34589 <!--chtml if pinemode="function_key"-->
34590 <PRE>
34591 Available Commands -- Group 1
34592 -------------------------------
34593 F1  Display this help text
34594 F2  Show other available commands
34595 F3  Exit to MAIN MENU
34596 F4  Select the highlighted foreground or background color
34597 F5  Move to previous line
34598 F6  Move to next line
34599 F7  Previous page
34600 F8  Next page
34601 F9  Add a config section for a header field
34602 F10 Restore all default colors (for all sections)
34603 F11 Print color configuration screen
34604 F12 Whereis (search for word)
34605
34606 Available Commands -- Group 2
34607 -------------------------------
34608 F1  Display this help text
34609 F2  Show other available commands
34610 F5  Delete config section for highlighted header field
34611 F6  Shuffle the order of Header Color sections
34612 </PRE>
34613 <!--chtml else-->
34614 <PRE>
34615 General commands
34616 -------------------------------------------------
34617  ?  Display this help text     E  Exit back to MAIN MENU
34618  P  Previous Line              N  Next Line
34619  -  Previous page             Spc (space bar) Next page
34620  W  WhereIs (search for word)  %  Print color configuration screen
34621
34622 Color Setup Commands
34623 ------------------------------------------------
34624  *  Select the highlighted foreground or background color
34625  A  Add a config section for a header field
34626  D  Delete config section for highlighted header field
34627  R  Restore all default colors (for all sections)
34628  $  Shuffle the order of Header Color sections
34629 </PRE>
34630 <!--chtml endif-->
34631
34632 <H2>Description of the Setup Color Screen</H2>
34633
34634 From this screen you may turn on color and set the colors of
34635 various parts of the Alpine display.
34636 For help on turning on color move your cursor into the Color Style section
34637 at the top of the Setup Color screen and ask for help.
34638
34639 <P>
34640 There are several sections in the Setup Color Screen.
34641 At the top are some settings that handle the style of color used
34642 with your terminal emulator (UNIX only), and some settings that
34643 control how the current indexline and the titlebar are colored.
34644 After that comes a long section called GENERAL COLORS that allows
34645 you to set the color of many elements in the Alpine screens.
34646 For example, the color of the titlebar, status messages,
34647 selectable links, quotes and signatures in messages, and so on.
34648 After that is a section called INDEX COLORS that allows you to
34649 set the colors of various pieces of the displayed index lines in
34650 the MESSAGE INDEX screen.
34651 The next section is HEADER COLORS. This is for coloring headers of
34652 messages in the MESSAGE TEXT screen in just about any way you would like.
34653 Finally, the KEYWORD COLORS section allows you to highlight
34654 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
34655 in the MESSAGE INDEX screen.
34656
34657 <P>
34658 To change a color, highlight the color you want to change (for example,
34659 the Status Color) by moving
34660 the cursor into it.
34661 You may want to read the help text for the color to see a brief description
34662 of what you are coloring.
34663 Then press &quot;C&quot; for Change to set the color to something new.
34664 That will put you into a screen with two columns of colors, one for
34665 the foreground color and one for the background color.
34666 The foreground color is just the color you want the actual characters
34667 to be and the background color is the color of the rest of the rectangle
34668 behind the characters.
34669 Select the foreground and background colors desired by using the Next and
34670 Prev keys to highlight the color, and the * command to select it.
34671 <P>
34672 To set a color to its default value, set the X in the Default line at
34673 the bottom of the list of colors.
34674 <P>
34675
34676 The HEADER COLORS section is a little bit different from the others.
34677 Besides coloring the specific fields that Alpine knows about, you may also
34678 color specific header fields when viewing a message in the MESSAGE TEXT
34679 screen.
34680 For example, you may color the Subject header a particular color.
34681 There are a few commands for use with headers.
34682 The &quot;AddHeader&quot; command adds a section to the color
34683 configuration screen that allows you to set the color for that header.
34684 You'll be asked for the name of the header field you want to color.
34685 If you wanted to color the Subject, you would answer
34686 with the word &quot;subject&quot;.
34687 Once you've added a header field, the color setting works just like the
34688 other color fields, except that there is an additional line on the
34689 configuration screen labeled &quot;Pattern to match&quot;.
34690 If you leave that blank, then the whole field for that header will always
34691 be colored.
34692 However, if you give a pattern to match, the coloring will only take place
34693 if there is a match for that pattern in the value of the field.
34694 For example, if you are working on a color for the Subject header and
34695 you fill in a pattern of &quot;important&quot;, then only Subjects that
34696 contain the word &quot;important&quot; will be colored.
34697 <P>
34698 The &quot;DeleteHdr&quot; command removes a header section from the
34699 configuration altogether.
34700 The &quot;Shuffle&quot; command changes the order of header sections.
34701 This is only necessary if you use header sections with pattern fields.
34702 For example, if you have two Subject sections, one with one pattern and
34703 another with another pattern, and the subject for a particular message
34704 happens to match both, then the color from the first match is used.
34705 <P>
34706
34707 The command &quot;RestoreDefs&quot; will restore all of the default colors.
34708 Each section will change to the default value used for that section when
34709 color is first enabled.
34710 When you restore all default colors the color settings for the Header Colors
34711 will be unset (since that's the default), but the header fields you've
34712 added will remain so that you may easily reset them.
34713 In order to get rid of them completely you'd have to use
34714 the &quot;DeleteHdr&quot; command.
34715
34716 <P>
34717 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
34718 may be set with matching rules and that is configured separately from
34719 the rest of the color settings described here.
34720 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
34721 instead of in the Setup/Kolor section.
34722
34723 <P><UL>
34724 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34725 </UL><P>
34726 &lt;End of help on this topic&gt;
34727 </BODY>
34728 </HTML>
34729 ====== h_config_news_uses_recent ======
34730 <HTML>
34731 <HEAD>
34732 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
34733 </HEAD>
34734 <BODY>
34735 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
34736
34737 This feature causes certain messages to be marked as "New" in the
34738 MESSAGE INDEX of newsgroups.
34739 This feature is set by default.
34740
34741 <P>
34742
34743 When opening a newsgroup, Alpine will consult your "newsrc" file and
34744 determine the last message you have previously disposed of via the "D"
34745 key.  If this feature is set, any subsequent messages will be shown in the
34746 Index with an "N", and the first of these messages will be highlighted.
34747 Although this is only an approximation of true "New" or "Unseen"
34748 status, it provides a useful cue to distinguish more-or-less recent
34749 messages from those you have seen previously, but are not yet ready to
34750 mark deleted.
34751
34752 <P>
34753
34754 Background: your "newsrc" file (used to store message status information
34755 for newsgroups) is only capable of storing a single flag, and Alpine uses
34756 this to record whether or not you are "done with" a message, as
34757 indicated by marking the message as "Deleted".  Unfortunately, this
34758 means that Alpine has no way to record exactly which messages you have
34759 previously seen, so it normally does not show the "N" status flag for
34760 any messages in a newsgroup. This feature enables a starting
34761 *approximation* of seen/unseen status that may be useful.
34762 <P>
34763 &lt;End of help on this topic&gt;
34764 </BODY>
34765 </HTML>
34766 ====== h_config_expose_hidden_config =====
34767 <HTML>
34768 <HEAD>
34769 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
34770 </HEAD>
34771 <BODY>
34772 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
34773
34774 If set, this causes configuration options and features that are normally
34775 hidden from view to be editable in the Setup/Config screen.
34776
34777 <P>
34778 The purpose of this feature is to allow you to change configuration
34779 features and variables that are normally hidden.
34780 This is particularly useful if you are using a remote configuration,
34781 where it is difficult to edit the contents manually, but it may also be used
34782 on a local pinerc configuration file.
34783 <P>
34784 If set, several configuration variables and features that are normally
34785 hidden from view will show up in the Setup/Configuration screen.
34786 They will be at the bottom of the configuration screen.
34787 You can find them by searching for the words &quot;hidden configuration&quot;.
34788 <P>
34789
34790 Note that this is an advanced feature that should be used with care.
34791 The reason that this part of the configuration is normally hidden is because
34792 there is a significant potential for causing problems if you change these
34793 variables.
34794 If something breaks after a change try changing it back to see if that is
34795 what is causing the problem.
34796 There are also some variables that are normally hidden because they are
34797 manipulated through Alpine in other ways.
34798 For example, colors are normally set using the Setup/Kolors screen and
34799 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
34800 the Setup/AddressBooks screen, so there is little reason to edit these directly.
34801 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
34802 the Add, Delete, and Rename commands in the FOLDER LIST screen,
34803 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
34804 internally by Alpine and not set directly by the user.
34805 <P>
34806 <UL>
34807 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34808 </UL><P>
34809 &lt;End of help on this topic&gt;
34810 </BODY>
34811 </HTML>
34812 ====== h_config_disable_signature_edit =====
34813 <HTML>
34814 <HEAD>
34815 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
34816 </HEAD>
34817 <BODY>
34818 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
34819
34820 If set, this disables the editing of signature files from within
34821 the Setup/Config screen.
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_delete_before_writing =====
34830 <HTML>
34831 <HEAD>
34832 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delete-before-writing"--></TITLE>
34833 </HEAD>
34834 <BODY>
34835 <H1>FEATURE: <!--#echo var="FEAT_enable-delete-before-writing"--></H1>
34836
34837 This feature controls a behavior of Alpine intended to workaround problems in
34838 terminals where the marker for the end of inverse video cannot be overwritten,
34839 but must be deleted, as a way to start inverse video again.
34840
34841 <P>
34842 When this feature is enabled, Alpine will delete a line before writing it,
34843 therefore deleting the end of reverse video. Modern terminals do not require
34844 enabling this feature, but some old terminals might require it.
34845 <P>
34846 <UL>
34847 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34848 </UL><P>
34849 &lt;End of help on this topic&gt;
34850 </BODY>
34851 </HTML>
34852 ====== h_config_disable_roles_templateedit =====
34853 <HTML>
34854 <HEAD>
34855 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
34856 </HEAD>
34857 <BODY>
34858 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
34859
34860 If set, this disables the editing of template files within the
34861 Role setup screen.
34862 <P>
34863 <UL>
34864 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34865 </UL><P>
34866 &lt;End of help on this topic&gt;
34867 </BODY>
34868 </HTML>
34869 ====== h_config_disable_roles_sigedit =====
34870 <HTML>
34871 <HEAD>
34872 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
34873 </HEAD>
34874 <BODY>
34875 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
34876
34877 If set, this disables the editing of signature files within the
34878 Role setup screen.
34879 <P>
34880 <UL>
34881 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34882 </UL><P>
34883 &lt;End of help on this topic&gt;
34884 </BODY>
34885 </HTML>
34886 ====== h_config_disable_roles_setup =====
34887 <HTML>
34888 <HEAD>
34889 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
34890 </HEAD>
34891 <BODY>
34892 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
34893
34894 If set, this disables the Setup/Rules/Roles command.
34895 <P>
34896 <UL>
34897 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34898 </UL><P>
34899 &lt;End of help on this topic&gt;
34900 </BODY>
34901 </HTML>
34902 ====== h_config_disable_pipes_in_templates =====
34903 <HTML>
34904 <HEAD>
34905 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
34906 </HEAD>
34907 <BODY>
34908 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
34909
34910 By default, if a template file name is followed by a vertical bar (|) then
34911 that causes the file to be executed to produce the text for the template.
34912 If this feature is set, then this is not allowed.
34913 <P>
34914 <UL>
34915 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34916 </UL><P>
34917 &lt;End of help on this topic&gt;
34918 </BODY>
34919 </HTML>
34920 ====== h_config_disable_pipes_in_sigs =====
34921 <HTML>
34922 <HEAD>
34923 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
34924 </HEAD>
34925 <BODY>
34926 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
34927
34928 By default, if a signature file name is followed by a vertical bar (|) then
34929 that causes the file to be executed to produce the text for the signature.
34930 If this feature is set, then this is not allowed.
34931 <P>
34932 <UL>
34933 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34934 </UL><P>
34935 &lt;End of help on this topic&gt;
34936 </BODY>
34937 </HTML>
34938 ====== h_config_disable_password_cmd =====
34939 <HTML>
34940 <HEAD>
34941 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
34942 </HEAD>
34943 <BODY>
34944 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
34945
34946 If set, then the Setup/Newpassword command is disabled.
34947 <P>
34948 <UL>
34949 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34950 </UL><P>
34951 &lt;End of help on this topic&gt;
34952 </BODY>
34953 </HTML>
34954 ====== h_config_disable_password_caching =====
34955 <HTML>
34956 <HEAD>
34957 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
34958 </HEAD>
34959 <BODY>
34960 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
34961
34962 Normally, loginname/password combinations are cached in Alpine so that
34963 you do not have to enter the same password more than once in a session.
34964 A disadvantage to this approach is that the password must be stored in
34965 the memory image of the running Alpine in order that it can be re-used.
34966 In the event that Alpine crashes and produces a core dump, and that core
34967 dump is readable by others, the loginname and password could be read
34968 from the core dump.
34969 <P>
34970 If this feature is set, then the passwords will not be cached and you
34971 will have to retype the password whenever Alpine needs it.
34972 Even with this feature set there is still some chance that the core
34973 file will contain a password, so care should be taken to make the
34974 core files unreadable.
34975 <P>
34976 NOTE: If PASSFILE caching is enabled, this does not disable it.
34977 That is a separate and independent feature.
34978 <UL>
34979 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34980 </UL><P>
34981 &lt;End of help on this topic&gt;
34982 </BODY>
34983 </HTML>
34984 ====== h_config_disable_password_file_saving =====
34985 <HTML>
34986 <HEAD>
34987 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></TITLE>
34988 </HEAD>
34989 <BODY>
34990 <H1>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></H1>
34991
34992 <P> This feature disables caching of passwords, even if your version of Alpine allows
34993 saving passwords. For MAC OS users saving passwords is done using the Apple Key Chain, for
34994 Windows users caching passwords is done using the internal Windows Credentials, and for
34995 other users this is done by using the password file. In this feature, the phrase
34996 &quot;password file&quot; is a misnomer and represents the way in which your system
34997 stores passwords.
34998
34999 <P>
35000 Specifically, this feature changes the behavior of Alpine when a login name and password combination
35001 for a specific server is not found in the password file. The default behavior is that
35002 Alpine will ask the user if they wish to save this information in the password file for future
35003 use. It is assumed that if a user created a password file it is because they intend
35004 to use it, but in some instances a user might want to save some passwords and not others.
35005 In this case, enabling this feature will make Alpine not add any more passwords to the
35006 password file and will only use the passwords that it already saved. If you wish to allow
35007 Alpine to save more passwords in the password file, disable this feature.
35008
35009 <P> Regardless of which method Alpine uses to store passwords, this is done in a secure
35010 way when compiled with OpenSSL or LibreSSL. This is very likely to be your version, and
35011 you can check this by reading the encryption features
35012 <A HREF="X-Alpine-Config:">supported</A> by Alpine.
35013
35014 <P>
35015 <UL>
35016 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35017 </UL><P>
35018 &lt;End of help on this topic&gt;
35019 </BODY>
35020 </HTML>
35021 ====== h_config_disable_kb_lock =====
35022 <HTML>
35023 <HEAD>
35024 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
35025 </HEAD>
35026 <BODY>
35027 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
35028
35029 If set, then the Keyboard Lock command is removed from the MAIN MENU.
35030 <P>
35031 <UL>
35032 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35033 </UL><P>
35034 &lt;End of help on this topic&gt;
35035 </BODY>
35036 </HTML>
35037 ====== h_config_disable_config_cmd =====
35038 <HTML>
35039 <HEAD>
35040 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
35041 </HEAD>
35042 <BODY>
35043 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
35044
35045 If set, then the Setup/Config screen is disabled.
35046 <P>
35047 <UL>
35048 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35049 </UL><P>
35050 &lt;End of help on this topic&gt;
35051 </BODY>
35052 </HTML>
35053 ====== h_config_allow_chg_from =====
35054 <HTML>
35055 <HEAD>
35056 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
35057 </HEAD>
35058 <BODY>
35059 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
35060
35061 This feature affects Alpine's handling of the &quot;From:&quot; header field
35062 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
35063 option.
35064 <P>
35065 If this feature is set then the From line can be changed just like
35066 all the other header fields that can be changed.
35067 This feature defaults to <EM>ON</EM>.
35068 <P>
35069 Even with this feature turned ON (the default) you will not be able
35070 to change the From header unless you add it to your list of
35071 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
35072 You may also want to change the
35073 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
35074 if you want the From header to always show up in the composer without
35075 having to type the Rich Headers command first.
35076 <P>
35077 Note that many sites restrict the use of this feature in order to
35078 reduce the chance of falsified addresses and misdirected mail.
35079 If you want to change the value of what gets included in the From header
35080 in messages you send
35081 look <A HREF="h_config_change_your_from">here</A> for a description.
35082 <P>
35083 <UL>
35084 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35085 </UL><P>
35086 &lt;End of help on this topic&gt;
35087 </BODY>
35088 </HTML>
35089 ====== h_config_disable_collate =====
35090 <HTML>
35091 <HEAD>
35092 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
35093 </HEAD>
35094 <BODY>
35095 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
35096
35097 This is a hard to understand feature that should only be used in rare cases.
35098 Normally, the C function call
35099 <P>
35100 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
35101 <P>
35102 is used by Alpine.
35103 If you want to try turning it off,
35104 setting this feature will turn it off.
35105 This part of the locale has to do with the sort order
35106 of characters in your locale.
35107 <P>
35108 <UL>
35109 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35110 </UL><P>
35111 &lt;End of help on this topic&gt;
35112 </BODY>
35113 </HTML>
35114 ====== h_config_quell_attach_extra_prompt =====
35115 <HTML>
35116 <HEAD>
35117 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
35118 </HEAD>
35119 <BODY>
35120 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
35121
35122 By default, when you attempt to view an attachment externally
35123 from the &quot;Attachment View&quot; screen, you are asked if you
35124 really want to view the selected attachment.
35125
35126 <P>
35127 If this feature is set, you will <B>not</B> be prompted to confirm
35128 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
35129 prompt. This feature was added for those wanting to preserve that
35130 behavior (along with
35131 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
35132
35133 <P>
35134 <UL>
35135 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35136 </UL><P>
35137 &lt;End of help on this topic&gt;
35138 </BODY>
35139 </HTML>
35140 ====== h_config_quell_attach_ext_warn =====
35141 <HTML>
35142 <HEAD>
35143 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
35144 </HEAD>
35145 <BODY>
35146 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
35147
35148 <P>
35149 This feature suppresses the extra warning you can get when trying
35150 to view an attachment for which there is no mime-type match.  Turning
35151 on this feature will just run the program according to extension
35152 instead of first warning the user that it will run according to the
35153 file's extension.
35154 <P>
35155 This feature can be used along side
35156 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
35157 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
35158 <P>
35159 <UL>
35160 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35161 </UL><P>
35162 &lt;End of help on this topic&gt;
35163 </BODY>
35164 </HTML>
35165 ====== h_config_mailcap_params =====
35166 <HTML>
35167 <HEAD>
35168 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
35169 </HEAD>
35170 <BODY>
35171 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
35172
35173 If set, this will allow mailcap named parameter substitution to occur
35174 in mailcap entries.
35175 By default, this is turned off to prevent security problems that may occur
35176 with some incorrect mailcap configurations.
35177 For more information, see RFC1524 and look for "named parameters" in the
35178 text of the RFC.
35179 <P>
35180 <UL>
35181 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35182 </UL><P>
35183 &lt;End of help on this topic&gt;
35184 </BODY>
35185 </HTML>
35186 ====== h_config_disable_shared =====
35187 <HTML>
35188 <HEAD>
35189 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
35190 </HEAD>
35191 <BODY>
35192 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
35193
35194 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
35195 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
35196 will be disabled.
35197 The reason this feature exists is because there are some implementations
35198 of system password lookup routines that are very slow when presented with
35199 a long loginname that does not exist.
35200 This feature could be set to prevent the delay at startup time when the
35201 names above are searched for in the password file.
35202 <P>
35203 <UL>
35204 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35205 </UL><P>
35206 &lt;End of help on this topic&gt;
35207 </BODY>
35208 </HTML>
35209 ====== h_config_hide_nntp_path =====
35210 <HTML>
35211 <HEAD>
35212 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
35213 </HEAD>
35214 <BODY>
35215 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
35216
35217 Normally the Path header that Alpine generates when posting to a newsgroup
35218 contains the name of the computer from which the message is being sent and
35219 the user name.
35220 Some believe that this information is used by spammers.
35221 If this feature is set, that information will be replaced with the text
35222 <P>
35223 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
35224 <P>
35225 instead.
35226 <P>
35227 It should be noted that many servers being connected to will still reveal
35228 the information that this feature attempts to protect.
35229 <P>
35230 <UL>
35231 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35232 </UL><P>
35233 &lt;End of help on this topic&gt;
35234 </BODY>
35235 </HTML>
35236 ====== h_config_no_bezerk_zone =====
35237 <HTML>
35238 <HEAD>
35239 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
35240 </HEAD>
35241 <BODY>
35242 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
35243
35244 POSIX mandates a timezone in UNIX mailbox format folder delimiters
35245 (the line that begins with From <SPACE>).
35246 Some versions of Berkeley mail have trouble with this, and don't recognize
35247 the line as a message delimiter.
35248 If this feature is set, the timezone will be left off the delimiter line.
35249 <P>
35250 <UL>
35251 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35252 </UL><P>
35253 &lt;End of help on this topic&gt;
35254 </BODY>
35255 </HTML>
35256 ====== h_config_quell_domain_warn =====
35257 <HTML>
35258 <HEAD>
35259 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
35260 </HEAD>
35261 <BODY>
35262 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
35263
35264 When your configuration is set up so that your domain name contains no dots,
35265 it is usually a configuration error.
35266 By default, Alpine will warn you about this when you start it up.
35267 You will see a warning message that looks like
35268
35269 <P>
35270 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
35271
35272 <P>
35273 If this feature is set, the warning is turned off.
35274 <P>
35275 <UL>
35276 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35277 </UL><P>
35278 &lt;End of help on this topic&gt;
35279 </BODY>
35280 </HTML>
35281 ====== h_config_quell_imap_env =====
35282 <HTML>
35283 <HEAD>
35284 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
35285 </HEAD>
35286 <BODY>
35287 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
35288
35289 In the MESSAGE INDEX screen, if the open folder is being accessed
35290 using IMAP, Alpine normally tries to paint the index lines on the screen
35291 as soon as the information arrives from the IMAP server.
35292 This means that the index information makes it onto the screen more quickly
35293 than it otherwise would.
35294 This sometimes results in behavior that bothers some users.
35295 For example, when paging to a new page of the index, it may be possible for
35296 the lines to be painted on the screen in a random order, rather than from
35297 top to bottom.
35298 <P>
35299
35300 Setting this feature causes Alpine to wait for all of the information
35301 to be gathered before it paints the index screen.
35302 Once it collects all of the information, the screen will be painted quickly
35303 from top to bottom.
35304 <P>
35305 <UL>
35306 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35307 </UL><P>
35308 &lt;End of help on this topic&gt;
35309 </BODY>
35310 </HTML>
35311 ====== h_config_quell_news_env =====
35312 <HTML>
35313 <HEAD>
35314 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
35315 </HEAD>
35316 <BODY>
35317 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
35318
35319 In the MESSAGE INDEX screen, if the open folder is being accessed
35320 using NNTP (News), Alpine normally tries to paint the index lines on the screen
35321 as soon as the information arrives from the NNTP server.
35322 This means that the index information makes it onto the screen more quickly
35323 than it otherwise would.
35324 This sometimes results in behavior that bothers some users.
35325 For example, when paging to a new page of the index, it may be possible for
35326 the lines to be painted on the screen in a random order, rather than from
35327 top to bottom.
35328 <P>
35329
35330 Setting this feature causes Alpine to wait for all of the information
35331 to be gathered before it paints the index screen.
35332 Once it collects all of the information, the screen will be painted quickly
35333 from top to bottom.
35334 <P>
35335 <UL>
35336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35337 </UL><P>
35338 &lt;End of help on this topic&gt;
35339 </BODY>
35340 </HTML>
35341 ====== h_config_quell_content_id =====
35342 <HTML>
35343 <HEAD>
35344 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
35345 </HEAD>
35346 <BODY>
35347 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
35348
35349 This feature changes the behavior of Alpine when sending messages.
35350 It is intended to work around a bug in Microsoft's Outlook XP mail user
35351 agent.
35352 As of this writing, Microsoft has acknowledged the bug but
35353 has not added it to the Knowledge Base.
35354 We have been told that there will be a post-SP1 hotfix for Outlook XP.
35355 This particular bug has bug fix number OfficeQFE:4781.
35356 The nature of the bug is that messages with attachments that
35357 contain a Content-ID header (which standard Alpine attachments do)
35358 do not show the attachment indicator (a paperclip) when viewed with
35359 Outlook XP.
35360 So the user has no indication that the message contains an attachment.
35361
35362 <P>
35363 If this feature is set then Alpine will remove most Content-ID headers
35364 before sending a message.
35365 If an attachment is of type MESSAGE, then the existing Content-ID headers
35366 inside the message will be left intact.
35367 This would only happen with Alpine if a message was forwarded as an attachment
35368 or if a message with a message attached was forwarded.
35369 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
35370 the Content-ID headers of the alternative parts will not be removed.
35371
35372 <P>
35373 Because the Content-ID header is a standard part of MIME it is possible
35374 that setting this feature will break something.
35375 For example, if an attachment has a Content-ID header that is necessary
35376 for the correct functioning of that attachment, it is possible that Alpine
35377 may remove that header when the attachment is forwarded.
35378 However, it seems fairly safe at this time.
35379
35380 <P>
35381 <UL>
35382 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35383 </UL><P>
35384 &lt;End of help on this topic&gt;
35385 </BODY>
35386 </HTML>
35387 ====== h_config_winpos_in_config =====
35388 <HTML>
35389 <HEAD>
35390 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
35391 </HEAD>
35392 <BODY>
35393 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
35394
35395 PC-Alpine only.
35396 <P>
35397
35398 Normally, PC-Alpine will store its window size and position in the
35399 Windows Registry.
35400 This is convenient if you want to use the same remote
35401 configuration from more than one PC.
35402 If you use multiple configuration files to start PC-Alpine, you may want
35403 to store the window size and position in the configuration file instead
35404 of in the Registry.
35405 Setting this feature causes the value to be stored in
35406 <A HREF="h_config_window_position">Window-Position</A>.
35407
35408 <P>
35409 <UL>
35410 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35411 </UL><P>
35412 &lt;End of help on this topic&gt;
35413 </BODY>
35414 </HTML>
35415 ====== h_config_quell_ssl_largeblocks =====
35416 <HTML>
35417 <HEAD>
35418 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
35419 </HEAD>
35420 <BODY>
35421 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
35422
35423 PC-Alpine only.
35424 <P>
35425 This feature changes the behavior of fetching messages
35426 and attachments so that the message data is fetched in chunks no larger
35427 than 12K bytes.
35428 This works around a bug in Microsoft's SSL/TLS support.
35429 Some versions of Microsoft SSL are not able to read full-sized (16K)
35430 SSL/TLS packets.
35431 Some servers will send such packets and this will
35432 cause PC-Alpine to crash with the error
35433
35434 <P>
35435 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
35436
35437 <P>
35438 Microsoft is aware of the problem and has developed a hotfix for it, it is
35439 discussed in article 300562 in the Microsoft Knowledge Base.
35440 <P>
35441 <UL>
35442 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35443 </UL><P>
35444 &lt;End of help on this topic&gt;
35445 </BODY>
35446 </HTML>
35447 ====== h_config_quell_partial =====
35448 <HTML>
35449 <HEAD>
35450 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
35451 </HEAD>
35452 <BODY>
35453 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
35454
35455 Partial fetching is a feature of the IMAP protocol.
35456 By default, Alpine
35457 will use partial fetching when copying the contents of a message or attachment
35458 from the IMAP server to Alpine.
35459 This means that the fetch will be done in many
35460 small chunks instead of one big chunk. The main benefit of this approach is
35461 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
35462 to stop the fetch early. In some cases partial fetching may cause a performance
35463 problem so that the fetching of data takes significantly longer when partial
35464 fetching is used. Turning on this feature will turn off partial fetching.
35465 <P>
35466 <UL>
35467 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35468 </UL><P>
35469 &lt;End of help on this topic&gt;
35470 </BODY>
35471 </HTML>
35472 ====== h_config_quell_personal_name_prompt =====
35473 <HTML>
35474 <HEAD>
35475 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
35476 </HEAD>
35477 <BODY>
35478 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
35479
35480 PC-Alpine only.  This feature quells the prompting for a
35481 <A HREF="h_config_pers_name">personal name</A>.  This
35482 prompt normally happens before composing a message, and only happens when
35483 there is no personal name already set.
35484 <P>
35485 <UL>
35486 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35487 </UL><P>
35488 &lt;End of help on this topic&gt;
35489 </BODY>
35490 </HTML>
35491 ====== h_config_quell_user_id_prompt =====
35492 <HTML>
35493 <HEAD>
35494 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
35495 </HEAD>
35496 <BODY>
35497 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
35498
35499 PC-Alpine only.  This feature quells the prompting for a
35500 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
35501 if the information can be obtained from the login name used
35502 to open the INBOX.  Normally, this prompt happens before composing
35503 a message, and only happens when there is no user-id already set
35504 in the configuration.
35505 <P>
35506 With this feature set, composing a message is only possible after
35507 establishing a connection to the INBOX.
35508 <P>
35509 <UL>
35510 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35511 </UL><P>
35512 &lt;End of help on this topic&gt;
35513 </BODY>
35514 </HTML>
35515 ====== h_config_save_aggregates =====
35516 <HTML>
35517 <HEAD>
35518 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
35519 </HEAD>
35520 <BODY>
35521 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
35522
35523 This feature will optimize an aggregate copy operation, if
35524 possible, by issuing a single IMAP <EM>COPY</EM> command with a
35525 list of the messages to be copied.
35526 This feature is set by default.
35527 This may reduce network traffic and elapsed time for the Save.
35528 <EM>However, many IMAP servers (including the UW IMAP server) do
35529 not preserve the order of messages when this optimization is applied.</EM>
35530 If this feature is not set,
35531 Alpine will copy each message individually and the order of the messages
35532 will be preserved.
35533 <P>
35534 <UL>
35535 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35536 </UL><P>
35537 &lt;End of help on this topic&gt;
35538 </BODY>
35539 </HTML>
35540 ====== h_config_use_system_translation =====
35541 <HTML>
35542 <HEAD>
35543 <TITLE>FEATURE: Use System Translation</TITLE>
35544 </HEAD>
35545 <BODY>
35546 <H1>FEATURE: Use System Translation</H1>
35547
35548 UNIX Alpine only.
35549 <P>
35550 Alpine normally uses its own internal software to convert between the multi-byte
35551 representation of characters and the Unicode representation of those
35552 same characters.
35553 It converts from the multi-byte characters your keyboard produces to Unicode,
35554 and from Unicode to the multi-byte characters your display expects.
35555 Alpine also uses its own internal software to decide how much space on
35556 the screen a particular Unicode character will occupy.
35557
35558 <P>
35559 Setting this feature tells Alpine to use the system-supplied routines to
35560 perform these tasks instead.
35561 In particular there are three tasks and three system routines that will
35562 be used for these tasks.
35563
35564 <P>
35565 To convert from multi-byte to Unicode the routine
35566
35567 <P>
35568 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
35569 <P>
35570
35571 is used.
35572 To convert from Unicode to multi-byte the routine
35573
35574 <P>
35575 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
35576 <P>
35577
35578 is used, if available, otherwise
35579
35580 <P>
35581 <CENTER><SAMP>wctomb</SAMP></CENTER>
35582 <P>
35583
35584 is used.
35585
35586 And to find the screen width a particular Unicode character will
35587 occupy the routine used is
35588
35589 <P>
35590 <CENTER><SAMP>wcwidth</SAMP></CENTER>
35591 <P>
35592
35593 This feature has been only lightly tested.
35594 The internal routines should normally be used unless you run into
35595 a problem that you think may be solved by using the system routines.
35596 Note that your environment needs to be set up for these
35597 routines to work correctly.
35598 In particular, the LANG or LC_CTYPE variable in your environment will
35599 need to be set.
35600
35601 <P>
35602 <UL>
35603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35604 </UL><P>
35605 &lt;End of help on this topic&gt;
35606 </BODY>
35607 </HTML>
35608 ====== h_config_suspend_spawns =====
35609 <HTML>
35610 <HEAD>
35611 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
35612 </HEAD>
35613 <BODY>
35614 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
35615
35616 This feature affects Alpine's behavior when process suspension is enabled
35617 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
35618 temporarily interact with the operating system command &quot;shell&quot;
35619 without
35620 quitting Alpine, and then subsequently resume the still-active Alpine session.
35621 <P>
35622
35623 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
35624 is set and subsequently the Ctrl-Z key
35625 is pressed, Alpine will normally suspend itself and return temporary control
35626 to Alpine's parent shell process.  However, if this feature is set, Alpine
35627 will instead create an inferior subshell process.  This is useful when the
35628 parent process is not intended to be used interactively.  Examples include
35629 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
35630 or via a menu system.<P>
35631
35632 Note that one typically resumes a suspended Alpine by entering the Unix
35633 &quot;fg&quot; command, but if this feature is set, it will be necessary to
35634 enter the &quot;exit&quot; command instead.
35635 <P>
35636 <UL>
35637 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35638 </UL><P>
35639 &lt;End of help on this topic&gt;
35640 </BODY>
35641 </HTML>
35642 ====== h_config_8bit_smtp =====
35643 <HTML>
35644 <HEAD>
35645 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
35646 </HEAD>
35647 <BODY>
35648 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
35649
35650 This feature affects Alpine's behavior when sending mail.
35651 By default, this feature is set.
35652 Internet standards
35653 require that all electronic mail messages traversing the global Internet
35654 consist of 7bit ASCII characters unless a pair of cooperating mail
35655 transfer agents explicitly agree to allow 8bit messages.  In general,
35656 then, exchanging messages in non-ASCII characters requires MIME encoding.
35657 <P>
35658 However, there are now Internet standards that allow for unencoded 8bit
35659 exchange of messages between cooperating systems.  When this feature is set
35660 Alpine will try to negotiate unencoded 8bit transmission during the
35661 sending process.  Should the negotiation fail, Alpine will fall back to its
35662 ordinary encoding rules.
35663 <P>
35664 Note, this feature relies on your system's mail transport agent or
35665 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
35666 having the negotiation mechanism introduced in
35667 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
35668 &quot;8BITMIME&quot;.
35669 <P>
35670 ESMTP allows for graceful migration to upgraded mail transfer agents, but
35671 it is possible that this feature might cause problems for some servers.
35672 <P><UL>
35673 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35674 </UL>
35675 <P>&lt;End of help on this topic&gt;
35676 </BODY>
35677 </HTML>
35678 ====== h_config_8bit_nntp =====
35679 <HTML>
35680 <HEAD>
35681 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
35682 </HEAD>
35683 <BODY>
35684 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
35685
35686 This feature affects Alpine's behavior when posting news.
35687
35688 <P>
35689
35690 The Internet standard for exchanging USENET news messages (RFC-1036)
35691 specifies that USENET messages should conform to Internet mail standards
35692 and contain only 7bit characters, but much of the news transport software
35693 in use today is capable of successfully sending messages containing 8bit
35694 characters.  Hence, many people believe that it is appropriate to send 8bit
35695 news messages without any MIME encoding.
35696
35697 <P>
35698
35699 Moreover, there is no Internet standard for explicitly negotiating 8bit
35700 transfer, as there is for Internet email.  Therefore, Alpine provides the
35701 option of posting unencoded 8bit news messages, though not as the default.
35702 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
35703 postings that contain 8bit characters.
35704
35705 <P>
35706
35707 Note, articles may cross a path or pass through news transport software
35708 that is unsafe or even hostile to 8bit characters.  At best this will only
35709 cause the posting to become garbled.  The safest way to transmit 8bit
35710 characters is to leave Alpine's MIME encoding turned on, but recipients
35711 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
35712 messages.
35713 <P>
35714 &lt;End of help on this topic&gt;
35715 </BODY>
35716 </HTML>
35717 ====== h_config_mark_for_cc =====
35718 <HTML>
35719 <HEAD>
35720 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
35721 </HEAD>
35722 <BODY>
35723 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
35724
35725 This feature affects Alpine's MESSAGE INDEX display.
35726 By default, a '+' is displayed in the first column if the
35727 message is addressed directly to you.
35728 When this feature is set and the message is not addressed to you, then a
35729 '-' character is displayed if the message is instead Cc'd directly
35730 to you.
35731
35732 <P>
35733 <UL>
35734 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35735 </UL><P>
35736 &lt;End of help on this topic&gt;
35737 </BODY>
35738 </HTML>
35739 ====== h_config_tab_uses_unseen =====
35740 <HTML>
35741 <HEAD>
35742 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
35743 </HEAD>
35744 <BODY>
35745 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
35746
35747 This feature affects Alpine's behavior when using the TAB
35748 <A HREF="h_common_nextnew">NextNew Command</A>
35749 to move from one folder to the next.
35750 Alpine's usual behavior is to search for folders
35751 with <EM>Recent</EM> messages in them.
35752 Recent messages are messages that have arrived since the last time the
35753 folder was opened.
35754
35755 <P>
35756 Setting this feature causes Alpine to search for <EM>Unseen</EM>
35757 messages instead of Recent messages.
35758 Unseen messages remain Unseen until you view them (or flag then as Seen with
35759 the <A HREF="h_common_flag">Flag Command</A>).
35760 Setting this feature allows you to locate messages you have not read
35761 instead of only recently received messages.
35762 When this feature is set, the feature
35763 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
35764 will have no effect, so the checking may be slower.
35765
35766 <P>
35767 Another reason why you might want to use this feature is that Alpine sometimes
35768 opens folders implicitly behind the scenes, and this clears the
35769 Recent status of all messages in the folder.
35770 One example where this happens is when Saving or filtering a
35771 message to another folder.
35772 If that message has some <A HREF="h_config_keywords">keywords</A>
35773 set, then because of some shortcomings
35774 in the IMAP specification, the best way to ensure that those keywords are
35775 still set in the saved copy of the message is to open the folder and
35776 set the keywords explicitly.
35777 Because this clears the Recent status of all messages in that folder the
35778 folder will not be found by the NextNew command unless this feature is set.
35779
35780 <P>
35781 &lt;End of help on this topic&gt;
35782 </BODY>
35783 </HTML>
35784 ====== h_config_tab_new_only =====
35785 <HTML>
35786 <HEAD>
35787 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
35788 </HEAD>
35789 <BODY>
35790 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
35791
35792 This feature affects Alpine's behavior when using the TAB key to move from
35793 one message to the next.  Alpine's usual behavior is to select the next
35794 unread message or message flagged as "Important".
35795
35796 <P>
35797
35798 Setting this feature causes Alpine to skip the messages flagged as important,
35799 and select unread messages exclusively.  Tab behavior when there are no
35800 new messages left to select remains unchanged.
35801 <P>
35802 &lt;End of help on this topic&gt;
35803 </BODY>
35804 </HTML>
35805 ====== h_config_warn_if_subj_blank =====
35806 <HTML>
35807 <HEAD>
35808 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
35809 </HEAD>
35810 <BODY>
35811 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
35812
35813 This feature affects Alpine's behavior when you send a message being
35814 composed.
35815 If this option is set, Alpine will check to see if the message about to be sent
35816 has a subject or not.
35817 If not, you will be asked if you want to send the message anyway.
35818 <P>
35819
35820 <UL>
35821 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35822 </UL><P>
35823 &lt;End of help on this topic&gt;
35824 </BODY>
35825 </HTML>
35826 ====== h_config_warn_if_fcc_blank =====
35827 <HTML>
35828 <HEAD>
35829 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
35830 </HEAD>
35831 <BODY>
35832 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
35833
35834 This feature affects Alpine's behavior when you send a message being
35835 composed.
35836 If this option is set, Alpine will check to see if the message about to be sent
35837 has an Fcc or not.
35838 If not, you will be asked if you want to send the message anyway.
35839 <P>
35840
35841 <UL>
35842 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35843 </UL><P>
35844 &lt;End of help on this topic&gt;
35845 </BODY>
35846 </HTML>
35847 ====== h_config_warn_if_no_to_or_cc =====
35848 <HTML>
35849 <HEAD>
35850 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
35851 </HEAD>
35852 <BODY>
35853 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
35854
35855 This feature affects Alpine's behavior when you send a message being
35856 composed.
35857 If this option is set, Alpine will check to see if the message about to be sent
35858 has either a To address, a Cc address, or a Newsgroup.
35859 If none of these is set,
35860 you will be asked if you want to send the message anyway.
35861 <P>
35862
35863 This feature is closely related to
35864 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
35865 Alpine will normally ask if you want to copy a message only to the Fcc.
35866 This feature also applies to cases where there is a Bcc but still no To, Cc,
35867 or Newsgroup.
35868 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
35869 message with only an Fcc, then you won't be asked about sending with
35870 a blank To and Cc and Newsgroups header even if this feature is set.
35871 Similarly, if you have already been asked if you want to send to the Fcc
35872 only and you have answered Yes, then you won't be asked again about sending with
35873 blank To, Cc, and Newsgroups headers even if this feature is set.
35874 <P>
35875
35876 <UL>
35877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35878 </UL><P>
35879 &lt;End of help on this topic&gt;
35880 </BODY>
35881 </HTML>
35882 ====== h_config_quell_dead_letter =====
35883 <HTML>
35884 <HEAD>
35885 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
35886 </HEAD>
35887 <BODY>
35888 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
35889
35890 This feature affects Alpine's behavior when you cancel a message being
35891 composed.  Alpine's usual behavior is to write the canceled message to
35892 a file named
35893 <!--chtml if pinemode="os_windows"-->
35894 &quot;DEADLETR&quot;,
35895 <!--chtml else-->
35896 &quot;dead.letter&quot; in your home directory,
35897 <!--chtml endif-->
35898 overwriting any previous message. Under
35899 some conditions (some routine), this can introduce a noticeable delay.
35900 Setting this feature will cause Alpine NOT to write canceled compositions
35901 into the file.
35902 <P>
35903 NOTE: Enabling this feature means NO record of canceled messages is
35904 maintained.
35905 <P>
35906 This feature affects the newer option
35907 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
35908 number of dead letter files to keep around.
35909 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
35910 <P>
35911 <UL>
35912 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35913 </UL><P>
35914 &lt;End of help on this topic&gt;
35915 </BODY>
35916 </HTML>
35917 ====== h_config_quell_beeps =====
35918 <HTML>
35919 <HEAD>
35920 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
35921 </HEAD>
35922 <BODY>
35923 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
35924
35925 This feature affects Alpine's behavior when it displays status message
35926 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
35927 will not affect the display of such messages, but will cause those that
35928 emit a beep to become silent.
35929
35930 <P>
35931 <UL>
35932 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35933 </UL><P>
35934 &lt;End of help on this topic&gt;
35935 </BODY>
35936 </HTML>
35937 ====== h_config_suppress_user_agent =====
35938 <HTML>
35939 <HEAD>
35940 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
35941 </HEAD>
35942 <BODY>
35943 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
35944
35945 If this feature is set then Alpine will not generate a
35946 <CODE>User-Agent</CODE> header in outgoing messages.
35947 <P>
35948 <UL>
35949 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35950 </UL><P>
35951 &lt;End of help on this topic&gt;
35952 </BODY>
35953 </HTML>
35954 ====== h_config_quell_lock_failure_warnings =====
35955 <HTML>
35956 <HEAD>
35957 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
35958 </HEAD>
35959 <BODY>
35960 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
35961
35962 This feature affects Alpine's behavior when it encounters a problem
35963 acquiring a mail folder lock.  Typically, a secondary file associated
35964 with the mail folder being opened is created as part of the locking
35965 process.  On some systems, such file creation has been administratively
35966 precluded by the system configuration.
35967 <P>
35968 Alpine issues a warning when such failures occur, which can become bothersome
35969 if the system is configured to disallow such actions.  Setting this
35970 feature causes Alpine to remain silent when this part of lock creation fails.
35971 <P>
35972 WARNING: systems that have been configured in a way that precludes locking
35973 introduce some risk of mail folder corruption when more than one program
35974 attempts to modify the mail folder.  This is most likely to occur to one's
35975 INBOX or other incoming message folder.
35976 <P>
35977 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
35978 <P>
35979 <UL>
35980 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35981 </UL><P>
35982 &lt;End of help on this topic&gt;
35983 </BODY>
35984 </HTML>
35985 ====== h_config_enable_role_take ======
35986 <HTML>
35987 <HEAD>
35988 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
35989 </HEAD>
35990 <BODY>
35991 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
35992
35993 Normally, the Take command takes addresses from a message and helps you
35994 put them into your Address Book.
35995 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
35996 you may find it useful
35997 to be able to Take information from a message's headers and put it into
35998 a new Rule.
35999 When this feature is set, you will be given an extra prompt that gives
36000 you the choice to Take into the Address Book or Take into a rule.
36001 <P><UL>
36002 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36003 </UL>
36004 <P>
36005 &lt;End of help on this topic&gt;
36006 </BODY>
36007 </HTML>
36008 ====== h_config_enable_take_export ======
36009 <HTML>
36010 <HEAD>
36011 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
36012 </HEAD>
36013 <BODY>
36014 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
36015
36016 Normally, the Take command takes addresses from a message and helps you
36017 put them into your Address Book.
36018 When this feature is set, you will be given an extra prompt that gives you
36019 the choice to Take addresses into a file instead of your Address
36020 Book.
36021 Only the user@domain_name part of the address is put in the file.
36022 <P><UL>
36023 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36024 </UL>
36025 <P>
36026 &lt;End of help on this topic&gt;
36027 </BODY>
36028 </HTML>
36029 ====== h_config_quell_folder_internal_msg ======
36030 <HTML>
36031 <HEAD>
36032 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
36033 </HEAD>
36034 <BODY>
36035 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
36036
36037 This feature determines whether or not Alpine will create
36038 &quot;pseudo messages&quot; in folders that are in standard Unix or
36039 MMDF format. <P>
36040
36041 Alpine will normally create these pseudo messages when they are not already
36042 present in a standard Unix or MMDF folder.  Their purpose is to record
36043 certain mailbox state data needed for correct IMAP and POP server
36044 operation, and also for Alpine to be able to mark messages as Answered when
36045 the Reply has been postponed.<P>
36046
36047 Sites that do not use IMAP/POP for remote mail access, and that need to
36048 support mail tools that are adversely affected by the presence of the
36049 pseudo-messages (e.g. some mail notification tools) may enable this
36050 feature to tell Alpine not to create them.  Note that Alpine's
36051 &quot;Answered&quot; flag
36052 capability will be adversely affected if this is done.<P>
36053
36054 Note too that, even if this feature is enabled, Alpine will not remove
36055 pseudo-messages when it encounters them (e.g. those created by UW's imapd
36056 or ipopd servers.) This feature has no effect on folders that are not in
36057 standard Unix or MMDF format, as pseudo-messages are not needed in the
36058 other formats to record mailbox state information.
36059 <P><UL>
36060 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36061 </UL>
36062 <P>
36063 &lt;End of help on this topic&gt;
36064 </BODY>
36065 </HTML>
36066 ====== h_config_mulnews_as_typed ======
36067 <HTML>
36068 <HEAD>
36069 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
36070 </HEAD>
36071 <BODY>
36072 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
36073
36074 This feature will be of little use to most users.
36075 It has no effect unless the feature
36076 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
36077 is set.
36078
36079 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
36080 then the setting of this feature may have an effect on the names of the
36081 newsrc files used.
36082 Normally, the name of the news server will be canonicalized before it is
36083 used in the newsrc file name.
36084 For example, if you type the news server name
36085
36086 <P>
36087 <CENTER><SAMP>servername</SAMP></CENTER>
36088 <P>
36089
36090 it is likely that the canonical name will be something like
36091
36092 <P>
36093 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
36094 <P>
36095
36096 Or it may be the case that
36097
36098 <P>
36099 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
36100 <P>
36101
36102 is really an alias (a DNS CNAME) for
36103
36104 <P>
36105 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
36106 <P>
36107
36108 If this feature is not set, then the canonicalized names will be used.
36109 If this feature is set, then the name you typed in (or put in your
36110 configuration) will be used.
36111
36112 <P><UL>
36113 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36114 </UL>
36115 <P>
36116 &lt;End of help on this topic&gt;
36117 </BODY>
36118 </HTML>
36119 ====== h_config_quell_empty_dirs ======
36120 <HTML>
36121 <HEAD>
36122 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
36123 </HEAD>
36124 <BODY>
36125 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
36126
36127 This feature causes Alpine to remove from the display any directories
36128 that do not contain at least one file or directory.  This can be useful
36129 to prevent overly cluttered folder lists when a collection is stored on
36130 a server that treats all names as both a folder and a directory.
36131
36132 <P>
36133 Note, enabling this feature can cause surprising behavior!  For example,
36134 you can still use Add to create a directory, but unless you immediately
36135 enter that directory and create a folder, that newly created directory
36136 may not be displayed next time you enter the folder list.
36137
36138 <P>
36139 The description above is not quite correct.
36140 Only directories which potentially may hold messages are hidden if empty.
36141 That is, a directory which is really just a directory and is not selectable
36142 as a folder will not be hidden.
36143 Such directories can occur on servers that treat most names as both a folder
36144 and a directory.
36145 These directories are typically created implicitly when a folder is created
36146 inside a directory that does not yet exist.
36147
36148 <P>
36149 <UL>
36150 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36151 </UL><P>
36152 &lt;End of help on this topic&gt;
36153 </BODY>
36154 </HTML>
36155 ====== h_config_termcap_wins =====
36156 <HTML>
36157 <HEAD>
36158 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
36159 </HEAD>
36160 <BODY>
36161 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
36162
36163 This feature may affect Alpine's low-level input routines.  Termcap (or
36164 terminfo, depending on how your copy of Alpine was compiled and linked)
36165 is the name of the database that describes terminal capabilities.  In
36166 particular, it describes the sequences of characters that various keys
36167 will emit.
36168
36169 <P>
36170 An example would be the Up Arrow key on the keyboard.  Up
36171 Arrow is not a distinct character on most Unix systems.  When you press
36172 the Up Arrow key a short sequence of characters are produced.  This
36173 sequence is supposed to be described in the termcap database by the
36174 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
36175 are using terminfo instead of termcap).
36176
36177 <P>
36178 By default, Alpine defines some terminal
36179 escape sequences that are commonly used.  For example, the sequence
36180 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
36181 &quot;ESC&nbsp;[&nbsp;A&quot;
36182 is also recognized as an Up Arrow key.  These are chosen because common
36183 terminals like VT100's or ANSI standard terminals produce these
36184 sequences when you press the Up Arrow key.
36185
36186 <P>
36187 If your system's termcap
36188 (terminfo) database assigns some other function to the sequence
36189 &quot;ESC&nbsp;O&nbsp;A&quot;
36190 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
36191 database assigns a sequence that doesn't begin with an escape
36192 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
36193 This usually works fine
36194 because most terminals emit the escape sequences that Alpine has defined
36195 by default.  We have also found that it is usually better to have these
36196 defaults take precedence over the definitions contained in the database
36197 because the defaults are more likely to be correct than the database.
36198
36199 <P>
36200 There are some terminals where this breaks down.  If you want Alpine to
36201 believe the definitions given in your termcap (terminfo) database in
36202 preference to the defaults the Alpine itself sets up, then you may turn
36203 this feature on.  Then, sequences of characters that are defined in
36204 both termcap (terminfo) and in Alpine's set of defaults will be
36205 interpreted the way that termcap (terminfo) says they should be
36206 interpreted.  Also, if your terminal capabilities database assigns a
36207 sequence that doesn't begin with escape, it will not be ignored.
36208
36209 <P>
36210 <UL>
36211 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36212 </UL><P>
36213 &lt;End of help on this topic&gt;
36214 </BODY>
36215 </HTML>
36216 ====== h_config_cruise_mode =====
36217 <HTML>
36218 <HEAD>
36219 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
36220 </HEAD>
36221 <BODY>
36222 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
36223
36224 This feature affects Alpine's behavior when you hit the
36225 &quot;Space&nbsp;Bar&quot; at
36226 the end of a displayed message.  Typically, Alpine complains that the end
36227 of the text has already been reached.  Setting this feature causes such
36228 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
36229 taking you to the next &quot;interesting&quot; message,
36230 or scanning ahead to the
36231 next incoming folder with &quot;interesting&quot; messages.
36232
36233 <P>
36234 <UL>
36235 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36236 </UL><P>
36237 &lt;End of help on this topic&gt;
36238 </BODY>
36239 </HTML>
36240 ====== h_config_cruise_mode_delete =====
36241 <HTML>
36242 <HEAD>
36243 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
36244 </HEAD>
36245 <BODY>
36246 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
36247
36248 This feature modifies the behavior of Alpine's
36249 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
36250 Setting this feature causes Alpine to implicitly delete read
36251 messages when it moves on to display the next &quot;interesting&quot; message.
36252 <P>
36253 NOTE: Beware when enabling this feature AND the
36254 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
36255 feature.
36256 <P>
36257 <UL>
36258 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36259 </UL><P>
36260 &lt;End of help on this topic&gt;
36261 </BODY>
36262 </HTML>
36263 ====== h_config_slash_coll_entire =====
36264 <HTML>
36265 <HEAD>
36266 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
36267 </HEAD>
36268 <BODY>
36269 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
36270
36271 The slash (/) command is available from the MESSAGE INDEX screen when
36272 the folder is sorted by either Threads or OrderedSubject, and the
36273 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
36274 is set to something other than &quot;none&quot;.
36275 Normally, the slash command Collapses or Expands the subthread that
36276 starts at the currently highlighted message, if any.
36277 If this option is set, then the slash command Collapses or Expands the
36278 <EM>entire</EM> current thread instead of just the subthread.
36279 The current thread is simply the top-level thread that contains the
36280 current message.
36281
36282 <P>
36283 <UL>
36284 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36285 </UL><P>
36286 &lt;End of help on this topic&gt;
36287 </BODY>
36288 </HTML>
36289 ====== h_config_color_thrd_import =====
36290 <HTML>
36291 <HEAD>
36292 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
36293 </HEAD>
36294 <BODY>
36295 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
36296
36297 This option affects only the THREAD INDEX screen.
36298 Whether or not you ever see a THREAD INDEX screen depends on the setting
36299 of the configuration option
36300 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
36301 and on the sort order of the index.
36302
36303 <P>
36304 If a message within a thread is flagged as Important
36305 and this option is set, then
36306 the entire line in the THREAD INDEX will be colored the color of the
36307 Index-important Symbol, which can be set using the
36308 <A HREF="h_color_setup">Setup Kolor</A> screen.
36309
36310 <P>
36311 <UL>
36312 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36313 </UL><P>
36314 &lt;End of help on this topic&gt;
36315 </BODY>
36316 </HTML>
36317 ====== h_config_allow_goto =====
36318 <HTML>
36319 <HEAD>
36320 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
36321 </HEAD>
36322 <BODY>
36323 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
36324
36325 This feature modifies the behavior of Alpine's file browser.  Setting this
36326 feature causes Alpine to offer the "G Goto" command in the file browser.
36327 That is the default.
36328
36329 <P>
36330
36331 The Goto command allows you to explicitly type in the desired directory.
36332 <P>
36333 &lt;End of help on this topic&gt;
36334 </BODY></HTML>
36335 ====== h_config_add_ldap =====
36336 <HTML>
36337 <HEAD>
36338 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
36339 </HEAD>
36340 <BODY>
36341 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
36342
36343 If both the Directory option
36344 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
36345 and this feature are set,
36346 then when an implicit directory lookup is done from the
36347 composer you will automatically be prompted to add the result of the
36348 directory lookup to your address book.
36349 <P>
36350 <UL>
36351 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36352 </UL><P>
36353 &lt;End of help on this topic&gt;
36354 </BODY>
36355 </HTML>
36356 ===== h_patterns_compat_behavior =====
36357 <HTML>
36358 <HEAD>
36359 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
36360 </HEAD>
36361 <BODY>
36362 <H1>Rules Behavior Changes in Pine 4.50</H1>
36363
36364 In Alpine, Rules that contain unrecognized elements
36365 are ignored.
36366 In most cases, the unrecognized elements will be something that was
36367 added as a new Rules feature in a later version of Alpine.
36368 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
36369 ignore rules that contained unrecognized elements.
36370 For example, a new element of Rules that was added in Pine 4.50 is
36371 Age interval.
36372 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
36373 all messages older than a week red.
36374 Now, if you run Pine 4.44 using that same configuration file, it will not
36375 recognize the Age interval and so will just ignore it.
36376 That means that all messages will match that rule so all messages will
36377 be colored red when using Pine version 4.44.
36378
36379 <P>
36380 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
36381 However, since the behavior still exists in versions prior to Pine 4.50 and
36382 since Filtering is a potentially destructive operation, another measure
36383 was taken to attempt to avoid unintentional Filtering of messages.
36384 The first time that you run Alpine or a Pine that is version 4.50 or greater,
36385 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
36386 will be copied to a new Filters configuration variable
36387 with a different name (&quot;Patterns-Filters2&quot;).
36388 From then on, Alpine will continue to use the new
36389 variable.
36390 Of course, Pine version 4.44 or lower will continue to use the old
36391 variable.
36392 That means that if you are using Alpine
36393 and also using a version of Pine that is older than 4.50, they will not
36394 share the configuration information about Filters.
36395 If you make a change in one version you won't see it in the other version.
36396
36397 <P>
36398 Since Scoring can be used to trigger Filtering, the same thing has been
36399 done for Score rules.
36400 The old configuration variable name is (&quot;Patterns-Scores&quot;)
36401 and the new name is (&quot;Patterns-Scores2&quot;).
36402 The same is not true of Role, Indexcolor, and Other rules that are
36403 thought to be less harmful when a mistake is made.
36404
36405 <P>
36406 &lt;End of help on this topic&gt;
36407 </BODY>
36408 </HTML>
36409 ======= h_config_filt_opts_sentdate =======
36410 <HTML>
36411 <HEAD>
36412 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
36413 </HEAD>
36414 <BODY>
36415 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
36416
36417 By default, the Age interval of a Pattern uses a message's time of
36418 arrival to compute the age of the message.
36419 If this feature is set, the date in the message's Date header will
36420 be used instead.
36421 <P>
36422 &lt;End of help on this topic&gt;
36423 </BODY>
36424 </HTML>
36425 ======= h_config_filt_opts_notdel =======
36426 <HTML>
36427 <HEAD>
36428 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
36429 </HEAD>
36430 <BODY>
36431 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
36432
36433 If this option is set then a message will be moved into the
36434 specified folder only if it is not marked for deletion.
36435 This is useful if you have multiple Alpine sessions running
36436 simultaneously and you don't want messages to be filtered into a
36437 folder more than once.
36438 It is also useful if you want to filter
36439 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
36440 This method is not foolproof.
36441 There may be cases where a message
36442 gets marked deleted and so it is never filtered into the folder.
36443 For example, if you deleted it in another Alpine session or another mail
36444 program that didn't use the filtering rule.
36445 <P>
36446 This option has no effect if the Filter Action is not set to Move.
36447 <P>
36448 &lt;End of help on this topic&gt;
36449 </BODY>
36450 </HTML>
36451 ======= h_config_filt_opts_nonterm =======
36452 <HTML>
36453 <HEAD>
36454 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
36455 </HEAD>
36456 <BODY>
36457 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
36458
36459 If this option is set then this is a non-terminating rule.
36460 Usually, for each message, Alpine searches through the Filter Rules until
36461 a match is found and then it performs the action associated with that rule.
36462 Rules following the match are not considered.
36463 If this option is set then the search for matches will continue at the next
36464 rule.
36465 <P>
36466 If a non-terminating rule matches then the actions associated with
36467 that rule, except for any implied deletion of the message, are performed
36468 before the match for the next rule is checked.
36469 For example, if the non-terminating rule sets the Important status, then that
36470 status will be set when the next rule is considered.
36471 However, if the non-terminating rule Moves the message, the message will
36472 actually be copied instead of copied and deleted so that it is still there
36473 for the next rule.
36474 A moved message is deleted after all the relevant rules have been checked.
36475 The name of the &quot;Move&quot; action is confusing in this case because
36476 a single message can be moved to more than one folder.
36477 It turns the Move into a Copy instead, but it is still followed by a deletion
36478 at the end.
36479 <P>
36480 This option may be useful if you want to have a single message filtered to
36481 two different folders because it matches two different Patterns.
36482 For example, suppose you normally filter messages to a particular mailing
36483 list into one folder, and messages addressed directly to you into a second
36484 folder.
36485 If a message is sent to both you and the list (and you can tell that by
36486 looking at the headers of the message) this option may give you a convenient
36487 way to capture a copy to each folder.
36488 (It may also cause you to capture two copies to each folder,
36489 depending on whether your mail system delivers one or two copies of the
36490 message to you and on how the list works.)
36491 <P>
36492 &lt;End of help on this topic&gt;
36493 </BODY>
36494 </HTML>
36495 ====== h_command_external_browser =====
36496 <HTML>
36497 <HEAD>
36498 <TITLE>The External Browser Command</TITLE>
36499 </HEAD>
36500 <BODY>
36501 <H1>The External Browser Command</H1>
36502
36503 <P>
36504 A new command was added to Alpine that allows users to send HTML messages to be displayed
36505 by a web browser. This is helpful when a user wants to see images in the context of the
36506 message, or get a better display of the message than Alpine provides.
36507
36508 <P>
36509 The simplest way to use this command is to do as follows. While reading a message,
36510 press the &quot;V&quot; to go to the <A href="h_attachment_screen">ATTACHMENT SCREEN</A>.
36511 In that screen move the cursor until it is on top of a TEXT/HTML attachment and press the
36512 &quot;X&quot; key. This will make Alpine launch the browser you have configured for
36513 in the <a href="h_config_browser"><!--#echo var="VAR_url-viewers"--></a> variable, and
36514 you should be able to read the message in your browser, as well as in Alpine.
36515
36516 <P> If the message you sent to your browser has inline images, then the images attached to
36517 the message that are necessary for the display of the message are also sent to the browser
36518 for its display.
36519
36520 <P> The text that follows will explain more details about this command, and is only
36521 recommended for more advanced users.
36522
36523 <h1><CENTER>Displaying Images</CENTER></h1>
36524
36525 <P> First, we will talk about displaying images in an HTML file. Typically, HTML images
36526 are displayed as the result of some specific code of the form
36527 <center>
36528 <PRE>
36529 &lt;img src=&quot;...&quot;&gt;,
36530 </PRE>
36531 </center>
36532 where the text between the quotes tells Alpine how to find the image.
36533 If the source of the image is internal to the message, Alpine passes that image to the
36534 browser. Otherwise Alpine erases the link to the image. This is done so that
36535 you can be protected from a bad use of external images. Images can be used to track
36536 that you read the message, or your location, devices you own, etc.. Since Alpine does
36537 not open images in any messages, your
36538 privacy is always protected this way. Therefore, when you do not pass the links to
36539 external images to a browser, your privacy is being protected. However, doing this
36540 might make the message not be displayed correctly, since when the message was
36541 created the images were part of the formatted message, and not having images might make
36542 this formatting look awkward.
36543
36544 <P> If you would like that Alpine display all images, regardless of their source, and
36545 regardless of the sender, then you need to disable the feature <a
36546 href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>.
36547 The message will display as intended, but you will leak information to the sender of the
36548 message, as well as to your internet service provider, which could be your employer, or
36549 school, etc.
36550
36551 <P> Alpine provides an alternative mechanism to either send all links to the images to the
36552 external browser or to send only those that are attached to the message you are trying to
36553 display. In order to use this mechanism you must first enable
36554 <a href="h_config_enable_view_attach"><!--#echo var="FEAT_enable-msg-view-attachments"--></a>.
36555 This allows Alpine to add direct links to each attachments. If you want to send an HTML
36556 attachment to an external browser, you would place the cursor over the attachment and press
36557 the &quot;Return&quot; or &quot;Enter&quot; key to open the attachment. When you do that
36558 you will see a prompt and menu which says
36559
36560 <pre>
36561 View selected Attachment  ?
36562 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
36563 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
36564 </pre>
36565
36566 <P>In order to send this message to an external browser, you would press the &quot;X&quot;
36567 key. This will change the prompt and menu to
36568
36569 <pre>
36570 View selected Attachment using external viewer including inline images only ?
36571 &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
36572 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I All images
36573 </pre>
36574
36575 <P>This is telling you that if you answer &quot;Yes&quot; to this question, and external
36576 browser will be used to send this messages, and only inline images, that is, those attached
36577 in the message will be sent to the browser. If you would like to send all images in
36578 this case, the menu tells you that you must press the &quot;I&quot; key. Pressing
36579 that key changes the prompt and menu to
36580
36581 <pre>
36582 View selected Attachment using external viewer including all images ?
36583 &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
36584 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I Inline imgs
36585 </pre>
36586
36587 <P>and as you can see the prompt says that if you press &quot;Yes&quot; then the message
36588 will be sent to the browser including the source of all images, including those in
36589 external servers. Notice that the &quot;X&quot; command now is a toggle. If you
36590 were to press it now, you would return to the original prompt,
36591
36592 <pre>
36593 View selected Attachment  ?
36594 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
36595 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
36596 </pre>
36597
36598 <P>which means that if you answer &quot;Yes&quot; at this time your message would not
36599 be sent to your external browser for display, unless you have configured a mailcap
36600 entry to display HTML files.
36601
36602 <P> One of the lessons of this discussion is that if you never press the &quot;X&quot;
36603 command in the ATTACHMENT SCREEN, and you never press the &quot;X&quot; command when
36604 launching a viewer for an attachment in the MESSAGE TEXT screen, you will never use this
36605 mechanism, and Alpine will resort to your already configured mechanisms to open HTML
36606 text.This means you can live your life without worrying that Alpine will do anything
36607 different because of this new feature. You do not have to use it, but if you do, you should
36608 know the risks and advantages and decide when and how to use it.
36609
36610 <h1><CENTER>Saving HTML Messages to Disk</CENTER></h1>
36611
36612 <P>
36613 No matter what your reason to send a message to an external web browser is, Alpine must
36614 write your message to a file (and also all related inline images), and point your browser
36615 to open that file. Alpine saves all your messages and auxiliary images in a subdirectory
36616 of the ~/.alpine-html directory in unix-like Alpine, or the alpine-html folder in your home
36617 directory in PC-Alpine. If Alpine cannot access these directories, or create folders
36618 in them, then the full mechanism described above will fail, and you will not be able
36619 to send messages to an external browser for display.
36620
36621 <P>
36622 Unfortunately browsers do not remove the file that Alpine created, nor the images
36623 that Alpine saved in order to display this message, so if you use this mechanism often
36624 you will create many directories and files which the browser will not remove. Alpine
36625 will remove these files when you exit Alpine. Any temporary directory that Alpine
36626 created that has existed for longer than 10 minutes will be automatically erased.
36627 Alpine also erases these directories upon exiting.
36628
36629 <P>
36630 When Alpine creates a directory to house the files associated to a message that will
36631 pass to an external browser, it tries to delete that directory later on, according to
36632 the discussion above. What this means is that you should consider the contents of the
36633 ~/.alpine-html directory in unix-like Alpine and the alpine-html folder in PC-Alpine
36634 as temporary, and not rely on their existence. If you attempt to save files in one of
36635 these directories, chances are your data will be deleted by Alpine. Since deleting is
36636 a destructive action,
36637 every session of Alpine that you have open will only attempt to remove the directories
36638 it created, with their content in them. If this operation fails, Alpine will not try
36639 to investigate, nor will report to you, why the operation failed. Therefore, users
36640 should periodically check their html directory to see if there is content there that
36641 they wish to delete.
36642
36643 <P>
36644 <UL>
36645 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36646 </UL><P>
36647 &lt;End of help on this topic&gt;
36648 </BODY>
36649 </HTML>
36650 ===== h_mainhelp_smime ======
36651 <HTML>
36652 <HEAD>
36653 <TITLE>S/MIME Overview</TITLE>
36654 </HEAD>
36655 <BODY>
36656 <H1>S/MIME Overview</H1>
36657
36658 S/MIME is a standard for the public key encryption and signing of email.
36659 UNIX Alpine contains a basic implementation of S/MIME based on
36660 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries. The
36661 same support can be provided using the
36662 <A HREF="http://www.libressl.org/">LibreSSL</A> libraries. The
36663 support for S/MIME in PC-Alpine is fully based on the LibreSSL libraries.
36664 To check if this version of Alpine supports S/MIME look at
36665 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
36666 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
36667 <P>
36668 Some limitations:
36669 <UL>
36670    <LI> There is no provision for checking for CRLs
36671         (Certificate Revocation Lists) in Alpine.
36672    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
36673    <LI> There is no mechanism available for feeding either an entire incoming
36674         or an entire outgoing message to an external
36675         filter and using that external filter to do S/MIME or PGP processing.
36676    <LI> Because the implementation currently uses OpenSSL, there is only a very
36677         limited integration with the Mac OS Keychain (the storing and access of
36678         public certificates).
36679 </UL>
36680 <P>
36681 The S/MIME configuration screen is reached by going to the Main Menu and typing
36682 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
36683 <P>
36684
36685 <H2>S/MIME BASICS</H2>
36686
36687 In order to digitally sign messages you send you must have a public/private key-pair.
36688 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
36689 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
36690 users or a company which provides certificates for its workers.
36691 These certificates are bound to an email address, so the identity being verified is the
36692 email address not a person's name.
36693 <P>
36694 Mail is signed by using the sender's private key, which only the owner of the private key
36695 has access to.
36696 The signature is verified using the signer's public key, which anyone can
36697 have access to.
36698 With Alpine, the first time you receive a signed message the public key of the
36699 sender will be stored for future use.
36700
36701 <P>
36702 Mail is encrypted using the recipient's public key and decrypted by
36703 the recipient with their private key.
36704
36705 <P>
36706 You need a key of your own in order to sign outgoing messages and to have others
36707 encrypt messages sent to you.
36708 You do not need a key of your own to verify signed messages sent by others or to
36709 encrypt messages sent to others.
36710
36711 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
36712
36713 By default UNIX Alpine stores the certificates it uses in a directory in your
36714 home directory.
36715 The directory name is
36716 <P>
36717 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
36718 <P>
36719 For PC-Alpine, the equivalent directory is called
36720 <CENTER><SAMP>alpine-smime</SAMP></CENTER>
36721 and is also located under your home directory.
36722 <P>
36723 Within that directory are three subdirectories.
36724 Each of the three subdirectories contains files with PEM-encoded contents,
36725 the default format for OpenSSL.
36726 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
36727 The files within that directory have names that are email addresses with the
36728 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
36729 An example filename is
36730 <P>
36731 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
36732 <P>
36733 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
36734 your private key.
36735 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
36736 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
36737 Authorities that you want to trust but that aren't contained in the set of system CAs.
36738 Those files may have arbitrary names as long as they end with the
36739 suffix &quot;<SAMP>.crt</SAMP>&quot;.
36740
36741 <H2>HOW TO SIGN AND ENCRYPT</H2>
36742
36743 If you have a certificate you may sign outgoing messages.
36744 After typing the Ctrl-X command to send a message you will see the prompt
36745 <P>
36746 <CENTER><SAMP>Send message?</SAMP></CENTER>
36747 <P>
36748 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
36749 Typing the &quot;G&quot; command will change the prompt to
36750 <P>
36751 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
36752 <P>
36753 Typing the &quot;E&quot; command will change the prompt to
36754 <P>
36755 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
36756 <P>
36757 You may even type both to get
36758 <P>
36759 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
36760 <P>
36761
36762 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
36763
36764 The reading of a signed message should not require any special action on
36765 your part.
36766 There should be an editorial addition at the start of the message which
36767 says either
36768 <P>
36769 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
36770 <P>
36771 or
36772 <P>
36773 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
36774 <P>
36775 If an encrypted message is sent to you the encrypted text will not
36776 be shown.
36777 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
36778 you are viewing the message) and supply your passphrase when asked.
36779 <P>
36780 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
36781 which gives you some information about the certificate used to sign or encrypt the message.
36782
36783 <H2>MISCELLANEOUS</H2>
36784
36785 If you have access to a private certificate in the PKCS12 format, which
36786 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
36787 use the following commands to generate private keys, public and certificate
36788 authorities certificates. In the examples below, we assume that the
36789 certificate in the p12 format is called &quot;certificate.p12&quot;, and
36790 that your email address is &quot;your@address.com&quot;.
36791
36792 <P>
36793 In order to create a private key use the command
36794 <P>
36795 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
36796 <P>
36797 In order to create a public certificate use the command
36798 <P>
36799 <CENTER><SAMP>
36800 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
36801 </SAMP></CENTER>
36802 <P>
36803 In order to create a certificate authority certificate use the command
36804 <P>
36805 <CENTER><SAMP>
36806 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
36807 </SAMP></CENTER>
36808
36809 <P> If the previous command produces an empty file, it means that the
36810 certificate authority was not included in the .p12 file, so you will have
36811 to get it from some other sources. You will need these certificates, so
36812 that you can validate correctly signatures.
36813
36814 <P>
36815 After you have exported these certificates and keys, you can  use the import
36816 command in Alpine, from the S/MIME configuration screen,
36817 to import these certificates into Alpine. They will be available for use
36818 as soon as you import them.
36819 <P>
36820 &lt;End of help on this topic&gt;
36821 </BODY>
36822 </HTML>
36823 ====== h_config_smime_pubcertdir =====
36824 <HTML>
36825 <HEAD>
36826 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
36827 </HEAD>
36828 <BODY>
36829 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
36830
36831 <P>
36832 If the option
36833 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36834 is set then this option will have no effect.
36835 <P>
36836 Normally, Public Certificates for use with S/MIME will be stored in the directory
36837 which is the value of this option.
36838 Those certificates will be stored in PEM format, one certificate per file.
36839 The name of the file for the certificate corresponding to
36840 <P>
36841 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36842 <P>
36843 should be
36844 <P>
36845 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
36846 <P>
36847 For example, a file for user@example.com would be in the file
36848 <P>
36849 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
36850 <P>
36851 in this directory.
36852 <P>
36853 Use the Setup/SMIME screen to modify this variable.
36854 <P>
36855 Typically, the public certificates that you have will come from S/MIME signed
36856 messages that are sent to you.
36857 Alpine will extract the public certificate from the signed message and store
36858 it in the certificates directory.
36859 These PEM format public certificates look something like:
36860 <PRE>
36861 -----BEGIN CERTIFICATE-----
36862 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
36863 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
36864 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
36865 ...
36866 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
36867 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
36868 -----END CERTIFICATE-----
36869 </PRE>
36870 <P>
36871 <UL>
36872 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36873 </UL><P>
36874 <P>
36875 <UL>
36876 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36877 </UL><P>
36878 &lt;End of help on this topic&gt;
36879 </BODY>
36880 </HTML>
36881 ====== h_config_smime_pubcertcon =====
36882 <HTML>
36883 <HEAD>
36884 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
36885 </HEAD>
36886 <BODY>
36887 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
36888
36889 <P>
36890 If this option is set it will be used instead of
36891 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
36892 <P>
36893 This option gives you a way to store certificates remotely on an IMAP server
36894 instead of storing the certificates one per file locally.
36895 In order to do that you just give this option a remote folder name for a folder
36896 which does not yet exist.
36897 The name is similar to the name you might use for a remote configuration file.
36898 A remote folder name might look something like:
36899 <P>
36900 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
36901 <P>
36902 See
36903 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36904 about the syntax of folder names.
36905 <P>
36906 Use the Setup/SMIME screen to modify this variable.
36907 <P>
36908 <UL>
36909 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36910 </UL><P>
36911 <P>
36912 <UL>
36913 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36914 </UL><P>
36915 &lt;End of help on this topic&gt;
36916 </BODY>
36917 </HTML>
36918 ====== h_config_smime_privkeydir =====
36919 <HTML>
36920 <HEAD>
36921 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
36922 </HEAD>
36923 <BODY>
36924 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
36925
36926 <P>
36927 In order to sign outgoing S/MIME messages you will need a
36928 personal digital ID certificate.
36929 You will usually get such a certificate from a certificate authority such as
36930 Thawte or CAcert.
36931 (In order to encrypt outgoing messages you don't need a personal digital ID, you
36932 need the public certificate of the recipient instead.)
36933 If the option
36934 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
36935 is set then this option will have no effect.
36936 <P>
36937 Normally, Private Keys for use with S/MIME will be stored in the directory
36938 which is the value of this option.
36939 Those certificates will be stored in PEM format, one certificate per file.
36940 The name of the file for the certificate corresponding to your
36941 <P>
36942 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36943 <P>
36944 should be
36945 <P>
36946 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
36947 <P>
36948 For example, if your address is user@example.com the name of the file would be
36949 <P>
36950 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
36951 <P>
36952 in this directory.
36953 <P>
36954 Use the Setup/SMIME screen to modify this variable.
36955 <P>
36956 Typically, the private key that you have will come from a Certificate
36957 Authority.
36958 The private key should be stored in a PEM format file that
36959 looks something like:
36960 <PRE>
36961 -----BEGIN RSA PRIVATE KEY-----
36962 Proc-Type: 4,ENCRYPTED
36963 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
36964
36965 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
36966 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
36967 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
36968 ...
36969 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
36970 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
36971 -----END RSA PRIVATE KEY-----
36972 </PRE>
36973 <P>
36974 <UL>
36975 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36976 </UL><P>
36977 <P>
36978 <UL>
36979 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36980 </UL><P>
36981 &lt;End of help on this topic&gt;
36982 </BODY>
36983 </HTML>
36984 ====== h_config_smime_privkeycon =====
36985 <HTML>
36986 <HEAD>
36987 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
36988 </HEAD>
36989 <BODY>
36990 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
36991
36992 <P>
36993 If this option is set it will be used instead of
36994 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36995 <P>
36996 This option gives you a way to store keys remotely on an IMAP server
36997 instead of storing the keys one per file locally.
36998 In order to do that you just give this option a remote folder name for a folder
36999 which does not yet exist.
37000 The name is similar to the name you might use for a remote configuration file.
37001 A remote folder name might look something like:
37002 <P>
37003 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
37004 <P>
37005 See
37006 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
37007 about the syntax of folder names.
37008 <P>
37009 Use the Setup/SMIME screen to modify this variable.
37010 <P>
37011 <UL>
37012 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37013 </UL><P>
37014 <P>
37015 <UL>
37016 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37017 </UL><P>
37018 &lt;End of help on this topic&gt;
37019 </BODY>
37020 </HTML>
37021 ====== h_config_smime_cacertdir =====
37022 <HTML>
37023 <HEAD>
37024 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
37025 </HEAD>
37026 <BODY>
37027 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
37028
37029 <P>
37030 If the option
37031 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
37032 is set then this option will have no effect.
37033 <P>
37034 CACert is a shorthand name for certification authority certificate.
37035 Normally Alpine will use the CACerts that are located in the standard system
37036 location for CACerts.
37037 It may be the case that one of your correspondents has a Digital ID which has
37038 been signed by a certificate authority that is not in the regular set of system certificate
37039 authorities.
37040 You may supplement the system list by adding further certificates of your own.
37041 These should  be stored in the directory
37042 which is the value of this option.
37043 The certificates will be stored in PEM format, one certificate per file.
37044 The names of the files can be anything ending in &quot;.crt&quot;.
37045 <P>
37046 Use the Setup/SMIME screen to modify this variable.
37047 <P>
37048 These PEM format CA certificates look very similar to your public
37049 certificates for particular email addresses
37050 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
37051 <P>
37052 <UL>
37053 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37054 </UL><P>
37055 <P>
37056 <UL>
37057 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37058 </UL><P>
37059 &lt;End of help on this topic&gt;
37060 </BODY>
37061 </HTML>
37062 ====== h_config_smime_cacertcon =====
37063 <HTML>
37064 <HEAD>
37065 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
37066 </HEAD>
37067 <BODY>
37068 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
37069
37070 <P>
37071 If this option is set it will be used instead of
37072 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
37073 <P>
37074 This option gives you a way to store certificates remotely on an IMAP server
37075 instead of storing the certificates one per file locally.
37076 In order to do that you just give this option a remote folder name for a folder
37077 which does not yet exist.
37078 The name is similar to the name you might use for a remote configuration file.
37079 A remote folder name might look something like:
37080 <P>
37081 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
37082 <P>
37083 See
37084 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
37085 about the syntax of folder names.
37086 <P>
37087 Use the Setup/SMIME screen to modify this variable.
37088 <P>
37089 <UL>
37090 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37091 </UL><P>
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_config_smime_sign_by_default ==========
37100 <HTML>
37101 <HEAD>
37102 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
37103 </HEAD>
37104 <BODY>
37105 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
37106
37107 <P>
37108 This feature only has an effect if your version of Alpine includes
37109 support for S/MIME.
37110 It affects Alpine's behavior when you send a message.
37111 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
37112 <P>
37113 Only the default value is affected.
37114 In any case, you may still toggle the Signing option on or off before sending
37115 with the &quot;G Sign&quot; command (provided you have a personal digital ID
37116 certificate).
37117 <P>
37118 <UL>
37119 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37120 </UL><P>
37121 <P>
37122
37123 <UL>
37124 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37125 </UL><P>
37126 &lt;End of help on this topic&gt;
37127 </BODY>
37128 </HTML>
37129 ========== h_config_smime_use_cert_store ==========
37130 <HTML>
37131 <HEAD>
37132 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
37133 </HEAD>
37134 <BODY>
37135 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
37136
37137 <P>
37138 This feature only has an effect if your version of Alpine includes
37139 support for S/MIME.
37140 It affects Alpine's behavior when you validate a message, and should
37141 not be disabled, unless you are performing a test.
37142 <P>
37143 There are two important aspects of validation: validation of the message
37144 (that is, the message was not modified after it was sent)
37145 as well as validation of the identity of the sender. This option has to
37146 do with the latter.
37147 <P>
37148 In order to validate that the message came from the sender in the message
37149 and not an impersonator, Alpine can
37150 either use the certificates that come in the message, or the ones that
37151 you have personally stored. If this feature is enabled (the default) then
37152 Alpine will use certificates that you have already saved in your store
37153 and not those that come in the message to validate the sender of the
37154 message. In particular, the first time that you receive a signed message
37155 from a sender, and their certificate does not validate against your
37156 store, then you will be asked if you wish to save such certificate. If
37157 you do not wish to save the certificate, then Alpine will fail to validate
37158 the signature of the message. Otherwise, Alpine will proceed to validate
37159 the signature of the message. This behavior helps you prevent against impersonation, because
37160 it is assumed that you trust the certificates that you have saved, and
37161 might not trust those that came with the message that you are validating.
37162 <P>
37163 <UL>
37164 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37165 </UL><P>
37166 <P>
37167
37168 <UL>
37169 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37170 </UL><P>
37171 &lt;End of help on this topic&gt;
37172 </BODY>
37173 </HTML>
37174 ========== h_config_smime_pubcerts_in_keychain ==========
37175 <HTML>
37176 <HEAD>
37177 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
37178 </HEAD>
37179 <BODY>
37180 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
37181
37182 <P>
37183 If this feature is set the Mac OS X default keychain will be used as the place
37184 to store public certificates instead of a
37185 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
37186 or a
37187 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
37188 <P>
37189 <UL>
37190 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37191 </UL><P>
37192 <P>
37193 <UL>
37194 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37195 </UL><P>
37196 &lt;End of help on this topic&gt;
37197 </BODY>
37198 </HTML>
37199 ========== h_config_smime_dont_do_smime ==========
37200 <HTML>
37201 <HEAD>
37202 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
37203 </HEAD>
37204 <BODY>
37205 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
37206
37207 <P>
37208 Setting this feature turns off all of Alpine's S/MIME support.
37209 You might want to set this if you are having trouble due to the S/MIME support.
37210 <P>
37211 <UL>
37212 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37213 </UL><P>
37214 <P>
37215
37216 <UL>
37217 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37218 </UL><P>
37219 &lt;End of help on this topic&gt;
37220 </BODY>
37221 </HTML>
37222 ========== h_config_smime_encrypt_by_default ==========
37223 <HTML>
37224 <HEAD>
37225 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
37226 </HEAD>
37227 <BODY>
37228 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
37229
37230 <P>
37231 This feature only has an effect if your version of Alpine includes
37232 support for S/MIME.
37233 It affects Alpine's behavior when you send a message.
37234 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
37235 <P>
37236 Only the default value is affected.
37237 In any case, you may still toggle the Encrypt option on or off before sending
37238 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
37239 for the recipient).
37240 <P>
37241 <UL>
37242 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37243 </UL><P>
37244 <P>
37245
37246 <UL>
37247 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37248 </UL><P>
37249 &lt;End of help on this topic&gt;
37250 </BODY>
37251 </HTML>
37252 ========== h_config_smime_remember_passphrase ==========
37253 <HTML>
37254 <HEAD>
37255 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
37256 </HEAD>
37257 <BODY>
37258 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
37259
37260 <P>
37261 This feature only has an effect if your version of Alpine includes
37262 support for S/MIME.
37263 If this option is set, you will only have to enter your passphrase for your private key
37264 once during an Alpine session.
37265 <P>
37266 <UL>
37267 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37268 </UL><P>
37269 <P>
37270
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_smime_transfer_pub_to_con =====
37278 <HTML>
37279 <HEAD>
37280 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
37281 </HEAD>
37282 <BODY>
37283 <H1>S/MIME: Transfer Public Certs to Container</H1>
37284
37285 <P>
37286 The Transfer command will copy the public certificates in your configured
37287 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
37288 to the container in your configured
37289 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
37290 This might be useful if you decide to switch from using a cert directory to a cert
37291 container.
37292 <P>
37293 Warning: Any previous contents in the container will be lost.
37294 <P>
37295 <UL>
37296 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37297 </UL><P>
37298 <P>
37299 <UL>
37300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37301 </UL><P>
37302 &lt;End of help on this topic&gt;
37303 </BODY>
37304 </HTML>
37305 ====== h_config_smime_transfer_pub_to_dir =====
37306 <HTML>
37307 <HEAD>
37308 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
37309 </HEAD>
37310 <BODY>
37311 <H1>S/MIME: Transfer Public Certs to Directory</H1>
37312
37313 <P>
37314 The Transfer command will copy the public certificates in your configured
37315 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
37316 to the directory in your configured
37317 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
37318 This might be useful if you decide to switch from using a cert container to a cert
37319 directory.
37320 <P>
37321 <UL>
37322 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37323 </UL><P>
37324 <P>
37325 <UL>
37326 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37327 </UL><P>
37328 &lt;End of help on this topic&gt;
37329 </BODY>
37330 </HTML>
37331 ====== h_config_smime_transfer_priv_to_con =====
37332 <HTML>
37333 <HEAD>
37334 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
37335 </HEAD>
37336 <BODY>
37337 <H1>S/MIME: Transfer Private Keys to Container</H1>
37338
37339 <P>
37340 The Transfer command will copy the private keys in your configured
37341 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
37342 to the container in your configured
37343 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
37344 This might be useful if you decide to switch from using a key directory to a key
37345 container.
37346 <P>
37347 Warning: Any previous contents in the container will be lost.
37348 <P>
37349 <UL>
37350 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37351 </UL><P>
37352 <P>
37353 <UL>
37354 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37355 </UL><P>
37356 &lt;End of help on this topic&gt;
37357 </BODY>
37358 </HTML>
37359 ====== h_config_smime_transfer_priv_to_dir =====
37360 <HTML>
37361 <HEAD>
37362 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
37363 </HEAD>
37364 <BODY>
37365 <H1>S/MIME: Transfer Private Keys to Directory</H1>
37366
37367 <P>
37368 The Transfer command will copy the private keys in your configured
37369 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
37370 to the directory in your configured
37371 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
37372 This might be useful if you decide to switch from using a key container to a key
37373 directory.
37374 <P>
37375 <UL>
37376 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37377 </UL><P>
37378 <P>
37379 <UL>
37380 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37381 </UL><P>
37382 &lt;End of help on this topic&gt;
37383 </BODY>
37384 </HTML>
37385 ====== h_config_smime_transfer_cacert_to_con =====
37386 <HTML>
37387 <HEAD>
37388 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
37389 </HEAD>
37390 <BODY>
37391 <H1>S/MIME: Transfer CA Certs to Container</H1>
37392
37393 <P>
37394 The Transfer command will copy the CA certificates in your configured
37395 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
37396 to the container in your configured
37397 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
37398 This might be useful if you decide to switch from using a CA cert directory to a CA cert
37399 container.
37400 <P>
37401 Warning: Any previous contents in the container will be lost.
37402 <P>
37403 <UL>
37404 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37405 </UL><P>
37406 <P>
37407 <UL>
37408 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37409 </UL><P>
37410 &lt;End of help on this topic&gt;
37411 </BODY>
37412 </HTML>
37413 ====== h_config_smime_transfer_cacert_to_dir =====
37414 <HTML>
37415 <HEAD>
37416 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
37417 </HEAD>
37418 <BODY>
37419 <H1>S/MIME: Transfer CA Certs to Directory</H1>
37420
37421 <P>
37422 The Transfer command will copy the CA certificates in your configured
37423 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
37424 to the directory in your configured
37425 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
37426 This might be useful if you decide to switch from using a CA cert container to a CA cert
37427 directory.
37428 <P>
37429 <UL>
37430 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37431 </UL><P>
37432 <P>
37433 <UL>
37434 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37435 </UL><P>
37436 &lt;End of help on this topic&gt;
37437 </BODY>
37438 </HTML>
37439 ====== h_config_smime_transfer_pubcon_to_key =====
37440 <HTML>
37441 <HEAD>
37442 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
37443 </HEAD>
37444 <BODY>
37445 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
37446
37447 Mac OS X Alpine only.
37448 <P>
37449 The Transfer command will copy the public certificates in your configured
37450 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
37451 to your default Mac OS X Keychain.
37452 This might be useful if you decide to switch from using a cert container to using
37453 the Keychain to store your public certs, which you may do by using the
37454 feature
37455 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
37456 <P>
37457 <UL>
37458 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37459 </UL><P>
37460 <P>
37461 <UL>
37462 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37463 </UL><P>
37464 &lt;End of help on this topic&gt;
37465 </BODY>
37466 </HTML>
37467 ====== h_config_smime_transfer_pubkey_to_con =====
37468 <HTML>
37469 <HEAD>
37470 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
37471 </HEAD>
37472 <BODY>
37473 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
37474
37475 <P>
37476 The Transfer command will copy the public certificates in your configured
37477 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
37478 to your default Mac OS X Keychain.
37479 This might be useful if you decide to switch from using a cert container to using
37480 the Keychain to store your public certs.
37481 <P>
37482 <UL>
37483 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37484 </UL><P>
37485 <P>
37486 <UL>
37487 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37488 </UL><P>
37489 &lt;End of help on this topic&gt;
37490 </BODY>
37491 </HTML>
37492 ====== h_config_smime_public_certificates =====
37493 <HTML>
37494 <HEAD>
37495 <TITLE>S/MIME: Manage Public Certificates</TITLE>
37496 </HEAD>
37497 <BODY>
37498 <H1>S/MIME: Manage Public Certificates</H1>
37499
37500 <P>
37501 This menu item allows you to manage your public certificates, this
37502 may include your own public certificate, but it normally includes
37503 certificates of people you correspond with. These certificates are
37504 saved by Alpine automatically when they are found in signed messages
37505 that you receive. This interface allows you to manage them, by
37506 giving you the option to delete them, or trust them (in the case
37507 of self-signed certificates).
37508
37509 <P>
37510 Please note that Alpine will not validate a message that was sent to you
37511 using a self-signed certificate, unless you decide to trust that certificate.
37512 Internally, a certificate is trusted by copying it to the
37513 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
37514 collection. If you decide that you want to stop trusting a self-signed
37515 certificate, you must delete such certificate from such collection.
37516 <P>
37517 The <B>I</B> Import command available in this screen allows you to
37518 import a command to this collection.
37519 <P>
37520 <UL>
37521 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37522 </UL><P>
37523 <P>
37524 <UL>
37525 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37526 </UL><P>
37527 &lt;End of help on this topic&gt;
37528 </BODY>
37529 </HTML>
37530 ====== h_config_smime_private_keys =====
37531 <HTML>
37532 <HEAD>
37533 <TITLE>S/MIME: Manage Private Keys</TITLE>
37534 </HEAD>
37535 <BODY>
37536 <H1>S/MIME: Manage Private Keys</H1>
37537
37538 <P>
37539 This option allows you to manage your private key. Normally a person has only
37540 one key, in the same way that a person only has one valid passport, or ID card,
37541 at any given time. This option allows you to manage private keys. You can
37542 delete them or import them. Additionally, you can view information
37543 about your public certificate, such as the issuer and the dates of validity
37544 of such certificate, among others.
37545
37546 <P>
37547 If you have more than one e-mail address for which you want to use the
37548 same private key, you must add all those addresses to the private key at
37549 the moment that the key is generated. When you receive a signed message using
37550 a key generated for several e-mail addresses, Alpine will save a
37551 certificate for each e-mail address included in such certificate.
37552 <P>
37553 The <B>I</B> Import command available in this screen allows you to
37554 import a command to this collection.
37555 <P>
37556 <UL>
37557 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37558 </UL><P>
37559 <P>
37560 <UL>
37561 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37562 </UL><P>
37563 &lt;End of help on this topic&gt;
37564 </BODY>
37565 </HTML>
37566 ====== h_config_smime_certificate_authorities =====
37567 <HTML>
37568 <HEAD>
37569 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
37570 </HEAD>
37571 <BODY>
37572 <H1>S/MIME: Manage Certificate Authorities</H1>
37573
37574 <P>
37575 This collection contains certificates that are needed to validate the
37576 certificate of another person, and therefore contains certificates that
37577 you trust. Typically a certificate is signed by another entity, called a
37578 certificate authority. This option allows you to manage which certificates
37579 you trust, allowing you to import them and to delete them or view information
37580 about each certificate, such as the issuer and the dates of validity
37581 of such certificate.
37582 <P>
37583 The <B>I</B> Import command available in this screen allows you to
37584 import a command to this collection.
37585 <P>
37586 <UL>
37587 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37588 </UL><P>
37589 <P>
37590 <UL>
37591 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37592 </UL><P>
37593 &lt;End of help on this topic&gt;
37594 </BODY>
37595 </HTML>
37596 ====== h_config_smime_password_file_certificates =====
37597 <HTML>
37598 <HEAD>
37599 <TITLE>S/MIME: Manage Password File Certificates</TITLE>
37600 </HEAD>
37601 <BODY>
37602 <H1>S/MIME: Manage Password File Certificates</H1>
37603
37604 <P>
37605 This option allows you to manage the certificates that are used to
37606 encrypt and decrypt your password file. This is useful in case you
37607 want to change the certificates used to encrypt your password file.
37608 <P>
37609 Depending on the version of Alpine that you used for the first time
37610 to set this up, you might have had to enter a password to enter this
37611 screen. In the case that you did not enter a password to enter this
37612 screen, you should know two things that are important:
37613 <UL>
37614 <LI> If anyone takes control of your computer (for example, if you
37615 left it unattended) then that person can add a password to your
37616 password file and make it unreadable to you in the future.
37617 <LI> If anyone can access your computer (this includes remote access)
37618 then that person can steal your password file and decrypt it without
37619 your help. This gives access to that person to the same services you
37620 have access and such person can use your name to access that service.
37621 In particular, that person can try to hack into your service provider
37622 with your name on it, or that person could try to send spam with
37623 your name.
37624 </UL>
37625 <P> Needless to say, this is not advisable. You should keep your
37626 password file protected. In order to do so, all you need to do is use
37627 the &quot;Create Key&quot; command to create a key. Once you do this,
37628 Alpine will use that key, encrypted with the password used to create that
37629 key, to protect your password file.
37630 <P>
37631 In this screen you can import a new key to encrypt your password file,
37632 and read cryptographic information on your current key.
37633 <P>
37634 To import a new key press &quot;RETURN&quot; and enter the location of
37635 the new key. You will be asked to enter the password of the new key. If
37636 this part of the process is successful, Alpine will search for the
37637 certificate that matches that key. If your key is named
37638 &quot;your_email@address.com.key&quot;, then Alpine will look for your
37639 certificate in the same directory in the file named
37640 &quot;your_email@address.com.crt&quot;, otherwise it will look for it
37641 as part of your key (that is, it will look to see if your certificate
37642 is in the file &quot;your_email@address.com.key&quot;), if all of this
37643 fails, Alpine will ask you to enter the location of the certificate
37644 that matches the key you unlocked. If a certificate is found, it will be
37645 used, and in this case, the password file will be read, decrypted with the
37646 old key and encrypted with the new key. Once this is done, the new key and
37647 certificates are saved, and the old keys are permanently deleted.
37648 <P>
37649 Alpine does not create a backup of your password file, or your old keys
37650 that will be replaced. If you need to keep old copies, you will have to do
37651 this operation outside Alpine.
37652 <P>
37653 Observe that you can use this screen to remove the password for the key.
37654 As explained earlier, this is not advisable, but you can always restore the
37655 password to encrypt your password file by creating a new key.
37656 <P>
37657 Be safe and keep your password file encrypted with a password.
37658 <UL>
37659 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37660 </UL><P>
37661 <P>
37662 <UL>
37663 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37664 </UL><P>
37665 &lt;End of help on this topic&gt;
37666 </BODY>
37667 </HTML>
37668 ====== h_certificate_information =====
37669 <HTML>
37670 <HEAD>
37671 <TITLE>S/MIME: Certificate Information Screen</TITLE>
37672 </HEAD>
37673 <BODY>
37674 <H1>S/MIME: Certificate Information Screen</H1>
37675
37676 <P>
37677 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
37678 such as its owner, e-mail address, issuer, and interval of validity,
37679 among others.
37680 <P>
37681 In the case of public certificates, this screen shows you if there was a
37682 failure when attempting to validate such message. If the certificate is
37683 self-signed, then the <B>T</B> Trust command will be available, which
37684 you can use to trust such certificate and make Alpine not fail validating
37685 signatures signed with such certificate.
37686 <P>
37687 You can also mark a certificate deleted, with the <B>D</B> command, or
37688 remove the deleted mark with the <B>U</B> undelete command.
37689 <P>
37690 In the case of your private key, Alpine shows you the information
37691 from your public key. Additionally, Alpine allows you to see public
37692 and private information about your key, with the <B>B</B> and
37693 <B>R</B> commands respectively.
37694 <UL>
37695 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37696 </UL><P>
37697 <P>
37698 <UL>
37699 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37700 </UL><P>
37701 &lt;End of help on this topic&gt;
37702 </BODY>
37703 </HTML>
37704 ====== h_config_smime_manage_public_menu =====
37705 <HTML>
37706 <HEAD>
37707 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
37708 </HEAD>
37709 <BODY>
37710 <H1>S/MIME: Commands that Manage Public Certificates</H1>
37711
37712 <P>
37713 This screen allows you to manage your public certificates.
37714 <P>
37715 The format of this screen is as follows. There are five fields: The
37716 leftmost field is normally empty, but it could contain the letter
37717 &quot;D&quot; to indicate that that certificate has been marked for
37718 deletion. The next field is the e-mail address of the owner of the
37719 certificate, shown in its entirety. The third and fourth field are the
37720 first and last day validity for that certificate, respectively. The date
37721 is displayed in the user's locale unless the option
37722 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
37723 is set. In this case, the month, day and year are represented by two
37724 digits, and the format used is mm/dd/yy. Finally, the fifth
37725 field is what can be displayed of the MD5 hash of the certificate. You can
37726 use any of the last three fields to distinguish between two certificates
37727 for the same owner.
37728 <P>
37729 Available commands in this screen and a short description of what they
37730 do follows.
37731 <UL>
37732 <LI> <B>I</B> Imports a public certificate to this collection.
37733 <LI> <B>V</B> View information about a certificate such as the name of the person the
37734 certificate was issued to, its dates of validity, and validity status.
37735 <LI> <B>D</B> Marks a certificate deleted.
37736 <LI> <B>U</B> Removes the deletion mark on a certificate.
37737 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
37738 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
37739 trust a certificate by copying it to the collection of trusted certificates.
37740 </UL>
37741 <P>
37742 All commands provide feedback to let you know about their success or failure.
37743 <P>
37744 <UL>
37745 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37746 </UL><P>
37747 <P>
37748 <UL>
37749 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37750 </UL><P>
37751 &lt;End of help on this topic&gt;
37752 </BODY>
37753 </HTML>
37754 ====== h_config_smime_manage_private_menu =====
37755 <HTML>
37756 <HEAD>
37757 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
37758 </HEAD>
37759 <BODY>
37760 <H1>S/MIME: Commands that Manage Private Keys</H1>
37761
37762 <P>
37763 This screen allows you to manage your private key.
37764 <P>
37765 The format of this screen is as follows. There are five fields: The
37766 leftmost field is normally empty, but it could contain the letter
37767 &quot;D&quot; to indicate that that certificate has been marked for
37768 deletion. The next field is the e-mail address of the owner of the
37769 certificate, shown in its entirety. The third field is the first day of
37770 validity for that certificate; the fourth field in the last day that that
37771 certificate is valid, and the fifth field is what can be displayed of the
37772 MD5 hash of the public certificate corresponding to this private key. You
37773 can use any of the last three fields to distinguish between two
37774 certificates for the same owner.
37775 <P>
37776 Available commands and a short description of what they do follows.
37777 <UL>
37778 <LI> <B>I</B> Imports a new public key to this collection.
37779 <LI> <B>V</B> View information about the public certificate corresponding to this
37780 key.
37781 <LI> <B>D</B> Marks a key to be deleted.
37782 <LI> <B>U</B> Removes the deletion mark on a key.
37783 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
37784 Note that expunging a private key does not remove the public key, which must
37785 be removed separately.
37786 </UL>
37787 <P>
37788 All commands provide feedback to let you know about their success or failure.
37789 <P>
37790 <UL>
37791 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37792 </UL><P>
37793 <P>
37794 <UL>
37795 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37796 </UL><P>
37797 &lt;End of help on this topic&gt;
37798 </BODY>
37799 </HTML>
37800 ====== h_config_smime_manage_cacerts_menu =====
37801 <HTML>
37802 <HEAD>
37803 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
37804 </HEAD>
37805 <BODY>
37806 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
37807
37808 <P>
37809 This screen allows you to manage your collection of certificates that you
37810 trust.
37811 <P>
37812 The format of this screen is as follows. There are five fields: The
37813 leftmost field is normally empty, but it could contain the letter
37814 &quot;D&quot; to indicate that that certificate has been marked for
37815 deletion. The next field is the e-mail address of the owner of the
37816 certificate, shown in its entirety. The third field is the first day of
37817 validity for that certificate; the fourth field in the last day that that
37818 certificate is valid, and the fifth field is what can be displayed of the
37819 MD5 hash of the certificate. You can use any of the last three fields to
37820 distinguish between two certificates for the same owner.
37821 <P>
37822 Available commands and a short description of what they do follows.
37823 <UL>
37824 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
37825 done by reading the certificate and validating it. Once a certificate
37826 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
37827 to the certificate, if necessary.
37828 <LI> <B>V</B> View information about this certificate, such as its issuer
37829 and validity dates.
37830 <LI> <B>D</B> Marks a certificate to be deleted.
37831 <LI> <B>U</B> Removes the deletion mark on a certificate.
37832 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
37833 </UL>
37834 <P>
37835 All commands provide feedback to let you know about their success or failure.
37836 <P>
37837 <UL>
37838 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37839 </UL><P>
37840 <P>
37841 <UL>
37842 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37843 </UL><P>
37844 &lt;End of help on this topic&gt;
37845 </BODY>
37846 </HTML>
37847 ====== h_config_lame_list_mode =====
37848 <HTML>
37849 <HEAD>
37850 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
37851 </HEAD>
37852 <BODY>
37853 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
37854
37855 This feature modifies the method Alpine uses to ask your IMAP
37856 server for folder names to display in the FOLDER LIST screen.
37857 It is intended to compensate for a small set of IMAP servers that
37858 are programmed to ignore a part of the request, and thus respond
37859 to Alpine's query with nonsensical results.
37860 <P>
37861
37862 If you find that Alpine is erroneously displaying blank folder lists,
37863 try enabling this feature.
37864 <P>
37865
37866 NOTE: Enabling this feature has consequences for the Goto and Save
37867 commands.  Many servers allow access to folders outside the area
37868 reserved for your personal folders via some reserved character,
37869 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
37870 allows, at the Goto and Save prompts, quick access to folders
37871 outside your personal folder collection without requiring a specific
37872 collection definition.  This behavior will generally not be available
37873 when this feature is enabled.
37874
37875 <P>
37876 <UL>
37877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37878 </UL><P>
37879 &lt;End of help on this topic&gt;
37880 </BODY>
37881 </HTML>
37882 ====== h_config_enable_mulnewsrcs =====
37883 <HTML>
37884 <HEAD>
37885 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
37886 </HEAD>
37887 <BODY>
37888 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
37889
37890 This feature makes it so Alpine can use multiple newsrcs based on
37891 the news server being connected to, which allows for separate lists
37892 of subscribed-to newsgroups. When this feature is not set, there is only
37893 one list of newsgroups.
37894 <P>
37895 Under this feature, the name of a newsrc is based on the news server.
37896 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
37897 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
37898 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
37899 Setting this feature for the first time will allow for the option of using
37900 your old newsrc the next time you read news.
37901 <P>
37902 If this feature is set, then the feature
37903 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
37904 also may affect the name of the newsrc file that is used.
37905 <P>
37906 <UL>
37907 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37908 </UL><P>
37909 &lt;End of help on this topic&gt;
37910 </BODY>
37911 </HTML>
37912 ======= h_ab_export_vcard =======
37913 <HTML>
37914 <HEAD>
37915 <TITLE>Address Book Export Format</TITLE>
37916 </HEAD>
37917 <BODY>
37918 <H1>Address Book Export Format</H1>
37919
37920 You are exporting address book data from Alpine to a file outside of Alpine.
37921 You are being asked to choose the format of the export.
37922 Here are the choices:
37923
37924 <DL>
37925 <DT><EM>A</EM>ddress List</DT>
37926 <DD>
37927 The addresses from the address book entries you are saving
37928 from will be saved one address per line.
37929 Address book lists (those with more than one address) will have
37930 all of their addresses saved separately.
37931 </DD>
37932
37933 <DT><EM>V</EM>Card</DT>
37934 <DD>
37935 The entries will be saved in
37936 <A HREF="h_whatis_vcard">vCard</A> format.
37937 </DD>
37938
37939 <DT><EM>T</EM>ab Separated</DT>
37940 <DD>
37941 The entries will be saved in tab-separated columns.
37942 There will be just 4 columns of data that correspond to Alpine's
37943 Nickname field, Full Name field, Address field, and Comment field.
37944 It might prove useful to Select only the Simple, non-List address book
37945 entries before Saving.
37946 </DD>
37947
37948 <DT><EM>^C</EM> Cancel</DT>
37949 <DD>
37950 Cancel out of the Save.
37951 </DD>
37952
37953 </DL>
37954
37955
37956 <P>
37957 &lt;End of help on this topic&gt;
37958 </BODY>
37959 </HTML>
37960 ====== h_config_predict_nntp_server =====
37961 <HTML>
37962 <HEAD>
37963 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
37964 </HEAD>
37965 <BODY>
37966 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
37967
37968 This feature allows Alpine to assume that the open NNTP server at the
37969 time of composition is the NNTP server to which the message should be
37970 posted.  This is especially recommended when there are multiple News
37971 collections.  If this feature is not set, Alpine will try to post to the first server in
37972 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
37973 this feature also negates the need to add News collection servers to
37974 the <!--#echo var="VAR_nntp-server"--> variable.
37975 <P>
37976 This feature can be especially handy when used in conjunction with
37977 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
37978 <P>
37979 <UL>
37980 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37981 </UL><P>
37982 &lt;End of help on this topic&gt;
37983 </BODY>
37984 </HTML>
37985 ====== h_config_nntp_search_uses_overview =====
37986 <HTML>
37987 <HEAD>
37988 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
37989 </HEAD>
37990 <BODY>
37991 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
37992
37993 This feature should probably be turned on unless it causes trouble.
37994 The results of the NNTP overview command (XOVER) may be used to help
37995 with some searches in news groups.
37996 It should result in quicker response time.
37997 Turning this feature on apparently causes search results which are
37998 different from what you would get with the feature turned off on some
37999 servers.
38000 <P>
38001 <UL>
38002 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38003 </UL><P>
38004 &lt;End of help on this topic&gt;
38005 </BODY>
38006 </HTML>
38007 ====== h_config_thread_sorts_by_arrival =====
38008 <HTML>
38009 <HEAD>
38010 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
38011 </HEAD>
38012 <BODY>
38013 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
38014
38015 This feature affects how a threading sort arranges threads.  The default way
38016 to arrange threads is by the date of the earliest message in the thread.
38017 This feature arranges threads by the last message to arrive in a thread.
38018 <P>
38019 This feature causes old threads that get recent messages to sort to the bottom,
38020 where previously a message arrival to a thread would not rearrange the order of
38021 that thread.
38022 <P>
38023 <UL>
38024 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38025 </UL><P>
38026 &lt;End of help on this topic&gt;
38027 </BODY>
38028 </HTML>
38029 ====== h_config_textplain_int =====
38030 <HTML>
38031 <HEAD>
38032 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
38033 </HEAD>
38034 <BODY>
38035 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
38036
38037 This feature modifies the method Alpine uses to display Text/Plain
38038 MIME attachments from the Attachment Index screen.  Normally, the
38039 &quot;View&quot; command searches for any externally defined (usually
38040 via the
38041 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
38042 and displays the selected text within that viewer.
38043
38044 <P>
38045 Enabling this feature causes Alpine to ignore any external viewer
38046 settings and always display text with Alpine's internal viewer.
38047
38048 <P>
38049 <UL>
38050 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38051 </UL><P>
38052 &lt;End of help on this topic&gt;
38053 </BODY>
38054 </HTML>
38055 ====== h_config_wp_columns =====
38056 <HTML>
38057 <HEAD>
38058 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
38059 </HEAD>
38060 <BODY>
38061 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
38062
38063 Web Alpine only.
38064 <P>
38065 This configuration setting specifies the number of horizontal characters
38066 used to format various WebAlpine pages.  Smaller values will tend to reduce
38067 the amount of horizontal scrolling required to view pages within narrow
38068 browsers, such as those found on PDAs, and larger values will tend to
38069 spread more information across the page.
38070
38071 <P>
38072 The Message List page uses the width to determine how many characters
38073 to assign each field.  Note, a smaller value may result in a disproportionate
38074 amount of blank space between fields on each line.  Similarly, a large
38075 value may result in cramped fields or horizontal scrolling.
38076
38077 <P>
38078 The Message View page uses this value to determine when to wrap lines
38079 in displayed message text.  Note, a smaller value may result in jagged
38080 right margins or confusing quoting.  A larger value may cause lines of text to
38081 run beyond the browser's right edge, requiring horizontal scrolling.
38082
38083 <P>
38084 <UL>
38085 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38086 </UL><P>
38087 &lt;End of help on this topic&gt;
38088 </BODY>
38089 </HTML>
38090 ====== h_config_wp_state =====
38091 <HTML>
38092 <HEAD>
38093 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
38094 </HEAD>
38095 <BODY>
38096 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
38097
38098 Web Alpine only.
38099 <P>
38100 Various aspects of cross-session state.
38101
38102 <P>
38103 <UL>
38104 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38105 </UL><P>
38106 &lt;End of help on this topic&gt;
38107 </BODY>
38108 </HTML>
38109 ====== h_config_wp_aggstate =====
38110 <HTML>
38111 <HEAD>
38112 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
38113 </HEAD>
38114 <BODY>
38115 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
38116
38117 Web Alpine only.
38118 <P>
38119 Aggregate operations tab state.
38120
38121 <P>
38122 <UL>
38123 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38124 </UL><P>
38125 &lt;End of help on this topic&gt;
38126 </BODY>
38127 </HTML>
38128 ====== h_config_wp_indexlines =====
38129 <HTML>
38130 <HEAD>
38131 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
38132 </HEAD>
38133 <BODY>
38134 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
38135
38136 Web Alpine only.
38137 <P>
38138 Number of index lines in table.
38139
38140 <P>
38141 <UL>
38142 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38143 </UL><P>
38144 &lt;End of help on this topic&gt;
38145 </BODY>
38146 </HTML>
38147 ====== h_config_wp_indexheight =====
38148 <HTML>
38149 <HEAD>
38150 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
38151 </HEAD>
38152 <BODY>
38153 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
38154
38155 Web Alpine only.
38156 <P>
38157 Index table row height.
38158
38159 <P>
38160 <UL>
38161 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38162 </UL><P>
38163 &lt;End of help on this topic&gt;
38164 </BODY>
38165 </HTML>
38166 ====== h_config_rss_news =====
38167 <HTML>
38168 <HEAD>
38169 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
38170 </HEAD>
38171 <BODY>
38172 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
38173
38174 Web Alpine only.
38175 <P>
38176 RSS News feed.
38177
38178 <P>
38179 <UL>
38180 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38181 </UL><P>
38182 &lt;End of help on this topic&gt;
38183 </BODY>
38184 </HTML>
38185 ====== h_config_rss_weather =====
38186 <HTML>
38187 <HEAD>
38188 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
38189 </HEAD>
38190 <BODY>
38191 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
38192
38193 Web Alpine only.
38194 <P>
38195 RSS Weather feed.
38196
38197 <P>
38198 <UL>
38199 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38200 </UL><P>
38201 &lt;End of help on this topic&gt;
38202 </BODY>
38203 </HTML>
38204 ====== h_config_send_confirms_only_expanded =====
38205 <HTML>
38206 <HEAD>
38207 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
38208 </HEAD>
38209 <BODY>
38210 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
38211
38212 This Web Alpine option specifies whether or not a Send confirmations
38213 happens when a composed message is readied for sending or not.  The
38214 default behavior is to not confirm that the nicknames were expanded to
38215 the intended addresses.
38216
38217 <P>
38218 <UL>
38219 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38220 </UL><P>
38221 &lt;End of help on this topic&gt;
38222 </BODY>
38223 </HTML>
38224 ====== h_config_enable_jump_command =====
38225 <HTML>
38226 <HEAD>
38227 <TITLE>FEATURE: enable-jump-command</TITLE>
38228 </HEAD>
38229 <BODY>
38230 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
38231
38232 This Web Alpine option specifies whether or not a Jump command is
38233 offered in the Message List and Message View pages.  The command is
38234 implemented as an input field in the left column of the List and View
38235 screens.
38236
38237 <P>
38238 When enabled and a number is entered in the input field while the
38239 Message List is displayed, the Message List is reframed with the
38240 specified message.  While viewing a message, the message associated
38241 with the specified message number is displayed.
38242
38243 <P>
38244 <UL>
38245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38246 </UL><P>
38247 &lt;End of help on this topic&gt;
38248 </BODY>
38249 </HTML>
38250 ====== h_config_enable_newmail_sound =====
38251 <HTML>
38252 <HEAD>
38253 <TITLE>FEATURE: enable-newmail-sound</TITLE>
38254 </HEAD>
38255 <BODY>
38256 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
38257
38258 This Web Alpine option specifies whether or not a sound file is sent
38259 to the web browser along with the newmail notification message.
38260
38261
38262 <P>
38263 <UL>
38264 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38265 </UL><P>
38266 &lt;End of help on this topic&gt;
38267 </BODY>
38268 </HTML>
38269 ====== h_config_render_html_internally =====
38270 <HTML>
38271 <HEAD>
38272 <TITLE>FEATURE: render-html-internally</TITLE>
38273 </HEAD>
38274 <BODY>
38275 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
38276
38277 By default, Web Alpine will pass cleansed HTML text you receive in messages
38278 to the browser for display (rendering).  This feature causes Web Alpine to convert
38279 the HTML text into plain text in the same way Unix and PC-Alpine do.
38280
38281
38282 <P>
38283 <UL>
38284 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
38285 </UL><P>
38286 &lt;End of help on this topic&gt;
38287 </BODY>
38288 </HTML>
38289 ====== h_config_role_undo =====
38290 Yes, remember changes and exit back to list of roles; No, discard changes
38291 made in this screen; ^C, cancel exit and stay in this config screen.
38292 ====== h_exit_editor =====
38293 S, save changes and exit from the editor; D, do not save changes but
38294 do exit from the editor; or ^C, cancel exit and stay in the editor.
38295 ====== h_config_undo =====
38296 Yes, save changes and exit; No, exit without saving any changes made since
38297 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
38298 ====== h_os_index_whereis =====
38299 Enter ^V or ^Y to go immediately to the last or first message in the index.
38300 Or, enter the match string followed by RETURN.
38301 ====== h_os_index_whereis_agg =====
38302 Enter ^V or ^Y to go immediately to the last or first message in the index,
38303 Or, enter the match string followed by RETURN (or ^X to select all matches).
38304 =========== h_oe_add_full ==================
38305 Type the full name of the person being added and press the RETURN key.
38306 Press ^C to cancel addition.
38307 =========== h_oe_add_nick ==================
38308 Type a short nickname and press RETURN.  A nickname is a short easy-to-
38309 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
38310 ========== h_oe_add_addr ================
38311 Type the e-mail address and press RETURN.
38312 Press ^C to cancel addition.
38313 ========== h_oe_crlst_full ==============
38314 Type a long name or description for the list that you are creating and
38315 press RETURN.  Press ^C to cancel creation of list.
38316 =========== h_oe_crlst_nick =============
38317 Type a nickname (short, easy-to-remember name or single word) for the list
38318 you are creating and press RETURN.  Press ^C to cancel.
38319 ========== h_oe_crlst_addr ==============
38320 Type an e-mail address, or a nickname already in the address book that you
38321 want to be part of this list and press RETURN.
38322 ========== h_oe_adlst_addr =============
38323 Type an e-mail address or a nickname already in the address book that you
38324 want to add to this list and press RETURN.
38325 ========== h_oe_editab_nick ============
38326 Change the nickname using the arrow keys and delete key.  Press RETURN
38327 when done.  Press ^C to cancel editing and leave the nickname as it was.
38328 ========== h_oe_editab_full ============
38329 Change the full name using the arrow keys and delete key.  Press RETURN
38330 when done.  Press ^C to cancel editing and leave the full name as it was.
38331 ========== h_oe_editab_addr ============
38332 Change the address using the arrow keys and delete key.  Press RETURN
38333 when done.  Press ^C to cancel editing and leave the address as it was.
38334 ========== h_oe_editab_fcc ============
38335 Change the fcc using the arrow keys and delete key.  Press RETURN when
38336 done.  Press ^C to cancel editing and leave the fcc as it was.
38337 ========== h_oe_editab_comment ============
38338 Change the comment field using the arrow keys and delete key.  Press RETURN
38339 when done.  Press ^C to cancel editing and leave the comment as it was.
38340 ====== h_ab_forward =====
38341 Yes, expand nicknames and qualify local names with your current domain name;
38342 No, leave nicknames and local names as is;  ^C, cancel.
38343 ========== h_ab_export ==========
38344 Type the name of a file to write the addresses into and
38345 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
38346 ========== h_ab_edit_a_field ==========
38347 Edit any of the fields of the currently selected entry by typing one of the
38348 letters at the bottom of the screen.  Press ^C to cancel edit.
38349 ====== h_ab_del_data_revert =====
38350 Press B to completely delete addrbook and revert to default, C to delete config
38351 and revert while leaving data, or D to only delete data (make it empty).
38352 ====== h_ab_del_data_modify =====
38353 Press B to completely delete addrbook, C to delete configuration while leaving
38354 data, or D to delete data (make it empty) but leave config. ^C to cancel.
38355 ====== h_ab_del_config_modify =====
38356 Yes, remove this address book from my configuration.
38357 No, make no changes now.
38358 ====== h_ab_del_config_revert =====
38359 Yes, remove this address book from my config and revert to default.
38360 No, make no changes now.
38361 ====== h_ab_del_default =====
38362 Yes, remove this default address book from my configuration.
38363 No, make no changes now.
38364 ====== h_ab_really_delete =====
38365 Yes, delete the actual contents of the address book, not just the
38366 configuration.  No, don't delete the data after all, cancel and start over.
38367 ====== h_ab_del_ignore =====
38368 Press I to ignore all the default address books for this category.  Press R to
38369 remove this one address book and add the others to your personal list.
38370 ====== h_ab_del_dir_ignore =====
38371 Press I to ignore all the default directory servers for this category.
38372 Press R to remove this one server and add the others to your personal list.
38373 ====== h_ab_copy_dups =====
38374 Yes, overwrite the existing entry.
38375 No, skip duplicates but save the rest. Press ^C to cancel.
38376 ====== h_confirm_cancel =====
38377 Type C to Confirm that you want to abandon the message you are composing.
38378 Type N or ^C to cancel out of the cancel and keep composing.
38379 ====== h_ab_text_or_vcard =====
38380 Text, start composer with displayed text already included.
38381 VCard, start composer with address book entry attached as a vCard. ^C cancels.
38382 ====== h_ab_backup_or_ldap =====
38383 Backup, copy email address from entry and allow editing of it.
38384 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
38385 ====== h_ldap_text_or_vcard =====
38386 Text: export displayed text for selected entry. Address: export only the
38387 email address. VCard: export entry in vCard format. ^C cancels.
38388 ====== h_ab_save_exp =====
38389 Save, save entry or entries to an address book.
38390 Export, save to file outside of pine. ^C cancels save.
38391 ====== h_ab_add =====
38392 A, add a brand new entry to this address book.
38393 E, edit the entry that is currently highlighted. ^C to cancel.
38394 ====== h_ab_shuf =====
38395 U, swap order of highlighted address book and the one above it.
38396 D, swap order of highlighted address book and the one below it. ^C to cancel.
38397 ====== h_ab_shuf_up =====
38398 U, swap order of highlighted address book and the one above it.
38399 Press ^C to cancel.
38400 ====== h_ab_shuf_down =====
38401 D, swap order of highlighted address book and the one below it.
38402 Press ^C to cancel.
38403 ====== h_folder_prop =====
38404 Count is # of messages in the folder, Unseen means messages that have not
38405 been read, New means messages that were Recently added to the folder.
38406 ====== h_role_shuf =====
38407 U, swap order of highlighted rule and the one above it.
38408 D, swap order of highlighted rule and the one below it. ^C to cancel.
38409 ====== h_role_shuf_up =====
38410 U, swap order of highlighted rule and the one above it.
38411 Press ^C to cancel.
38412 ====== h_role_shuf_down =====
38413 D, swap order of highlighted rule and the one below it.
38414 Press ^C to cancel.
38415 ====== h_incoming_shuf =====
38416 B, swap order of highlighted directory and the one before it.
38417 F, swap order of highlighted directory and the one after it. ^C to cancel.
38418 ====== h_incoming_shuf_up =====
38419 B, swap order of highlighted directory and the one before it.
38420 Press ^C to cancel.
38421 ====== h_incoming_shuf_down =====
38422 F, swap order of highlighted directory and the one after it.
38423 Press ^C to cancel.
38424 ====== h_dir_shuf =====
38425 U, swap order of highlighted directory and the one above it.
38426 D, swap order of highlighted directory and the one below it. ^C to cancel.
38427 ====== h_dir_shuf_up =====
38428 U, swap order of highlighted directory and the one above it.
38429 Press ^C to cancel.
38430 ====== h_dir_shuf_down =====
38431 D, swap order of highlighted directory and the one below it.
38432 Press ^C to cancel.
38433 ====== h_hdrcolor_shuf =====
38434 U, swap order of highlighted Header Color and the one above it.
38435 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
38436 ====== h_hdrcolor_shuf_up =====
38437 U, swap order of highlighted Header Color and the one above it.
38438 Press ^C to cancel.
38439 ====== h_hdrcolor_shuf_down =====
38440 D, swap order of highlighted Header Color and the one below it.
38441 Press ^C to cancel.
38442 ========== h_oe_editab_al ============
38443 Change the address using the arrow keys and delete key.  Press RETURN
38444 when done.  Press ^C to cancel editing and leave the address as it was.
38445 ========== h_dir_comp_search ===============
38446 Type a string to look for just like you would in the composer. Your configured
38447 rules for the servers with the implicit flag set will be used.
38448 ========== h_oe_searchab ===============
38449 Type the word or name you want to search for and press RETURN.  If you press
38450 RETURN without entering anything the word in [] will be searched for.
38451 ========== h_oe_chooseabook ==========
38452 Choose the address book you want to save the new entry in.
38453 Use ^N or ^P to change address books.  ^C to cancel.
38454 ========== h_oe_takeaddr ==========
38455 Edit the e-mail address using the arrow and delete keys.  Press RETURN
38456 when done.  Press ^C to cancel adding this entry to the address book.
38457 ========== h_oe_take_replace ==========
38458 Press R to replace the old entry with this new data.  You will still have
38459 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
38460 ========== h_oe_take_replace_or_add ==========
38461 Press R to replace the old entry.  Press A to add the selected addresses to
38462 the old existing list.  N to enter another nickname. ^C to cancel now.
38463 ========== h_oe_takename ==========
38464 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
38465 when done.  Press ^C to cancel adding this entry to the address book.
38466 ========== h_oe_takenick ==========
38467 Type a nickname (short easy-to-remember name, initials or single word) for this
38468 entry in the address book and press RETURN.  Press ^C to cancel addition.
38469 ========== h_oe_jump ==========
38470 Type the message number you want to jump to and press RETURN.  The word "end"
38471 represents the last message. Press ^C to cancel jumping to another message.
38472 ========== h_oe_jump_thd ==========
38473 Type the thread number you want to jump to and press RETURN.  The word "end"
38474 represents the last thread. Press ^C to cancel jumping to another thread.
38475 ========== h_oe_debuglevel ==========
38476 Higher number shows more debugging details.
38477 Press ^C if you want to cancel the change.
38478 ========== h_oe_broach ==========
38479 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
38480 to go to the previous/next collections in the list.  Press ^C to cancel goto.
38481 ========== h_oe_foldsearch ==========
38482 Type the text you want to search for in foldernames and press RETURN.  If you
38483 press RETURN without entering anything, any text in [] will be searched for.
38484 ========== h_oe_foldrename ==========
38485 Change the old name of the folder to the new name using the arrow and
38486 delete keys and press RETURN.  Press ^C to cancel rename.
38487 ========== h_oe_login ==========
38488 Enter your login name for the host you are opening the mailbox on.  Just press
38489 RETURN to use your login from this host as is, or edit it with delete key.
38490 ========== h_oe_passwd ==========
38491 Type your password for the host and login shown as part of the prompt.
38492 Press ^C to cancel opening folder.
38493 ========== h_oe_choosep ==========
38494 Enter the number associated with the printer you want to select.  Press ^C to
38495 cancel the printer selection.  The current selection is highlighted.
38496 ========== h_oe_customp ==========
38497 Type the name of the Unix print command and press RETURN.  Press ^C to
38498 cancel the printer selection.
38499 ========== h_oe_searchview ==========
38500 Type the word or name you want to search for and press RETURN.  If you press
38501 RETURN without entering anything the word in [] will be searched for.
38502 ========== h_oe_keylock ==========
38503 The keyboard is in use and locked by another user.  Only that user can
38504 unlock this keyboard by typing the password.
38505 ========== h_wt_expire ==========
38506 At the beginning of each month Alpine offers to rename your current sent-mail
38507 folder to one named for the month so you have a sent-mail folder for each month
38508 ========== h_wt_delete_old ==========
38509 It is the beginning of the month, and we need to conserve disk
38510 space.  Please delete any sent-mail that you do not need.
38511 ========== h_select_sort ==========
38512 Select the order for sorting the index by typing the capitalized letter.
38513 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
38514 ========== h_no_F_arg ============
38515 Enter name of file to be opened.
38516
38517 ========== h_sticky_personal_name ==========
38518 Type in your name as you want it to appear on outgoing email.  This entry
38519 will be saved into your Alpine configuration file.
38520 ========== h_sticky_inbox ============
38521 INBOX syntax is usually {complete.machine.name}INBOX
38522 This entry will be saved in your Alpine configuration file.
38523 ========== h_sticky_smtp ============
38524 The name of the computer on your campus that relays your outgoing email
38525 to the Internet.  This entry will be saved in your Alpine configuration file.
38526 ========== h_sticky_user_id ==========
38527 The username or login-id part of your email address.  This entry will be
38528 saved in your Alpine configuration file.
38529 ========== h_sticky_domain ==========
38530 The domain part of your email address, NOT the name of your PC.  This
38531 entry will be saved in your Alpine configuration file.
38532 ========== h_bounce =========
38533 Enter the address or nickname of the intended recipient.  Alpine will resend
38534 the message, which will retain the original author's From: address.
38535 ========== h_incoming_add_folder_nickname =========
38536 Enter an (optional) nickname that will be used in lieu of the actual
38537 host and folder names in the FOLDER LIST display.
38538 ========== h_anon_forward ==========
38539 Enter the address of your intended recipient, or ^C to cancel.
38540 Example: jsmith@somewhere.edu
38541 ========== h_news_subscribe ==========
38542 Enter the name of the newsgroup to which you wish to subscribe,
38543 or ^C to cancel.  Example: comp.mail.pine
38544 ========== h_pipe_msg ==========
38545 Enter the name of the Unix command to which you wish to send this
38546 message, or ^C to cancel.
38547 ========== h_pipe_attach ==========
38548 Enter the name of the Unix command to which you wish to send this
38549 attachment, or ^C to cancel.
38550 ========== h_select_by_num ==========
38551 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
38552 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
38553 ========== h_select_by_gm_content ==========
38554 Enter your search key in the same way that you would enter a search
38555 key in the web interface for Gmail.
38556 ========== h_select_by_thrdnum ==========
38557 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
38558 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
38559 ========== h_select_txt_from ==========
38560 Messages with From: headers containing the entered string will be selected.
38561 ^C to cancel. ^G again to see original options.
38562 ========== h_select_txt_not_from ==========
38563 Messages without From: headers containing the entered string will be selected.
38564 ^C to cancel. ^G again to see original options.
38565 ========== h_select_txt_to ==========
38566 Messages with To: headers containing the entered string will be selected.
38567 ^C to cancel. ^G again to see original options.
38568 ========== h_select_txt_not_to ==========
38569 Messages without To: headers containing the entered string will be selected.
38570 ^C to cancel. ^G again to see original options.
38571 ========== h_select_txt_cc ==========
38572 Messages with Cc: headers containing the entered string will be selected.
38573 ^C to cancel. ^G again to see original options.
38574 ========== h_select_txt_not_cc ==========
38575 Messages without Cc: headers containing the entered string will be selected.
38576 ^C to cancel. ^G again to see original options.
38577 ========== h_select_txt_subj ==========
38578 Messages with Subject: headers containing the entered string will be selected.
38579 ^C to cancel.  ^X enters Subject: line of current message.
38580 ========== h_select_txt_not_subj ==========
38581 Messages without Subject headers containing the entered string will be selected.
38582 ^C to cancel.  ^X enters Subject: line of current message.
38583 ========== h_select_txt_all ==========
38584 All messages containing the entered string will be selected.  Headers and body,
38585 but not encoded attachments, will be compared.  Enter ^C to cancel.
38586 ========== h_select_txt_not_all ==========
38587 All messages that don't contain the entered string will be selected.  Headers
38588 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
38589 ========== h_select_txt_body ==========
38590 All messages containing the entered string will be selected. Body text, but
38591 not headers or encoded attachments, will be compared. ^C to cancel.
38592 ========== h_select_txt_not_body ==========
38593 All messages that don't contain the entered string will be selected. Body
38594 text, but not headers or encoded attachments, will be compared. ^C to cancel.
38595 ========== h_select_txt_recip ==========
38596 Messages with Cc: or To: headers containing the entered string will be selected.
38597 ^C to cancel. ^G again to see original options.
38598 ========== h_select_txt_not_recip ==========
38599 Messages without Cc: or To: headers containing the string will be selected.
38600 ^C to cancel. ^G again to see original options.
38601 ========== h_select_txt_partic ==========
38602 Messages with Cc, To, or From headers containing the string will be selected.
38603 ^C to cancel. ^G again to see original options.
38604 ========== h_select_txt_not_partic ==========
38605 Messages without Cc, To, or From headers containing the string will be selected.
38606 ^C to cancel. ^G again to see original options.
38607 ========== h_select_date ==========
38608 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
38609 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
38610 ========== h_attach_index_whereis ==========
38611 Enter some text that appears in the Attachment Index entry for the desired
38612 attachment.  The first attachment containing that text will be highlighted.
38613 ========== h_kb_lock ==========
38614 Keystrokes entered here (up to a RETURN) comprise a password that must
38615 be entered again later in order to unlock the keyboard.
38616 ========== h_compose_default ==========
38617 N, compose a new message. R, set a role.
38618 ^C to cancel.
38619 ========== h_untranslatable ==========
38620 Send using UTF-8 character set; Send but replace untranslatable characters
38621 with question marks; return to the composer; or cancel message altogether.
38622 ========== h_compose_intrptd ==========
38623 N, compose a new msg. I, continue interrupted msg. R, set a role.
38624 ^C to cancel.
38625 ========== h_compose_postponed ==========
38626 N, compose a new message. P, continue postponed msg. R, set a role.
38627 ^C to cancel.
38628 ========== h_compose_intrptd_postponed ==========
38629 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
38630 R, set a role. ^C to cancel.
38631 ========== h_compose_form ==========
38632 N, compose a new message. F, use form letter. R, set a role.
38633 ^C to cancel.
38634 ========== h_compose_intrptd_form ==========
38635 N, compose a new msg. I, continue interrupted msg. F, use form letter.
38636 R, set a role. ^C to cancel.
38637 ========== h_compose_postponed_form ==========
38638 N, compose a new message. P, continue postponed msg. F, use form letter.
38639 R, set a role. ^C to cancel.
38640 ========== h_compose_intrptd_postponed_form ==========
38641 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
38642 F, use form letter. R, set a role. ^C to cancel.
38643 ========== h_config_context_del_except ==========
38644 If you delete the last exceptional collection you can only add it back by
38645 manually editing the exceptions config file.
38646 ========== h_config_whereis ==========
38647 To move quickly to a particular line, enter a search string or
38648 ^C to cancel.
38649 ========== h_config_edit_scorei ==========
38650 Enter interval in the form (min,max). -INF and INF may be used to represent
38651 -infinity and infinity. ^C to cancel change. RETURN to accept change.
38652 ========== h_config_add ==========
38653 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
38654 pressing RETURN sets the Empty Value (this turns off any global default).
38655 ========== h_config_add_custom_color ==========
38656 Enter a header fieldname. For example, "subject" or "from".
38657
38658 ========== h_config_add_pat_hdr ==========
38659 Enter a header fieldname. For example, "reply-to" or "organization" or
38660 any fieldname you want that isn't included already.
38661 ========== h_config_print_opt_choice ==========
38662 You may edit either the initialization string (characters printed before
38663 printing starts) or the trailer string.  Choose one or ^C to cancel.
38664 ========== h_config_print_init ==========
38665 Enter a C-style string for this.  You may use common backslash escapes like
38666 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
38667 ========== h_config_change ==========
38668 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
38669 delete current (highlighted) character, etc.  Enter ^C to cancel change.
38670 ========== h_config_replace_add ==========
38671 Replace ignores the current default, Add places the current default in your
38672 editing buffer as if you had typed it in.
38673 ========== h_config_insert_after ==========
38674 Enter a nickname for this print command.  (InsertBefore puts the new item
38675 before the current line, InsertAfter puts it after the current line.)
38676 ========== h_config_print_cmd ==========
38677 Enter command to be executed for the printer.  Use normal editing keys
38678 to modify, ^C to cancel, carriage return to accept current value.
38679 ========== h_config_role_del ==========
38680 Answering Yes will remove this rule completely from your rules list.
38681 ========== h_config_role_addfile ==========
38682 Type the name of a file to add to your configuration. You don't need to
38683 use a file, you may add rules directly (with Add) without using a file.
38684 ========== h_config_role_delfile ==========
38685 Answering Yes will remove this rule file completely from your rules list.
38686 The rules data file itself will not be removed.
38687 ========== h_config_print_del ==========
38688 Answering Yes will remove this printer completely from your printer list.
38689 ========== h_config_print_name_cmd ==========
38690 You may edit the Nickname of this printer, the Command to be executed when
38691 printing, or change the Options associated with this printer.
38692 ========== h_send_check_fcc ==========
38693 Yes, send message without an Fcc.
38694 No, return to composer.
38695 ========== h_send_check_subj ==========
38696 Yes, send message without a Subject.
38697 No, return to composer.
38698 ========== h_send_check_to_cc ==========
38699 Yes, send message without a To address, or a Cc address, or a Newsgroup.
38700 No, return to composer.
38701 ========== h_send_fcc_only ==========
38702 Yes, copy message to Fcc only and send to NO recipients.
38703 No, return to composer.
38704 ========== h_send_prompt ==========
38705 Yes, send the message.
38706 No or ^C, return to composer.
38707 ========== h_send_prompt_flowed ==========
38708 Yes, send the message.  No or ^C, return to composer.
38709 What's Flowed? See Do Not Send Flowed Text in config screen.
38710 ========== h_send_prompt_dsn ==========
38711 Yes, send the message.  No or ^C, return to composer.
38712 What's DSNOpts? See Enable Delivery Status Notification in config screen.
38713 ========== h_send_prompt_dsn_flowed ==========
38714 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
38715 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
38716 ========== h_role_confirm ==========
38717 Yes, use displayed role. No, compose without a role.
38718 ^C, cancel the message. ^T, select a role from your other eligible roles.
38719 ========== h_norole_confirm ==========
38720 Return, compose without a role.
38721 ^C, cancel the message. ^T, select a role from your eligible roles.
38722 ========== h_custom_print ==========
38723 Enter a Unix command that accepts its data on standard input.
38724 Alpine will display any information the command sends to standard output.
38725 ========== h_convert_abooks_and_sigs ==========
38726 You will be given the opportunity to convert address books and signature files
38727 to remote configurations.
38728 ========== h_convert_abooks ==========
38729 You will be given the opportunity to convert address books to remote
38730 configurations.
38731 ========== h_flag_keyword ==========
38732 Enter the name of the keyword you want to add for this folder.
38733 No spaces, parentheses, braces, percents or asterisks are allowed.
38734 ========== h_select_keyword ==========
38735 Enter the keyword you want to match, or use ^T to select a keyword from a list
38736 of possible keywords for this folder. Use ! to look for non-matches instead.
38737 ========== h_type_keyword ==========
38738 Enter the keyword you want to add. You may add a nickname in the next step.
38739 No spaces, parentheses, braces, percents or asterisks are allowed.
38740 ========== h_type_keyword_nickname ==========
38741 Enter an optional nickname for the keyword you want to add.
38742 Type Carriage return to use the keyword name instead of a nickname.
38743 ========== h_convert_sigs ==========
38744 You will be given the opportunity to convert signature files to remote
38745 configurations.
38746 ========== h_convert_abook ==========
38747 Yes is fairly safe. You will be ADDing a remote address book that is a copy
38748 of the current address book. The current abook won't be removed automatically.
38749 ========== h_convert_sig ==========
38750 Answering Yes copies the contents of the signature file into your Alpine
38751 configuration file. After that, the contents of the file will not be used.
38752 ========== h_save_addman ==========
38753 Enter the simple name of the folder you want to add. Carriage return to
38754 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
38755 ========== h_reopen_folder ==========
38756 Yes reopens the folder, as if you were starting over. This uncovers new mail.
38757 No leaves the folder index as it was without discovering new mail.
38758 ========== h_convert_pinerc_server ==========
38759 This is the name of the host (computer) where the remote Alpine configuration
38760 will be stored. This should be an IMAP server that you have permission to use.
38761 ========== h_convert_pinerc_folder ==========
38762 Enter the correct remote folder name. This folder is special and should
38763 contain only configuration data. It shouldn't contain other mail messages.
38764 ========== h_role_compose ==========
38765 Compose a New message, Reply to current message, Forward current message, or
38766 Bounce message. Then you will be asked to choose one of your Roles to be used.
38767 ========== h_role_aggregate ==========
38768 Compose a reply, or forward, or bounce the selected messages. Then you
38769 will be asked to choose one of your Roles to be used for this operation.
38770 ========== h_save_size_changed ==========
38771 The reported size of a message is not the same as the actual size. Answer Yes
38772 to continue and hope for the best or No to Cancel the entire Save.
38773 ========== h_select_by_larger_size ==========
38774 Enter a number or ^C to cancel. All messages greater than this many characters
38775 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
38776 ========== h_select_by_smaller_size ==========
38777 Enter a number or ^C to cancel. All messages less than this many characters
38778 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
38779 ========== h_preserve_field ==========
38780 Use 'p' to toggle between preserving or not preserving the original To:
38781 and Cc: fields of the message. Enter ^C to cancel message.
38782 ========== h_privacy_policy ==========
38783 x-alpine-http:https://alpineapp.email/legal/privacy.html
38784 ========== h_apache_license ==========
38785 x-alpine-http:https://alpineapp.email/legal/apache_license.html
38786