pith/pine.hlp

   1 # $Id: pine.hlp 1266 2009-07-14 18:39:12Z hubert@u.washington.edu $
   2 #
   3 #        T H E   A L P I N E    M E S S A G E   S Y S T E M
   4 #
   5 #/* ========================================================================
   6 # * Copyright 2013-2020 Eduardo Chappa
   7 # * Copyright 2006-2008 University of Washington
   8 # *
   9 # * Licensed under the Apache License, Version 2.0 (the "License");
  10 # * you may not use this file except in compliance with the License.
  11 # * You may obtain a copy of the License at
  12 # *
  13 # *     http://www.apache.org/licenses/LICENSE-2.0
  14 # *
  15 # * ========================================================================
  16 # */
  17 #
  18          Help text for the Alpine mailer
  19
  20 This file is in a format created to be turned into text strings in a C
  21 program.
  22
  23 There are two shell scripts that run on this.  Cmplhelp.sh is the
  24 first and turns this into a C file (helptext.c) of text strings that
  25 are compiled and linked. The other program, cmplhlp2.sh, turns this
  26 into a .h file (helptext.h) with extern string definitions of the
  27 strings in the .c file.  The code that actually processes these files
  28 while alpine is running is in help.c
  29
  30 The lines with "===== xxxx ====" divide the different help screens.  The
  31 xxx is the name of the variable that strings will be put in, which are
  32 also declared in helptext.h.
  33
  34 # is a comment
  35
  36 Help text screen text can be either plain text OR HTML.  The latter is
  37 denoted by the first line starting with "<HTML>".  The former is simply
  38 displayed as it's formatted here.
  39
  40 HTML is limited to simple formatting ala HTML 2.0.  No forms, or tables.
  41 In addition a small set of tools are are available to customize the HTML
  42 screen's text:
  43
  44 1a)  Default and function key bindings are separated like this:
  45
  46 <!--chtml if pinemode="function_key"-->
  47         Function key bindings here
  48 <!--chtml else-->
  49         Default key bindings here
  50 <!--chtml endif-->
  51
  52
  53 1b)  A way to distinguish HTML text that is to be displayed when
  54      pine is running vs. when the text is served up outside Alpine
  55      (someday) can be done via:
  56
  57 <!--chtml if pinemode="running"-->
  58    Text displayed when viewed within a running pine session
  59 <!--chtml else-->
  60    Text displayed when HTML viewed outside pine (using chtml aware server)
  61 <!--chtml endif-->
  62
  63 1c)  A way to distinguish HTML text that is to be displayed under
  64      PC-Alpine vs. not is available via:
  65
  66 <!--chtml if pinemode="os_windows"-->
  67    Text displayed under PC-Alpine
  68 <!--chtml else-->
  69    Text displayed otherwise
  70 <!--chtml endif-->
  71
  72 WARNING ABOUT CHTML "if-else-endif" CLAUSES: They don't nest.
  73
  74 2a) Several "server side include" commented elements are supported:
  75
  76 <!--#include file="textfile"-->
  77
  78 The file "textfile" will be inserted into the HTML text directly.
  79 Alpine does no formatting of the text.  At some point we might want to
  80 look at the first line for <HTML> but not today.
  81
  82 2b) Various bits of Alpine's running state can be inserted into the
  83 HTML text as well using the special comment:
  84
  85 <!--#echo var="variable"-->
  86
  87 Where "variable" is one of either:
  88
  89     ALPINE_VERSION
  90     ALPINE_REVISION
  91     ALPINE_COMPILE_DATE
  92     ALPINE_TODAYS_DATE
  93     C_CLIENT_VERSION
  94     _LOCAL_FULLNAME_
  95     _LOCAL_ADDRESS_
  96     _BUGS_FULLNAME_
  97     _BUGS_ADDRESS_
  98     CURRENT_DIR
  99     HOME_DIR
 100     PINE_CONF_PATH
 101     PINE_CONF_FIXED_PATH
 102     PINE_INFO_PATH
 103     MAIL_SPOOL_PATH
 104     MAIL_SPOOL_LOCK_PATH
 105     VAR_<VARNAME> - where <VARNAME> is config variable name
 106     FEAT_<FEATURENAME> - where <FEATURENAME> is config feature name
 107
 108 3) The URL scheme "X-Alpine-Gripe:" is available to insert links to
 109    pine's composer such that various debugging data can be attached to the
 110    message. Aside from normal email addresses, this can be set to
 111    either "_LOCAL_ADDRESS_" for the configured local help address, or
 112    "_BUGS_ADDRESS_" for the configured local bug reporting address.
 113    Aside from the special tokens above, the default behavior only differs
 114    from "mailto:" by the insertion of a special Subject: prefix that
 115    consists of a randomly-generated token for tracking purposes.
 116    Several optional parameters can be included to control what is
 117    attached or offered for attachment to the message:
 118
 119         ?config  --  Automatically attaches the user's configuration
 120                      information to the trouble report
 121         ?keys    --  Automatically attaches the user's most recent
 122                      keystrokes
 123         ?curmsg  --  Causes the user to get an offer to attach the
 124                      current message to the trouble report
 125         ?local   --  Automatically attaches the result of the script
 126                      defined by VAR_BUGS_EXTRAS
 127
 128 For HTML-format sections, the help screen dividers  "===== xxxx ====" must
 129 contain one and only one space after the first and before the second set of
 130 equal signs.
 131
 132 Note to authors of this file: to mark sections that need further revision,
 133 please use the text string on the following line consistently so that it is
 134 easy to find those places again in this file:
 135 *revision needed*
 136
 137 NOTE: Several sections of help text which weren't being used were removed
 138 at RCS version number 4.122.  In particular, there were some placeholders
 139 with help text for the config screen and the composer that didn't have any
 140 reasonable place to be called from.
 141 Dummy change to get revision in pine.hlp
 142 ============= h_revision =================
 143 Alpine Commit 488 2020-07-09 00:16:30
 144 ============= h_news =================
 145 <HTML>
 146 <HEAD>
 147 <TITLE>RELEASE NOTES for Alpine</TITLE>
 148 </HEAD>
 149 <BODY>
 150 <H1>Alpine Release Notes</H1>
 151 <DIV ALIGN=CENTER>
 152 Version <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)
 153 <BR>
 154 <!--chtml if pinemode="running"-->
 155 (built <!--#echo var=ALPINE_COMPILE_DATE-->)
 156 <!--chtml endif-->
 157
 158 <BR>
 159 <BR>Copyright 2013-2020 Eduardo Chappa
 160 <BR>Copyright 2006-2008 University of Washington
 161 </DIV>
 162
 163 <P>
 164 Alpine is an &quot;Alternatively Licensed Program for Internet
 165 News and Email&quot; produced until 2009 by the University of Washington.
 166 It is intended to be an easy-to-use program for
 167 sending, receiving, and filing Internet electronic mail messages and
 168 bulletin board (Netnews) messages.  Alpine is designed to run on a wide
 169 variety of Unix&reg; operating systems.  A version for Microsoft Windows&reg;
 170 is available as is a world wide web based version designed to run under the
 171 Apache web server.
 172
 173 <P>
 174 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
 175 href="h_apache_license">Apache License 2.0</A>.
 176
 177 <P>
 178 Alpine's privacy policy is a living, online only, document, which can be found at
 179 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
 180 By following the previous link,  Alpine
 181 will connect to an external server, and will download it and display
 182 it for you. Please take some time to read it and understand it.
 183 Since the Privacy Policy could be ammended to take into consideration
 184 new additions to Alpine, please check it periodically.
 185
 186 <P>
 187 This is a development version of Alpine. These enhancements are
 188 released after the release of version 2.23. Please report any
 189 problems you find with this release.
 190
 191 <P> Additions include:
 192
 193 <UL>
 194 <LI> Expansion of the configuration screen for XOAUTH2 to include
 195      username, and tenant.
 196
 197 <LI> If a user has more than one client-id for a service, Alpine tries to
 198      asks the user which client-id to use and associates that client-id to
 199      the credentials in the XOAUTH2 configuration screen.
 200      <A HREF="h_xoauth2_config_screen">Learn more</A>.
 201
 202 <LI> Addition of a link to the Apache License 2.0 (see above). This is
 203      available from the Release Notes as well as the welcome screen.
 204
 205 <LI> Modifications to protect the privacy of users:
 206 <UL>
 207 <LI> Alpine does not generate Sender or X-X-Sender by default
 208      by enabling  <a href="h_config_disable_sender"><!--#echo var="FEAT_disable-sender"--></a>
 209      as the default.
 210 <LI> Alpine does not disclose User Agent by default by enabling
 211      <A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A>
 212      by default.
 213 <LI> Alpine uses the domain in the From: header of a message
 214      to generate a message-id and suppresses all information
 215      about Alpine, version, revision, and time of generation
 216      of the message-id from this header. This information is
 217      replaced by a random string.
 218 </UL>
 219
 220 <LI> Unix Alpine displays configure options and flags when
 221      invoked as &quot;alpine -v&quot;. Suggested by Matt Ackeret.
 222
 223 <LI> Alpine will ding the terminal bell when asking  about quitting
 224      when new mail arrives. This is consistent with Alpine dinging the
 225      bell when new mail arrives. The bell will not ding if it is disabled
 226      for status messages. Suggested by Chime Hart.
 227
 228 <LI> When messages are selected, pressing the &quot;;&quot; command to broaden or narrow
 229      a search, now offers the possibility to completely replace the search, and
 230      is almost equivalent to being a shortcut to &quot;unselect all messages, and select
 231      again&quot;. The difference is that cancelling this command will not unselect
 232      all currently selected messages. Suggested by Holger Trapp.
 233
 234 <LI> Alpine will not write debug files unless started with the option -d,
 235      so for example &quot;alpine -d 2&quot; will generate a debug file at level 2,
 236      but just issuing the alpine command will not write any debug to a file.
 237 </UL>
 238
 239 <P>
 240 Bugs addressed:
 241
 242 <UL>
 243 <LI> When Alpine starts a PREAUTH connection, it might still ask the user
 244      to login. Reported by Frank Tobin.
 245
 246 <LI> Invalid signatures created by Alpine, when built with recent
 247      releases of the Openssl-1.1.1 series (but not in the Openssl-1.0.1 series).
 248      Fix contributed by Bernd Edlinger.
 249
 250 <LI> After returning from the directory side of a dual-folder, sometimes
 251      Alpine would return to the first folder in the parent directory or to
 252      the dual-folder. The fix is to return to the original dual-folder as
 253      intended. Reported by Holger Trapp.
 254
 255 <LI> When an attachment is deleted and the original message is saved, Alpine
 256      might write only a part of the name of the file deleted. Reported by Holger
 257      Trapp.
 258
 259 <LI> URLs that are surrounded by white space are not cleaned by Alpine before
 260      passing them to the browser, resulting in no display of the URL when Alpine
 261      tries to open it. Reported by Gregory Heytings.
 262
 263 <LI>  When Alpine is built without smime, password file functionality might
 264       fail. Reported by Andres Fehr.
 265 </UL>
 266
 267 <P>
 268 Version 2.23 has new additions and addresses bugs found in previous releases.
 269
 270 <P>
 271 Additions include:
 272
 273 <UL>
 274 <LI> Implementation of XOAUTH2 authentication support for Outlook.
 275      Based on documentation suggested by Andrew C Aitchison.
 276
 277 <LI> Add support for the OAUTHBEARER authentication method in Gmail. Thanks to
 278      Alexander Perlis for suggesting it and explaining how the method works.
 279
 280 <LI> Creation of Alpine's Privacy Policy. This is presented as a link to
 281     an online document from the Release Notes (Link at the top of this
 282     document.) Upon user request, Alpine downloads and displays this
 283     document. Links to the privacy policy are also displayed when a user
 284     starts Alpine for the first time, or when a user starts a new version
 285     of Alpine. There is no default exit greeting command for these
 286     screens, and to exit the user must press "E", instead of the old
 287     default, which was the RETURN command. The RETURN command will open
 288     the handle on which the cursor is on, which by default is the Privacy
 289     Policy.
 290
 291 <LI> Support for the SASL-IR IMAP extension that avoids a round trip during
 292      authentication. Similar support added for the SMTP, NNTP and POP3
 293      protocols. Thanks to Geoffrey Bodwin for a report that lead to this
 294      implementation.
 295
 296 <LI> Alpine can pass an HTML message to an external web browser, by using the
 297      &quot;External&quot; command in the <a href="h_attachment_screen">ATTACHMENT INDEX</a>
 298      screen. <A href="h_command_external_browser">Learn more</A>.
 299
 300 <LI> New configuration variable
 301      <a href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
 302      that controls if Alpine will keep the source link to all the images in the
 303      HTML message, or will only pass a link to inline images included in the message. For your
 304      privacy and security this feature is enabled by default.
 305
 306 <LI> When reading an email and a user selects an email address to which to compose
 307      a message from the message, the user will be able to select a role to compose
 308      that message.
 309
 310 <LI> New variable system-certs-path that allows users to indicate the
 311      location of the directory where certificates are located. In PC-Alpine
 312      this must be C:\\libressl\\ssl\\certs. The C: drive can be replaced
 313      by the name of the drive where the binary and DLL files are located.
 314
 315 <LI> New variable system-certs-file that allows users to configure the
 316      location of a container of certificate authority (CA) certificates
 317      to be used to validate certificates of remote servers.
 318
 319 <LI> Remove sleep of 5 seconds for mailcap programs that use the terminal
 320      to display content. Suggested by Carl Edquist. In addition, remove the
 321      configurable process table command and its corresponding sleep time.
 322 </UL>
 323
 324 <P>
 325 Bugs addressed:
 326
 327 <UL>
 328  <LI> Security Bug: Alpine can be configured to start a secure connection using /tls
 329       on an insecure connection. However, if the connection is PREAUTH, Alpine
 330       will not upgrade the connection to a secure connection, because a client
 331       must not issue a STARTTLS to a server that supports it in authenticated
 332       state. This makes Alpine continue to use an insecure connection with the
 333       server, exposing user data. Reported by Damian Poddebniak and Fabian
 334       Ising from Münster University of Applied Sciences.
 335
 336    <LI> Selecting by subject might not copy the subject of the current message
 337      to the selection text correctly. Reported by Iosif Fettich.
 338
 339    <LI> Alpine does not set the return path correctly when using a role while bouncing
 340     a message. Reported by Dr. C. Griewatsch.
 341
 342 <LI>Bug in PC-Alpine that made Alpine go into an infinite loop and
 343     consume CPU when it was iconized. Reported by Holger Schieferdecker in
 344     comp.mail.pine.
 345
 346 <LI>Crash in Alpine when attempting to reply to a multipart/alternative
 347     message that is malformed, and the option to include attachments in
 348     reply is enabled. Reported and patched by Peter Tirsek.
 349
 350 <LI>Bug that makes Alpine split encoded words in the subject of a message
 351     in the middle of a utf-8 character into two encoded words, breaking the
 352     encoding. Reported by Jean Chevalier.
 353
 354 <LI> Alpine would not redraw the screen when a check for new mail in an
 355     incoming folder failed due to a failure while validating the server
 356     certificate, and the user did not allow the connection to proceed.
 357
 358 <LI> Crash in Alpine while resizing the screen when using any of the tokens
 359     SUBJKEYTEXT, SUBJECTTEXT, or SUBJKEYINITTEXT in the index format, and
 360     the screen was resized. Reported by Iggy Mogo.
 361
 362 <LI> When Alpine is trying to authenticate to Gmail, using the XOAUTH2 method,
 363     it does not display the url the user needs to open, in order to authorize
 364     Alpine to access Gmail using XOAUTH2 when Alpine still has not created
 365     a screen. Reported by Baron Fujimoto.
 366
 367 <LI> When an html anchor does not quote the link in the href parameter,
 368     alpine does not link to it.
 369
 370 <LI> Attempt to fix a bug that breaks scrolling of a message in Alpine when
 371      the screen is resized. Reported in the Debian bug system at
 372      <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=956361">https://bugs.debian.org/cgi-bin/bugreport.cgie?bug=956361</A>.
 373 </UL>
 374
 375 <P>
 376 Version 2.22 addresses bugs found in previous releases and has several
 377 additions as well.
 378
 379 <P>
 380 Additions include:
 381
 382 <UL>
 383 <LI> Support for <A HREF="h_xoauth2">XOAUTH2</A> authentication method in Gmail.
 384
 385 <LI> PC-Alpine builds with LibreSSL and supports S/MIME.
 386
 387 <LI> NTLM authentication support with the ntlm library, in Unix systems.
 388 Based on code provided by Maciej W. Rozycki.
 389
 390 <LI> Add /tls1_3 flag for servers that support it. Read more information
 391 in the secure protocols <A HREF="h_network_encryption_security">help</A>.
 392
 393 <LI> To increase user's privacy, remove phone-home code that would prompt
 394 users to send an email message upon starting Alpine for the first time for
 395 purposes of counting. Your use of Alpine does not disclose information about
 396 you or your use of Alpine to the developers of Alpine.
 397
 398 <LI> New variable
 399 <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A>
 400 that allows users to configure versions of the SSL/TLS protocol that Alpine is
 401 restricted to try when establishing a secure connection SSL/TLS to a remote
 402 server. The default can be set at compilation time.
 403
 404 <LI> Add -dict option to PC-Pico, which allows users to choose a dictionary
 405 when spelling. Sample usage: -dict "en_US, de_DE, fr_FR".
 406
 407 <LI> Improvements to the configure stage of compilation. Some of
 408 these contributed by Helmut Grohne. See
 409 <A href="https://bugs.debian.org/876164">Bug 876164</A> in Debian.
 410
 411 <LI> Add &quot;remove password&quot; command to the management screen for the
 412 password file encryption key. This allows users to use their password file
 413 without entering a master password.
 414
 415 <LI> Add the &quot;g&quot; option to the select command that works in IMAP
 416 servers that implement the X-GM-EXT-1 capability (such as the one offered
 417 by Gmail.) This allows users to do selection in Alpine as if they were
 418 doing a search in the web interface for Gmail.
 419
 420 <LI> New variable close-connection-timeout, which tells Alpine to close
 421 a connection that is having problems being kept alive after the number
 422 of seconds configured in this variable, if the connection has not
 423 recovered. The default is 0, which means to keep the connection alive
 424 and wait for the connection to recover.
 425
 426 <LI> When a message is of type multipart/mixed, and its first part is
 427 multipart/signed, Alpine will include the text of the original message
 428 in a reply message, instead of including a multipart attachment.
 429 Suggested by Barry Landy.
 430
 431 <LI> S/MIME: Some clients do not transform messages to canonical form when
 432 signing first and encrypting second, which makes Alpine fail to parse the
 433 signed data after encryption. Reported by Holger Trapp.
 434
 435 <LI> Add /auth=XYZ to the way to define a server. This allows users to
 436 select the method to authenticate to an IMAP, SMTP or POP3 server.
 437 Examples are /auth=plain, or /auth=gssapi, etc.
 438
 439 <LI> Add backward search in the index screen. Based on patch by Astyanax Foo,
 440 submitted in 2009, but resubmitted by Erich Eckner on 2019.
 441
 442 <LI> SMIME: When Alpine is set to validate a message using the user's store, and
 443      user agrees to save a certificate of another user, use the saved
 444      certificate immediately to verify the smime message. Reported by
 445      Stefan Mueller.
 446
 447 <LI> Do not use a delay when printing messages to screen when the initial
 448      keystroke sequence of commands is active. Based on a report from Holger
 449      Trapp.
 450
 451 <LI> In PC-Alpine, when the decoded name of an attachment does not agree
 452      with its encoded name, Alpine will offer to save the file using the
 453      UTF8 encoded name.
 454 </UL>
 455
 456 <P>
 457 Bugs that have been addressed include:
 458 <UL>
 459    <LI> Width of characters is not always determined correctly when wcwidth
 460         is used. Revert to using code for the Windows operating system.
 461         Reported by Andrew Ho.
 462
 463    <LI> The call realpath(..., NULL) gives an error in Solaris, which means that
 464         we need to allocate memory for storing the resolved path. Reported by
 465         Fabian Schmidt.
 466
 467    <LI> Crash when attempting to bounce a message due to lack of space in
 468         allocated space for key menu array. Reported by David Sewell.
 469
 470    <LI> Crash when a CA certificate failed to load, and user attempted to
 471         view certificate information of other certificate authorities.
 472
 473    <LI> Crash in the S/MIME configuration screen when a user turned off S/MIME, and
 474         then re-enabled it. Also crash when attempting to enter the S/MIME
 475         configuration screen if S/MIME was turned off.
 476
 477    <LI> Deactivate some color code from Pico (as standalone editor in the
 478         windows version) until I find a way to activate it again. This is
 479         not critical and it is not something that PC-Pico must have (some
 480         of it already exists in other ways, like color support, what does
 481         not exist is the more complex code that Unix-Pico has with color
 482         codes for specific colors.)
 483
 484    <LI> When a message is multipart, and the first part is flowed text,
 485         then forwarding the message will set the first part to be flowed,
 486         and sent that way even when the option Do Not Send Flowed Text is
 487         enabled. Reported by Holger Trapp.
 488
 489    <LI> When a message/rfc822 part of a message is encoded with
 490         Content-Transfer-Encoding: QUOTED-PRINTABLE, Alpine will stop
 491         processing that message. Later this causes Alpine to crash because
 492         when it displays messages, it assumes that both header and body
 493         parts are processed. Reported by Mark Crispin in 2010, in the
 494         Alpine-info list (message with subject "crash bug in
 495         alpine/mailpart.c:format_msg_att()") with no example, and reported
 496         now by Holger Trapp, with an example.
 497
 498    <LI> In addition to the previous report, Alpine encodes message/rfc822
 499         messages as QUOTED-PRINTABLE, in contradiction with RFC 2045,
 500         when it receives a report that its encoding is 8bit. We preserve
 501         the encoding reported by the IMAP server, and do not encode in
 502         QUOTED-PRINTABLE.
 503
 504    <LI> Update build.bat file to add /DWINVER=0x0501 so that Alpine can
 505         build when using Visual Studio 2017. Fix contributed by
 506         Ulf-Dietrich Braunmann.
 507
 508    <LI> When the locale is not set up to UTF-8, alpine might determine the
 509         width of a character incorrectly. Reported by Alexandre Fedotov.
 510
 511    <LI> In some rare cases, when attachments are deleted before saving
 512         emails, the filenames will be displayed in RFC1522 representation,
 513         instead of in decoded form. Reported and patched by Wang Kang.
 514
 515    <LI> When colors are edited from the main setup configuration screen, some
 516         color settings are not updated until Alpine is restarted. Reported by
 517         Andrew Hill.
 518
 519    <LI> If the first part of a message is multipart/alternative, and the
 520         first part of this is also a multipart type, then Alpine might
 521         fail to select the first text part when replying to a message.
 522         Reported by Lucio Chiappetti.
 523
 524    <LI> TLS 1.2 works does not work if Alpine is compiled with openssl &gt;= 1.1.0.
 525         Reported and patched by Kyle George.
 526
 527    <LI> If the directory where Alpine saves the certificates is empty,
 528         alpine would not create a self-signed certificate to encrypt the
 529         password file.
 530
 531    <LI> S/MIME: The list of public certificates is freed before it is
 532         reused when a signature fails to verify. This causes Alpine to
 533         crash. Patch submitted by Linus Torvalds.
 534
 535    <LI> S/MIME: A message could fail to verify its signature even if the
 536         certificate was saved when the message was open. Based on a report
 537         by David Woodhouse to the RedHat bugzilla system.
 538
 539    <LI> When there are time changes in the clock, Alpine might go to sleep
 540         for big amounts of time while displaying messages in the screen.
 541         Reset sleep time to 5 seconds in case it finds it needs to sleep
 542         more than 5 seconds or a negative amount of time.
 543
 544    <LI> Restore recognition of empty directories. It was deleted by mistake
 545         when added support for internationalization in folders. Based on a
 546         report by Michael Rutter.
 547
 548    <LI> Alpine stops parsing the mailcap file when it finds an invalid entry.
 549         Reported by Matt Roberds to the Debian bug system at
 550         <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370">https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370</A>.
 551
 552    <LI> Crash with error "Lock when already locked" when an attempt to check
 553         for new mail on a locked stream that is being used for a save
 554         operation. Reported by Carlos E.R.
 555
 556    <LI> Alpine removes trailing spaces from passwords, making a longin attempt
 557         fail. Reported by R. Lyons.
 558
 559    <LI> Alpine crashes when opening a remote imap folder and computing scores.
 560         Reported by Paul DeStefano.
 561
 562    <LI> When more than one server was given in the server-name configuration
 563         option of rldap servers, none of them worked. Reported by Robert Wolf.
 564 </UL>
 565
 566 <P>
 567 Version 2.21 addresses bugs found in previous releases and has several
 568 additions as well.
 569
 570 <P>
 571 Additions include:
 572 <UL>
 573   <LI> PC-Alpine: New configuration option "Aspell Dictionaries" allows a
 574        user to choose the dictionary used to spell check, in case the user
 575        communicates in more than one language. Examples of values for the
 576        variable are "en_US" or "de_DE", etc. Only the first 10
 577        dictionaries are offered.
 578
 579   <LI> Unix-Alpine: Connect securely to a LDAP server on a secure port.
 580        Based on a contribution by Wang Kang.
 581
 582   <LI> Colors configured in Alpine are inherited in the composer.
 583
 584   <LI> When Alpine is compiled with password file and SMIME support
 585        the password file is encrypted using a private key/public
 586        certificate pair. If one such pair cannot be found, one will be
 587        created. <A HREF="h_password_file_support">Learn more</A>.
 588
 589   <LI> Alpine builds with any version of OpenSSL greater than or equal
 590        to 1.0.0c. This includes version 1.1.0. Alpine also builds with
 591        LibreSSL.
 592
 593   <LI> New SHORTSUBJECT, SHORTSUBJKEY and SHORTSUBJKEYINIT token for index
 594        format, which removes text in the SUBJECT between &quot;[&quot; and
 595        &quot;]&quot;.
 596
 597   <LI> New SMARTTIME24 token for index screen. It is close to SMARTDATETIME
 598        but it differns in that it gives the time in which the message was
 599        sent for messages that are less than a week old. it uses a 24 hour
 600        format.
 601
 602   <LI> Alpine will include attachments when forwarding some
 603        multipart/alternative messages for which it did not use to include
 604        attachments.
 605
 606   <LI> New configuration option
 607        <a href="h_config_alt_reply_menu"><!--#echo var="FEAT_alternate-reply-menu"--></a>
 608        which adds more ways to control features and variables when you
 609        start to reply to a message.
 610
 611   <LI> Added support for RFC 2971 - IMAP ID extension.
 612
 613   <LI> Add configuration <A href="h_config_ignore_size"><!--#echo var="FEAT_ignore-size-changes"--></A>
 614        that allows users to ignore errors in the computation of the size
 615        of a message from defective servers.
 616
 617   <LI> SMIME: Upgrade the default signature digest from sha1 to sha-256, since
 618        clients such as Thunderbird do not validate signatures that use sha1 digest.
 619
 620   <LI> Add the configuration variable "default-directories", which is called
 621        <A href="h_config_history"><!--#echo var="VAR_default-directories"--></A>
 622        variable saves a list of directories that are readily accessible
 623        for save or export of attachments. This makes it easier to save
 624        attachments in directories that are hard to navigate to, or that
 625        are accessed frequently.
 626
 627   <LI> When a filename is attached and its name is encoded, the save
 628        attachment command will offer to save the file in the encoded form.
 629        This might work for some users, but the save command will have a
 630        subcommand ^N to decode the file name and save the file with the
 631        decoded name.
 632
 633   <LI> The TAB key allows autocomplete in the Fcc field in the composer headers,
 634        as well as autocompletes automatically when only one possibility exists
 635        for the ^J attach command.
 636
 637   <LI> Add support for the &quot;TYPE&quot; and &quot;VALUE&quot; attributes of
 638        the html OL tag.
 639
 640   <LI> Ignore message from smtp server after a successful authentication
 641        challenge.
 642
 643   <LI> When a message is saved in the Form Letter folder, add the ability
 644        to save the role being used to compose such message so that settings
 645        such as the SMTP server set in the role can be used when sending
 646        such form message. Suggested and patched by Frank Doepper.
 647
 648   <LI> If SSLDIR is defined somehow, do not disable S/MIME if the
 649        SSLCERTSDIR is not found.
 650
 651   <LI> When Alpine sends an attachment, it will set the boundary attribute
 652        in lower case, as some SMTP servers, such as those of libero.it
 653        reject messages if the boundary attribute is in uppercase.
 654
 655   <LI> Add the ability to change the private key and certificates used
 656        to encrypt a password file in the SMIME setup configuration screen.
 657        <A HREF="h_config_smime_password_file_certificates">Learn more</A>
 658
 659   <LI> SMIME: The ctrl-E command that gives information on the certificate
 660        is only available for messages that have a signed or encrypted
 661        part.
 662
 663   <LI> SMIME: If a message contains a RFC822 attachment that is
 664        signed/decrypted add the ability to view its SMIME information.
 665
 666   <LI> SMIME: Certificate information in the S/MIME screen is available
 667        for certificates stored in a container.
 668
 669   <LI> SMIME: Offer the common name of the person, instead of the name of
 670        file containing the certificate, as the name to be displayed in the
 671        certificate management screen for certificate authorities.
 672        Suggested by Matthias Rieber.
 673
 674   <LI> SMIME: Management of several alternate name (SAN) certificates is
 675        improved. When importing a SAN certificate, also import a certificate
 676        for the filename, besides for the e-mail addresses in the
 677        certificate. Suggested by Matthias Rieber.
 678
 679   <LI> SMIME: add full year when displaying information about a certificate
 680        in the certificate management screen. Suggested by Matthias Rieber.
 681
 682   <LI> SMIME: sort certificates by some type of alphabetical order in the
 683        displayed name.
 684
 685   <LI> SMIME: Alpine will ask users if they wish to save S/MIME
 686        certificates included in signatures, when the option "Validate
 687        Using Certificate Store Only" is enabled. If the user does not wish
 688        to save it, validation will fail.
 689
 690   <LI> HTML: Add support for decoding entities in hexadecimal notation.
 691        Suggested by Tulip&aacute;nt Gergely.
 692
 693   <LI> The &quot;#&quot; command, when used as part of an aggregate
 694        operation will allow users to select the role used in either
 695        replying, forwarding or replying to the group of selected messages,
 696        Suggested by Hisashi T Fujinaka.
 697
 698   <LI> If the charset of a message can not be determined, use the value set
 699        in the <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A> for its value.
 700
 701   <LI> Resizing setup screen will redraw screen.
 702
 703   <LI> Unix Alpine only. Experimental: If Alpine/Pico finds a UCS4 code
 704        in the width ambiguous zone, it will use other means to determine
 705        the width, such as call wcwidth.
 706
 707   <LI> Pico: Code reorganization in the search command to make it easier to
 708        add subcommands of the search command.
 709
 710   <LI> Pico: Search command can do a case sensitive match. Use the Ctrl-^
 711        subcommand of the search command to bring this choice into view.
 712
 713   <LI> Pico: Add the ability to search for strings in the beginning or end
 714        of a line. Use the Ctrl-^ subcommand of the search command to bring
 715        this choice into view.
 716
 717   <LI> For a multipart/alternative message, the Take Address command will
 718        work on the part that is being read.
 719
 720   <LI> When sending a message, allow for 512 characters of consecutive
 721        non-white space before folding the subject line.
 722
 723   <LI> Make sure titlebar (the line at the top of the screen) always
 724        contains the name of the folder/newsgroup that is open, if this
 725        fits in the title.
 726
 727   <LI> The feature <a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
 728        will also scramble the name, version and operating system in the
 729        message-id header. Based on a contribution by Dennis Davis, which
 730        is itself based on a contribution by Mark Hills.
 731
 732   <LI> Change in logic in imap_set_password function to make Alpine ask if
 733        a user wants to save a password before reading the password file.
 734
 735   <LI> When exporting all parts of a message, if two attachments have the same
 736        name, do not overwrite a file more than once, but instead add a counter
 737        number to the filename to make a new file that does not exist in the file
 738        system.
 739
 740   <LI> Add the Control-R subcommand to the save command for attachments.
 741        This subcommand toggles if the saving will be done in binary mode
 742        for text attachments. When a user saves an attachment using binary
 743        mode it will be saved as it was sent, otherwise the attachment will
 744        be transformed to UTF-8 for further transformation through internal
 745        and user defined filters for saving.
 746
 747   <LI> Add command line argument -smimedir, which allows users to specify
 748        the default path for a directory that contains the public, private,
 749        and ca directories. This is useful in case a user has a backup of
 750        old certificates that cannot be installed in the ~/.alpine-smime
 751        dir.
 752
 753   <LI> Reimplementation of the code that allows the .pinerc file to be a
 754        symbolic link by Kyle George from tcpsoft.com to use realpath.
 755
 756   <LI> When saving an attachment, the "^T" command leads to a screen where the
 757        "A" command can be used to add a file. A directory can be added by
 758        pressing "^X" after the "A" command. Added after a suggestion by
 759        Stefan Goessling.
 760
 761   <LI> When saving an attachment, the ^Y and ^V commands allow a user to
 762        scroll through the history of directories used to save attachments,
 763        while preserving the given name of the file. Suggested by Peter
 764        Koellner.
 765
 766   <LI> SMIME: Turn off automatic signing and encrypting of a message when
 767        bouncing. Suggested after a discussion with Matthias Rieber.
 768
 769   <LI> When messages are selected, warn the user if a message that is not
 770        selected will be bounced, or if not all selected messages will be
 771        bounced. Suggested by Ulf-Dietrich Braumann.
 772
 773   <LI> The bounce command adds a subcommand to choose a role.
 774
 775   <LI> When selecting messages by number, the &quot;.&quot; character can
 776        be used to specify the message on which the cursor is on.
 777
 778   <LI> When Alpine opens an attachment, it sometimes changes the extension
 779        of the file that is being opened and replaces it by another for the
 780        same mime type. If Alpine finds that the extension of the file
 781        corresponds with the mime type, according to the mime-types file,
 782        then it will keep it, and no substitution will be made.
 783
 784   <LI> Set no restrictions on the length of encoded subjects, but encode
 785        words in length of no more than 75 characters.
 786 </UL>
 787
 788
 789 <P>
 790 Bugs that have been addressed include:
 791 <UL>
 792   <LI> SMIME: Crash when a certificate has an invalid date of validity. Also
 793        Alpine will use the function ASN1_TIME_print to determine the date
 794        of validity. Reported by Ben Stienstra.
 795
 796   <LI> SMIME: Crash when attempting to unlock the password file and an
 797        incorrect password is entered.
 798
 799   <LI> SMIME: Crash when checking the signature of a message that contains
 800        a RFC822 attached message. Reported by Holger Trapp and Bj&ouml;rn
 801        Krellner.
 802
 803   <LI> SMIME: Cancelling entering password to unlock key will not reprompt.
 804
 805   <LI> SMIME: fix a bug that did not allow users to transfer certificates to
 806        remote containers. Reported by Matthias Rieber.
 807
 808   <LI> SMIME: certificates included in messages were not being transferred
 809        to a remote container.
 810
 811   <LI> SMIME: Crash if public certificates are located in an inaccessible
 812        remote server and the private key is not available.
 813
 814   <LI> SMIME: Alpine does not remove temporary files created when adding a
 815        CA certificate to a container. Reported by Holger Trapp.
 816
 817   <LI> SMIME: When reading a local certificate, Alpine converts the name
 818        of the certificate to lowercase, which may make Alpine not be able
 819        to read such certificate. Reported by Dennis Davis.
 820
 821   <LI> SMIME: If the option "Remember S/MIME Passphrase" is disabled, then
 822        entering a password to read an encrypted message will make Alpine
 823        forget the key and not ask the password to unlock it again in case
 824        it is necessary to unlock it again. Reported by Ulf-Dietrich
 825        Braumann.
 826
 827   <LI> Alpine would use freed memory while trying to compute the color
 828        of the titlebar. This happened when trying to continue a postponed
 829        message.
 830
 831   <LI> Alpine failed to read an encrypted password file if too many
 832        passwords were saved in the password file.
 833
 834   <LI> When selecting messages while in Threaded Index Screen, some
 835        messages other than top of threads could appear in the index, making
 836        Alpine display messages &quot;out of the screen.&quot;
 837
 838   <LI> The index format would be chopped at the position of an unrecognized
 839        token, instead of skipping the token as intended.
 840
 841   <LI> Work in progress: Avoid calling non-safe functions when Alpine
 842        receives a signal. See bug report
 843        <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=825772">here.</A>
 844
 845   <LI> Crash when attempting to read a message after a bounce command.
 846        In order to produce a crash one needed to use the ^T subcommand and
 847        do a search in a LDAP directory. The crash is produced by changes
 848        to the text in the title bar. Reported by Heinrich Mislik in the
 849        Alpine-info list.
 850
 851   <LI> HTML messages that contain UTF-8 may wrap at the wrong position,
 852        making Alpine not display the correct character at the position
 853        that wrapping is done. Reported by Wang Kang.
 854
 855   <LI> Pico: Searching for a string that is too long causes Pico to crash
 856        in the next search.
 857
 858   <LI> Fix vulnerability in regex library. This only affects those who use
 859        this library, such as the windows version of Alpine. See
 860        <A HREF="http://www.kb.cert.org/vuls/id/695940">http://www.kb.cert.org/vuls/id/695940</A>
 861        for more details.
 862
 863   <LI> Alpine would not set include and lib paths for OpenSSL if this was
 864        installed in /usr/local/ssl.
 865
 866   <LI> If the .pinerc file is a symbolic link, Alpine might not write its
 867        contents when saving its configuration.
 868
 869   <LI> The _INIT_ token does not skip over non-alphanumeric characters in
 870        the name. Reported by Andreas Fehr.
 871
 872   <LI> When opening an INBOX folder in a context different from the
 873        incoming folders collection, from the command line, Alpine would
 874        open the INBOX folder from the incoming folders collection.
 875
 876   <LI> Mismatch in size of UCS and CELL caused a corruption in the
 877        content of a pointer, which made the speller in PC-Alpine get the
 878        content of a word incorrectly.
 879
 880   <LI> Skip testing openssl compatibility version when cross-compilation
 881        is detected. Fix contributed by Antti Sepp&auml;l&auml;
 882
 883   <LI> Alpine fails to remove temporary files used during a display or sending
 884        filter. Fix contributed by Phil Brooke.
 885
 886   <LI> When the index is in zoomed state, adding new messages to the
 887        selection would not show those messages if those messages are on
 888        top of the current message in the top of the screen. Reported by
 889        Ulf-Dietrich Braumann. In addition, when the user scrolls through
 890        the index, this scroll smoothly, without jumping pages. Reported
 891        by Holger Trapp.
 892
 893   <LI> Crash when reviewing history of saving attachments.
 894
 895   <LI> Crash when canceling a goto command on a local collection that has
 896        not been expanded and attempting to expand such collection.
 897
 898   <LI> Crash in Pico when forwarding messages that contain a direction mark
 899        at the end of a line. Reported by James Mingo.
 900
 901   <LI> Solve compilation errors when Alpine is built with Visual Studio 2015.
 902 </UL>
 903
 904
 905 <P>
 906 Version 2.20 addresses bugs found in previous releases and has several
 907 additions as well.
 908
 909 <P>
 910 Additions include:
 911 <P>
 912
 913 <UL>
 914   <LI> Upgrade UW-IMAP to Panda IMAP from
 915        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
 916   <LI> S/MIME: Add screen to manage certificates.
 917   <LI> S/MIME: Signatures are validated using the user's certificates instead
 918        of the ones included in the message. Behavior can be disabled by
 919        disabling the option <A href="h_config_smime_use_cert_store">
 920         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
 921        by default.
 922   <LI> S/MIME: sign messages using intermediate certificates when needed
 923        and possible.
 924   <LI> S/MIME: validation of certificates for servers that modify signed
 925        content.
 926   <LI> S/MIME: signed and encrypted messages will be signed first and
 927        encrypted second, so that they can be decoded by other clients.
 928   <LI> S/MIME: add the sender certificate to the list of certificates in
 929        encrypted messages to make it possible for the sender to decrypt
 930        the message they sent.
 931   <LI> S/MIME: When transferring certificates to a local container, create
 932        container with default names PublicContainer, PrivateContainer and
 933        CAContainer, as appropriate for these files, unless the user has
 934        provided some other names.
 935   <LI> S/MIME: Forwarding a message will include the signed part as part
 936        of the text and not as a multipart message, just as the reply
 937        command does.
 938   <LI> HTML: Style tag in body of html message causes Alpine to not write
 939        its content until a new &lt;/style&gt;
 940   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
 941        the same inline tag; the same is valid for the &lt;HR&gt; tag.
 942   <LI> Add support to selective expunge through a subcommand of the
 943        select-apply commands. Read more in the <A
 944        HREF="h_index_cmd_expunge">help</A> for the expunge command.
 945   <LI> Pico: New subcommand of the search command, allows to reverse the
 946        direction of search.
 947   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
 948        the key and certificate used to encrypt the password file are saved
 949        in the ~/.alpine-smime/.pwd directory, or in the directory specified
 950        by the -pwdcertdir command line option.
 951        <A HREF="h_password_file_support">Learn more</A>.
 952   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
 953        server to use different ways to connect using ssl, for
 954        example {server.com/tls1} will attempt to connect to
 955        server.com at the ssl imap port (port 993) and establish a
 956        connection using TLSv1. These flags can be used in
 957        conjunction with the /ssl flag, the ssl flag is redundant.
 958        Conversely, however, the /ssl flag does not imply any of
 959        these flags; the /ssl flag means SSLv3 or, if not available,
 960        SSLv2 in the SSL port.
 961   <LI> Alpine does not attempt to automatically reopen a collection
 962        that was not opened due to cancellation by the user.
 963        Instead, the user must try to open it explicitly.
 964   <LI> Alpine searches for a certificate that matches an email address in
 965        all addresses in a certificate (instead of just the first
 966        one) but when it tries to unlock the certificate, it asks
 967        for the password for the first email address in that
 968        certificate.
 969   <LI> Style tag in body of html message causes Alpine to not write its content
 970        until a new &lt;/style&gt;
 971   <LI> Experimental: Write the content-type of a message in
 972        lowercase, as some non-compliant servers do not understand
 973        uppercase content-type, such as those of GMX.de.
 974   <LI> Experimental: Do not send the RSET command before attempting
 975        to send a message, as this causes a delay in some evily managed
 976        servers.
 977   <LI> Opening a folder updates recent count in maildrops (this
 978        already works for other types of folders)
 979   <LI> Automatically redraw screen after opening an attachment
 980        instead of simply clearing it.
 981   <LI> Pico: Justification works without need of a predefined quote
 982        string. This allows justification of blocks of text that are
 983        indented with spaces.
 984   <LI> Decode the name of attachment names, so they can be written as part
 985        of the description of the part.
 986   <LI> Check bounds and tie strings off to improve security. Contributed
 987        by James Jerkins.
 988   <LI> Replace tabs by spaces in From and Subject fields to control for
 989        size in screen of these fields. Change only in index screen display.
 990   <LI> Aggregate operations allows bouncing a list of messages using a role.
 991        Suggested by Ulf-Dietrich Braumann.
 992   <LI> Disable saving new passwords to the password file. Implemented
 993        by Louis Raphael from dpslabs.com. <A HREF="h_config_disable_password_file_saving">Learn more.</A>
 994   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
 995      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
 996      Charles M. Register.
 997 </UL>
 998
 999
1000 <P>
1001 Bugs that have been addressed include:
1002 <UL>
1003   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
1004        in personal names. Reported by Lev Gorenstein.
1005   <LI> When writing the .pinerc file, lines were truncated if they were longer
1006        than 10,000 characters. This could cause data corruption, so now lines
1007        are allowed to be of any length.
1008   <LI> S/MIME: signed messages that contained an attachment would not validate.
1009   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
1010        validate. Thanks to Andreas Schamanek for testing, debugging and
1011        advising during the process of fixing this problem.
1012   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
1013        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
1014        and Stefan Mueller.
1015   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
1016        home directory.
1017   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
1018        SMIME making it not possible to sign or encrypt messages.
1019   <LI> S/MIME: Forwarding a signed message might make the body contain mime
1020        information that is not part of the body, and hence making the body
1021        of the message seem wrong.
1022   <LI> S/MIME Alpine would compute incorrectly the signature of a message
1023        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
1024        enabled, the message contains 8bit characters and the smtp server
1025        supports 8bit sending.
1026   <LI> When replying to several messages, subject will be decoded first,
1027        and then stripped from re/fwd before they are compared to determine
1028        the subject of the replied message.
1029   <LI> Crash when tcp connection to NNTP server was lost after connection
1030        had been established, but lost immediately afterwards.
1031   <LI> Crash with message &quot;lock when already locked&quot;, when painting
1032        an index was based on scores that needed information from a remote
1033        addressbook in the same server as the folder opened. Reported by
1034        Peter Koellner.
1035   <LI> Crash in message/rfc822 attachments encoded in base64.
1036   <LI> Postponed messages whose content-type is text/html, text/enriched and
1037        text/richtext are sent with that content-type, even though, after
1038        resuming composition, Alpine had changed its type to text/plain.
1039   <LI> Alpine cannot handle correctly some characters in the Windows-1256
1040        character set, which might lead to a crash or a corruption in the
1041        screen. Work was done to contain the bug. A more complete fix will
1042        be done in a future release. Reported by Professor Robert Funnell.
1043   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
1044   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
1045   <LI> Save command did not warn of existence of a message with a deleted
1046        attachment in an aggregate save, unless cursor was positioned on a message
1047        with a deleted attachment. Reported by Florian Herzig.
1048   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
1049        in an IMAP server.
1050   <LI> DATE tokens were not internally transformed to UTF-8, which made their
1051        values not appear complete in the screen. Reported by Werner Scheinast.
1052   <LI> Fixes to configure script so that it will not require PAM for every system.
1053   <LI> Fix to configure script so that it will use CPPFLAGS instead of
1054        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
1055        during the build. Fix by Ulf-Dietrich Braumann.
1056   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
1057        needs to use tcl_getstringresult() instead. Reported by
1058        Ulf-Dietrich Braumann.
1059   <LI> Quoted string in URL Viewers configuration variable were not
1060        unquoted before passing to viewer.
1061   <LI> Fix in configure script to detect location of tcl library; add
1062        /usr/local in FreeBSD and fix a bug in configure script that used
1063        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
1064        by Werner Scheinast.
1065   <LI> Move SSL configurations from UW-IMAP to configure script, and
1066        update OpenSSL configuration for Mac OS X.
1067   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
1068   <LI> When the download of an attachment is interrumpted, Alpine stills
1069      caches what was downloaded, making the download incomplete for
1070      subsequent calls of Alpine attempting to open the attachment. In the
1071      future, Alpine will not cache any downloaded part of the attachment
1072      when it is interrupted.
1073 </UL>
1074 <P>
1075
1076
1077 <P>
1078 Version 2.11 addresses bugs found in previous releases and has a few
1079 additions as well.
1080
1081 <P>
1082 Additions include:
1083 <P>
1084
1085 <UL>
1086    <LI> Alpine requires version 1.0.0c of Openssl to build.
1087    <LI> Increase encryption of S/MIME encrypted messages.
1088    <LI> Pico: Improvements in justification of paragraphs: lines that begin
1089 with a quote string, followed by a space were considered individual paragraphs,
1090 now they are considered part of a paragraph. Based on earlier joint work
1091 with Jeff Franklin.
1092    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
1093    <LI> Experimental extended support of recognition of UTF-8 in urls based on
1094 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
1095    <LI> Added recognition of ws and wss URIs.
1096    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
1097  <A HREF="h_config_directory_color">directory names</A>,
1098  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
1099    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
1100 used in the display of the INDEX SCREEN.
1101    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
1102 that adds the ability to preserve To: and Cc: fields when replying to a
1103 message, as specified by original sender.
1104    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
1105  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
1106    <LI> Quota command includes subcommands for printing, forwarding, etc.
1107 </UL>
1108
1109 <P>
1110 Bugs that have been addressed include:
1111 <P>
1112 <UL>
1113   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
1114   <LI> Crash when resizing the screen in a configuration screen.
1115   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
1116   <LI> Do not use a shell to open a browser.
1117   <LI> Configure script did not test for crypto or pam libraries.
1118   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
1119   <LI> Change Cygwin directory separator to &quot;/&quot;.
1120   <LI> Alpine could set List- headers, contrary to RFC 2369.
1121 </UL>
1122
1123 <P>
1124 Version 2.10 addresses bugs found in previous releases and has a few
1125 additions as well.
1126
1127 <P>
1128 Additions include:
1129 <P>
1130
1131 <UL>
1132    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
1133    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
1134    <LI> Foreign characters are decoded correctly in IMAP folder names.
1135    <LI> Question about breaking connection to slow servers includes their name.
1136    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
1137    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
1138    <LI> Cygwin: Alpine builds without need of patch.
1139    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
1140    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
1141    <LI> Add support for strong encryption of password file when S/MIME is built in.
1142 </UL>
1143
1144 <P>
1145 Bugs that have been addressed include:
1146 <P>
1147
1148 <UL>
1149    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
1150    <LI> Double allocation of memory in Pico.
1151    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
1152    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
1153    <LI> Not recognition of environment variables in some options.
1154    <LI> Not display of login prompt during initial keystrokes.
1155    <LI> justification of long urls breaks them.
1156    <LI> Incorrect New Mail message when envelope is not available.
1157    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
1158    <LI> Crash when resizing the screen after display of LDAP search.
1159    <LI> Crash when redrawing screen while opening a remote folder collection.
1160    <LI> Infinite loop in scrolltool function during notification of new mail.
1161    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
1162    <LI> No display of signed and encrypted S/MIME messages.
1163    <LI> Alpine will not build with OpenSSL.
1164    <LI> Crash for double locking in calls to c-client.
1165    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
1166    <LI> Ignore the references header when threading messages
1167    <LI> No update of colors in index screen after update to addressbook.
1168 </UL>
1169
1170 <P>
1171 Version 2.01 addresses bugs found in previous releases and has a few
1172 additions as well.
1173
1174 <P>
1175 Additions include:
1176 <P>
1177
1178 <UL>
1179    <LI> Fixed non-ASCII web alpine handling
1180    <LI> Added web alpine help.
1181    <LI> Allow web alpine inbox on second IMAP server.
1182    <LI> Allow web alpine config reset after bad inbox-path gets set.
1183    <LI> Added web alpine ability to create group contact from contact list members.
1184    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
1185    <LI> Tidied up web alpine script layout.
1186    <LI> Fixed web alpine status message ordering
1187    <LI> Added web alpine Fcc setting via Contacts in Compose
1188    <LI> Fixed web alpine autodraft attachment issues
1189    <LI> Fixed web alpine problems with recent count maintenance
1190    <LI> Fixed web alpine newmail arrival display in message list
1191    <LI> Added web alpine confirmation to folder create for Move/Copy
1192    <LI> Added web alpine user-domain support
1193    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
1194 </UL>
1195
1196 <P>
1197 Bugs that have been addressed include:
1198 <P>
1199
1200 <UL>
1201    <LI> In web alpine fixed delete all selected within a search result to reorient
1202         correctly to whole-mailbox message list.
1203    <LI> Fixed web alpine delete in view page to be sensitive to sort
1204    <LI> Fixed web alpine open of folder within directory from folder manager page.
1205    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
1206    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
1207    <LI> Fixed web alpine adding contacts from message list and view
1208    <LI> Fixed web alpine create of non-existent fcc
1209    <LI> Remove mistakenly left debugger statement in web alpine javascript.
1210    <LI> Some UNIX alpine build problems fixed
1211    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
1212         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
1213         by locale charmap call on some Solaris 8 systems.
1214    <LI> MacOS Keychain logins were not working correctly with generic host names, like
1215         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
1216         new password requests when not needed
1217    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
1218         last folder in the list
1219    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
1220         looked for along with the email address
1221    <LI> Changes to configure to get spellcheck options with work with arguments.
1222    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
1223         returned by gethostname (iPhone can do this)
1224    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
1225         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
1226    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
1227         Jake Scott of marganstanley.com.
1228    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
1229         is not used in alpine.
1230    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
1231         Apparently this causes RIM Blackberry BIS service problems. This is not
1232         used in alpine.
1233    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
1234    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
1235         Fix from Ludwig Nussel of SUSE and from Crispin.
1236    <LI> Include whole filename in export filename history
1237    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
1238 </UL>
1239
1240 <P>
1241 Version 2.00
1242 addressed bugs found in previous releases and had a few additions as well.
1243 <P>
1244 Additions included:
1245 <P>
1246
1247 <UL>
1248    <LI> Redesigned Web Alpine interface
1249    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
1250         in UNIX versions of Alpine
1251    <LI> Attempt to include the attachment filename as part of the name of the
1252         temporary file used when viewing an attachment with an external program.
1253         Add some randomness to that filename to make it hard to predict the filename.
1254         Add a filename extension, usually derived from the type/subtype, to the
1255         temporary filename. This was previously done only on Windows and MacOS X.
1256    <LI> Enhance address completion in the composer (TAB command) so that it looks
1257         through nicknames, fullnames, and addresses from the address book; addresses
1258         from the message being viewed, if any; and the results from
1259         <A HREF="h_direct_config">LDAP Directory Server</A>
1260         lookups for all of the defined directory servers that have the
1261         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
1262         feature set.
1263    <LI> Make the default character set setting more liberal in what it will accept
1264         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
1265    <LI> Remove the Alpine revision number from the titlebar in released versions
1266         while leaving it there in snapshot versions
1267    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
1268         display of asterisks when you type a password for Alpine
1269    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
1270    <LI> When the
1271         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
1272         feature is turned on convert not only the dates in the index screen but also
1273         the dates in the MESSAGE VIEW
1274 </UL>
1275
1276 <P>
1277 Bugs addressed in the 2.00 release included:
1278 <P>
1279
1280 <UL>
1281    <LI> Crash when using tab-completion for selecting a Save filename
1282    <LI> Make Web Alpine help text images relative for more portability
1283    <LI> Fixed attach save of html parts in Web Alpine
1284    <LI> Viewing, printing, exporting, replying, and bouncing of message
1285         digests was broken. Replying and bouncing should not have been
1286         allowed at all for digests. It would be nice to have a more standard
1287         index-like view of a message digest but that has not been addressed
1288         with this minor bug fix.
1289    <LI> Adjust wrapping of HTML messages so that the margins specified by
1290         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
1291         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
1292         are observed correctly
1293    <LI> Interrupt of WhereIs command in index was broken
1294    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1295         option did not work correctly interpreting unknown characters in message headers
1296    <LI> Long address lines could cause blank continuation lines
1297    <LI> Save to a local default INBOX failed if the primary collection was also local,
1298         which it is by default. The save went to  ~/mail/inbox instead.
1299    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
1300         inbox, not the inbox in the primary collection
1301    <LI> Address book entries with lots of addresses would be truncated when
1302         entered in the composer with a screen size wider than 270 or so characters
1303    <LI> Some fields in the index screen were truncated when the screen width was
1304         wider than 256 characters
1305    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
1306         folder, and there is a more than 10 minute pause between typing the TAB
1307         and typing the Yes
1308 </UL>
1309
1310 <P>
1311 Version 1.10(962)
1312 addressed bugs found in previous releases and had a few additions as well.
1313 <P>
1314 Additions included:
1315 <P>
1316
1317 <UL>
1318    <LI> Add the possibility of setting a default role
1319         (see <A HREF="h_role_select">Roles Screen</A>)
1320         which may be convenient if your work flow involves acting in one
1321         role for a while then switching to another role and staying in the
1322         new role for another period of time
1323    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
1324         is encountered, ask the user if he or she wants to continue with the
1325         risky Save anyway instead of aborting. This may be helpful if your
1326         IMAP server is broken in this way but be aware that it is possible there
1327         was a real error instead of just a broken server implementation.
1328    <LI> Some configure adjustments for Kerberos detection and
1329         for SCO OpenServer 5 support
1330    <LI> Hide INBOX in a collection if it also appears as an
1331         <A HREF="h_config_enable_incoming">Incoming Folder</A>
1332    <LI> Show asterisks for feedback when the user is typing a password
1333    <LI> Performance improvement for threading of large folders
1334    <LI> Previously, the search used to find
1335         Pattern matches containing To patterns searched for both To
1336         and Resent-To headers. The relatively complicated search this
1337         produces causes problems when using some deficient IMAP servers.
1338         Now the default is to look only for To headers and ignore the
1339         presence of Resent-To. The previous behavior may be restored
1340         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
1341    <LI> Add an
1342         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1343         to help with reading malformed unlabeled messages
1344    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
1345    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
1346    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
1347 </UL>
1348
1349 <P>
1350 Bugs addressed in the 1.10(962) release included:
1351 <P>
1352
1353 <UL>
1354    <LI> Crash when encountering certain errors from an SMTP server
1355    <LI> Crash in composer caused by overflow in replace_pat()
1356    <LI> Hang when authenticating to an SMTP server that fails with a
1357         &quot;connection disconnected&quot; error
1358    <LI> Bug in handling of trailing tab character in flowed text
1359    <LI> Security enhancement for mailcap parameter substitution
1360    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
1361         did not work if the message being replied to was not flowed text
1362         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
1363         was not turned on
1364    <LI> Don't allow printer to be changed through hidden config screen
1365         if system administrator didn't want it to be allowed
1366    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
1367         should know that it won't work, causing error messages to appear
1368    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
1369         of double-quote double-quote didn't work right
1370    <LI> Quoting wasn't being done to protect special characters from the
1371         MacOS X shell when
1372         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
1373         was not defined
1374    <LI> On MacOS X message attachments should be shown internally instead of
1375         being shown using the Mail application
1376    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
1377         sometimes set the outgoing charset to X-UNKNOWN, making the result
1378         unreadable
1379    <LI> When the sending of a message failed lines with leading spaces had one
1380         additional space inserted in each of those lines when the user
1381         was returned to the composer
1382    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
1383         that contained non-ascii characters because it was truncating the
1384         line being searched so that it was shorter than what was visible on
1385         the screen
1386    <LI> When composing, an attachment with a long name that causes wrapping in
1387         just the wrong place would generate an error and cause the send
1388         of the attachment to fail
1389    <LI> After calling the file browser to attach a file in the composer, a resize
1390         of the window when back in the composer would redraw the last screen that
1391         had been shown in the browser instead of the current composer screen
1392    <LI> Possible crash in index screen when encountering unparsable addresses
1393         or when using one of the PRIORITY tokens or the HEADER token in the
1394         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
1395    <LI> Problems with Header Color editing if the configuration option
1396         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
1397         was inadvertently changed to the Empty Value in the hidden config screen
1398    <LI> When resuming the final postponed message from an Exchange server the user
1399         could get a certificate validation failure because alpine was trying
1400         to validate the canonical name of the folder instead of the name the
1401         user used
1402    <LI> Windows line endings in a mimetypes file on a Unix system cause a
1403         failure to find a match
1404    <LI> Make matching of extension names case independent in mimetypes files
1405    <LI> Windows dialog boxes for entering text were not working correctly
1406    <LI> Replying to or Forwarding multipart/alternative messages which had a
1407         single text/html part did not work well
1408    <LI> Printing the print confirmation page caused a crash
1409    <LI> A To line with a long, quoted personal name could display incorrectly
1410         if it was close to the same width as the screen
1411    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
1412         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
1413         are turned on hide (0/0) when the folder is empty
1414    <LI> Folder completion while Saving didn't work if the collection being
1415         saved to was the local home directory
1416 </UL>
1417
1418 <P>
1419 Version 1.00
1420 was an evolutionary release based on Pine, which was also
1421 developed at the University of Washington.
1422 It is upwards-compatible for existing Pine users.
1423
1424 <P>
1425 Changes included:
1426 <P>
1427 <UL>
1428    <LI> Ground-up reorganization of source code around addition
1429         of "pith/" core routine library.
1430    <LI> Fundamental improvement in Alpine's internal text handling, which
1431         is now based exclusively on Unicode. This allows displaying incoming
1432         messages and producing outgoing messages in many different languages.
1433    <LI> Ground-up reorganization of build and install procedures
1434         based on GNU Build System's autotools. NOTE, the included IMAP library
1435         build is not based on autotools, so some features will not work. However,
1436         it should get built automatically during the Alpine build process.
1437    <LI> Web-based version included built on TCL designed to run under
1438         a suitable CGI-supporting web server such as Apache.
1439 </UL>
1440
1441 <P>
1442
1443 Details on changes in previous (prerelease) versions of Alpine
1444 may be found at the following URL:
1445 <P>
1446 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1447 <P>
1448
1449 <HR WIDTH="75%"><P>
1450
1451 <H2>Getting Help</H2>
1452 <DL>
1453 <DT>Online Help</DT>
1454 <DD>
1455 Every Alpine screen and command has associated help text
1456 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
1457 </DD>
1458
1459 <DT>Web Help</DT>
1460 <DD>
1461 The most current source of information about Alpine,
1462 including new version availability, is the web page at
1463 <P>
1464 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1465 </DD>
1466 </DL>
1467
1468 <HR WIDTH="75%"><P>
1469
1470 <H2>Additional Information</H2>
1471
1472 General Alpine configuration information can be found
1473 <A HREF="h_news_config">here</A>.
1474 <P>
1475 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
1476 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
1477 access is provided by the IMAP Toolkit Environment (c-client library)
1478 version <!--#echo var="C_CLIENT_VERSION"-->.
1479 <P>
1480 Alpine was developed until 2009 by the Office of Computing
1481 &amp; Communications at the University of Washington in Seattle.
1482 Since then, the effort of developing Alpine has been continued by
1483 a community of volunteers who make good software even better!
1484
1485 <P>
1486 Alpine Copyright 2013-2020 Eduardo Chappa,
1487 <BR> Copyright 2006-2008 University of Washington.
1488
1489 <P>
1490 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
1491 or instead you can find the Apache License, version 2.0 at the web URL:
1492
1493 <P>
1494 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
1495
1496 <P>
1497 &lt;End of Release Notes&gt;
1498 </BODY>
1499 </HTML>
1500 ====== h_password_file_support ======
1501 <HTML>
1502 <HEAD>
1503 <TITLE>Encryption for Password File Support Explained</TITLE>
1504 </HEAD>
1505 <BODY>
1506 <H1>Encryption for Password File Support Explained</H1>
1507
1508 Index<BR>
1509 <OL>
1510 <LI><A HREF="#content">Explanation</A>
1511 <LI><A HREF="#example_existing_key">Example of Use of Existing Key and Certificate</A>
1512 <LI><A HREF="#example_self_signed">Example of Creating Master Password</A>
1513 </OL>
1514
1515 <P><A NAME="content">Unix Alpine Only.</A>
1516
1517 <P> If your version of Alpine has been built with password file support
1518 then you can use a special file to save your passwords, and avoid typing
1519 them every time you open a connection to a remote server.
1520
1521 <P> If, in addition, your version of Alpine was built with SMIME support, then your
1522 password file will be encrypted with a strong key. There are two ways in
1523 which this can happen: Alpine will either use a matching private key and
1524 public certificate pair that you already own, or it will create one for
1525 you, just for purposes of encrypting this file. We describe both processes
1526 below.
1527
1528 <P> Initially, Alpine will scan your public and private directories for a
1529 certificate/private key pair that works. Alpine will pick the first pair
1530 that it finds that matches.
1531
1532 <P> Once a pair has been chosen, it will be copied to the directory
1533 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
1534 that directory. The first time this process is done, this directory will
1535 be created, a key/certificate pair will be copied to it, from then on
1536 this pair will be used to encrypt and decrypt your password file.
1537
1538 <P> If you want to use a specific key and certificate pair to encrypt
1539 your password file, you can create the directory ~/.alpine-smime/.pwd
1540 manually, and then create your preferred key/certificate pair there.
1541 Alpine will use this key regardless of if it has expired, or if it is
1542 self-signed. These issues do not affect the encryption or decryption
1543 of the password file.
1544
1545 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
1546 your key/certificate pair, you can specify a different one with the
1547 -pwdcertdir command line option in Alpine. If the directory specified by
1548 this option is not found Alpine will fail to encrypt and decrypt your
1549 password file. However if it exists, Alpine will search for a
1550 key/certificate pair in that
1551 directory, and if it does not find one, it will create one and save it
1552 in that directory.
1553
1554 <P> Alpine does not care about the names of the key and certificates in
1555 this directory, but the private key must have &quot;.key&quot; extension
1556 and your public certificate must have the &quot;.crt&quot; extension. The
1557 name of the private key will be used in the prompt when you are asked
1558 to unlock your key to decrypt your password.
1559
1560 <P> If Alpine cannot find a suitable private key and public certificate
1561 pair to encrypt your password, it will create one. You will be asked to
1562 create a &quot;Master Password&quot; to protect such key. At this moment
1563 there are no restrictions on passwords, other than they have to be at
1564 least 8 characters long, but future versions of Alpine will include
1565 functionality to restrict master passwords, as set up by the administrator
1566 of the system in the pine.conf.fixed file.
1567
1568 <P><A NAME="example_existing_key"><B>Example of Use of Existing Key and Certificate</B></A>
1569
1570 <P>Assume you have a private key called peter@address.com.key in your,
1571 ~/.alpine-smime/private directory, and a public certificate called
1572 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
1573 are your only key/certificate pair.
1574
1575 <P> When Alpine starts for the first time, without command line options,
1576 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
1577 it will create it. Then it will go through your keys and certificates and
1578 find a pair that it can use, and copy the files peter@address.com.key,
1579 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
1580 you can do the same by copying these files by yourself. This can be done
1581 with the sequence of commands
1582
1583 <PRE>
1584 mkdir ~/.alpine-smime/.pwd
1585 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
1586 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
1587 </PRE>
1588
1589 <P> When Alpine starts, you will be asked the password to unlock your
1590 private key with the prompt.
1591
1592 <PRE>
1593 Enter password of key &lt;peter@address.com&gt; to unlock password file:
1594 </PRE>
1595
1596 <P> If you prefer to use different names for your private and public keys
1597 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
1598 preserve the extension of the files. For example, you can use the names
1599 private_key.key and public_cert.crt instead. In this case, the prompt you
1600 will see when you are asked to unlock your private key will read
1601
1602 <PRE>
1603 Enter password of key &lt;private_key&gt; to unlock password file:
1604 </PRE>
1605
1606 <P>Observe that you do not need to use an existing key/certificate pair,
1607 and that you can create a new private key/public certificate pair to
1608 encrypt and decrypt your password file. Alpine provides a mechanism to
1609 change the encryption key for this file in the S/MIME configuration
1610 screen.
1611
1612 <P><A NAME="example_self_signed"><B>Example of Creating Master Password</B></A>
1613
1614 <P> If Alpine cannot find a suitable private key and public certificate pair
1615 to encrypt your password file, it will create one. When doing so, it will
1616 start the process with the following warning:
1617
1618 <PRE>
1619 Creating a Master Password for your Password file.
1620 </PRE>
1621
1622 <P> Then Alpine will ask you to enter your Master Password:
1623
1624 <PRE>
1625 Create master password (attempt 1 of 3):
1626 </PRE>
1627
1628 <P> Once you enter this password, and it validates according to system policy,
1629 you will be asked to confirm this password.
1630
1631 <PRE>
1632 Confirm master password (attempt 1 of 3):
1633 </PRE>
1634
1635 <P> If you input the same password, then Alpine will set that as your
1636 Master Password, and you will use this password to unlock your key in the
1637 future.
1638
1639 <P> If you would like to switch your Master Password in the future, you can
1640 do so by creating a new public key and public certificate pair. You can do
1641 so in the S/MIME configuration screen, in the &quot;Manage Key and
1642 Certificate for Password File&quot; section, simply enter your current
1643 password to unlock your current key and then press &quot;C&quot; to create
1644 a new key.
1645
1646 <P>
1647 &lt;End of help&gt;
1648 </BODY>
1649 </HTML>
1650 ====== h_network_encryption_security ======
1651 <HTML>
1652 <HEAD>
1653 <TITLE>Network Encryption Security Explained</TITLE>
1654 </HEAD>
1655 <BODY>
1656 <H1>Network Encryption Security Explained</H1>
1657
1658 You can specify which encryption protocol you would like to try when
1659 creating a secure connection to a server. Alpine will attempt to use
1660 that encryption protocol, but in practice the protocol being used will
1661 default to the most secure protocol that both Alpine and the server
1662 support.
1663
1664 <P> If you use the latest version of OpenSSL, the /ssl modifier to the
1665 server definition will use the most secure version of the TLS encryption
1666 protocol. The same will be true if you try /tls1_1 or /tls1_2, but in an
1667 old version of OpenSSL (pre 1.1.0 series) /tls1_1 might mean to use
1668 version 1.1 of the TLS protocol.
1669
1670 <P> You will never go wrong by using the /ssl modifier. At the time of
1671 this writing OpenSSL had released version 1.1.1, with support for
1672 TLS version 1.3. If your version of OpenSSL does not support this version
1673 of the TLS protocol, then the /tls1_3 modifier will only mean to use
1674 the most secure version of the TLS protocol that OpenSSL and the
1675 server can negotiate. In future versions of OpenSSL, /tls1_3 might mean
1676 to try to negotiate a higher version of the TLS protocol.
1677
1678 <P> In order to avoid confusion, the /ssl flag is the best way to guarantee
1679 the highest encryption protocol available, and it is the recommended
1680 modifier to the server definition to create a secure encrypted connection.
1681
1682 <P>
1683 &lt;End of help&gt;
1684 </BODY>
1685 </HTML>
1686 ====== h_xoauth2 ======
1687 <HTML>
1688 <HEAD>
1689 <TITLE>XOAUTH2 Authenticator Explained</TITLE>
1690 </HEAD>
1691 <BODY>
1692 <H1>XOAUTH2 Authenticator Explained</H1>
1693
1694 The XOAUTH2 authenticator method is a way in which you can sign in to your
1695 account to read and send email. This method is different from the traditional
1696 username/password that users are accostumed to, and it needs to be set up
1697 by the user. This text will help you understand this authentication method.
1698
1699 <P>
1700 The most important difference between this method and other authentication
1701 methods is what happens if someone steals your credentials. This method is
1702 attached to three components: Your username, your password and your email
1703 program.
1704
1705 <P>
1706 At the beginning of this process, the developer of the email program
1707 registers the email program with the email service provider (Gmail,
1708 Outlook, etc.) In return, the email service provider creates a client-id.
1709 In addition, some services provice a client-secret.
1710 Since Alpine is an open source program, these values are part
1711 of the source code, and are known to everyone, and cannot be obfuscated.
1712
1713 <P>
1714 After a program has been registered with an email service provider, the
1715 user must authorize the email program access to their email account in
1716 that service. Alpine helps you do that, but it cannot do all the process
1717 for you, and you will need to use an external web browser to authorize
1718 Alpine to read and send email.
1719
1720 <P>
1721 This part of the process is simple. Alpine creates a URL based on the id
1722 and secret created by the email service, which the user opens. Once the
1723 URL has been opened, the user signs in to the server, and once signed into
1724 the account, the user is asked to authorize Alpine access to the email
1725 account. If the user agrees, an &quot;<I>Access Code</I>&quot; will be
1726 generated.
1727
1728 <P>
1729 An Access Code is a very long string, and so the recommendation is to copy
1730 and paste this code back into Alpine, at the time Alpine is helping you
1731 set up this authenticator. This part of the process is done only once per
1732 email program (If you run Alpine in several computers, you would do this
1733 once per computer. Each computer gets its own Access Code.)
1734
1735 <P>
1736 Once Alpine has an Access Code, it goes back internally to the email
1737 service and asks it to generate two strings, called the &quot;<I>Refresh
1738 Token</I>&quot; and the &quot;<I>Access Token</I>&quot;. This part is
1739 invisible to the user, and they will never see it, but in order for you to
1740 understand what to do in case you lose them, you need to understand their
1741 use.
1742
1743 <P>
1744 The <I>Access Token</I> is the equivalent of a temporary password. It
1745 allows the user to access (and reaccess as many times as they would like)
1746 their email account for a limited amount of time, typically 1 hour after
1747 it was issued. After that time expires, users need a new Access Token.
1748
1749 <P>
1750 The <I>Refresh Token</I> is the equivalent of a password generator. With
1751 this token, Alpine can go to the email service provider and request a new
1752 Access Token. This part of the process does not need user intervention,
1753 anyone can do this, as long as they have the Refresh Token, program id and
1754 program secret, so it is important that users keep their Refresh Token as
1755 secure as they can.
1756
1757 <P>
1758 Given that the Refresh Token and the Access Token are long strings, users
1759 are not supposed to be able to memorize them and recall them later. Alpine
1760 will store them in the password file, should a user have one. Otherwise,
1761 the user will have to create one each time they run Alpine, starting by
1762 creating the Access Code all over each time they try to sign in to their
1763 email account. When Alpine is compiled with SSL and password file support,
1764 it will default to saving this information using encryption and under a
1765 master password, so unless they have made changes to this process, their
1766 Refresh and Access Tokens are saved securely and persist from one session
1767 to the next.
1768
1769 <P>
1770 Should any person steal your Refresh Token, you must login to your account
1771 with your username and password and revoke Alpine authorization to your
1772 account. This is enough to stop the person who stole your Refresh Token
1773 from accessing your email service. In the case of Gmail, changing your
1774 password will invalidate your Refresh Token, and this will be enough to
1775 prevent others from using a stolen Refresh Token. Consult with your email
1776 service provider to learn what you can do if someone steals your Refresh
1777 Token.
1778
1779 <P>
1780 If, for any reason, Alpine cannot sign in to your email service for two
1781 consecutive times with Access Codes generated by your Refresh Token, it
1782 will remove the Refresh Token from your password file, forcing you to get
1783 a new one, by getting an Access Code first, and granting authorization to
1784 Alpine to access your email once again.
1785
1786 <P>
1787 This implementation of XOAUTH2 knows the list of servers that it can
1788 access using the same credentials, so Alpine will be able to read and send
1789 emails using the same Access Token. You will not have to create
1790 Access and Refresh Tokens for the IMAP and SMTP servers separately.
1791
1792 <P>
1793 &lt;End of help&gt;
1794 </BODY>
1795 </HTML>
1796 ====== h_xoauth2_config_screen ======
1797 <HTML>
1798 <HEAD>
1799 <TITLE>XOAUTH2 Configuration Screen</TITLE>
1800 </HEAD>
1801 <BODY>
1802 <H1>XOAUTH2 Configuration Screen</H1>
1803
1804 The XOAUTH2 configuration screen helps you connect your client-id and
1805 other configuration information about the service you want to use with
1806 Alpine.
1807
1808 <P> Alpine provides a default configuration for you. For some providers
1809 this configuration does not work, and requires you to get your own
1810 Client-ID for Alpine. Depending on the service, you might need extra information,
1811 such as a Client-Secret or a Tenant.
1812
1813 <P> If the default configuration of Alpine does not work for you, you can simply
1814 replace the default configuration of Alpine by your new configuration. If for
1815 any reason you need to have a second client-id, you can use the ^A command to
1816 add a new configuration for one of the supported services by Alpine.
1817
1818 <P> If you wish to delete a configuration for a service, place the cursor
1819 on the configuration you want to delete and press ^D.
1820
1821 <P> When you have more than one client-id for the same service, is is convenient
1822 to fill up the username field. This will tell Alpine that that specific configuration
1823 is to be used with the username(s) specified in that variable. If Alpine cannot
1824 detemine which configuration to use, it will ask you to select the correct
1825 Client-ID for your connection. This could happen when you are trying to login to
1826 your account. The client-id you select will be used by Alpine for that and future
1827 connections to that server.
1828
1829
1830 <P>
1831 &lt;End of help&gt;
1832 </BODY>
1833 </HTML>
1834 ====== h_tls_failure_details ======
1835 <HTML>
1836 <HEAD>
1837 <TITLE>Certificate Validation Details</TITLE>
1838 </HEAD>
1839 <BODY>
1840 <H1>Certificate Validation Details</H1>
1841
1842 This screen gives details as to why the certificate validation failed: the
1843 name of the desired server system; the reason for failure; and the name on
1844 the certificate.  This is primarily of interest to experts.
1845
1846 <P>
1847 &lt;End of help&gt;
1848 </BODY>
1849 </HTML>
1850 ====== h_tls_failure ======
1851 <HTML>
1852 <HEAD>
1853 <TITLE>TLS or SSL Failure</TITLE>
1854 </HEAD>
1855 <BODY>
1856 <H1>TLS or SSL Failure</H1>
1857
1858 An attempt was made to establish a secure, encrypted connection to the
1859 server system using either Transport Layer Security (TLS) or the older
1860 Secure Sockets Layer (SSL).  This attempt failed.
1861
1862 <P>
1863 You should contact your server system management for more assistance.
1864 The problem is probably at the server system and not in Alpine or your local
1865 system.  The text in this screen may be helpful for the server system
1866 management in debugging the problem,
1867
1868 <P>
1869 &lt;End of help&gt;
1870 </BODY>
1871 </HTML>
1872 ====== h_tls_validation_failure ======
1873 <HTML>
1874 <HEAD>
1875 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
1876 </HEAD>
1877 <BODY>
1878 <H1>TLS and SSL Certificate Validation Failures</H1>
1879
1880 An attempt was made to establish a secure, encrypted connection to the
1881 server system using either Transport Layer Security (TLS) or the older
1882 Secure Sockets Layer (SSL).
1883
1884 <P>
1885 An important part of this procedure is server certificate validation.  A
1886 server certificate is an &quot;electronic identification card&quot; for the server
1887 system that is signed by a well-known certificate authority (CA).  Alpine
1888 compares the server system identity in the server certificate with the
1889 name of the server system to which it is trying to connect.  Alpine also
1890 verifies that the CA signature is authentic.
1891
1892 <P>
1893 Some common failure conditions are:
1894 <P>
1895
1896 <UL>
1897   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
1898 signed its own certificate.  This does not necessarily indicate anything
1899 bad; the server operators may simply have elected to not purchase a
1900 signed certificate from a certificate authority.
1901
1902   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
1903 the signature on the server system is from an unknown certificate authority.
1904 It can also mean that no certificate authority certificates have been
1905 installed on the local UNIX system.
1906
1907   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
1908 the same as either of the above two conditions in UNIX Alpine.  Note that
1909 Windows systems typically have a full set of certificate authority
1910 certificates installed, so it is more likely to be a self-signed
1911 certificate than an unknown certificate authority.
1912
1913   <LI> Server name does not match certificate.  This means that the server
1914 presented a proper signed certificate for a name other than the desired
1915 name.
1916 </UL>
1917
1918 <P>
1919 Any of these conditions can indicate that you are being attacked and have
1920 been directed to an imposter server that will record your password and
1921 your private mail messages.  It can also mean something innocuous.
1922
1923 <P>
1924 If you are certain that the problem is innocuous, you can append the
1925 option
1926
1927 <P>
1928 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
1929 <P>
1930
1931 to the server system name where it appears in your configuration (e.g. the
1932 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
1933 a folder-collection, or a news or SMTP server).  This will
1934 disable certificate validation.  On the other hand, if you are attacked,
1935 you will get no warning if you do this.
1936
1937 <P> When you get an error indicating a self-signed certificate from the
1938 remote server, you can download and install the certificate for that
1939 server. Avoid using the /NoValidate-Cert modifier. Alpine cannot help you
1940 with this process because certificates are part of the system and are not
1941 under the control of the user. Find directions on how to download and
1942 install certificates for your system using your favorite search engine.
1943
1944 <P>
1945 &lt;End of Cert Validation Failures help&gt;
1946 </BODY>
1947 </HTML>
1948 ====== h_oauth2_start ======
1949 <HTML>
1950 <HEAD>
1951 <TITLE>Setting up XOAUTH2 Authentication</TITLE>
1952 </HEAD>
1953 <BODY>
1954 <H1>Setting up XOAUTH2 Authentication</H1>
1955
1956 You are trying to connect to a server that uses the XOAUTH2 method of
1957 authentication.
1958
1959 <P>
1960 In order to set this up, you need to authenticate in the target server
1961 and authorize Alpine to access your email account.
1962
1963 <P>
1964 After you have authorized Alpine, the server will generate an
1965 &quot;access code.&quot; In order to use this code, press 'C'
1966 and copy and paste this code back into Alpine.
1967
1968 <P>
1969 After you have input the code, Alpine will conclude logging you into your
1970 account.
1971
1972 <P>
1973 &lt;End of setting up XOAUTH2 Authentication help&gt;
1974 </BODY>
1975 </HTML>
1976 ====== h_release_tlscerts ======
1977 <HTML>
1978 <HEAD>
1979 <TITLE>TLS and SSL usage note</TITLE>
1980 </HEAD>
1981 <BODY>
1982 <H1>TLS and SSL usage note</H1>
1983
1984 <P>
1985 When using Alpine from Unix or Windows 2000,
1986 server certificates must be signed by a trusted certificate authority.
1987 You may relax this requirement (at the cost of some security) by using
1988 the
1989 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
1990 modifier in the mailbox name.
1991
1992 <P>
1993 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
1994 <P>
1995
1996 The fully-qualified host name of the server should be used
1997 so that it matches the host name in the server certificate.
1998 <P>
1999 Here is an example of a host specification that directs Alpine to use
2000 the SSL port (993) and an encrypted data stream.
2001 <P>
2002 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
2003 <P>
2004 &lt;End of TLS usage help&gt;
2005 </BODY>
2006 </HTML>
2007 ====== h_news_config ======
2008 <HTML>
2009 <HEAD>
2010 <TITLE>Alpine Configuration</TITLE>
2011 </HEAD>
2012 <BODY>
2013 <H1>Alpine Configuration</H1>
2014
2015 <H2>Using Environment Variables</H2>
2016
2017 The values of Alpine configuration options may include environment variables
2018 that are replaced by the value of the variable at the time Alpine is run
2019 (and also at the time the config option is changed).
2020 The syntax to use environment variables is a subset of the common Unix
2021 shell dollar-syntax.
2022 For example, if
2023
2024 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
2025
2026 appears in the value of an Alpine configuration option it is looked up in the
2027 envirom ent (using getenv(&quot;VAR&quot;)) and its
2028 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
2029 To include a literal dollar sign you may precede the dollar sign with another
2030 dollar sign.
2031 In other words, if the text
2032
2033 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
2034
2035 is the value of a configuration option, it will be expanded to
2036
2037 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
2038
2039 and no environment lookup will be done.
2040 For Unix Alpine it will also work to use a backslash character to
2041 escape the special meaning of the dollar sign, but $$ is preferable since
2042 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
2043 to be in a shared configuration file.
2044 <P>
2045
2046 This all sounds more complicated than it actually is.
2047 An example may make it clearer.
2048 Unfortunately, the way in which environment variables are set is OS-dependent
2049 and command shell-dependent.
2050 In some Unix command shells you may use
2051
2052 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
2053    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
2054
2055 Now, if you use Alpine's Setup/Config screen to set
2056
2057 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
2058
2059 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
2060 so that this would be equivalent to
2061
2062 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
2063
2064 Note, environment variable substitution happens after configuration
2065 options that are lists are split into the separate elements of the list,
2066 so a single environment variable can't contain a list of values.
2067
2068 <P>
2069 The environment variable doesn't have to be the only thing
2070 after the equal sign.
2071 However, if the name of the variable is not at the end of the line or
2072 followed by a space (so that you can tell where the variable name ends),
2073 it must be enclosed in curly braces like
2074
2075 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
2076
2077 It is always ok to use the braces even if you don't need to.
2078 <P>
2079 It is also possible to set a default value for an environment variable.
2080 This default value will be used if the environment variable is not
2081 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
2082 The syntax used to set a default value is
2083
2084 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
2085
2086 If the config file contains
2087
2088 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
2089
2090 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
2091 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
2092 the value that <SAMP>VAR</SAMP> was set to, otherwise,
2093 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
2094 the default value.
2095 (Note that the variable is called &quot;personal-name&quot; in the config
2096 file but is displayed in the config screen as
2097 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
2098 In general, the value that goes into a config file is never exactly the
2099 same as the value you see on the screen.)
2100
2101 <P>
2102 An example where an environment variable might be useful is the
2103 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
2104 Suppose most users used the server
2105
2106 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
2107
2108 but that there were some exceptions who used
2109
2110 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
2111
2112 In this case, the system manager might include the following line in
2113 the systemwide default Alpine configuration file
2114
2115 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
2116
2117 For the exceptional users adding
2118
2119 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
2120
2121 to their environment should work.
2122 <P>
2123 Another example might be the case where a user has to use a different
2124 SMTP server from work and from home.
2125 The setup might be something as simple as
2126
2127 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
2128
2129 or perhaps a default value could be given.
2130 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
2131 a list of SMTP servers.
2132 <P>
2133
2134 <H2>Configuration precedence</H2>
2135
2136 There are several levels of Alpine configuration.  Configuration values at
2137 a given level override corresponding values at lower levels.  In order of
2138 increasing precedence:
2139 <P>
2140 <UL>
2141  <LI> built-in defaults
2142  <LI> system-wide
2143 <!--chtml if pinemode="os_windows"-->
2144       config file from command line or provided
2145       by "PINECONF" environment variable
2146 <!--chtml else-->
2147       pine.conf file
2148 <!--chtml endif-->
2149  <LI> personal configuration file
2150  <LI> personal exceptions configuration file
2151  <LI> command-line options
2152  <!--chtml if pinemode="os_windows"--><!--chtml else-->
2153  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
2154 </UL>
2155 <P>
2156 The values in both the personal configuration file and the
2157 <A HREF="h_config_exceptions">exceptions</A>
2158 configuration file may be set using the Setup command.
2159 Setup/Config is the command to change most of the personal configuration
2160 options.
2161 The other Setup subcommands are also used to change the configuration,
2162 for example, Setup/AddressBook, Setup/Rules, and so on.
2163 Changing the personal exceptions configuration is very similar.
2164 To change a value in the Config screen you would use the command
2165 Setup/eXceptions/Config.
2166 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
2167 <P>
2168 There are a couple exceptions to the rule that configuration values are replaced
2169 by the value of the same option in a higher-precedence file.
2170 The Feature-List variable has values that are additive, but can be
2171 negated by prepending &quot;no-&quot; in front of an individual feature name.
2172 So for features, each individual feature's value is replaced by the value
2173 of the same feature in a higher-precedence file.
2174 Note that this is done automatically for you when you change these values via
2175 the Setup/Config command.
2176 The other exception to the <EM>replace</EM> semantics happens when you
2177 use <A HREF="h_config_inheritance">configuration inheritance</A>
2178 for option lists.
2179 <P>
2180
2181 <H2>File name defaults</H2>
2182
2183 Notes:<P>
2184
2185 <BR> &lt;exe dir&gt; = directory where pine.exe found.
2186 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
2187 <BR> # = default file name is overridable in pinerc.
2188 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
2189 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
2190 <BR> + between the mailcap paths implies that the two files are combined.
2191 <BR> ; between other default paths implies that the first one found is used.
2192 </P>
2193 Alpine looks for most support files in the same directory it finds its
2194 personal configuration file (pinerc).  The -p command-line flag may be
2195 used to specify a particular path name for the pinerc file.  If a
2196 pinerc file does not exist, it will be created (if directory permissions
2197 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
2198 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
2199 file does not exist in either one, it will create one in the first of those
2200 two directories that is writable.  In detail:
2201 <PRE>
2202
2203 PC-Alpine:
2204
2205  executable     &lt;DOS search path&gt;&#92;pine.exe
2206  help index     &lt;exe dir&gt;&#92;pine.ndx
2207  help text      &lt;exe dir&gt;&#92;pine.hlp
2208
2209  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
2210  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
2211  global cfg     $PINECONF
2212
2213  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
2214  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
2215  signature#     &lt;pinerc dir&gt;&#92;pine.sig
2216  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
2217  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
2218  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
2219  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
2220  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
2221  postponed#     $HOME&#92;mail&#92;postpond.mtx
2222  interrupted    $HOME&#92;mail&#92;intruptd
2223
2224 Unix Alpine:
2225
2226  executable     &lt;Unix search path&gt;/pine
2227  persnl cfg     ~/.pinerc
2228  except cfg     ~/.pinercex
2229  global cfg     <!--#echo var="PINE_CONF_PATH"-->
2230  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
2231  local help     <!--#echo var="PINE_INFO_PATH"-->
2232
2233  interrupted    ~/.pine-interrupted-mail
2234  debug          ~/.pine-debugN
2235  crash          ~/.pine-crash
2236  newsrc#        ~/.newsrc
2237  signature#     &lt;pinerc dir&gt;/.signature
2238  addressbook#   &lt;pinerc dir&gt;/.addressbook
2239  postponed#     ~/mail/postponed-msgs
2240  sentmail#      ~/mail/sent-mail
2241  mailcap#       ~/.mailcap + /etc/mailcap
2242                            + /usr/etc/mailcap + /usr/local/etc/mailcap
2243  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
2244
2245  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
2246  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
2247  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
2248  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
2249  password       /etc/passwd
2250
2251 Unix Alpine and PC-Alpine:
2252
2253  .ab*           remote addressbook support files
2254  a[1-9]*        temporary (while Alpine is running) addressbook files
2255
2256 </PRE>
2257 <P>
2258
2259 <H2>Mailcap files</H2>
2260
2261 Alpine honors the mailcap configuration system for specifying external
2262 programs for handling attachments.  The mailcap file maps MIME attachment
2263 types to the external programs loaded on your system that can display
2264 and/or print the file.  A sample mailcap file comes bundled with the Alpine
2265 distribution.  It includes comments that explain the syntax you need to
2266 use for mailcap.  With the mailcap file, any program (mail readers,
2267 newsreaders, WWW clients) can use the same configuration for handling
2268 MIME-encoded data.
2269 <P>
2270
2271 <H2>MIME-Types files</H2>
2272
2273 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
2274 what Content-Type to use for labeling an attached file, based on
2275 the file extension.  That is, this file provides a mapping between
2276 filename extensions and MIME content-types.
2277 <P>
2278
2279 <H2>Environment variables</H2>
2280
2281 PC-Alpine uses the following environment variables:
2282 <DL>
2283 <DT>PINERC</DT>
2284 <DD>Optional path to pinerc file.</DD>
2285 <DT>PINERCEX</DT>
2286 <DD>Optional path to personal exceptions configuration file.</DD>
2287 <DT>PINECONF</DT>
2288 <DD>Optional path to global pine config file.</DD>
2289 <DT>HOME</DT>
2290 <DT>TMPDIR, TMP, or TEMP</DT>
2291 <DT>COMSPEC</DT>
2292 <DT>MAILCAPS</DT>
2293 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
2294 <DT>USER_DICTIONARY</DT>
2295 <DD>Used to specify the file to contain the user's spell check
2296 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
2297 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
2298 </DL>
2299
2300 Unix Alpine uses the following environment variables:
2301 <DL>
2302 <DT>TERM</DT>
2303 <DD>Tells Alpine what kind of terminal is being used.</DD>
2304 <DT>DISPLAY</DT>
2305 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
2306 <DT>SHELL</DT>
2307 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
2308 <DT>TMPDIR, TMP, or TEMP</DT>
2309 <DT>MAILCAPS</DT>
2310 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
2311 </DL>
2312 <!--chtml if pinemode="os_windows"-->
2313 <P>
2314 <H2>Common PC-Alpine Configuration Problems</H2>
2315
2316 <H3>Configuration settings aren't being saved</H3>
2317
2318 <P>This problem can happen if you run pine from one directory and
2319 then decide to move your pine directory to another location.  PC-Alpine
2320 stores certain variables, including the configuration location, in the
2321 Windows Registry (which you shouldn't ever need to manually edit).  There
2322 are a couple of ways to go about removing or resetting the values in the
2323 registry.
2324
2325 <P>
2326 1) Run PC-Alpine's registry value deletion command.  This can be done by
2327 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
2328 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
2329 value to the above command.
2330
2331 <P>
2332 2) Tell PC-Alpine where to look for the configuration file.  Configuration
2333 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
2334 option, you can tell PC-Alpine the location of your pinerc.  An example of
2335 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;.
2336 Again, you can use the DOS prompt or the shortcut method explained in (1).
2337
2338 <P>
2339 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
2340 set registry values to the current setting, and is therefore useful with
2341 the &quot;-p&nbsp;PINERC&quot; option.
2342
2343 <!--chtml endif-->
2344 <P>
2345 &lt;End of Configuration Notes&gt;
2346 </BODY>
2347 </HTML>
2348 ====== h_news_legal ======
2349 <html>
2350 <head>
2351 <TITLE>Alpine Legal Notices</TITLE>
2352 </head>
2353 <body>
2354
2355 <H1>Alpine Legal Notices</H1>
2356
2357 Alpine and its constituent programs are covered by the Apache License Version 2.0.
2358
2359
2360 <P>
2361 &lt;End of Alpine Legal Notices&gt;
2362 </BODY>
2363 </HTML>
2364 ===== h_info_on_mbox =====
2365 <HTML>
2366 <HEAD>
2367 <TITLE>Information on mbox driver</TITLE>
2368 </HEAD>
2369 <BODY>
2370 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
2371
2372 Beginning with Pine 4.00 (Pine came before Alpine)
2373 a new INBOX access method is
2374 available as part of the standard configuration.  It is called the
2375 &quot;mbox&quot; driver and it works like this:<P>
2376
2377 <P>
2378 <BLOCKQUOTE>
2379 If the file &quot;mbox&quot; exists in the user's home directory, and
2380 is in Unix mailbox format, then when INBOX is opened this file will be
2381 selected as INBOX instead of the mail spool file.  Messages will be
2382 automatically transferred from the mail spool file into the mbox
2383 file.
2384 </BLOCKQUOTE>
2385
2386 <P>
2387 The advantage of this method is that, after new mail has been copied
2388 from the system mail spool, all subsequent access is confined to the
2389 user's home directory, which is desirable on some systems.  However, a
2390 possible disadvantage is that mail tools other than those from the
2391 University of Washington will not know to look for mail in the user's
2392 mbox file.  For example, POP or IMAP servers other than those from the
2393 University of Washington, and many &quot;new mail notification&quot;
2394 programs may not work as expected with this driver enabled.<P>
2395
2396 To disable this behavior, either remove/rename the &quot;mbox&quot;
2397 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
2398 option in Setup/Config
2399 and add &quot;mbox&quot; to it:
2400 <P>
2401 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
2402 <P>
2403 &lt;End of help on this topic&gt;
2404 </BODY>
2405 </HTML>
2406 ===== h_info_on_locking =====
2407 <HTML>
2408 <HEAD>
2409 <TITLE>FAQs on Alpine Locking</TITLE>
2410 </HEAD>
2411 <BODY>
2412 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
2413
2414 There is an extensive section on locking in the Alpine technical notes;
2415 this information is intended to provide answers to some common questions:<P>
2416 <OL>
2417 <LI> Why did locking change in Pine 4.00?<BR>
2418 The actual locking mechanisms did not change in 4.00.
2419 What changed is that when one particular locking mechanism used by Alpine
2420 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
2421 failure would occur, but no warning was issued.<P>
2422
2423 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
2424 Yes.  It means that Alpine was unable to create a lockfile in the
2425 spool directory, generally because of overly restrictive protections on the
2426 spool directory.  The correct permissions on the spool directory for
2427 running Alpine are 1777, i.e. read-write-execute permission for everyone,
2428 with the sticky-bit set, so only owners of a file can delete them.<P>
2429
2430 <LI> Why does Alpine require that the mail spool directory have 1777
2431    protections?<BR>
2432 Alpine was designed to run without special privileges.  This means that in
2433 order to create a lockfile in the spool directory, it is necessary to have
2434 the spool directory permissions be world-writable.<P>
2435
2436 <LI> Can't you create the lockfile somewhere else?<BR>
2437 No.  The lockfile in question must be in the mail spool directory, because
2438 that's where the mail delivery program expects to find it, and the purpose
2439 of the file is to coordinate access between the mail client (Alpine) and the
2440 mail delivery program.<P>
2441
2442 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
2443 No.  Remember that the individual mail files in the spool directory are
2444 NOT world-writable, only the containing directory.  Setting the &quot;sticky
2445 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
2446 -- means that only the owner of the file (or root) can delete files in the
2447 directory.  So the only bad behavior that is invited by the 1777 mode is that
2448 anyone could
2449 create a random file in the spool directory.  If the spool directory is
2450 under quota control along with home directories, there is little incentive
2451 for anyone to do this, and even without quotas a periodic scan for
2452 non-mail files usually takes care of the problem.  <P>
2453
2454 <LI> Why not run Alpine as setgid mail?<BR>
2455 Alpine was never designed to run with privileges, and to do so introduces a
2456 significant security vulnerability.  For example, if a user suspends Alpine,
2457 the resulting shell will have group privileges.  This is one example of
2458 why we strongly recommend against running Alpine as a privileged program.
2459 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
2460 users
2461 could not test Alpine versions or other mailers that had not been installed
2462 by the system administrators.<P>
2463
2464
2465 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
2466 There are, but they all have different sets of tradeoffs, and not all will
2467 work on all systems.  Some examples:<UL>
2468  <LI> Use lock system calls.  Works fine on a few systems, provided mail
2469    spool is local.   Doesn't work reliably if NFS is used.
2470    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
2471    use the same calls.
2472  <LI> Deliver mail to user's home directory.  An excellent solution, highly
2473    recommended -- but one which is incompatible with some &quot;legacy&quot;
2474 mail tools that always look in the spool directory for the mail.
2475 </UL><P>
2476
2477 <LI> Are these spool directory lock files the only kinds of locks used by
2478    Alpine?<BR>
2479 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
2480 mailbox format folders, these are used to coordinate access between
2481 multiple Alpine sessions.  <P>
2482
2483 <LI> What about the
2484 <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>
2485 This is for people who are content to live dangerously, or who have
2486 specific knowledge that the spool directory lockfiles are superfluous on
2487 their system (because both Alpine and the mail delivery program are using
2488 system call file locking in a context that works reliably, e.g. not NFS.)<P>
2489
2490 <LI> Where can I find more details on how Alpine locking works?<BR>
2491 See the Alpine Technical Notes.<P>
2492
2493 </OL>
2494 <P>
2495 &lt;End of help on this topic&gt;
2496 </BODY>
2497 </HTML>
2498 ===== h_finding_help ====
2499 <HTML>
2500 <HEAD>
2501 <TITLE>Finding more information and requesting help</TITLE>
2502 </HEAD>
2503 <BODY>
2504 <H1>Places to Look for More Answers</H1>
2505 If you have questions about or problems with Alpine that you cannot resolve
2506 after consulting the program's internal, context-sensitive help screens, here
2507 are additional information resources that you may find helpful:
2508 <P>
2509 <UL>
2510   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
2511
2512   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
2513
2514   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
2515 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
2516   since the last version, which may be useful for you to be aware of,
2517 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
2518 a change in the way an aspect of Alpine works.  There, you will also find notes
2519 on Alpine configuration.<P>
2520   <LI> The main site for Alpine contains information on configuring and solving problems
2521        with Alpine, it can be found at
2522
2523 <CENTER><A HREF="http://alpine.x10host.com/alpine/">http://alpine.x10host.com/alpine/</A></CENTER>
2524
2525   <LI> Archives of the Alpine-info mailing list, at <A
2526 href="http://mailman13.u.washington.edu/pipermail/alpine-info/">http://mailman13.u.washington.edu/pipermail/alpine-info/</A>
2527
2528   <LI>The newsgroup comp.mail.pine.
2529
2530 </UL>
2531 <P><HR WIDTH="75%">
2532 <H1>Requesting help</H1>
2533 If the internal help, the Release Notes, and your
2534 local online and print resources do not help you resolve a problem, please
2535 start by contacting your local computer support staff and asking for help.
2536 <p>
2537 This is especially true if:
2538 <ul>
2539   <li>You suddenly have trouble sending or receiving mail.
2540   <li>You receive a "disk quota exceeded" message.
2541   <li>You have forgotten your password.
2542   <li>You think your account may have been compromised.
2543   <li>You need help viewing an attachment.
2544   <li>You need to know how to configure your:
2545       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
2546       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
2547       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
2548       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
2549   <li>You want to know what alternative editors or spellcheckers you may be able to use.
2550   <li>You want to block email from a particular person.
2551   <li>You're going on vacation and need to autorespond to incoming mail.
2552   <li>You want to automatically file or filter incoming messages.
2553 </ul>
2554
2555 In all of these cases,
2556 you should contact <B>your</B> support staff, because <B>only they</B>
2557 will be able to assist you effectively. Your support staff may be, depending on who
2558 provides you with the email account you use Alpine with, for example:<UL>
2559 <LI> the computing help desk of (a department of) your university, school,
2560 employer, ... ; or
2561 <LI> the customer service center of your Internet Service Provider; or
2562 <LI> the friendly volunteer helpers of your Freenet; or
2563 <LI> the person who setup your computer and internet connection.
2564 </UL>
2565
2566 <P>
2567 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
2568 newsgroup can be a valuable source of information and assistance for Alpine
2569 user issues.
2570 <P>
2571 For systems/email administrators, developers, trainers, user support
2572 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
2573 level, the mailing list alpine-info is available; for information on
2574 subscribing and posting to it, see
2575 <P>
2576 <CENTER><A HREF="https://mailman13.u.washington.edu/mailman/listinfo/alpine-info">https://mailman13.u.washington.edu/mailman/listinfo/alpine-info</A></CENTER>
2577 <P>
2578
2579 Regardless of whom you are asking for help with Alpine, remember
2580 to provide as much detail as you can about the
2581 nature of any problem you are encountering, such as
2582 <UL>
2583 <LI>when it first occurred;
2584 <LI>what, if anything, happened that might have brought it about;
2585 <LI>whether it still persists;
2586 <LI>whether it is reproducible, and if so, how;
2587 <LI>what, if anything, you already tried to solve it.
2588 </UL>
2589 It may also be helpful if you specify what version of Alpine you are using
2590 <!--chtml if pinemode="running"-->
2591 -- this is <!--#echo var="ALPINE_VERSION"--> --
2592 <!--chtml endif-->
2593 and on what system, and when the copy of Alpine you are using was created
2594 <!--chtml if pinemode="running"-->
2595 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
2596 <!--chtml endif-->
2597
2598 <!--chtml if pinemode="running"-->
2599 <P>
2600 When the Alpine program you are currently using was installed, a support
2601 contact email address may have been set up; in that case, you can simply select
2602 this link now to send a message to it:<BR>
2603 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
2604 <!--chtml endif-->
2605 <!--chtml if [ -r PINE_INFO_PATH ]-->
2606 <HR WIDTH="75%">Local Support Contacts:<P>
2607 <!--#include file="PINE_INFO_PATH"-->
2608 <HR WIDTH="75%">
2609 <!--chtml endif-->
2610 <P>
2611 &lt;End of help on this topic&gt;
2612 </BODY>
2613 </HTML>
2614 ===== new_user_greeting ======
2615 <HTML>
2616 <HEAD>
2617 <TITLE>NEW USER GREETING</TITLE>
2618 </HEAD>
2619 <BODY>
2620 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2621 <BR>
2622 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2623 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
2624 select Setup/Config to see many of the options available to you. Also note
2625 that all screens have context-sensitive help text available.
2626
2627 <P>
2628 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
2629 href="h_apache_license">Apache License 2.0</A>.
2630
2631 <P>
2632 Alpine's privacy policy is a living, online only, document, which can be found at
2633 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2634 By following the previous link,  Alpine
2635 will connect to an external server, and will download it and display
2636 it for you. Please take some time to read it and understand it.
2637 Since the Privacy Policy could be ammended to take into consideration
2638 new additions to Alpine, please check it periodically. You can always
2639 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2640
2641 <P>
2642 To Exit this screen and continue your Alpine session press "E".
2643 </BODY>
2644 </HTML>
2645 ===== new_alpine_user_greeting ======
2646 <HTML>
2647 <HEAD>
2648 <TITLE>NEW ALPINE USER GREETING</TITLE>
2649 </HEAD>
2650 <BODY>
2651 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2652 <BR>
2653 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2654 Your Alpine configuration file indicates that you may have used Pine before
2655 but not Alpine.
2656 If you are familiar with the way Pine works, you should be comfortable
2657 using Alpine.
2658 Your Pine configuration file is automatically used for Alpine.
2659 The Release Notes may be viewed by pressing
2660 &quot;R&quot; now or while in the MAIN MENU.
2661
2662 <P>
2663 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
2664 href="h_apache_license">Apache License 2.0</A>.
2665
2666 <P>
2667 Alpine's privacy policy is a living, online only, document, which can be found at
2668 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2669 By following the previous link,  Alpine
2670 will connect to an external server, and will download it and display
2671 it for you. Please take some time to read it and understand it.
2672 Since the Privacy Policy could be ammended to take into consideration
2673 new additions to Alpine, please check it periodically. You can always
2674 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2675
2676 <P>
2677 To Exit this screen and continue your Alpine session press "E".
2678 </BODY>
2679 </HTML>
2680 ===== new_version_greeting ======
2681 <HTML>
2682 <HEAD>
2683 <TITLE>NEW VERSION GREETING</TITLE>
2684 </HEAD>
2685 <BODY>
2686 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2687 <BR>
2688 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
2689 Your Alpine configuration file indicates that you may not have used
2690 this version of Alpine before.  This version's significant changes are
2691 documented in the Release Notes, which may be viewed by pressing
2692 &quot;R&quot; now or while in the MAIN MENU.
2693 <P>
2694
2695 <P>
2696 Alpine is a free email program. Your use of Alpine is subject to the terms of the <A
2697 href="h_apache_license">Apache License 2.0</A>.
2698
2699 <P>
2700 Alpine's privacy policy is a living, online only, document, which can be found at
2701 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2702 By following the previous link,  Alpine
2703 will connect to an external server, and will download it and display
2704 it for you. Please take some time to read it and understand it.
2705 Since the Privacy Policy could be ammended to take into consideration
2706 new additions to Alpine, please check it periodically. You can always
2707 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2708
2709 <P>
2710 To Exit this screen and continue your Alpine session press "E".
2711 </BODY>
2712 </HTML>
2713
2714 ===== main_menu_tx ======
2715 <HTML>
2716 <HEAD>
2717 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
2718 </HEAD>
2719 <BODY>
2720 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
2721 <DIV ALIGN=CENTER>
2722 Version <!--#echo var="ALPINE_VERSION"-->
2723 <!--chtml if pinemode="running"-->
2724 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
2725 <!--chtml endif-->
2726 </DIV>
2727 <CENTER>Copyright 2013-2020 Eduardo Chappa,
2728 <BR>Copyright 2006-2008 University of Washington.
2729 </CENTER>
2730
2731 <P>
2732 When you are viewing a help screen, there may be links to
2733 other topics highlighted (in Reverse video) in the text.
2734 Here is an example.
2735 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
2736 highlighted.
2737 If you type carriage return (or V for View Link, see the commands at the
2738 bottom of the screen) you will be taken to a new help screen to view the
2739 Introduction.
2740 The commands at the bottom of the screen should then include
2741 &quot;P Prev Help&quot;.
2742 If you type &quot;P&quot; you will end up back here.
2743 If you type &quot;E&quot; for Exit, you will be back out of help and returned
2744 to the place you were in Alpine when you entered Help.
2745 In this case, you would go back to the MAIN MENU.
2746 There are also other links that are highlighted in bold (or the color used
2747 by your terminal to display bold).
2748 The items after the Introduction in the TABLE OF CONTENTS are all examples
2749 of such links.
2750 In order to view those links, you first have to make the link you want
2751 to view the current link.
2752 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
2753 (see bottom of screen) can do that for you.
2754 <P>
2755
2756 <H2>TABLE OF CONTENTS</H2>
2757 <OL>
2758   <LI> <A HREF="h_mainhelp_intro">Introduction</A>
2759   <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
2760 <!--chtml if [ -r PINE_INFO_PATH ]-->
2761   <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
2762 <!--chtml endif-->
2763   <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
2764   <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
2765   <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
2766   <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
2767   <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
2768   <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
2769   <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
2770   <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
2771   <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
2772   <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
2773   <LI> <A HREF="h_mainhelp_folders">Folders</A>
2774   <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
2775   <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
2776   <LI> <A HREF="h_mainhelp_color">Color Setup</A>
2777   <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
2778   <LI> <A HREF="h_mainhelp_roles">Roles</A>
2779   <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
2780   <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
2781   <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
2782   <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
2783   <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
2784   <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
2785   <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
2786   <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
2787   <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
2788 </OL>
2789
2790 <P>
2791 &lt;End of help on this topic&gt;
2792 </BODY>
2793 </HTML>
2794 ===== h_mainhelp_intro ======
2795 <HTML>
2796 <HEAD>
2797 <TITLE>Introduction</TITLE>
2798 </HEAD>
2799 <BODY>
2800 <H1>Introduction</H1>
2801
2802 Alpine is an &quot;Alternatively Licensed Program for Internet
2803 News and Email&quot; produced until 2009 by the University of Washington.
2804 It is intended to be an easy-to-use program for
2805 sending, receiving, and filing Internet electronic mail messages and
2806 bulletin board (Netnews/Usenet) messages. Alpine supports the following
2807 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
2808 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
2809 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
2810 Directory Access Protocol).<p>
2811
2812 Although originally designed for inexperienced email users, Alpine has
2813 evolved to support many advanced features.  There are an ever-growing
2814 number of configuration and personal-preference options, though which of
2815 them are available to you is determined by your local system managers.
2816
2817 <H2>WHAT ALPINE DOES...</H2>
2818
2819 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
2820 allows you to
2821 compose and read messages using Internet mail standards.  (Whether you
2822 can correspond with others on the Internet depends on whether or not your
2823 computer is connected to the Internet.)  Alpine also allows reading and
2824 posting messages on the Internet &quot;net news&quot; system, provided
2825 that your site operates a suitable news server.
2826
2827 <H2>WHAT ALPINE DOES NOT DO...</H2>
2828
2829 A &quot;mail user agent&quot; such as Alpine is just one part of a
2830 messaging system. Here are some things that are <B>not</B> done by Alpine,
2831 but require other programs:<P>
2832 <UL>
2833  <LI> Actual relaying of email... which is done by &quot;message transfer
2834 agents&quot;.
2835  <LI> Vacation messages... automatically responding to incoming messages
2836  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
2837 email.
2838  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
2839  <LI> List processing... resending one message to a list of recipients.
2840 </UL>
2841
2842 <P>
2843 &lt;End of help on this topic&gt;
2844 </BODY>
2845 </HTML>
2846
2847 ===== h_mainhelp_pinehelp ======
2848 <HTML>
2849 <HEAD>
2850 <TITLE>Alpine Help</TITLE>
2851 </HEAD>
2852 <BODY>
2853 <H1>Alpine Help</H1>
2854
2855 Alpine help is generally context-sensitive. In other words, each Alpine screen you
2856 use will have its own help text, explaining the choices available for that
2857 screen. This general help section, on the other hand, attempts to give an
2858 overall picture of what Alpine is capable of doing, as well as pointers to
2859 additional help sections about specific topics.<p>
2860
2861 Much of the help text contains links to further help topics, similar to
2862 how the World Wide Web works.
2863 You may choose a link to view using the &quot;NextLink&quot; and
2864 &quot;PrevLink&quot; commands to change the link that is highlighted.
2865 The &quot;View Link&quot; command will then show you the highlighted link.
2866 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
2867 will return you to where you were before viewing the link, and &quot;Exit Help&quot
2868 will return you to the location in Alpine before you asked for help.
2869 For example, if you are reading this text in Alpine you may return to the
2870 help table of contents with the &quot;Prev Help&quot; command or you may view the
2871 Release notes link in the next paragraph and then return here with
2872 &quot;Prev Help&quot;.
2873 <P>
2874
2875 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
2876 on the current Alpine version are also available from the MAIN MENU: Press
2877 <!--chtml if pinemode="function_key"-->
2878 &quot;F9&quot;
2879 <!--chtml else-->
2880 &quot;R&quot;
2881 <!--chtml endif-->
2882 to browse the release notes.  These include changes since the last release,
2883 configuration information, the history of the Alpine
2884 project, credits, and legal notices.
2885
2886 Alpine releases are available via the world wide web at
2887 <P>
2888 <CENTER><SAMP><A
2889 HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP
2890 ></CENTER>
2891 <P>
2892
2893 If you would like to print <EM>all</EM> of Alpine's internal help text
2894 (not recommended) for a little light bedtime reading, then press
2895 <!--chtml if pinemode="function_key"-->
2896 &quot;F12&quot;
2897 <!--chtml else-->
2898 &quot;Z&quot;
2899 <!--chtml endif-->
2900 now.  (This assumes that the
2901 copy of Alpine you are using has been properly configured for printing
2902 at your site.)
2903 <P>
2904 &lt;End of help on this topic&gt;
2905 </BODY>
2906 </HTML>
2907 ===== h_mainhelp_localsupport ======
2908 <HTML>
2909 <HEAD>
2910 <TITLE>Local Support Contacts</TITLE>
2911 </HEAD>
2912 <BODY>
2913 <H1>Local Support Contacts</H1>
2914
2915 <!--chtml if [ -r PINE_INFO_PATH ]-->
2916 <!--#include file="PINE_INFO_PATH"-->
2917 <!--chtml else-->
2918 No Local Support Contacts configured.
2919 <!--chtml endif-->
2920
2921 <P>
2922 &lt;End of help on this topic&gt;
2923 </BODY>
2924 </HTML>
2925
2926 ===== h_mainhelp_cmds ======
2927 <HTML>
2928 <HEAD>
2929 <TITLE>Giving Commands in Alpine</TITLE>
2930 </HEAD>
2931 <BODY>
2932 <H1>Giving Commands in Alpine</H1>
2933
2934 Unless configured otherwise
2935 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
2936 the bottom two lines of the screen are always used to list the
2937 commands you can give.  You press the keys that are highlighted to give
2938 the command.  The commands for getting help and going back to the main
2939 menu are always present (except when viewing help as you are now).
2940 <!--chtml if pinemode="function_key"-->
2941 <!--chtml else-->
2942 <p>
2943 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
2944 you see at the bottom of any screen. In some cases there are 3 or
2945 even 4 different
2946 sets of keys that can be seen by using the O key. <EM>All commands are
2947 active</EM>, even if they are not currently showing at the bottom of your
2948 screen. In other words, you <EM>never</EM> need to press the O key, except to
2949 remind yourself of the proper key to press to perform an operation.
2950
2951 <H2>Control Key Commands</H2>
2952 When composing mail, and in a few other places, in Alpine you
2953 have to use Control keys. This means pressing the Control key (usually labeled
2954 &quot;Ctrl&quot;) and the
2955 letter indicated at the same time.  Usually, this is shown with a
2956 &quot;^&quot; in front of the letter.  On some systems, certain control
2957 characters are intercepted before they get to Alpine.  As a work-around,
2958 you can press the ESCAPE key twice followed by the desired key.  For
2959 example, if Ctrl-O (^O) does not work on your system, try typing
2960 &quot;ESC ESC O&quot;.
2961 <!--chtml endif-->
2962 <H2>Paging Up and Down</H2>
2963 The &quot;+&quot; and &quot;-&quot; keys are used for
2964 moving to the next or previous page.  The space bar is a synonym for
2965 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
2966 up as you do in the message composer.  On screens with a WhereIs (search)
2967 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
2968 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
2969 of the message or list.
2970
2971 <H2>Return Key</H2>
2972 The return key is usually a synonym for a frequently used
2973 command.  When viewing a message, there is currently not a default
2974 command, so RETURN does nothing; when in the index, it is synonymous with
2975 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
2976 enclosed in square brackets [] is the same as the return key.
2977
2978 <H2>Control Keys Not Used By Alpine</H2>
2979 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
2980 value, but in places where Alpine is expecting text input, e.g. in the composer or
2981 at prompts for file/folder names, control keys must be used for editing and
2982 navigation functions.
2983 <P>
2984
2985 Alpine has used nearly all the control keys available.  There are, however,
2986 certain control keys that are reserved by other programs or for technical
2987 reasons.  Alpine does not use any of these keys:
2988 <DL>
2989  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
2990  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
2991  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
2992 </DL>
2993 <P>
2994 Note: Ctrl-S and Ctrl-Q can be subject to
2995 <A HREF="h_special_xon_xoff">special handling</A>.
2996 <P>
2997 In addition, while the ESC key alone is not used for command input,
2998 Alpine will recognize two consecutive ESC key presses followed by a letter
2999 key as a substitute for control key input.  For example, the control key
3000 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
3001 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
3002 This is useful if the communication program you are using
3003 (e.g. Telnet) has its own, conflicting, idea of what certain control
3004 characters mean.
3005
3006
3007 <H2>Repainting the Screen</H2>
3008 Sometimes what is displayed on the screen will be
3009 incorrect due to noise on the phone line or other causes and you will want
3010 to repaint the whole screen to make it correct.  You can use the Ctrl-L
3011 command to do this.  It never hurts to do it when in doubt.
3012
3013 <P>
3014 &lt;End of help on this topic&gt;
3015 </BODY>
3016 </HTML>
3017 ===== h_mainhelp_status ======
3018 <HTML>
3019 <HEAD>
3020 <TITLE>Titlebar Line</TITLE>
3021 </HEAD>
3022 <BODY>
3023 <H1>Titlebar Line</H1>
3024
3025 The top line of the screen is Alpine's titlebar line.  It will always display
3026 the current version of Alpine and will also convey information about the
3027 status of the program.  This is where you look to find out what
3028 collection, folder and message number is active and where you are in Alpine.
3029 <P>
3030
3031 If the titlebar line says &quot;READONLY&quot; it means that the open folder
3032 (typically your INBOX) is &quot;locked&quot; by another mail session --
3033 most likely a more recent session of Alpine has taken the INBOX lock.
3034 <P>
3035
3036 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
3037 access a
3038 folder on a remote mail server, and for some reason, communication with
3039 the mail server has either been lost, or never successfully established.
3040 This can be a result of trying to open a non-existent folder, or one
3041 stored on an invalid or non-operational server, or it can mean that Alpine
3042 has been suspended for more that 30 minutes while accessing a remote mail
3043 server.
3044
3045 <P>
3046 &lt;End of help on this topic&gt;
3047 </BODY>
3048 </HTML>
3049 ===== h_mainhelp_mainmenu ======
3050 <HTML>
3051 <HEAD>
3052 <TITLE>Main Menu</TITLE>
3053 </HEAD>
3054 <BODY>
3055 <H1>Main Menu</H1>
3056
3057 The Main Menu lists Alpine's main options.
3058 The key or keys you must type to enter your
3059 choice are to the left of each option or command name.
3060 You can type either uppercase or lowercase letters,
3061 and you should not press &lt;Return&gt; after typing the
3062 letter (unless you are specifically asking for the default,
3063 highlighted command).
3064 <P>
3065
3066 From the Main Menu you can choose to read online help, write (compose) and
3067 send a message, look at an index of your mail messages, open or maintain
3068 your mail folders, update your address book, configure Alpine, and quit Alpine.
3069 There are additional options listed at
3070 the bottom of the screen as well.
3071
3072 <P>
3073 The Help command usually returns context-sensitive help information.
3074 However, in the Main Menu you get the most general help, which includes
3075 a Table of Contents.
3076 The last entry in the Table of Contents is an Index of help topics,
3077 so this is a good place to go if you are having trouble finding how
3078 to do something.
3079
3080 <H2>Main Menu Commands</H2>
3081 The Alpine main menu lists the most common Alpine functions. A <a
3082 href="h_main_menu_commands">full list of these
3083 commands</a> and what they do is available.
3084 <P>
3085 &lt;End of help on this topic&gt;
3086 </BODY>
3087 </HTML>
3088 ===== h_mainhelp_abooks ======
3089 <HTML>
3090 <HEAD>
3091 <TITLE>Address Books</TITLE>
3092 </HEAD>
3093 <BODY>
3094 <H1>Address Books</H1>
3095
3096
3097 As you use email, you can build a list of your regular email correspondents
3098 in your Alpine
3099 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
3100 screen. Your
3101 personal address book will be highlighted. Press &lt;Return&gt; to view it.
3102 You can use the address book to store email addresses for individuals or
3103 groups, to create easily
3104 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
3105 address when you are composing a message.
3106 <P>
3107 There are two ways to add addresses to your address book: you can add them
3108 manually or take them from messages (by pressing T to access the Take command).
3109 With either method, you specify nicknames for your correspondents. A single
3110 address book entry (or nickname) can point to just one email address, or, it can
3111 point to more than one. When it points to more than one, it is called a
3112 distribution list. Each distribution list has a nickname, a full name, and a
3113 list of addresses. These
3114 addresses may be actual addresses, other nicknames in your address book, or
3115 other
3116 distribution lists.
3117
3118 <P>
3119 Additional information is available in Alpine's online help:
3120 <ul>
3121   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
3122 </ul>
3123 <P>
3124 &lt;End of help on this topic&gt;
3125 </BODY>
3126 </HTML>
3127 ===== h_mainhelp_ldap ======
3128 <HTML>
3129 <HEAD>
3130 <TITLE>LDAP</TITLE>
3131 </HEAD>
3132 <BODY>
3133 <H1>LDAP</H1>
3134
3135 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
3136 an organization's shared
3137 directories. Essentially, using LDAP, Alpine is able to find email addresses in
3138 large address
3139 books, rather like the White Pages provided by the phone company. As an Alpine
3140 user, it is not
3141 necessary to know much about how this works, only how to use it and how to
3142 configure
3143 it.
3144 <P>
3145 More information on configuring LDAP is available in Alpine's online help:
3146 <ul>
3147   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
3148 </ul>
3149 <P>
3150 Additional help on using LDAP in Alpine is also available:
3151 <ul>
3152   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
3153 </ul>
3154 <P>
3155 &lt;End of help on this topic&gt;
3156 </BODY>
3157 </HTML>
3158 ===== h_mainhelp_index ======
3159 <HTML>
3160 <HEAD>
3161 <TITLE>Index of Messages</TITLE>
3162 </HEAD>
3163 <BODY>
3164 <H1>Index of Messages</H1>
3165
3166 In Alpine's message index, the selected message is highlighted. The first
3167 column on the left is blank, shows a &quot;+&quot; if the message was
3168 sent directly to you (i.e., it is not a
3169 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
3170 <P>
3171 The second column may be blank, or it may contain:
3172 <ul>
3173   <li>"N" if the message is new (unread), </li>
3174   <li>"A" if you have answered the message (using the Reply command), </li>
3175   <li>"D" if you have marked the message for deletion.</li>
3176 </ul>
3177
3178 <P>
3179 Note: If you answer a message as well as mark it deleted (in either order),
3180 you will only see the &quot;D&quot;.
3181
3182 <P>
3183 The rest of the columns in the message line show you the message
3184 number, date sent, sender, size, and subject. For details, press ? (Help).
3185 The behavior and appearance of the Index screen is highly configurable.
3186 In the Setup/Config screen search (with the WhereIs command) for options
3187 that contain the words &quot;index&quot; or &quot;thread&quot; to see
3188 many of the configuration possibilities.
3189 In particular, the
3190 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
3191 option may be used to configure the look of the standard MESSAGE INDEX lines
3192 in many different ways.
3193 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
3194 read the help text there for more information.
3195 <P>
3196 Most of the commands you need to handle your messages are visible at the
3197 bottom of the screen, and you can press O (OTHER CMDS) to see additional
3198 commands that are available.
3199 You do not need to see these &quot;other commands&quot;
3200 on the screen to use them. That is, you never need to press O as a prefix
3201 for any other command.
3202
3203 <P>
3204 Additional information is available in Alpine's online help:
3205 <ul>
3206   <li><a href="h_mail_index">Message Index Commands</a></li>
3207 </ul>
3208 <P>
3209 &lt;End of help on this topic&gt;
3210 </BODY>
3211 </HTML>
3212 ===== h_mainhelp_reading ======
3213 <HTML>
3214 <HEAD>
3215 <TITLE>Reading Messages</TITLE>
3216 </HEAD>
3217 <BODY>
3218 <H1>Reading Messages</H1>
3219
3220 The message text screen shows you the text of the message along with
3221 its header. If a message has attachments, those will be listed (but not
3222 displayed) also.  The titlebar line displays information about the currently
3223 open message, folder and collection.  You see the name of the collection
3224 (if there is one) in angle brackets, then the name of the folder, then the
3225 message number and finally the position within the current message (in
3226 percent). If the message is marked for deletion
3227 &quot;DEL&quot; will appear in the
3228 upper right as well.
3229
3230 <P>
3231 As with every Alpine screen, the bottom two lines show you the commands
3232 available.
3233
3234 <P>Additional information is available in Alpine's online help:
3235 <ul>
3236   <li><a href="h_mail_view">Message Text Screen</a></li>
3237   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
3238   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
3239 </ul>
3240 <P>
3241 &lt;End of help on this topic&gt;
3242 </BODY>
3243 </HTML>
3244 ===== h_mainhelp_composing ======
3245 <HTML>
3246 <HEAD>
3247 <TITLE>Composing Messages</TITLE>
3248 </HEAD>
3249 <BODY>
3250 <H1>Composing Messages</H1>
3251
3252 To write a message, press C (Compose). You see the Compose Message
3253 screen, which is divided into two parts: the header area and the message
3254 text area. The header area is where information on the recipient (the To:
3255 field) and the subject line go, while the message text area contains the
3256 actual text of the email message. Different commands are available to you
3257 when your cursor is in different areas on this screen. To see additional
3258 help on commands in either the message text or header area, type
3259 <Control>G (Get help).
3260
3261 <P>
3262 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
3263 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
3264
3265 <P>The following information from Alpine's online help may prove useful:
3266 <ul>
3267   <li><a href="h_composer_to">Message Header Commands</a></li>
3268   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
3269   <li><a href="h_composer">Composer Commands</a></li>
3270   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
3271   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
3272   <li><a href="h_compose_send">Send Command</a></li>
3273   <li><a href="h_compose_spell">Spell Check Command</a></li>
3274 </ul>
3275 <P>
3276 &lt;End of help on this topic&gt;
3277 </BODY>
3278 </HTML>
3279 ===== h_mainhelp_collections ======
3280 <HTML>
3281 <HEAD>
3282 <TITLE>Collection Lists</TITLE>
3283 </HEAD>
3284 <BODY>
3285 <H1>Collection Lists</H1>
3286
3287 Collection lists are Alpine's way of organizing groups of folders. Each
3288 "collection" can reside on a different server, for example, and contain a
3289 different group of mail folders.
3290
3291 <P>
3292 For more information on this, see:
3293 <ul>
3294   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
3295 </ul>
3296 <P>
3297 Additional information relating to collection lists is also available in
3298 Alpine's online
3299 help:
3300 <ul>
3301   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
3302   <li><a href="h_collection_screen">Collection List Screen</a></li>
3303 </ul>
3304 <P>
3305 &lt;End of help on this topic&gt;
3306 </BODY>
3307 </HTML>
3308 ===== h_mainhelp_folders ======
3309 <HTML>
3310 <HEAD>
3311 <TITLE>Folders</TITLE>
3312 </HEAD>
3313 <BODY>
3314 <H1>Folders</H1>
3315
3316 Messages can quickly accumulate in your INBOX folder. If you use email
3317 often, you soon could have hundreds. You need to delete messages you do
3318 not want, and you can use folders to organize messages you wish to save. A
3319 folder is a collection of one or more messages that are stored (just like
3320 the messages in your INBOX) so you can access and manage them.
3321
3322 <P>
3323 You can organize your email messages into different folders by topic,
3324 correspondent, date, or any other category that is meaningful to you. You
3325 can create your own folders, and Alpine automatically provides three:
3326 <ul>
3327   <li>The INBOX folder: messages sent to you are listed in this folder.
3328       When you first start Alpine and go to the Message Index screen, you are
3329 looking at the list of messages in your INBOX folder. Every incoming
3330 message remains in your INBOX until you delete it or save it in another
3331 folder. </li>
3332   <li>The sent-mail folder: copies of messages you send are stored in this
3333 folder. This is
3334 convenient if you cannot remember whether you actually sent a message and want
3335 to check, or
3336 if you want to send a message again.</li>
3337   <li>The saved-messages folder: copies of messages you save are stored in this
3338 folder
3339 unless you choose to save them to other folders you create yourself.</li>
3340 </ul>
3341
3342 <P>
3343 More information about folders is available in Alpine's online help:
3344 <ul>
3345   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
3346   <li><a href="h_folder_maint">Help for Folder List</a></li>
3347   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
3348   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
3349 Explained</a></li>
3350   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
3351 </ul>
3352 <P>
3353 &lt;End of help on this topic&gt;
3354 </BODY>
3355 </HTML>
3356 ===== h_mainhelp_color ======
3357 <HTML>
3358 <HEAD>
3359 <TITLE>Color</TITLE>
3360 </HEAD>
3361 <BODY>
3362 <H1>Color</H1>
3363
3364 If the terminal emulator you are using is capable of displaying color or if
3365 you are using PC-Alpine, then it is possible to set up Alpine so that various
3366 parts of the display will be shown in colors you configure. This is done
3367 using the Setup Color screen, available from the MAIN MENU by selecting
3368 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
3369 stands for Config in this context).
3370
3371 <P>
3372 For example, you may color things like the titlebar, the current item,
3373 the keymenu, and the status messages.
3374 You may also color lines in the index, and headers and quoted text in the
3375 MESSAGE TEXT screen.
3376 You use the Color Setup screen for configuring most of this, but you must
3377 use the IndexColor setup for coloring whole index lines.
3378 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
3379
3380 <P>
3381 The following entries in Alpine's online help provide additional information
3382 about how to use color:
3383 <UL>
3384   <LI> <A HREF="h_color_setup">Color Setup screen</A>
3385   <LI> <A HREF="h_rules_incols">Index Line Color</A>
3386   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
3387   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
3388 </UL>
3389 <P>
3390 &lt;End of help on this topic&gt;
3391 </BODY>
3392 </HTML>
3393 ===== h_mainhelp_mouse ======
3394 <HTML>
3395 <HEAD>
3396 <TITLE>Using a Mouse</TITLE>
3397 </HEAD>
3398 <BODY>
3399 <H1>Using a Mouse</H1>
3400
3401 If you are using PC-Alpine mouse support is turned on automatically.
3402 If you are using UNIX Alpine within an X terminal window or within
3403 a terminal emulator that supports an xterm-style mouse, then you may
3404 turn on support for the mouse with the feature
3405 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
3406 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
3407 <P>
3408 PC-Alpine offers considerable mouse support.  You can view what is
3409 &quot;clickable&quot; by dragging your mouse over any screen; when the
3410 arrow cursor changes into a hand, you found something. Mouse-click
3411 possibilities include navigating between screens and folders and
3412 double-clicking on hyperlinks to open your Web browser.
3413 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
3414 screen.  Examples of right-click options include &quot;copy&quot; after
3415 selecting text to copy and &quot;View in New Window&quot; when you click
3416 on a particular message in the Message Index. The menu choices available
3417 to you will vary based upon what screen is open, where on the screen your
3418 cursor is located, and even what action you have already taken.
3419 Within a folder, you may set the &quot;Important&quot; flag on any
3420 message.
3421 <P>
3422 X terminal mouse support is more limited but still quite powerful.
3423 As with PC-Alpine, clicking on any of the commands in the keymenu at
3424 the bottom of the screen will execute that command as if you typed it.
3425 Double-clicking on a link, for example the link to the
3426 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
3427 will take you to that link.
3428 Double-clicking on an index line will view the message, and so on.
3429 <P>
3430 &lt;End of help on this topic&gt;
3431 </BODY>
3432 </HTML>
3433 ===== h_mainhelp_keywords ======
3434 <HTML>
3435 <HEAD>
3436 <TITLE>Keywords</TITLE>
3437 </HEAD>
3438 <BODY>
3439 <H1>Keywords</H1>
3440
3441 Within a folder, you may set the &quot;Important&quot; flag on any
3442 message.
3443 This doesn't have any system-defined meaning and is only called
3444 the Important flag because many users use it to signify that a message
3445 is important to them in some way.
3446 <P>
3447 You may also define your own set of keywords.
3448 You might know these as user defined flags or as labels.
3449 These are similar to the Important flag but you choose the names for yourself.
3450 <P>
3451 Alpine will only display keywords that
3452 have been added by you in the Flag Details screen or
3453 that have been configured by you using the Setup/Config option
3454 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
3455 Keywords set by other means (for example, by another email client) will not
3456 show up in Alpine unless you configure Alpine to know about them.
3457 They will show up in the Flag Details screen, but will not show up, for example,
3458 in the index line.
3459
3460 <P>
3461 The following entries in Alpine's online help provide additional information
3462 about how to use keywords:
3463 <ul>
3464   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
3465   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
3466 </ul>
3467 <P>
3468 &lt;End of help on this topic&gt;
3469 </BODY>
3470 </HTML>
3471 ===== h_mainhelp_roles ======
3472 <HTML>
3473 <HEAD>
3474 <TITLE>Roles</TITLE>
3475 </HEAD>
3476 <BODY>
3477 <H1>Roles</H1>
3478
3479 You may play different roles depending on who you are replying to. For
3480 example, if you are replying to a message addressed to help-desk you may
3481 be acting as a Help Desk Worker. That role may require that you use a
3482 different return address and/or a different signature.
3483
3484 <P>
3485 To configure roles, go to the MAIN MENU and use the Setup command
3486 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
3487 The following entries in Alpine's online help provide additional information
3488 about how to
3489 use roles:
3490 <ul>
3491   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
3492   <li><a href="h_role_select">Roles Screen</a></li>
3493 </ul>
3494 <P>
3495 &lt;End of help on this topic&gt;
3496 </BODY>
3497 </HTML>
3498 ===== h_mainhelp_filtering ======
3499 <HTML>
3500 <HEAD>
3501 <TITLE>Filtering</TITLE>
3502 </HEAD>
3503 <BODY>
3504 <H1>Filtering</H1>
3505
3506 The software that actually delivers mail (the stuff that happens
3507 before Alpine is involved) for you is in a better position to do mail filtering
3508 than Alpine itself.
3509 If possible, you may want to look into using that sort of mail filtering to
3510 deliver mail to different folders, delete it, or forward it.
3511 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
3512
3513 <P>
3514 Filtering is a way to automatically move certain messages from one folder
3515 to another or to automatically delete messages.
3516 You may also automatically set the state (Important, New, Deleted, Answered) of messages
3517 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
3518 Alpine doesn't have the ability to forward mail to another address or
3519 to deliver vacation messages.
3520
3521 <P>
3522 To configure filtering, go to the MAIN MENU and use the Setup command
3523 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
3524 The following entries in Alpine's online help provide additional information
3525 about how to use filtering:
3526 <UL>
3527   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
3528 </UL>
3529 <P>
3530 &lt;End of help on this topic&gt;
3531 </BODY>
3532 </HTML>
3533 ===== h_mainhelp_patterns ======
3534 <HTML>
3535 <HEAD>
3536 <TITLE>Patterns</TITLE>
3537 </HEAD>
3538 <BODY>
3539 <H1>Patterns</H1>
3540
3541 Patterns are used with Roles, Filtering, Index Coloring,
3542 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
3543 The following entries in Alpine's online help provide information
3544 about using Patterns:
3545 <UL>
3546   <LI> <A HREF="h_rule_patterns">Patterns</A>
3547 </UL>
3548 <P>
3549 &lt;End of help on this topic&gt;
3550 </BODY>
3551 </HTML>
3552 ===== h_mainhelp_cmdlineopts ======
3553 <HTML>
3554 <HEAD>
3555 <TITLE>Command Line Options</TITLE>
3556 </HEAD>
3557 <BODY>
3558 <H1>Command Line Options</H1>
3559
3560 Alpine accepts a number of command line arguments, allowing you, for
3561 example, to start Alpine and immediately access a particular folder.
3562 Many of these arguments overlap with options in the Alpine configuration file.
3563 If there is a difference, then an option set on the command line takes
3564 precedence.
3565 Alpine expects command line arguments (other than addresses) to be
3566 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
3567 A <a href="h_command_line_options">full list</a> of command line
3568 possibilities is available.
3569 <P>
3570 &lt;End of help on this topic&gt;
3571 </BODY>
3572 </HTML>
3573 ===== h_mainhelp_config ======
3574 <HTML>
3575 <HEAD>
3576 <TITLE>Alpine Configuration</TITLE>
3577 </HEAD>
3578 <BODY>
3579 <H1>Alpine Configuration</H1>
3580
3581 Unless it has been administratively disabled, the Setup command on the
3582 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
3583 The possible subcommands are for general Configuration settings,
3584 Printer settings, Changing your Password, Signature setup,
3585 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
3586 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
3587 and Color configuration.
3588 In particular, the &quot;Config&quot; subcommand has many features you may
3589 set or unset and many other configuration variables that may be set to change
3590 the way Alpine works.
3591 Every one of the hundreds of options available in that configuration settings
3592 screen has help text associated with it.
3593 You may read that text by moving the cursor to highlight the option and then
3594 typing the Help command.
3595 <P>
3596 These settings are stored in your personal
3597 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
3598 <A HREF="h_config_remote_config">remotely</A>),
3599 but on shared systems these settings
3600 may be over-ridden by a system-wide control file (due to local site
3601 security or support policies).  A global pine configuration file can also
3602 be used to set default values for all Alpine users on a particular system.
3603 Power users may be interested in splitting their personal configuration
3604 data into two pieces, a generic piece and
3605 <A HREF="h_config_exceptions">exceptions</A> which apply to
3606 a particular platform.
3607 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
3608 General Alpine configuration information can be found
3609 <A HREF="h_news_config">here</A>.
3610 <P>
3611 &lt;End of help on this topic&gt;
3612 </BODY>
3613 </HTML>
3614 ===== h_mainhelp_aggops ======
3615 <HTML>
3616 <HEAD>
3617 <TITLE>Aggregate Operations</TITLE>
3618 </HEAD>
3619 <BODY>
3620 <H1>Aggregate Operations</H1>
3621
3622 When you are in the MESSAGE INDEX, the available commands
3623 (for example, Delete, Undelete, Save, Reply, and so on)
3624 normally act on a single message.
3625 So, for example, if you press the Delete command, the currently highlighted
3626 message is marked Deleted.
3627 These commands that normally act on a single message may be applied to
3628 several messages at once instead.
3629 <P>
3630 By default this feature is turned on, but it could be administratively turned
3631 off to reduce complexity.
3632 The feature
3633 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
3634 in the Setup/Config screen is used to turn it off or on.
3635 When this feature is turned on, the four commands &quot;Select&quot;,
3636 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
3637 are available.
3638 The two selection commands allow you to mark a set of
3639 messages as being &quot;selected&quot;.
3640 The &quot;ZoomMode&quot; command will toggle between
3641 displaying only the selected messages and displaying all the messages.
3642 The &quot;Apply&quot; command allows you to
3643 apply one of the regular MESSAGE INDEX commands to all of the selected
3644 messages instead of to only the highlighted message.
3645 <P>
3646 An example aggregate operation would be to catch up when reading
3647 a news group.
3648 That is, get rid of all the messages in the news group so that you can
3649 start fresh.
3650 The easiest way to do this in Alpine is to use aggregate operations.
3651 You want to Delete all of the messages in the group.
3652 You could start at the top and type &quot;D&quot; once for every message.
3653 A much faster method is to first Select all of the messages in the group,
3654 and then Delete all of them.
3655 This would take four keystrokes:
3656 <P>
3657 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
3658 <BR>
3659 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
3660 <P>
3661 Another use of Select is to use it for searching for a particular message
3662 or set of messages in a large folder.
3663 You may know that the message was From a certain user.
3664 You could select all messages from that user to start, and use Zoom to
3665 look at only those messages.
3666 If there were still too many messages to look at you could Narrow the
3667 set of messages further by selecting from all of those messages only
3668 the ones that were after a certain date, or contained a particular phrase
3669 in the Subject, or were too a particular address, and so on.
3670 That may be the end of what you are doing, or you may want to use Apply to
3671 Save or Forward or Print all of the selected messages.
3672 <P>
3673 Some related help topics are
3674 <UL>
3675 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
3676 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
3677 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
3678 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
3679 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
3680 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
3681 </UL>
3682 <P>
3683 &lt;End of help on this topic&gt;
3684 </BODY>
3685 </HTML>
3686 ===== h_mainhelp_readingnews ======
3687 <HTML>
3688 <HEAD>
3689 <TITLE>Reading News</TITLE>
3690 </HEAD>
3691 <BODY>
3692 <H1>Reading News</H1>
3693
3694 <H2>Background</H2>
3695 Alpine can read and post to Internet (or USENET) newsgroups, using the same
3696 commands as for mail. Similar to mailing lists but existing on a larger scale,
3697 Usenet newsgroups allow groups of people with common interests to discuss
3698 particular topics. You might find newsgroups related to your career, or you
3699 might wish to check out the online discussion among the fans of your favorite
3700 television show.
3701
3702 <H2>Configuring Alpine for Reading News</H2>
3703 Alpine often arrives
3704 pre-configured by your system administrator to automatically access the
3705 newsgroups offered by your organization, Internet Service Provider, or
3706 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
3707 need additional details on <a href="h_configuring_news">how to
3708 configure Alpine to read news</a>.
3709
3710 <H2>Accessing Newsgroups</H2>
3711 The first step in reading news is to access the newsgroups collections
3712 screen from Alpine. If everything is configured properly, you should be able
3713 to do this by first typing L (folder List), then selecting the folder
3714 collection listed as "News." The actual name of this collection may differ
3715 from system to system.
3716
3717 <H2>Subscribing to Newsgroups</H2>
3718
3719 Once you have accessed the news collection, you need to subscribe to a
3720 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
3721 will keep a record of the newsgroups in which you are interested and which
3722 articles in those newsgroups have been read.
3723
3724 <H2>Using Newsgroups</H2>
3725 Alpine uses the similar commands to read news as to read mail. For example,
3726 the D command marks messages as Deleted (or "Dismissed," if you prefer),
3727 and the R command Replies to a news posting. Basically, Alpine allows you to
3728 read news as if it were mail, so you don't need to change the way you
3729 interact with Alpine.
3730 <P>
3731 There is also additional Alpine help available on
3732 <A HREF="h_reading_news">how to use Alpine to read news</A>.
3733 <P>
3734 &lt;End of help on this topic&gt;
3735 </BODY>
3736 </HTML>
3737 ===== h_mainhelp_securing ======
3738 <HTML>
3739 <HEAD>
3740 <TITLE>Securing your Alpine Session</TITLE>
3741 </HEAD>
3742 <BODY>
3743 <H1>Securing your Alpine Session</H1>
3744
3745 By default, Alpine will attempt to connect to an IMAP server on the normal
3746 IMAP service port (143).
3747 If the Alpine you are using has been built to
3748 support &quot;Transport Layer Security&quot; (TLS)
3749 and &quot;Secure Sockets Layer&quot; (SSL)
3750 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
3751 and the server offers the STARTTLS capability, then a secure (encrypted)
3752 session will be established.
3753 <P>
3754 When you are connected to a remote folder the titlebar will contain a plus sign
3755 in the far right column if the connection is encrypted using TLS or SSL.
3756 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
3757 if the connection is encrypted.
3758
3759 <H2>More Information on Alpine with SSL and TLS</H2>
3760 <UL>
3761 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
3762 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
3763 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
3764 <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>
3765 </UL>
3766 <H2>Here are some other security-related features and options</H2>
3767 <P>
3768 <UL>
3769 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
3770 <LI> <A HREF="h_config_disable_password_file_saving"><!--#echo var="FEAT_disable-password-file-saving"--></A> Disable password file saving</LI>
3771 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
3772 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
3773 <LI> <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A> option </LI>
3774 </UL>
3775 <P>
3776 &lt;End of help on this topic&gt;
3777 </BODY>
3778 </HTML>
3779 ===== h_mainhelp_problems ======
3780 <HTML>
3781 <HEAD>
3782 <TITLE>Reporting Problems</TITLE>
3783 </HEAD>
3784 <BODY>
3785 <H1>Reporting Problems</H1>
3786
3787 We ask that you first read the relevant help screens and then seek
3788 assistance from your own local support staff.  Once you are sure that your
3789 difficulty is not a local configuration problem, you might look at the
3790 help section explaining where to look for
3791 <A HREF="h_finding_help">more information</A> and where to
3792 get assistance.
3793 <P>
3794
3795 <ADDRESS>
3796    Eduardo Chappa &lt;chappa@gmx.com&gt;
3797 </ADDRESS>
3798
3799 <P>
3800 &lt;End of help on this topic&gt;
3801 </BODY>
3802 </HTML>
3803 ===== h_main_menu_commands ======
3804 <HTML>
3805 <HEAD>
3806 <TITLE>MAIN MENU COMMANDS</TITLE>
3807 </HEAD>
3808 <BODY>
3809 <H1>MAIN MENU COMMANDS</H1>
3810
3811 <!--chtml if pinemode="function_key"-->
3812 &nbsp;Available&nbsp;Commands&nbsp;--
3813 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
3814 &nbsp;------------------------------
3815 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
3816 ----------<BR>
3817 &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>
3818 &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>
3819 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
3820 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
3821 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
3822 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
3823 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
3824 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
3825 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3826 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3827 &nbsp;F7&nbsp;&nbsp;<A
3828 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
3829 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3830 &nbsp;F8&nbsp;&nbsp;<A
3831 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
3832 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
3833 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
3834 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
3835 &nbsp;F10&nbsp;<A
3836 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
3837 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
3838 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3839 &nbsp;F11&nbsp;<A
3840 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3841 <!--chtml else-->
3842 &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>
3843 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
3844 &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>
3845 &nbsp;C&nbsp;&nbsp;<A
3846 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>
3847 &nbsp;I&nbsp;&nbsp;<A
3848 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>
3849 &nbsp;L&nbsp;&nbsp;<A
3850 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>
3851 &nbsp;A&nbsp;&nbsp;<A
3852 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
3853 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
3854 &nbsp;S&nbsp;&nbsp;<A
3855 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
3856 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3857 &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>
3858 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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
3859 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3860 <!--chtml endif-->
3861
3862 <P>
3863 NOTE:
3864 <OL>
3865  <LI>For help on a particular command, highlight the bold text associated
3866 with it above and hit Return.
3867  <LI> The availability of certain commands (e.g. some of the options under
3868 SETUP) is determined by Alpine configuration files and system capabilities.
3869 At some sites, certain commands may not be available due to security or
3870 support concerns.
3871 </OL>
3872 <P>
3873 &lt;End of help on this topic&gt;
3874 </BODY>
3875 </HTML>
3876
3877 ===== h_command_line_options ======
3878 <HTML>
3879 <HEAD>
3880 <TITLE>COMMAND LINE OPTIONS</TITLE>
3881 </HEAD>
3882 <BODY>
3883 <H1>COMMAND LINE OPTIONS</H1>
3884 Possible starting arguments for Alpine:
3885
3886 <DL COMPACT>
3887
3888 <DT> <EM>[addresses]</EM>
3889
3890 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
3891 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
3892 <EM>Alpine</EM> will startup in
3893 the composer with a message started to the addresses specified.
3894 Once the message is sent, the <EM>Alpine</EM> session closes.
3895 Standard input redirection is allowed.
3896 Separate multiple addresses with a space between them.
3897 Addresses are placed in the &quot;To&quot; field only.
3898 <P>
3899
3900 <DT> &lt; <EM>file</EM>
3901
3902 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
3903 into the body of the message.
3904 Once the message is sent, the <EM>Alpine</EM> session closes.
3905 <P>
3906
3907 <DT> -attach <EM>file</EM>
3908
3909 <DD> Go directly into composer with given file attached.
3910 <P>
3911
3912 <DT> -attachlist <EM>file-list</EM>
3913
3914 <DD> Go directly into composer with given files attached.
3915 This must be the last option on the command line.
3916 <P>
3917
3918 <DT> -attach_and_delete <EM>file</EM>
3919
3920 <DD> Go directly into composer with given file attached, delete when finished.
3921 <P>
3922
3923 <DT> -aux <EM>local_directory</EM>
3924
3925 <DD> <EM>PC-Alpine</EM> only.
3926 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
3927 files, like debug files, address books, and signature files.  The pinerc may
3928 be local or remote.
3929 <P>
3930
3931 <DT> -bail
3932
3933 <DD> If the personal configuration file doesn't already exist, exit.
3934 This might be useful if the configuration file is accessed using some
3935 remote filesystem protocol. If the remote mount is missing this will cause
3936 <EM>Alpine</EM> to quit instead of creating a new pinerc.
3937 <P>
3938
3939 <DT> -c <EM>n</EM>
3940
3941 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
3942 This is used when there are multiple folder collections (contexts) and you
3943 want to open a folder not in the primary collection.
3944 <P>
3945
3946 <DT> -conf
3947
3948 <DD> Configuration: Prints a sample system configuration file to the
3949 screen or standard output. To generate an initial system configuration
3950 file, execute
3951
3952 <PRE><CODE>
3953                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
3954 </CODE></PRE>
3955 <P>
3956
3957 To generate a system configuration file using settings from an old
3958 system configuration file, execute
3959
3960 <PRE><CODE>
3961                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
3962 </CODE></PRE>
3963 <P>
3964 A system configuration file is not required.
3965 <P>
3966
3967 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
3968
3969 <DD> Copy an address book file to a remote address book folder.
3970 If the remote folder doesn't exist, it will be created.
3971 If it exists but the first message in the folder isn't a remote address
3972 book header message, the copy will be aborted.
3973 This flag will not usually be used by a user.
3974 Instead, the user will create a remote address book from within <EM>Alpine</EM>
3975 and copy entries from the local address book by using aggregate Save in
3976 the address book screen.
3977 <P>
3978
3979 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
3980
3981 <DD> Copy a pinerc configuration file to a remote pinerc folder.
3982 If the remote folder doesn't exist, it will be created.
3983 If it exists but the first message in the folder isn't a remote pinerc
3984 header message, the copy will be aborted.
3985 This flag may be useful to users who already have a local pinerc file and
3986 would like to convert it to a remote pinerc folder and use that instead.
3987 This gives a way to bootstrap that conversion without having to manually
3988 reset all of the variables in the remote pinerc folder.
3989 <P>
3990
3991 <DT> -d <EM>debug-level</EM>
3992
3993 <DD> Debug Level:  Sets the level of debugging information written by
3994 <EM>Alpine</EM>.
3995 <EM>debug-level</EM> can be set to any integer 0-9.
3996 A debug level of 0 turns off debugging for the session.
3997 (Actually there are some levels higher than 9, but you probably don't
3998 want to see them.)
3999 <P>
4000
4001 <DT> -d <EM>keywords</EM>
4002
4003 <DD> You may use a more detailed version of the debugging flag to set
4004 the debug level in separate parts of <EM>Alpine</EM>.
4005 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
4006 verbose=0..9.
4007 <EM>Flush</EM> causes debugging information to be flushed immediately to
4008 the debug file as it is written.
4009 <EM>Verbose</EM> is the general debugging verbosity level.
4010 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
4011 is useful when you are trying to figure out what is responsible for delays.
4012 <EM>Numfiles</EM> sets the number of debug files saved.
4013 <EM>Imap</EM> sets the debug level for the debugging statements related
4014 to the conversation with the IMAP server, and more generally, for the
4015 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
4016 <EM>Tcp</EM> turns on some TCP/IP debugging.
4017 <P>
4018
4019 <DT> -f <EM>folder</EM>
4020
4021 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
4022 of the standard INBOX.
4023 <P>
4024
4025 <DT> -F <EM>file</EM>
4026
4027 <DD> Open named text file for viewing and forwarding.
4028 <P>
4029
4030 <DT> -h
4031
4032 <DD> Help:  Prints the list of available command-line arguments to the
4033 screen.
4034 <P>
4035
4036 <DT> -i
4037
4038 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
4039 screen instead of the MAIN MENU.
4040 <P>
4041
4042 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
4043 <P>
4044
4045 <DT> -I <EM>a,b,c,...</EM>
4046
4047 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
4048 sequence of commands upon startup.
4049 This allows users to get <EM>Alpine</EM> to start in any
4050 of its menus/screens.
4051 You cannot include any input to the composer in the initial keystrokes.
4052 The key &lt;Return&gt; is represented by a ``CR'' in
4053 the keystroke list; the spacebar is designated by the letters ``SPACE''.
4054 Control keys are two character sequences beginning with ``^'', such as
4055 ``^I''.
4056 A tab character is ``TAB''.
4057 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
4058 ``DOWN'', ``LEFT'', and ``RIGHT''.
4059 A restriction is that you can't mix function keys and character keys in this
4060 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
4061 A user can always use only <EM>character</EM> keys in the startup list even
4062 if he or she is using <EM>function</EM> keys normally, or vice versa.
4063 If an element in this list is a string of characters surrounded by double
4064 quotes (&quot;) then it will be expanded into the individual characters in
4065 the string, excluding the double quotes.
4066 <P>
4067
4068 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
4069 <P>
4070
4071 <DT> -install
4072
4073 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
4074 some basic information to help with getting properly set up.
4075 <P>
4076
4077 <DT> -k
4078
4079 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
4080 the input of commands to be function-keys.
4081 Otherwise, commands are linked to the regular character keys.
4082 <P>
4083
4084 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
4085 <EM>Feature-List</EM>.
4086 <P>
4087
4088 <DT> -n <EM>n</EM>
4089
4090 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
4091 FOLDER INDEX screen with the current message being the specified
4092 message number.
4093 <P>
4094
4095 <DT> -nosplash
4096
4097 <DD> <EM>PC-Alpine</EM> only.
4098 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
4099 This may be helpful for certain troubleshooting or terminal server scenarios.
4100 <P>
4101
4102 <DT> -o <EM>folder</EM>
4103
4104 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
4105 <P>
4106
4107 <DT> -p <EM>pinerc</EM>
4108
4109 <DD> Uses the named file as the personal configuration file instead of
4110 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
4111 Alpinerc may be either a local file or a remote configuration folder.
4112 <P>
4113
4114 <DT> -P <EM>pinerc</EM>
4115
4116 <DD> Uses the named file as the system wide configuration file instead of
4117 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
4118 Alpinerc may be either a local file or a remote configuration folder.
4119 <P>
4120
4121 <DT> -passfile <EM>passfile</EM>
4122
4123 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
4124 This should be a fully-qualified filename.
4125 <P>
4126
4127 <DT> -pinerc <EM>file</EM>
4128
4129 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
4130 settings of variables that the user has made.
4131 Use <EM>file</EM> set to ``-'' to make output go to standard out.
4132 <P>
4133
4134 <DT> -r
4135
4136 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
4137 <EM>Alpine</EM> in restricted mode can only send email to itself.
4138 Save and export are limited.
4139 <P>
4140
4141 <DT> -registry <EM>cmd</EM>
4142
4143 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
4144 <EM>Alpine</EM>'s registry entries.
4145 Possible values for <EM>cmd</EM> are set, clear, and dump.
4146 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
4147 entries according to its current settings.
4148 <EM>Clear</EM> will clear the registry values.
4149 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
4150 <EM>Dump</EM> will display the values of current registry settings.
4151 Note that the dump command is currently disabled.
4152 Without the -registry option, <EM>PC-Alpine</EM> will write values into
4153 the registry only if there currently aren't any values set.
4154 <P>
4155
4156 <DT> -sort <EM>key</EM>
4157
4158 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
4159 FOLDER INDEX screen.
4160 <EM>Key</EM> can have the following values:
4161 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
4162 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
4163 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
4164 The default value is &quot;arrival&quot;.
4165 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
4166 <P>
4167
4168 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
4169 <P>
4170
4171 <DT> -uninstall
4172
4173 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
4174 in Windows settings.  The registry settings are removed and
4175 the password cache is cleared.
4176 <P>
4177
4178 <DT> -url <EM>url</EM>
4179
4180 <DD> Open the given URL.
4181 <P>
4182
4183 <DT> -v
4184
4185 <DD> Version:  Print version information to the screen.
4186 <P>
4187
4188 <DT> -x <EM>exceptions_config</EM>
4189
4190 <DD> Configuration settings in the exceptions configuration override your normal
4191 default settings.
4192 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
4193 <P>
4194
4195 <DT> -z
4196
4197 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
4198 will suspend the <EM>Alpine</EM> session.
4199 <P>
4200
4201 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
4202 <EM>Feature-List</EM>.
4203 <P>
4204
4205 <DT> -<EM>option</EM>=<EM>value</EM>
4206
4207 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
4208 For example, <EM>-signature-file=sig1</EM> or
4209 <EM>-Feature-List=signature-at-bottom</EM>.
4210 Note:  Feature-List values are
4211 additive and features may be preceded with no- to turn them off.
4212 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
4213 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
4214 <EM>-Feature-List=signature-at-bottom</EM>.
4215 <P>
4216
4217 </DL>
4218 <P>
4219 &lt;End of help on this topic&gt;
4220 </BODY>
4221 </HTML>
4222 ===== h_configuring_news ======
4223 <HTML>
4224 <HEAD>
4225 <TITLE>CONFIGURING NEWS</TITLE>
4226 </HEAD>
4227 <BODY>
4228 <H1>CONFIGURING NEWS</H1>
4229 Alpine can access news folders in any one of three different ways:
4230 <DL>
4231 <DT>REMOTE NNTP</DT>
4232 <DD>Using the Network News Transport Protocol (NNTP) to
4233 access news on a remote news server.  In this case the newsrc file is
4234 stored on the machine where Alpine is running.
4235
4236 <P>
4237 To specify a remote news-collection accessed via NNTP use the
4238 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4239 Server: value to the NNTP server's hostname appended with the
4240 communication method &quot;/service=NNTP&quot;, and set the Path:
4241 value to the &quot;#news.&quot; namespace (without the quotes).  See
4242 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
4243 help text for a more complete explanation of access method, and the
4244 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4245 text for a more complete explanation of &quot;namespace&quot;.
4246 <P>
4247 Instead of specifying a news-collection, you may simply set the
4248 <A HREF="h_config_nntp_server">NNTP Server</A>
4249 option, which will cause Alpine to create a default news-collection for you.
4250 Another NNTP option that may be of interest is
4251 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
4252
4253 <DT>REMOTE IMAP</DT>
4254 <DD>Using the Internet Message Access Protocol (IMAP) to
4255 access news on a remote news server.  In this case, your newsrc file is
4256 stored on the news server, in your home directory, so you must have an
4257 account on the news server, but you would be running Alpine on a different
4258 machine.  The news server must be running an IMAPd server process.
4259
4260 <P>
4261 To specify a remote news-collection accessed via IMAP use the
4262 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4263 Server: value to the IMAP server's hostname, and set the Path: value
4264 to the &quot;#news.&quot; namespace (without the quotes).  See the
4265 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4266 text for a more complete explanation of &quot;namespace&quot;.
4267
4268 </DD>
4269
4270 <DT>LOCAL</DT>
4271 <DD>Using local file access to the news database.  In this
4272 case, your newsrc file is stored on the news server, in your home
4273 directory, so you must have an account on the news server, and you would
4274 be running Alpine on the same machine.
4275
4276 <P>
4277 To specify a local news-collection use the SETUP/collectionList
4278 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
4279 set the Path: value to the &quot;#news.&quot; namespace (without the
4280 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
4281 field's help text for a more complete explanation of &quot;namespace&quot;.
4282
4283 </DD>
4284 </DL>
4285
4286 <P>
4287
4288 NOTE: Should no news-collection be defined as above, Alpine will
4289 automatically create one using the Setup/Config screen's
4290 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
4291 will be created as a &quot;Remote NNTP&quot; as described above.
4292
4293 <P>
4294
4295 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
4296 possible.  If you don't have an account on the news server, or if the news
4297 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
4298 sure, ask your service provider, university, or company for help.)  In
4299 this case, your Unix .newsrc file can be transferred to your PC.  A good
4300 place to put it would be in the same directory as your PINERC file, under
4301 the name NEWSRC, but you can
4302 <A HREF="h_config_newsrc_path">specify a different location</A>
4303 via Alpine's Setup/Config screen.
4304
4305 <P>
4306 Other configuration features related to news are
4307 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
4308 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
4309 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
4310 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
4311 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
4312 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
4313 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
4314 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
4315
4316 <P>
4317 &lt;End of help on this topic&gt;
4318 </BODY>
4319 </HTML>
4320 ===== h_reading_news ======
4321 <HTML>
4322 <HEAD>
4323 <TITLE>READING NEWS</TITLE>
4324 </HEAD>
4325 <BODY>
4326 <H1>READING NEWS</H1>
4327
4328 Alpine uses almost the same commands for manipulating news folders as for
4329 mail folders.  This means, for example, that when you are done with a
4330 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
4331 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
4332 most newsreaders, wherein a message is implicitly dismissed after you have
4333 looked at it once. We strongly believe that Alpine should offer as much
4334 consistency as possible between mail and news, so the mail paradigm --
4335 wherein a message does not magically disappear without explicit action by
4336 the user -- is used for news as well. <P>
4337
4338 If you answer a message in a news folder, the index view will show the
4339 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
4340 keep track of what news as been read has no way of storing this flag, so
4341 it will not be preserved across sessions.  The Deleted flag is the only
4342 one that is preserved when you leave and then return to a newsgroup.  As an
4343 additional note on replies, when you Reply to a newsgroup message and say
4344 you want to reply to all recipients, Alpine will ask if you want to post the
4345 message to all the newsgroups listed in the original message. <P>
4346
4347 If you would like Alpine to mark more-or-less recent news messages as
4348 &quot;New&quot;, then set the
4349 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
4350 feature (which is set by default).  This will cause messages after the last one you have marked as
4351 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
4352 &quot;N&quot; status often makes it easier to distinguish later news
4353 articles from those you've previously seen, but not yet disposed of via
4354 the &quot;D&quot; key.  Note that this is an approximation, not an exact
4355 record of which messages you have not seen.
4356 <P>
4357
4358 A frequent operation in news-reading is &quot;catching up&quot; -- that
4359 is, getting rid of all the messages in the newsgroup so that you can
4360 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
4361 Select command.  You would enter the following four keystrokes:
4362 <tt>;aad</tt> to select all messaged, and then apply the delete (or
4363 dismiss) command to all of them.
4364
4365 <P>
4366 There are also additional details on
4367 <A HREF="h_configuring_news">configuring news</a>.
4368
4369 <P>
4370 &lt;End of help on this topic&gt;
4371 </BODY>
4372 </HTML>
4373 ====== h_help_index ======
4374 <HTML>
4375 <HEAD>
4376 <TITLE>Help Index</TITLE>
4377 </HEAD>
4378 <BODY>
4379 <H1>Help Index</H1>
4380 <ul>
4381 <li><a href="h_mainhelp_abooks">Address Books</a></li>
4382 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
4383 <li><a href="h_main_addrbook">Address Book Command</a>
4384 <li><a href="h_abook_view">Address Book View Explained</a>
4385 <li><a href="h_compose_addrcomplete">Address Completion</a>
4386 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
4387 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
4388 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
4389 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
4390 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
4391 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
4392 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
4393 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
4394 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
4395 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
4396 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
4397 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
4398 <li><a href="h_mainhelp_config">Alpine Configuration</a>
4399 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
4400 <li><a href="h_news_legal">Alpine Legal Notices</a>
4401 <li><a href="h_compose_alted">Alt Editor Command</a>
4402 <li><a href="h_index_cmd_apply">Apply Command</a>
4403 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
4404 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
4405 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
4406 <li><a href="h_composer_browse">BROWSER</a>
4407 <li><a href="h_common_bounce">Bounce Command</a>
4408 <li><a href="h_compose_cancel">Cancel Command</a>
4409 <li><a href="h_config_change_your_from">Changing your From Address</a>
4410 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
4411 <li><a href="h_mainhelp_color">Color</a>
4412 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
4413 <li><a href="h_composer">COMPOSER COMMANDS</a>
4414 <li><a href="h_mainhelp_composing">Composing Messages</a>
4415 <li><a href="h_mainhelp_collections">Collection Lists</a>
4416 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
4417 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
4418 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
4419 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
4420 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
4421 <li><a href="h_common_compose">Compose Command</a>
4422 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
4423 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
4424 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
4425 <li><a href="h_mainhelp_config">Configuration</a>
4426 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
4427 <li><a href="h_config_dflt_color">Default Color</a>
4428 <li><a href="h_common_delete">Delete and Undelete Commands</a>
4429 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
4430 <li><a href="h_special_list_commands">Email List Commands Explained</a>
4431 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
4432 <li><a href="h_folder_open">Explanation of Folder Selection</a>
4433 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
4434 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
4435 <li><a href="h_ge_export">Export File Selection</a>
4436 <li><a href="h_ge_allparts">Export Message File Selection</a>
4437 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
4438 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
4439 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
4440 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
4441 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
4442 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
4443 <li><a href="h_config_alt_reply_menu">FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></a>
4444 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
4445 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
4446 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
4447 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
4448 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
4449 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
4450 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
4451 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
4452 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
4453 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
4454 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
4455 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
4456 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
4457 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
4458 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
4459 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
4460 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
4461 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
4462 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
4463 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
4464 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
4465 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
4466 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
4467 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
4468 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
4469 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
4470 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
4471 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
4472 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
4473 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
4474 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
4475 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
4476 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
4477 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
4478 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
4479 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
4480 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
4481 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
4482 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
4483 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
4484 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
4485 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
4486 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
4487 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
4488 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
4489 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
4490 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
4491 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
4492 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
4493 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
4494 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
4495 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
4496 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
4497 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
4498 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
4499 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
4500 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
4501 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
4502 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
4503 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
4504 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
4505 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
4506 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
4507 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
4508 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
4509 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
4510 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
4511 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
4512 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
4513 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
4514 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
4515 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
4516 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
4517 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
4518 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
4519 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
4520 <li><a href="h_external_loads_inline_images_only">FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
4521 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
4522 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
4523 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
4524 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
4525 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
4526 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
4527 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
4528 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
4529 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
4530 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
4531 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
4532 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
4533 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
4534 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
4535 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
4536 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
4537 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
4538 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
4539 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
4540 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
4541 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
4542 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
4543 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
4544 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
4545 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
4546 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
4547 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
4548 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
4549 <li><a href="h_config_ignore_size">FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></a>
4550 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
4551 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
4552 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
4553 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
4554 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
4555 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
4556 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
4557 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
4558 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
4559 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
4560 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
4561 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
4562 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
4563 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
4564 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
4565 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
4566 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
4567 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
4568 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
4569 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
4570 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
4571 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
4572 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
4573 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
4574 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
4575 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
4576 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
4577 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
4578 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
4579 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
4580 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
4581 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
4582 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
4583 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
4584 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
4585 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
4586 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
4587 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
4588 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
4589 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
4590 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
4591 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
4592 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
4593 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
4594 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
4595 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
4596 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
4597 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
4598 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
4599 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
4600 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
4601 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
4602 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
4603 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
4604 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
4605 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
4606 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
4607 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
4608 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
4609 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
4610 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
4611 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
4612 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
4613 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
4614 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
4615 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
4616 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
4617 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
4618 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
4619 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
4620 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
4621 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
4622 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
4623 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
4624 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
4625 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
4626 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
4627 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
4628 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
4629 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
4630 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
4631 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
4632 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
4633 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
4634 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
4635 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
4636 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
4637 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
4638 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
4639 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
4640 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
4641 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
4642 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
4643 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
4644 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
4645 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
4646 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
4647 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
4648 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
4649 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
4650 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
4651 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
4652 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
4653 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
4654 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
4655 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
4656 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
4657 <li><a href="h_mainhelp_filtering">Filtering</a>
4658 <li><a href="h_finding_help">Finding more information and requesting help</a>
4659 <li><a href="h_common_flag">Flag Command</a>
4660 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
4661 <li><a href="h_mainhelp_folders">Folders</a>
4662 <li><a href="h_what_are_collections">Folder Collections Explained</a>
4663 <li><a href="h_common_folders">Folder List Command</a>
4664 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
4665 <li><a href="h_folder_save">Folder Select for Save Explained</a>
4666 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
4667 <li><a href="h_config_change_your_from">From Address, Changing</a>
4668 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
4669 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
4670 <li><a href="h_common_goto">Goto Command</a>
4671 <li><a href="h_common_hdrmode">HdrMode Command</a>
4672 <li><a href="h_mainhelp_pinehelp">Help</a>
4673 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
4674 <li><a href="h_folder_maint">Help for Folder List</a>
4675 <li><a href="h_valid_folder_names">IMAP</a>
4676 <li><a href="h_ge_import">Import File Selection</a>
4677 <li><a href="h_mainhelp_index">Index of Messages</a>
4678 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
4679 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
4680 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
4681 <li><a href="h_info_on_mbox">Information on mbox driver</a>
4682 <li><a href="h_mainhelp_intro">Introduction</a>
4683 <li><a href="h_main_journal">Journal Command</a>
4684 <li><a href="h_common_jump">Jump Command</a>
4685 <li><a href="h_compose_justify">Justify Command</a>
4686 <li><a href="h_main_kblock">Keyboard Lock Command</a>
4687 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
4688 <li><a href="h_mainhelp_ldap">LDAP</a>
4689 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
4690 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
4691 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
4692 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
4693 <li><a href="h_config_ldap_opts_ldaps">LDAP FEATURE: Require-LDAPS-On-Connection</a>
4694 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
4695 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
4696 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
4697 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
4698 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
4699 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
4700 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
4701 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
4702 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
4703 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
4704 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
4705 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
4706 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
4707 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
4708 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
4709 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
4710 <li><a href="h_ldap_view">LDAP Response View Explained</a>
4711 <li><a href="h_maildrop">Mail Drop: What is it?</a>
4712 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
4713 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
4714 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
4715 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
4716 <li><a href="h_common_index">Message Index Command</a>
4717 <li><a href="h_mainhelp_mouse">Mouse</a>
4718 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
4719 <li><a href="new_user_greeting">NEW USER GREETING</a>
4720 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
4721 <li><a href="h_mainhelp_readingnews">News Reading</a>
4722 <li><a href="h_folder_subscribe">Newsgroup Subscribe Screen explained</a>
4723 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
4724 <li><a href="h_common_nextnew">NextNew Command</a>
4725 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
4726 <li><a href="h_mainhelp_readingnews">NNTP</a>
4727 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
4728 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
4729 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
4730 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
4731 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
4732 <li><a href="h_config_color_style">OPTION: Color Style</a>
4733 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
4734 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
4735 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
4736 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
4737 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
4738 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
4739 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
4740 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
4741 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
4742 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
4743 <li><a href="h_config_encryption_range">OPTION: <!--#echo var="VAR_encryption-protocol-range"--></a>
4744 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
4745 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
4746 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
4747 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
4748 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
4749 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
4750 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
4751 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
4752 <li><a href="h_config_file_dir">OPTION: File Directory</a>
4753 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
4754 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
4755 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
4756 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
4757 <li><a href="h_config_font_name">OPTION: Font Name</a>
4758 <li><a href="h_config_font_size">OPTION: Font Size</a>
4759 <li><a href="h_config_font_style">OPTION: Font Style</a>
4760 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
4761 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
4762 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
4763 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
4764 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
4765 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
4766 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
4767 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
4768 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
4769 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
4770 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
4771 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
4772 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
4773 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
4774 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
4775 <li><a href="h_config_index_color">OPTION: Index Colors</a>
4776 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
4777 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
4778 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
4779 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
4780 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
4781 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
4782 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
4783 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
4784 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
4785 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
4786 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
4787 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
4788 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
4789 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
4790 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
4791 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
4792 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
4793 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
4794 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
4795 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
4796 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
4797 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
4798 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
4799 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
4800 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
4801 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
4802 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
4803 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
4804 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
4805 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
4806 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
4807 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
4808 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
4809 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
4810 <li><a href="h_config_pat_old">OPTION: Patterns</a>
4811 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
4812 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
4813 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
4814 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
4815 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
4816 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
4817 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
4818 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
4819 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
4820 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
4821 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
4822 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
4823 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
4824 <li><a href="h_config_printer">OPTION: Printer</a>
4825 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
4826 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
4827 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
4828 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
4829 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
4830 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
4831 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
4832 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
4833 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
4834 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
4835 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
4836 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
4837 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
4838 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
4839 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
4840 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
4841 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
4842 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
4843 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
4844 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
4845 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
4846 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
4847 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
4848 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
4849 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
4850 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
4851 <li><a href="h_config_aspell_dictionary">OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></a>
4852 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
4853 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
4854 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
4855 <li><a href="h_config_status_color">OPTION: Status Color</a>
4856 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
4857 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
4858 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
4859 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
4860 <li><a href="h_config_quit_query_timeo">OPTION: <!--#echo var="VAR_close-connection-timeout"--></a>
4861 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
4862 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
4863 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
4864 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
4865 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
4866 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
4867 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
4868 <li><a href="h_config_title_color">OPTION: Title Color</a>
4869 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
4870 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
4871 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
4872 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
4873 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
4874 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
4875 <li><a href="h_config_history">OPTION: <!--#echo var="VAR_default-directories"--></a>
4876 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
4877 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
4878 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
4879 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
4880 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
4881 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
4882 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
4883 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
4884 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
4885 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
4886 <li><a href="h_config_window_position">OPTION: Window-Position</a>
4887 <li><a href="h_mainhelp_patterns">Patterns</a>
4888 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
4889 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
4890 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
4891 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
4892 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
4893 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
4894 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
4895 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
4896 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
4897 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
4898 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
4899 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
4900 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
4901 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
4902 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
4903 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
4904 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
4905 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
4906 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
4907 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
4908 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
4909 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
4910 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
4911 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
4912 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
4913 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
4914 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
4915 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
4916 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
4917 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
4918 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
4919 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
4920 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
4921 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
4922 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
4923 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
4924 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
4925 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
4926 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
4927 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
4928 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
4929 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
4930 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
4931 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
4932 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
4933 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
4934 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
4935 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
4936 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
4937 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
4938 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
4939 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
4940 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
4941 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
4942 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
4943 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
4944 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
4945 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
4946 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
4947 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
4948 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
4949 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
4950 <li><a href="h_common_pipe">Pipe Command</a>
4951 <li><a href="h_valid_folder_names">POP</a>
4952 <li><a href="h_common_postpone">Postpone Command</a>
4953 <li><a href="h_common_print">Print Command</a>
4954 <li><a href="h_mainhelp_readingnews">Reading News</a>
4955 <li><a href="h_news">RELEASE NOTES for Alpine</a>
4956 <li><a href="h_mainhelp_roles">Roles</a>
4957 <li><a href="h_role_select">ROLES SCREEN</a>
4958 <li><a href="h_compose_readfile">Read File Command</a>
4959 <li><a href="h_mainhelp_reading">Reading Messages</a>
4960 <li><a href="h_main_release_notes">Release Notes Command</a>
4961 <li><a href="h_common_reply">Reply and Forward Commands</a>
4962 <li><a href="h_compose_richhdr">Rich Header Command</a>
4963 <li><a href="h_common_role">Role Command</a>
4964 <li><a href="h_mainhelp_smime">S/MIME</a>
4965 <li><a href="h_index_cmd_select">Searching for Messages</a>
4966 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
4967 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
4968 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
4969 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
4970 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
4971 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
4972 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
4973 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
4974 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
4975 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
4976 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
4977 <li><a href="h_common_save">Save and Export Commands</a>
4978 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
4979 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
4980 <li><a href="h_compose_send">Send Command</a>
4981 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
4982 <li><a href="h_main_setup">Setup Command</a>
4983 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
4984 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
4985 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
4986 <li><a href="h_mainhelp_smime">S/MIME</a>
4987 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
4988 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
4989 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
4990 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
4991 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
4992 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
4993 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
4994 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
4995 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
4996 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
4997 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
4998 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
4999 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
5000 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
5001 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
5002 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
5003 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
5004 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
5005 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
5006 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
5007 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
5008 <li><a href="h_index_cmd_sort">Sort Command</a>
5009 <li><a href="h_compose_spell">Spell Check Command</a>
5010 <li><a href="h_common_suspend">Suspend Command</a>
5011 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
5012 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
5013 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
5014 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
5015 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
5016 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
5017 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
5018 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
5019 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
5020 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
5021 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
5022 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
5023 <li><a href="h_common_take">TakeAddr Command</a>
5024 <li><a href="h_mainhelp_status">Titlebar Line</a>
5025 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
5026 <li><a href="h_config_usenone_color">Use None Color</a>
5027 <li><a href="h_config_usenormal_color">Use Normal Color</a>
5028 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
5029 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
5030 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
5031 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
5032 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
5033 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
5034 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
5035 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
5036 </UL>
5037
5038 <P>
5039 &lt;End of Help Index&gt;
5040 </BODY>
5041 </HTML>
5042
5043
5044 ============== h_config_remote_config =============
5045 <HTML>
5046 <HEAD>
5047 <TITLE>Remote Configuration</TITLE>
5048 </HEAD>
5049 <BODY>
5050 <H1>Remote Configuration</H1>
5051
5052 You may use the command line argument &quot;-p pinerc&quot; to tell
5053 Alpine to use a non-default configuration file.
5054 There are two types of storage for configuration information.
5055 <EM>Local</EM> configuration files are used by default.
5056 These are just regular files on the UNIX system or on the PC.
5057 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
5058 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
5059 <EM>Remote</EM> configuration folders are stored on an IMAP server.
5060 The advantage of using a remote configuration is that the same information
5061 may be accessed from multiple platforms.
5062 For example, if you use one computer at work and another at home, the same
5063 configuration could be used from both places.
5064 A configuration change from one place would be seen in both places.
5065 To use a remote configuration you simply give a
5066 <A HREF="h_valid_folder_names">remote folder name</A>
5067 as the argument to the &quot;-p&quot; command line option.
5068 The command line might look something like:
5069 <P>
5070 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
5071 <P>
5072 If there are special characters in the command shell you use, you may need to
5073 quote the last argument (to protect the curly braces from the shell).
5074 The command might look like:
5075 <P>
5076 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
5077 <P>
5078 You should choose a folder name for a folder that does not yet exist.
5079 It will be created containing an empty configuration.
5080 Do not use a folder that you wish to store regular mail messages in.
5081 <P>
5082 The Setup/RemoteConfigSetup command will help you convert from a local
5083 configuration to a remote configuration.
5084 It will create a remote configuration for you and copy your current local
5085 configuration to it.
5086 It will also help you convert local address books into remote address books
5087 and local signature files into literal signatures contained in the
5088 remote configuration file.
5089 <P>
5090 If the Setup/RemoteConfigSetup command doesn't do what you want, you
5091 may copy a local pinerc file to a remote configuration folder by hand
5092 by using the command line option &quot;-copy_pinerc&quot;.
5093 <P>
5094 Another command line option, which is somewhat related to remote
5095 configuration, is the option &quot;-x exceptions_config&quot;.
5096 The configuration settings in the exceptions configuration override
5097 your default settings.
5098 It may be useful to store the default configuration (the -p argument) remotely
5099 and to have the exceptions configuration stored in a local file.
5100 You might put generic configuration information in the remote configuration
5101 and platform-specific configuration on each platform in the exceptions
5102 configuration.
5103 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
5104 can be either remote folders or local files.
5105 <P>
5106 There is another command line argument that works only with PC-Alpine and
5107 which may prove useful when using a remote configuration.
5108 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
5109 to store your local auxiliary files.
5110 This only has an effect if your configuration file is remote.
5111 Some examples of auxiliary files are debug files, address book files, and
5112 signature files.
5113 <P>
5114 &lt;End of help on this topic&gt;
5115 </BODY>
5116 </HTML>
5117 ============== h_config_exceptions =============
5118 <HTML>
5119 <HEAD>
5120 <TITLE>Generic and Exceptional Configuration</TITLE>
5121 </HEAD>
5122 <BODY>
5123 <H1>Generic and Exceptional Configuration</H1>
5124
5125 If you use Alpine from more than one platform it may be convenient
5126 to split your configuration information into two pieces, a generic piece
5127 and exceptions that apply to a particular platform.
5128 For example, suppose you use Alpine from home and from work.
5129 Most of your configuration settings are probably the
5130 same in both locations, so those settings belong in the generic settings
5131 configuration.
5132 However, you may use a different SMTP server and INBOX
5133 from home than you do from work.
5134 The
5135 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
5136 and
5137 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
5138 options could be
5139 part of your exceptional configuration so that they could be different in the
5140 two places.
5141 <P>
5142 The command line option &quot;-x exceptions_config&quot;
5143 may be used to split your configuration into generic and exceptional pieces.
5144 &quot;Exceptions_config&quot; may be either local or remote.
5145 The regular Alpine configuration file will contain the generic data, and
5146 &quot;exceptions_config&quot; will contain the exceptional data.
5147 <P>
5148 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
5149 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
5150 in the same local directory that the regular config file is located in (usually
5151 the Unix home directory).
5152 If the regular config file is remote (because the command line option
5153 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
5154 directory for &quot;<CODE>.pinercex</CODE>&quot;.
5155 If the file does not already exist then no exceptions will be used.
5156 You can force exceptions to be used by using the &quot;-x&quot; option or
5157 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
5158 <P>
5159 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
5160 PC-Alpine will use the value of the
5161 environment variable <CODE>$PINERCEX</CODE>.
5162 If that is not set, PC-Alpine will look for
5163 the local file &quot;<CODE>PINERCEX</CODE>&quot;
5164 in the same local directory that the regular config file is located in.
5165 If the regular config file is remote (because the command line option
5166 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
5167 local directory specified by the &quot;-aux local_directory&quot; command
5168 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
5169 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
5170 <P>
5171 When you have an exception configuration there is a new command
5172 in the Alpine Setup screen, Setup/eXceptions.
5173 It toggles between exceptions and the regular configuration.
5174 This is the usual way to make changes in your exceptional configuration data.
5175 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
5176 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
5177 for Config or &quot;K&quot; for Kolor.
5178 <P>
5179 For most people, splitting the configuration information into two pieces is
5180 going to be most useful if the generic information is accessed
5181 <A HREF="h_config_remote_config">remotely</A>).
5182 That data will be the same no matter where you access it from and if you
5183 change it that change will show up everywhere.
5184 The exceptional data will most commonly be in a local file, so that the
5185 contents may easily be different on each computing platform used.
5186 <P>
5187 If you already have a local configuration file with settings you like
5188 you may find that the command Setup/RemoteConfigSetup is useful
5189 in helping you convert to a remote configuration.
5190 The command line flag &quot;-copy_pinerc&quot;
5191 may also be useful.
5192 <P>
5193 &lt;End of help on this topic&gt;
5194 </BODY>
5195 </HTML>
5196 ============== h_config_inheritance =============
5197 <HTML>
5198 <HEAD>
5199 <TITLE>Configuration Inheritance</TITLE>
5200 </HEAD>
5201 <BODY>
5202 <H1>Configuration Inheritance</H1>
5203
5204 Configuration inheritance is a power user feature.
5205 It is confusing and not completely supported by the configuration
5206 user interface.
5207 We start with an explanation of how configuration works in hopes of making
5208 it easier to describe how inheritance works.
5209 <P>
5210 Alpine uses a hierarchy of configuration values from different locations.
5211 There are five ways in which each configuration option (configuration
5212 variable) can be set.
5213 In increasing order of precedence they are:
5214 <P>
5215 <OL>
5216 <LI> the system-wide configuration file.
5217
5218 <LI> the personal configuration file
5219
5220 <LI> the personal exceptions file
5221
5222 <LI> a command line argument
5223
5224 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
5225 </OL>
5226 <P>
5227 The fixed configuration file is normally
5228 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
5229 <P>
5230 The system-wide configuration file is normally
5231 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
5232 set for PC-Alpine.
5233 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
5234 is used for the system-wide configuration.
5235 This location can be set or changed on the command line with the -P flag.
5236 The system-wide configuration file can be either a local file or a
5237 remote configuration folder.
5238 <P>
5239 For Unix Alpine, the personal configuration file is normally the file
5240 <CODE>.pinerc</CODE> in the user's home directory.
5241 This can be changed with the -p command line flag.
5242 For PC-Alpine, the personal configuration file is in
5243 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
5244 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
5245 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
5246 This can be changed with the -p command line flag.
5247 If -p is used, the configuration data may be in a local file or a remote config
5248 folder.
5249 <P>
5250 For Unix Alpine, the personal exceptions configuration file is named
5251 <CODE>.pinercex</CODE> and is in the same directory as the personal
5252 configuration file, if that configuration file is not remote, and is in
5253 the home directory if the personal configuration file is remote.
5254 If the file exists, then exceptions are turned on.
5255 If it doesn't, then you are not using exceptions.
5256 Alternatively, you may change the location of the exceptions configuration
5257 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5258 Like the personal configuration data, exceptions_config may be
5259 either local or remote.
5260 <P>
5261 For PC-Alpine, the personal exceptions configuration file is named
5262 <CODE>PINERCEX</CODE> and is in the same directory as the personal
5263 configuration file unless the personal configuration file is remote.
5264 In that case, it is in the local directory specified by the
5265 &quot;-aux local_directory&quot; command line argument.
5266 (In the case that the personal configuration is remote and there is no
5267 &quot;-aux&quot; command line argument, Alpine searches for
5268 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
5269 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
5270 If the file exists, then exceptions are turned on.
5271 If it doesn't, then you are not using exceptions.
5272 You may change the location of the exceptions configuration
5273 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5274 or with the
5275 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
5276 option).
5277 <P>
5278 To reiterate, the value of a configuration option is taken from the
5279 last location in the list above in which it is set.
5280 Or, thinking about it slightly differently, a default value for an option
5281 is established in the system-wide configuration file (or internally by Alpine
5282 if there is no value in the system-wide file).
5283 That default remains in effect until and unless it is overridden by a value in a
5284 location further down the list, in which case a new &quot;default&quot;
5285 value is established.
5286 As we continue down the list of locations we either retain the
5287 value at each step or establish a new value.
5288 The value that is still set after going through the whole list of
5289 configuration locations is the one that is used.
5290 <P>
5291 So, for example, if an option is set in the system-wide configuration
5292 file and in the personal configuration file, but is not set in the
5293 exceptions, on the command line, or in the fixed file; then the value
5294 from the personal configuration file is the one that is used.
5295 Or, if it is set in the system-wide config, in the personal config, not
5296 in the exceptions, but is set on the command line; then the value
5297 on the command line is used.
5298 <P>
5299 Finally we get to inheritance.
5300 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
5301 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
5302 the inheritance mechanism makes it possible to <EM>combine</EM>
5303 the values from different locations instead of <EM>replacing</EM> the value.
5304 This is true of all configuration lists other than the &quot;Feature-List&quot;,
5305 for which you may already set whatever you want at
5306 any configuration location (by using the &quot;no-&quot; prefix if
5307 necessary).
5308 <P>
5309 To use inheritance, set the first item in a configuration list to the
5310 token &quot;INHERIT&quot;, without the quotes.
5311 If the first item is &quot;INHERIT&quot;,
5312 then instead of replacing the default value established so far, the rest of
5313 the list is appended to the default value established so far and that is
5314 the new value.
5315 <P>
5316 Here is an example which may make it clearer. Suppose we have:
5317 <P>
5318 <PRE>
5319  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5320  Personal config    :   smtp-server = INHERIT, mysmtp.home
5321  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
5322  Command line       :   smtp-server = &lt;No Value Set&gt;
5323  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5324 </PRE>
5325 <P>
5326
5327 This would result in an effective smtp-server option of
5328 <P>
5329 <PRE>
5330  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
5331 </PRE>
5332 <P>
5333 The &quot;INHERIT&quot; token can be used in any of the configuration files
5334 and the effect cascades.
5335 For example, if we change the above example to:
5336 <P>
5337 <PRE>
5338  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5339  Personal config    :   smtp-server = INHERIT, mysmtp.home
5340  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5341  Command line       :   smtp-server = &lt;No Value Set&gt;
5342  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5343 </PRE>
5344 <P>
5345
5346 This would result in:
5347 <P>
5348 <PRE>
5349  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
5350 </PRE>
5351 <P>
5352 Unset variables are skipped over (the default value is carried forward) so
5353 that, for example:
5354 <P>
5355 <PRE>
5356  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5357  Personal config    :   smtp-server = &lt;No Value Set&gt;
5358  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5359  Command line       :   smtp-server = &lt;No Value Set&gt;
5360  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5361 </PRE>
5362 <P>
5363
5364 produces:
5365 <P>
5366 <PRE>
5367  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
5368 </PRE>
5369 <P>
5370
5371 If any later configuration location has a value set (for a particular list
5372 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
5373 then that value replaces whatever value has been defined up to that point.
5374 In other words, that cancels out any previous inheritance.
5375 <P>
5376 <PRE>
5377  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5378  Personal config    :   smtp-server = INHERIT, mysmtp.org
5379  Exceptions config  :   smtp-server = yoursmtp.org
5380  Command line       :   smtp-server = &lt;No Value Set&gt;
5381  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5382 </PRE>
5383 <P>
5384
5385 results in:
5386 <P>
5387 <PRE>
5388  smtp-server = yoursmtp.org
5389 </PRE>
5390 <P>
5391
5392 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
5393 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
5394 difficult to insert the value &quot;INHERIT&quot; into the list of values
5395 for the option using the normal Setup tools.
5396 In other words, the color setting screen (for example) does not
5397 provide a way to input the text &quot;INHERIT&quot; as the first
5398 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
5399 The way to do this is to either edit the pinerc file directly and manually
5400 insert it, or turn
5401 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
5402 feature and insert it using the Setup/Config screen.
5403 <P>
5404 &lt;End of help on this topic&gt;
5405 </BODY>
5406 </HTML>
5407 ============== h_special_xon_xoff =============
5408 <HTML>
5409 <HEAD>
5410 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
5411 </HEAD>
5412 <BODY>
5413 <H1>XOFF/XON Handling within Alpine</H1>
5414
5415 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
5416 and XON) as normal characters, even though Alpine does not use them.
5417 However, the printer, modem, or communication software you are using may
5418 be configured for &quot;software flow control,&quot; which means that
5419 XON/XOFF must be treated as special characters by the operating system.
5420 If you see messages such as &quot;^S not defined for this screen&quot;,
5421 then your system is probably using software flow control. In this case
5422 you will need to set the
5423 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
5424 feature.
5425 <P>
5426 If you <EM>do</EM> set this
5427 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
5428 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
5429 and see if that puts things right.  Printing via the
5430 &quot;attached-to-ansi&quot; or
5431 &quot;attached-to-wyse&quot;
5432 option will automatically enable software
5433 flow-control handling for the duration of the printing.
5434 <P>
5435 &lt;End of help on this topic&gt;
5436 </BODY>
5437 </HTML>
5438 ============= h_special_help_nav =============
5439 <HTML>
5440 <HEAD>
5441 <TITLE>Help Text Navigation Explained</TITLE>
5442 </HEAD>
5443 <BODY>
5444 <H1>Help Text Navigation Explained</H1>
5445
5446 Alpine contains extensive context-sensitive help text.   At any point,
5447 pressing the &quot;?&quot; key will bring up a page of help text
5448 explaining the options available to you.  You can leave the help
5449 text screen and return to normal Alpine operation by pressing
5450 the
5451 <!--chtml if pinemode="function_key"-->
5452 F3 function
5453 <!--chtml else-->
5454 &quot;E&quot;
5455 <!--chtml endif-->
5456 key to Exit Help at any time.
5457
5458 <P>
5459 Within the help screen you might find a word or phrase displayed in
5460 inverse text and others displayed in bold typeface.  Such words and
5461 phrases are used to tell you Alpine has more information available on
5462 the topic they describe.
5463 The inverted text is the &quot;selected&quot; topic.
5464 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
5465 displayed in bold type
5466 is &quot;selected&quot;.
5467 Hit the Return key to display the information Alpine has available on that
5468 topic.  While viewing such additional information, the
5469 <!--chtml if pinemode="function_key"-->
5470 F3 function
5471 <!--chtml else-->
5472 &quot;P&quot;
5473 <!--chtml endif-->
5474 key will return you to the previous help screen, and the
5475 <!--chtml if pinemode="function_key"-->
5476 F2 function
5477 <!--chtml else-->
5478 &quot;E&quot;
5479 <!--chtml endif-->
5480 key will Exit the Help system altogether.
5481
5482 <P>
5483 The "N" command will tell you the internal name of the help text you are
5484 reading each time, so that you can send this name in the text of a message
5485 and create a direct link to that internal help using the x-pine-help URL
5486 scheme. For example, the direct link to this item is
5487 x-pine-help:h_special_help_nav. If you add this text to a message, then
5488 a person using Pine to read such message would have a direct link to this
5489 help text.
5490
5491 <P>
5492 When you are finished reading this help text, you can press the
5493 <!--chtml if pinemode="function_key"-->
5494 F3 function
5495 <!--chtml else-->
5496 &quot;P&quot;
5497 <!--chtml endif-->
5498 key to return to the previously displayed help text.
5499
5500 <P>
5501 &lt;End of help on this topic&gt;
5502 </BODY>
5503 </HTML>
5504 ============= h_special_list_commands =============
5505 <HTML>
5506 <HEAD>
5507 <TITLE>Email List Commands Explained</TITLE>
5508 </HEAD>
5509 <BODY>
5510 <H1>Email List Commands Explained</H1>
5511
5512 Electonic mail lists provide a way for like-minded users to join in
5513 discussions on topics of interest.  The email list itself is
5514 represented by a
5515 single address that participants send messages to when they have
5516 something of interest to share with other members of the list.  The
5517 receiving computer then, either automatically or after review by the
5518 list's owner (or moderator), sends a copy of that message to each
5519 member of the list.
5520
5521 <P>
5522 Usually, subscribing and unsubscribing is done by sending requests in
5523 an email message to a special address setup to handle managing list
5524 membership.  Often this is the name of the list followed by
5525 <I>-request</I>.  This address is almost <EM>never</EM> the same as
5526 the address used to send messages to the list.
5527
5528 <P>
5529 Unfortunately, email list participation commands are more a matter
5530 of convention than standard, and thus may vary from list to list.
5531 Increasingly, list management software is adding information to
5532 the copy of the postings as they're copied to the list members that
5533 explains how to do the various list management functions.
5534
5535 <P>
5536 Alpine will recognize this information and offer the management commands
5537 they represent in a simple display. One or more of the following
5538 operations will be made available:
5539
5540 <DL>
5541 <DT>Help</DT>
5542 <DD>
5543 A method to get help on subscribing, unsubscribing,
5544 an explanation of what the list is about, or special instructions
5545 for participation.  This may be in the form of a reply in response
5546 to an email message, or instructions on how to connect to a Web site.
5547 </DD>
5548
5549 <DT>Unsubscribe</DT>
5550 <DD>
5551 A method to get your email addressed removed from the list of
5552 recipients of the email list.
5553 </DD>
5554
5555 <DT>Subscribe</DT>
5556 <DD>
5557 A method to get your email address added to the list of recipients
5558 of the email list.  It may be in the form of a message sent to
5559 a special address or you may be connected to a web site.
5560 <DD>
5561 </DD>
5562
5563 <DT>Post</DT>
5564 <DD>
5565 A method used to post to the email list.  However, it might also
5566 indicate that no posting is allowed directly to the list.
5567 </DD>
5568
5569 <DT>Owner</DT>
5570 <DD>
5571 A method to contact the list owner for special questions you might
5572 have regarding the list.
5573 </DD>
5574
5575 <DT>Archive</DT>
5576 <DD>
5577 A method to view an archive of previous messages posted to the list.
5578 This may be in the form of a mail folder on a remote computer, an
5579 IMAP mailbox or even a Web site.
5580 </DD>
5581 </DL>
5582
5583 <P>
5584 &lt;End of help on this topic&gt;
5585 </BODY>
5586 </HTML>
5587 ============= h_quota_command =============
5588 <HTML>
5589 <HEAD>
5590 <TITLE>Quota Screen Explained</TITLE>
5591 </HEAD>
5592 <BODY>
5593 <H1>Quota Screen Explained</H1>
5594
5595 <P> This screen summarizes the quota report for this mailbox in the
5596 IMAP server. For each resource that you have a quota, this reports summarizes
5597 its use and limit.
5598
5599 <P> Your IMAP server administrator may have set a quota based either on
5600 the total size of your mailbox (STORAGE), or the number of messages in
5601 your mailbox (MESSAGES), or some other criteria. This will be reported
5602 to you indicating the type of quota, its total use and its limit.
5603
5604 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
5605 1024 bytes. Each of the characters that you see in this help text is one
5606 byte, and this help text is about 1 kibibyte in size. Small messages sent
5607 by Alpine are normally less than 4 kibibytes in size (which includes
5608 headers and text). Other email programs may send messages with bigger
5609 sizes when they send messages, since they send plain text and an
5610 alternative part in HTML.
5611
5612 <P> A convenient way to save space for the STORAGE type of quota is by
5613 deleting attachments. This is done on each individual message by pressing
5614 the &quot;V&quot; command while reading the message text, then moving the cursor
5615 to the position of the attachment that is to be deleted, then pressing
5616 &quot;D&quot; to delete such attachment, going back to reading the
5617 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
5618 save the message in the same folder you are reading from. The saved
5619 message will not have the attachment that was marked deleted. Now you
5620 can delete and expunge the message with the unwanted attachment.
5621
5622 <P>
5623 &lt;End of help on this topic&gt;
5624 </BODY>
5625 </HTML>
5626 ============= h_mail_thread_index =============
5627 <HTML>
5628 <HEAD>
5629 <TITLE>THREAD INDEX COMMANDS</TITLE>
5630 </HEAD>
5631 <BODY>
5632 <H1>THREAD INDEX COMMANDS</H1>
5633 <!--chtml if pinemode="function_key"-->
5634 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>
5635 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5636 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>
5637 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>
5638 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>
5639 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>
5640 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>
5641 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>
5642 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>
5643 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>
5644 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>
5645 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>
5646 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>
5647 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>
5648 <BR>
5649 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5650 -----------------------------<BR>
5651 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>
5652 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>
5653 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>
5654 <BR>
5655 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5656 -----------------------------<BR>
5657 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
5658 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
5659 <BR>
5660 <!--chtml else-->
5661 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>
5662 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5663 &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>
5664 &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>
5665 &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>
5666 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>
5667 &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>
5668 &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>
5669 &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>
5670 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>
5671 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
5672 <BR>
5673 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
5674 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
5675 &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>
5676 &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>
5677 &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>
5678 &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>
5679 &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>
5680 &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>
5681 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
5682 <!--chtml endif-->
5683 <P>
5684
5685 NOTE:
5686 <OL>
5687  <LI>For help on a particular command, highlight the bold text associated
5688 with it above and hit Return.
5689  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5690 </OL>
5691
5692 <H2>Description of the THREAD INDEX Screen</H2>
5693
5694 The THREAD INDEX displays summary information from each
5695 thread (conversation) in the current folder.
5696 This is useful if you want to quickly
5697 scan new threads, or find a particular thread without having to go
5698 through the text of each message, or to quickly get rid of junk
5699 threads, etc.
5700 The current thread is always highlighted.
5701 Each line of the THREAD INDEX contains the following columns: <P>
5702 <DL>
5703  <DT>STATUS:</DT>
5704  <DD> The markings on the left side of the thread tell you about its
5705 status.  You may see one or more of the following codes on any given
5706 thread:
5707 <UL>
5708   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
5709   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
5710   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
5711   <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.
5712   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5713         message in the thread was sent to you as a cc:. This symbol will only show up if
5714         the feature
5715         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5716   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
5717         &quot;select&quot; command.  (Some systems may optionally allow selected
5718         messages to be denoted by the index line being displayed in bold
5719         type instead.)
5720   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5721       to mark at least one message in this thread as &quot;important&quot;.
5722 </UL></DD><P>
5723
5724  <DT>THREAD NUMBER:</DT>
5725  <DD>Threads in a folder are numbered, from one through the number
5726 of threads in the folder, to help you know where you are in the folder.
5727 </DD><P>
5728
5729  <DT>DATE STARTED:</DT>
5730  <DD>The date the thread was started. This is actually from the Date header
5731 of the first message in the thread. It doesn't take different time zones
5732 into account.</DD><P>
5733
5734  <DT>WHO STARTED THE THREAD:</DT>
5735  <DD>This is usually the name of the sender of the first message in the thread, taken from
5736 the From header of the message.
5737 If there is no personal name given in that
5738 address, then the email address is used instead.
5739 If the message is from you (or from one of your
5740 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5741 then the recipient's name is shown here instead, with the characters
5742 &quot;To: &quot; inserted before the name.
5743 (The idea of this is that if you started the thread you would rather see who
5744 the mail was sent to instead of that the mail was from you.)
5745 In Newsgroups, if you are
5746 the sender and there are no email recipients, the newsgroup name will be
5747 listed after the &quot;To: &quot;.
5748 </DD><P>
5749
5750  <DT>SIZE:</DT>
5751  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
5752
5753  <DT>SUBJECT:</DT>
5754  <DD>As much of the thread's subject line as will fit on the screen.
5755 This is the subject of the first message in the thread.</DD>
5756 </DL>
5757
5758 <P><UL>
5759 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5760 </UL>
5761 <P>
5762 &lt;End of help on this topic&gt;
5763 </BODY>
5764 </HTML>
5765 ============= h_mail_index =============
5766 <HTML>
5767 <HEAD>
5768 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
5769 </HEAD>
5770 <BODY>
5771 <H1>MESSAGE INDEX COMMANDS</H1>
5772 <!--chtml if pinemode="function_key"-->
5773 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>
5774 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5775 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>
5776 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>
5777 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>
5778 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>
5779 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>
5780 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>
5781 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>
5782 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>
5783 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>
5784 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>
5785 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>
5786 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>
5787 <BR>
5788 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5789 -----------------------------<BR>
5790 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>
5791 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>
5792 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>
5793 <BR>
5794 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5795 -----------------------------<BR>
5796 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
5797 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>
5798 <BR>
5799 <!--chtml else-->
5800 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>
5801 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5802 &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>
5803 &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>
5804 &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>
5805 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>
5806 &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>
5807 &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>
5808 &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>
5809 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>
5810 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
5811 Miscellaneous&nbsp;Operations<BR>
5812 ------------------------<BR>
5813 &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>
5814 &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>
5815 &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>
5816 &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>
5817 &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>
5818 &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>
5819 &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>
5820 &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>
5821 <!--chtml endif-->
5822 <P>
5823
5824 NOTE:
5825 <OL>
5826  <LI>For help on a particular command, highlight the bold text associated
5827 with it above and hit Return.
5828  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5829 </OL>
5830
5831 <H2>Description of the MESSAGE INDEX Screen</H2>
5832
5833 The MESSAGE INDEX displays summary information from each
5834 message in the current folder.
5835 This is useful if you want to quickly
5836 scan new messages, or find a particular message without having to go
5837 through the text of each message, or to quickly get rid of junk
5838 messages, etc.
5839 <P>
5840 The current message is always highlighted
5841 and many commands operate on the current message.
5842 For example, the Delete command will delete the current message.
5843 If the folder is sorted by either Threads or OrderedSubject, then, depending
5844 on some of your configuration settings, a single line in the index may
5845 refer to an entire thread or to a subthread.
5846 If that is the case, then the commands that normally operate on the current
5847 message will operate on the thread or subthread instead.
5848 For example, the Delete command will delete the whole collapsed thread
5849 instead of just a single message.
5850 <P>
5851 Each line of the MESSAGE INDEX contains the following columns (by default --
5852 you can change this with the
5853 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
5854 in the SETUP CONFIGURATION screen): <P>
5855 <DL>
5856  <DT>STATUS:</DT>
5857  <DD> The markings on the left side of the message tell you about its
5858 status.  You may see one or more of the following codes on any given
5859 message:
5860 <UL>
5861   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
5862          yet eXpunged the folder.
5863   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
5864   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
5865          to be answered.
5866   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
5867          forward a message.
5868   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
5869         directly to your account, your copy is not part of a cc: or a
5870         mailing list.
5871   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5872         message was sent to you as a cc:. This symbol will only show up if
5873         the feature
5874         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5875   <LI> &quot;X&quot; for selected.  You have selected the message by using the
5876         &quot;select&quot; command.  (Some systems may optionally allow selected
5877         messages to be denoted by the index line being displayed in bold
5878         type.)
5879   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5880       to mark this message as &quot;important&quot;.
5881 </UL></DD><P>
5882
5883  <DT>MESSAGE NUMBER:</DT>
5884  <DD>Messages in a folder are numbered, from one through the number
5885 of messages in the folder, to help you know where you are in the folder.
5886 These numbers are always in increasing order, even if you sort the folder
5887 in a different way.</DD><P>
5888
5889  <DT>DATE SENT:</DT>
5890  <DD>The date the message was sent.  By default, messages are
5891 ordered by arrival time, not by date sent.  Most of the time, arrival time
5892 and date sent (effectively departure time) are similar.  Sometimes,
5893 however, the index will appear to be out of order because a message took a
5894 long time in delivery or because the sender is in a different time
5895 zone than you are. This date is just the date from the Date header
5896 field in the message.</DD><P>
5897
5898  <DT>WHO SENT THE MESSAGE:</DT>
5899  <DD>This is usually the name of the sender of the message, taken from
5900 the From header of the message.
5901 If there is no personal name given in that
5902 address, then the email address is used instead.
5903 If the message is from you (or from one of your
5904 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5905 then the recipient's name is shown here instead, with the characters
5906 &quot;To: &quot; inserted before the name.
5907 (The idea of this is that if you sent the mail you would rather see who
5908 the mail was sent to instead of that the mail was from you.
5909 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
5910 above.
5911 In particular, use the FROM token or the FROMORTONOTNEWS token
5912 in place of the FROMORTO token.)
5913 In Newsgroups, if you are
5914 the sender and there are no email recipients, the newsgroup name will be
5915 listed after the &quot;To: &quot;. </DD><P>
5916
5917  <DT>SIZE:</DT>
5918  <DD>The number in parentheses is the number of characters in the message.
5919 It may have a suffix of K, M, or G which means the number should be
5920 multiplied by one thousand, one million, or one billion to get the
5921 size of the message.</DD><P>
5922
5923  <DT>SUBJECT:</DT>
5924  <DD>As much of the message's subject line as will fit on the screen.</DD>
5925 </DL>
5926
5927 <P><UL>
5928 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5929 </UL>
5930 <P>
5931 &lt;End of help on this topic&gt;
5932 </BODY>
5933 </HTML>
5934 ============= h_mail_view ========================
5935 <HTML>
5936 <HEAD>
5937 <TITLE>MESSAGE TEXT SCREEN</TITLE>
5938 </HEAD>
5939 <BODY>
5940 <H1>MESSAGE TEXT SCREEN</H1>
5941 <!--chtml if pinemode="function_key"-->
5942 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>
5943 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
5944 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>
5945 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>
5946 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>
5947 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>
5948 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>
5949 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>
5950 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>
5951 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>
5952 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>
5953 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>
5954 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>
5955 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>
5956 <BR>
5957 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5958 ------------------------------<BR>
5959 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
5960 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
5961 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
5962 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
5963 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
5964 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
5965 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
5966 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
5967 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
5968 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
5969 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
5970 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
5971 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5972 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
5973 <!--chtml else-->
5974 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
5975 ---------------------------------<BR>
5976 <BR>
5977 &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>
5978 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>
5979 &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>
5980 &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>
5981 &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>
5982 &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>
5983 &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>
5984 &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>
5985 &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>
5986 <BR>
5987 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
5988 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
5989 &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>
5990 &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>
5991 &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>
5992 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>
5993 <BR>
5994 General&nbsp;Alpine&nbsp;Commands<BR>
5995 ---------------------<BR>
5996 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
5997 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
5998 &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>
5999 &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>
6000 &nbsp;&nbsp;&nbsp;&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>
6001 <!--chtml endif-->
6002 <P>
6003
6004 NOTE:
6005 <OL>
6006  <LI>For help on a particular command, highlight the bold text associated
6007 with it above and hit Return.
6008  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
6009 </OL>
6010
6011 <H2>Description of the MESSAGE TEXT Screen</H2>
6012
6013 The top line of the view message screen displays status
6014 information about the currently open collection and folder and about the
6015 current message.  It shows the name of the collection in angle brackets
6016 and then the name of the folder.  The line also displays the number
6017 of messages in the folder, the number of the current message and the
6018 percentage of the current message that has been displayed on the screen.
6019 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
6020 right corner.
6021 If the message has been answered (but not deleted) &quot;ANS&quot; will show
6022 in the corner.
6023 <P>
6024
6025 NOTE: to rapidly move to the end of a message, hit the
6026 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6027 (or Ctrl-W) key followed
6028 by Ctrl-V.  Similarly,
6029 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6030 followed by Ctrl-Y will take you to the beginning of
6031 a message.
6032
6033 <H2>Explanation of Alternate Character Sets</H2>
6034
6035 Alpine attempts to stay out of the way so that it won't prevent you from
6036 viewing mail in any character set.  It will simply send the message to
6037 your display device.  If the device is capable of displaying the
6038 message as it was written it will do so.  If not, the display may be
6039 partially or totally incorrect.
6040 If the message contains characters that are not representable in your
6041 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
6042 variable in your configuration, then a warning message will be printed
6043 to your screen at the beginning of the message display.
6044 It is probably best to use UNIX Alpine in a terminal emulator
6045 capable of displaying UTF-8 characters.
6046 See <A HREF="h_config_char_set">Display Character Set</A> for a little
6047 more information about character set settings.
6048
6049 <P><UL>
6050 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6051 </UL>
6052 <P>
6053 &lt;End of help on this topic&gt;
6054 </BODY>
6055 </HTML>
6056 ======= h_index_cmd_select =======
6057 <HTML>
6058 <HEAD>
6059 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
6060 </HEAD>
6061 <BODY>
6062 <H1>Selecting: Select and WhereIs/Select</H1>
6063
6064 Aggregate operations give you the ability to process a group of messages
6065 at once.  Acting on multiple messages requires two steps: (1) selecting a
6066 set of messages and then; (2) applying a command to that set. The first
6067 part is handled by the select command.  Select allows you to
6068 select messages based on their status (read, answered, etc.), contents,
6069 date, size, or keywords.
6070 You may also select based on one of your Rules or based on threads,
6071 and there are quick options to select a specific message or range of messages,
6072 to select the current message, or to select all messages.
6073 <P>
6074
6075 We describe the various selection criteria briefly:
6076 <P>
6077
6078 <DL>
6079 <DT>select All</DT>
6080 <DD> Marks all the messages in the folder as selected.
6081 </DD>
6082
6083 <DT>select Cur</DT>
6084 <DD> Selects the currently highlighted message or currently highlighted
6085 set of messages if in a threaded view.
6086 </DD>
6087
6088 <DT>select by Number</DT>
6089 <DD> Select by message number. This may be a comma-separated list instead or
6090 a single entry.
6091 Each element in the list may be either a single message number or a range
6092 of numbers with a dash between the lowest and highest member of the range.
6093 Some examples are 7 to select only message number 7; 2-5 to select messages
6094 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
6095 The word &quot;end&quot; or the character &quot;$&quot; may be used as a
6096 substitute for the highest numbered message in the folder, while the
6097 character &quot;.&quot; represents the message number holding the position
6098 of the cursor in the folder.
6099 If in a separate thread index where the numbers refer to threads instead of
6100 to messages, then you will be selecting all of the messages in the
6101 referenced threads instead of selecting by message number.
6102 </DD>
6103
6104 <DT>select by Date</DT>
6105 <DD> Select by either the date stored in the Date headers of each message,
6106 or by the date when the messages arrived.
6107 This does not adjust for different time zones, but just checks to see what
6108 day the message was sent on.
6109 You may type in a date. If you do, the date should be in the form
6110 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
6111 For example,
6112 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
6113 or
6114 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
6115 If the date you want is close to the current date, it is probably
6116 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
6117 is displayed, instead of typing in the date yourself.
6118 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
6119 the date of the currently highlighted message.
6120 <P>
6121 There are six possible settings that are selected using the
6122 &quot;^W&nbsp;Toggle When&quot; command.
6123 Three of them select messages based on the Date headers.
6124 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
6125 and &quot;SENT ON&quot;.
6126 SINCE is all messages with the selected date or later.
6127 BEFORE is all messages earlier than the selected date (not including the day
6128 itself).
6129 ON is all messages sent on the selected date.
6130 The other three select messages in the same way but they use the arrival
6131 times of the messages instead of the Date headers included in the messages.
6132 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
6133 and &quot;ARRIVED ON&quot;.
6134 When you save a message from one folder to another the arrival time is
6135 preserved.
6136 </DD>
6137
6138 <DT>select by Text</DT>
6139 <DD> Selects messages based on the message contents.
6140 This allows you to select a set of messages based on whether or not the
6141 message headers or message body contain specified text.
6142 You may look for text in the Subject, the From header,
6143 the To header, or the Cc header.
6144 You may also choose Recipient, which searches for the text in
6145 either the To or the Cc header;
6146 or Participant, which means To or Cc or From.
6147 Besides those specific header searches, you may also search the entire
6148 header and text of the message with &quot;All Text&quot;, or just the
6149 body of the message.
6150 <P>
6151 To search for the absence of text, first type the &quot;! Not&quot; command
6152 before typing the specific type of text search.
6153 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6154 search for all messages that do not contain a particular word in their
6155 Subjects.
6156 <P>
6157 If you choose a Subject search, you may use the subject from the current
6158 message by typing the &quot;^X Cur Subject&quot; command.
6159 You may then edit it further if you wish.
6160 For example, you might select the subject of a reply and edit the
6161 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6162 the original message being replied to.
6163 All of the other header searches allow you to use addresses from the
6164 headers of the current message if you want to.
6165 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6166 &quot;^W Cur Cc&quot;.
6167 In each case, if there is more than one address, only the first is offered.
6168 </DD>
6169
6170 <DT>select by Status</DT>
6171 <DD> Selects messages based on their status.
6172 You may select all New, Important, Deleted, Answered, Recent, or Unseen
6173 messages.
6174 Or, if you first type the &quot;! Not&quot; command, you get not New,
6175 or not Important, and so on.
6176 If you select Deleted messages, you will get all messages with their
6177 Deleted flag set.
6178 Likewise for Important messages, all messages that you have flagged as
6179 being Important with the
6180 <A HREF="h_common_flag">Flag</A> command.
6181 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6182 because they try to match what you see on the screen by default.
6183 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6184 and Unanswered.
6185 If you have looked at the message, or deleted it, or answered it; then it
6186 is not considered &quot;New &quot;.
6187 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6188 <P>
6189 &quot;Answered&quot; is another one that is a little different.
6190 It means that the message has been Answered <EM>and</EM> is not deleted.
6191 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6192 the opposite of &quot;Answered&quot;!
6193 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6194 both Unanswered <EM>and</EM> not deleted.
6195 <P>
6196 The other two types were added later because the special nature of the
6197 New flag was not what was wanted by all users.
6198 New does match what you see in the index by default, but if you use
6199 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6200 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6201 be exactly what you want.
6202 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6203 they are deleted or answered, and
6204 &quot;Recent&quot; selects all of the messages that have been added to
6205 the folder since you started this Alpine session.
6206 (That's not technically quite true. If there are multiple mail clients
6207 reading an IMAP mailbox, each message will be marked as Recent in only
6208 one of the client's sessions.)
6209 </DD>
6210
6211 <DT>select by siZe</DT>
6212 <DD> Selects messages based on their size being smaller than or larger
6213 than the size you specify.
6214 The size is the number of bytes.
6215 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
6216 the number.
6217 For example, 7K is the same as 7000.
6218 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
6219 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
6220 Use the &quot;^W&quot; command to toggle back and forth between Smaller
6221 and Larger.
6222 </DD>
6223
6224 <DT>select by Keyword</DT>
6225 <DD> Selects messages that either have or do not have
6226 (using the &quot;!&nbsp;Not&quot; command)
6227 a particular <A HREF="h_config_keywords">Keyword</A> set.
6228 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
6229 command to select one from your list of keywords.
6230 The
6231 <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.
6232 </DD>
6233
6234 <DT>select by Rule</DT>
6235 <DD> Selects messages that either match or don't match
6236 (using the &quot;!&nbsp;Not&quot; command)
6237 one of the Rules you have defined.
6238 The most likely method of filling in the Rule is to use the
6239 &quot;^T&nbsp;To&nbsp;List&quot;
6240 command to select one of your Rules.
6241 All of the Rules you have defined will be in the list, including
6242 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
6243 They may not all make sense for this purpose, but they are all there for
6244 flexibility.
6245 You might find it useful to define some rules solely for the purpose
6246 of being used by the Select command.
6247 There is a special category for such Rules. They are called Search Rules.
6248 <P>
6249 Unfortunately, Alpine does not allow all possible Rules to be defined.
6250 For example, there is no logical OR operation.
6251 OR is accomplished in the Filter Rules or the other types of Rules by
6252 simply defining two rules, one that matches the first part of the OR
6253 and another that matches the second part.
6254 But you can't do that here, since you only have a single Rule to work with.
6255 Likewise, the order of Rules is usually important.
6256 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6257 a message, then that stops the search for a further match.
6258 This means that you may be confused if you try to use Select by Rule to
6259 check your Filter rules because the order is important when filtering but
6260 is not considered here.
6261 </DD>
6262
6263 <DT>select by tHread</DT>
6264 <DD> Selects all of the messages in the current thread.
6265 </DD>
6266 </DL>
6267
6268 After you have an initial selection, the next and subsequent selection
6269 commands modify the selection.
6270 The select command changes. It first gives
6271 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
6272 &quot;unselect Current&quot;,
6273 &quot;Broaden selection&quot; (implements a logical OR), and
6274 &quot;Narrow selection&quot; (implements a logical AND).
6275 After you choose either Broaden or Narrow, you then choose one of the
6276 selection criteria listed above (by Text or Number or ...).
6277 You may use select as many times as you wish to get the selected set right.
6278 <P>
6279
6280 The WhereIs command has a feature (Ctrl-X) to
6281 select all the messages that match the WhereIs search. WhereIs searches
6282 through just the text that appears on the MESSAGE INDEX screen.
6283 This method is often slower than using the select command itself, unless the
6284 line you are looking for is not too far away in the index.
6285 <P>
6286
6287 The availability of the aggregate operations commands is determined by the
6288 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6289 Feature-List option in your Alpine
6290 configuration, which defaults to set.
6291 The features
6292 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
6293 and
6294 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
6295 affect the behavior of the Select command.
6296
6297 <P>
6298 &lt;End of help on this topic&gt;
6299 </BODY>
6300 </HTML>
6301 ======= h_select_rule =======
6302 <HTML>
6303 <HEAD>
6304 <TITLE>Select: Rule</TITLE>
6305 </HEAD>
6306 <BODY>
6307 <H1>Select: Rule</H1>
6308
6309 You are selecting messages that either match or don't match
6310 one of the Rules you have defined.
6311 You may either type the nickname of the Rule at the prompt, or use the
6312 &quot;^T&nbsp;To&nbsp;List&quot;
6313 command to select one of your Rules.
6314 All of the Rules you have defined will be in the list, including
6315 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
6316 They may not all make sense for this purpose, but they are all there for
6317 flexibility.
6318 Rules may be added by using the Setup/Rules screen off of the main Alpine
6319 menu.
6320 <P>
6321 Unfortunately, Alpine does not allow all possible Rules to be defined.
6322 For example, there is no logical OR operation.
6323 OR is accomplished in the Filter Rules or the other types of Rules by
6324 simply defining two rules, one that matches the first part of the OR
6325 and another that matches the second part.
6326 But you can't do that here, since you only have a single Rule to work with.
6327 Likewise, the order of Rules is usually important.
6328 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6329 a message, then that stops the search for a further match.
6330 This means that you may be confused if you try to use Select by Rule to
6331 check your Filter rules because the order is important when filtering but
6332 is not considered here.
6333
6334 <P>
6335 &lt;End of help on this topic&gt;
6336 </BODY>
6337 </HTML>
6338 ======= h_select_text =======
6339 <HTML>
6340 <HEAD>
6341 <TITLE>Select: Text</TITLE>
6342 </HEAD>
6343 <BODY>
6344 <H1>Select: Text</H1>
6345
6346 You are selecting messages based on the contents of the message.
6347 This allows you to select a set of messages based on whether or not the
6348 message headers or message body contain specified text.
6349 You may look for text in the Subject, the From header,
6350 the To header, or the Cc header.
6351 You may also choose Recipient, which searches for the text in
6352 either the To or the Cc header;
6353 or Participant, which means either the To header, or the Cc header,
6354 or the From header.
6355 Besides those specific header searches, you may also search the entire
6356 header and text of the message with &quot;All Text&quot;, or just the
6357 body of the message with &quot;Body&quot;.
6358 <P>
6359 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
6360 before typing the specific type of text search.
6361 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6362 search for all messages that do not contain a particular word in their
6363 Subjects.
6364 <P>
6365 If you choose a Subject search, you may use the subject from the current
6366 message by typing the &quot;^X Cur Subject&quot; command.
6367 You may then edit it further if you wish.
6368 For example, you might select the subject of a reply and edit the
6369 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6370 the original message being replied to.
6371 All of the other header searches allow you to use addresses from the
6372 headers of the current message if you want to.
6373 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6374 &quot;^W Cur Cc&quot;.
6375 In each case, if there is more than one address, only the first is offered.
6376
6377 <P>
6378 &lt;End of help on this topic&gt;
6379 </BODY>
6380 </HTML>
6381 ======= h_select_status =======
6382 <HTML>
6383 <HEAD>
6384 <TITLE>Select: Status</TITLE>
6385 </HEAD>
6386 <BODY>
6387 <H1>Select: Status</H1>
6388
6389 You are selecting messages based on the status of the message.
6390 For example, whether or not the message has been marked Deleted or Important,
6391 or whether or not it has been Answered or is New.
6392 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
6393 opposite: not Deleted, not Important, and so on.
6394 <P>
6395 If you select Deleted messages, you will get all messages with their
6396 Deleted flag set.
6397 Likewise for Important messages, all messages that you have flagged as
6398 being Important with the
6399 <A HREF="h_common_flag">Flag</A> command.
6400 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6401 because they try to match what you see on the screen by default.
6402 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6403 and Unanswered.
6404 If you have looked at the message, or deleted it, or answered it; then it
6405 is not considered &quot;New &quot;.
6406 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6407 <P>
6408 &quot;Answered&quot; is another one that is a little different.
6409 It means that the message has been Answered <EM>and</EM> is not deleted.
6410 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6411 the opposite of &quot;Answered&quot;!
6412 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6413 both Unanswered <EM>and</EM> not deleted.
6414 <P>
6415 (The New and Answered options may seem counter-intuitive.
6416 The reason it is done this way is
6417 because, by default, a Deleted message will show up with the &quot;D&quot;
6418 symbol in the MAIL INDEX screen even if it is New or Answered.
6419 The Delete symbol overrides the New and Answered symbols, because you
6420 usually don't care about the message anymore once you've deleted it.
6421 Similarly, you usually only care about whether a message is Answered or
6422 not if it is not Deleted.
6423 Once it is Deleted you've put it out of your mind.)
6424 <P>
6425 The other two options were added later because the special nature of the
6426 New flag was not what was wanted by all users.
6427 New does match what you see in the index by default, but if you use
6428 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6429 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6430 be exactly what you expect.
6431 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6432 they are deleted or answered, and
6433 &quot;Recent&quot; selects all of the messages that have been added to
6434 the folder since you started this Alpine session.
6435 (That's not technically quite true. If there are multiple mail clients
6436 reading an IMAP mailbox, each message will be marked as Recent in only
6437 one of the client's sessions.
6438 That behavior can be convenienent for some purposes, like filtering, but
6439 it isn't usually what you expect when selecting.)
6440
6441 <P>
6442 &lt;End of help on this topic&gt;
6443 </BODY>
6444 </HTML>
6445 ======= h_index_cmd_apply =======
6446 <HTML>
6447 <HEAD>
6448 <TITLE>Apply Command</TITLE>
6449 </HEAD>
6450 <BODY>
6451 <H1>Apply Command</H1>
6452
6453 Apply
6454 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
6455 is the second step of most aggregate operations.  Apply
6456 becomes active any time there is a defined set of selected messages.  The
6457 following commands can be applied to a selected message set: delete,
6458 undelete, reply, forward,
6459 <!--chtml if pinemode="os_windows"-->
6460 <!--chtml else-->
6461 pipe,
6462 <!--chtml endif-->
6463 print, take address, save, export, bounce, and flag.
6464 <P>
6465
6466 The behavior of some of these commands in an aggregate sense is not easy to
6467 explain.  Try them out to see what they do.
6468 The feature
6469 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
6470 affects the behavior of the Apply command, as does the feature
6471 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
6472
6473 <P>
6474 &lt;End of help on this topic&gt;
6475 </BODY>
6476 </HTML>
6477 ======= h_index_cmd_zoom =======
6478 <HTML>
6479 <HEAD>
6480 <TITLE>ZoomMode Command</TITLE>
6481 </HEAD>
6482 <BODY>
6483 <H1>ZoomMode Command</H1>
6484
6485 Another action you might want to take on a set of selected messages is to
6486 zoom in on them.  Like apply, zoom only becomes active when messages have
6487 been selected.
6488 ZoomMode
6489 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
6490 is a toggle command that allows you to
6491 zoom-in (and only see the selected messages) and zoom-out (to see all
6492 messages in the folder).  Neither apply nor zoom removes the markings that
6493 define the selected set; you need to use a select command in order
6494 to do that.
6495
6496 <P>
6497 &lt;End of help on this topic&gt;
6498 </BODY>
6499 </HTML>
6500 ======= h_index_collapse_expand =======
6501 <HTML>
6502 <HEAD>
6503 <TITLE>Collapse/Expand Command</TITLE>
6504 </HEAD>
6505 <BODY>
6506 <H1>Collapse/Expand Command</H1>
6507
6508 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
6509 the folder is sorted by either Threads or OrderedSubject, and the
6510 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
6511 is set to something other than &quot;none&quot;.
6512 By default, this command collapses or expands the subthread that starts at
6513 the currently highlighted message, if any.
6514 If the subthread is already collapsed, then this command expands it.
6515 If the subthread is expanded, then this command collapses it.
6516 If there are no more messages below the current message in the
6517 thread tree (that is, there are no replies to the current message) then
6518 this command does nothing.
6519
6520 <P>
6521 The behavior of this command is affected by the option
6522 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
6523 Normally, this command Collapses or Expands the subthread that
6524 starts at the currently highlighted message.
6525 If the above option is set, then this command Collapses or Expands the
6526 entire current thread instead of just the subthread.
6527 The current thread is simply the top-level thread that contains the
6528 current message.
6529
6530 <P>
6531 &lt;End of help on this topic&gt;
6532 </BODY>
6533 </HTML>
6534 ======= h_index_cmd_sort =======
6535 <HTML>
6536 <HEAD>
6537 <TITLE>Sort Command</TITLE>
6538 </HEAD>
6539 <BODY>
6540 <H1>Sort Command</H1>
6541
6542 In Alpine's generic configuration, messages are presented in the order in
6543 which they arrive.  This default can be changed in the SETUP CONFIGURATION
6544 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
6545 You can also re-sort the folder on demand with the sort
6546 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
6547 command.
6548 Your sorting options are:
6549 <P>
6550 <UL>
6551  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
6552  <LI> <A HREF="h_index_sort_date">D</A>ate
6553  <LI> <A HREF="h_index_sort_subj">S</A>ubject
6554  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
6555  <LI> t<A HREF="h_index_sort_thread">H</A>read
6556  <LI> <A HREF="h_index_sort_from">F</A>rom
6557  <LI> si<A HREF="h_index_sort_size">Z</A>e
6558  <LI> scor<A HREF="h_index_sort_score">E</A>,
6559  <LI> <A HREF="h_index_sort_to">T</A>o
6560  <LI> <A HREF="h_index_sort_cc">C</A>c
6561 </UL>
6562
6563 <P>
6564 The Reverse option will toggle the order the index is currently
6565 sorted by, but will not change the relative sort order.
6566
6567 <P>
6568 Sorting a folder does not actually rearrange the way the folder is saved,
6569 it just re-arranges how the messages are presented to you.  This means
6570 that Alpine has to do the work of sorting every time you change sort order.
6571 Sometimes, especially with PC-Alpine or with large folders, this could take
6572 a while.
6573
6574 <P>
6575 &lt;End of help on this topic&gt;
6576 </BODY>
6577 </HTML>
6578 ======= h_index_sort_default =======
6579 <HTML>
6580 <HEAD>
6581 <TITLE>SORT OPTION: Default</TITLE>
6582 </HEAD>
6583 <BODY>
6584 <H1>SORT OPTION: Default</H1>
6585
6586 The <EM>Default</EM> sort option just means to use the default sort order
6587 set in the
6588 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
6589 option in Setup/Config.
6590
6591 <P>
6592 &lt;End of help on this topic&gt;
6593 </BODY>
6594 </HTML>
6595 ======= h_index_sort_arrival =======
6596 <HTML>
6597 <HEAD>
6598 <TITLE>SORT OPTION: Arrival</TITLE>
6599 </HEAD>
6600 <BODY>
6601 <H1>SORT OPTION: Arrival</H1>
6602
6603 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6604 in the order that they exist in the folder.  This is usually the same as the
6605 order in which they arrived.  This option is comparable to not sorting
6606 the messages at all.
6607
6608 <P>
6609 &lt;End of help on this topic&gt;
6610 </BODY>
6611 </HTML>
6612 ======= h_index_sort_date =======
6613 <HTML>
6614 <HEAD>
6615 <TITLE>SORT OPTION: Date</TITLE>
6616 </HEAD>
6617 <BODY>
6618 <H1>SORT OPTION: Date</H1>
6619
6620 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6621 according to the date and time they were
6622 sent.
6623
6624 <P>
6625 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
6626 identical to sorting by &quot;Arrival&quot;.
6627
6628 <P>
6629 &lt;End of help on this topic&gt;
6630 </BODY>
6631 </HTML>
6632 ======= h_index_sort_subj =======
6633 <HTML>
6634 <HEAD>
6635 <TITLE>SORT OPTION: Subject</TITLE>
6636 </HEAD>
6637 <BODY>
6638 <H1>SORT OPTION: Subject</H1>
6639
6640 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6641 by subject.
6642
6643 <P>
6644 Messages with the same subject are
6645 first grouped together, and then the groups of like-subject messages
6646 are arranged alphabetically.
6647
6648 <P>
6649 Alpine ignores leading &quot;Re:&quot; and
6650 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
6651 likeness and alphabetical order of subject lines.
6652
6653 <P>
6654 &lt;End of help on this topic&gt;
6655 </BODY>
6656 </HTML>
6657 ======= h_index_sort_ordsubj =======
6658 <HTML>
6659 <HEAD>
6660 <TITLE>SORT OPTION: OrderedSubject</TITLE>
6661 </HEAD>
6662 <BODY>
6663 <H1>SORT OPTION: OrderedSubject</H1>
6664
6665 The <EM>OrderedSubject</EM> sort option arranges messages in the
6666 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
6667 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
6668
6669 <P>
6670 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
6671 messages by the date of the oldest message in the group.
6672
6673 <P>
6674 This sort method provides for pseudo threading of conversations within
6675 a folder.
6676 You may want to try sorting by Thread instead.
6677
6678 <P>
6679 &lt;End of help on this topic&gt;
6680 </BODY>
6681 </HTML>
6682 ======= h_index_sort_thread =======
6683 <HTML>
6684 <HEAD>
6685 <TITLE>SORT OPTION: Thread</TITLE>
6686 </HEAD>
6687 <BODY>
6688 <H1>SORT OPTION: Thread</H1>
6689
6690 The <EM>Thread</EM> sort option arranges messages in the
6691 MESSAGE&nbsp;INDEX by grouping all messages that indicate
6692 they are part of a conversation (discussion thread) taking
6693 place within a mailbox or newsgroup.  This indication is
6694 based on information in the message's header -- specifically
6695 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
6696
6697 <P>
6698 &lt;End of help on this topic&gt;
6699 </BODY>
6700 </HTML>
6701 ======= h_index_sort_from =======
6702 <HTML>
6703 <HEAD>
6704 <TITLE>SORT OPTION: From</TITLE>
6705 </HEAD>
6706 <BODY>
6707 <H1>SORT OPTION: From</H1>
6708
6709 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6710 by the name of the author of the message.
6711
6712 <P>
6713 Messages with the same author are grouped together. Groups of
6714 messages are then put into alphabetical order according to message
6715 author.
6716
6717 <P>
6718 &lt;End of help on this topic&gt;
6719 </BODY>
6720 </HTML>
6721 ======= h_index_sort_size =======
6722 <HTML>
6723 <HEAD>
6724 <TITLE>SORT OPTION: Size</TITLE>
6725 </HEAD>
6726 <BODY>
6727 <H1>SORT OPTION: Size</H1>
6728
6729 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6730 by their relative sizes.
6731
6732 <P>
6733 &lt;End of help on this topic&gt;
6734 </BODY>
6735 </HTML>
6736 ======= h_index_sort_score =======
6737 <HTML>
6738 <HEAD>
6739 <TITLE>SORT OPTION: Score</TITLE>
6740 </HEAD>
6741 <BODY>
6742 <H1>SORT OPTION: Score</H1>
6743
6744 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6745 by their scores.
6746
6747 <P>
6748 Messages with the same score are sorted in arrival order.
6749 Scores are something you create using the
6750 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
6751
6752 <P>
6753 &lt;End of help on this topic&gt;
6754 </BODY>
6755 </HTML>
6756 ======= h_index_sort_to =======
6757 <HTML>
6758 <HEAD>
6759 <TITLE>SORT OPTION: To</TITLE>
6760 </HEAD>
6761 <BODY>
6762 <H1>SORT OPTION: To</H1>
6763
6764 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6765 by the names of the recipients of the message.
6766
6767 <P>
6768 Messages with the same recipients are grouped together. Groups of
6769 messages are then put into alphabetical order according to message
6770 recipients.
6771
6772 <P>
6773 &lt;End of help on this topic&gt;
6774 </BODY>
6775 </HTML>
6776 ======= h_index_sort_cc =======
6777 <HTML>
6778 <HEAD>
6779 <TITLE>SORT OPTION: Cc</TITLE>
6780 </HEAD>
6781 <BODY>
6782 <H1>SORT OPTION: Cc</H1>
6783
6784 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
6785 the names of the carbon copy addresses of the message.
6786
6787 <P>
6788 &lt;End of help on this topic&gt;
6789 </BODY>
6790 </HTML>
6791 ======= h_index_cmd_whereis =======
6792 <HTML>
6793 <HEAD>
6794 <TITLE>WhereIs Command</TITLE>
6795 </HEAD>
6796 <BODY>
6797 <H1>WhereIs Command</H1>
6798
6799 The WhereIs
6800 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6801 command lets you search the MESSAGE INDEX for a word.
6802 It scans through whatever you see, usually the name of the author
6803 and the Subject line.
6804 WhereIs has special subcommands to let you find the beginning of the
6805 index (Ctrl-Y -- first message)
6806 or the end of the index (Ctrl-V -- last message).
6807 <P>
6808 Note that WhereIs only searches through the visible text on the screen.
6809 For example, if only part of the Subject of a message is shown because it
6810 is long, then only the visible portion of the Subject is searched.
6811 Also note that WhereIs does not &quot;see&quot; the
6812 &quot;X&quot; in column one of Index entries for selected messages
6813 so it can't be used to search for
6814 selected messages (use &quot;Zoom&quot; instead).
6815 <P>
6816 If the feature
6817 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6818 is turned on,
6819 WhereIs can also be used as a quick way to select messages that match the
6820 string being searched for.
6821 Instead of typing carriage return to search for the next match, type
6822 Ctrl-X to select all matches.
6823 Once again, this only selects matches that are (or would be if the right
6824 index line was on the screen) visible.
6825 Truncated From lines or Subjects will cause matches to be missed.
6826 Although WhereIs is sometimes convenient for quick matching, the Select
6827 command is usually more powerful and usually faster.
6828
6829 <P>
6830 &lt;End of help on this topic&gt;
6831 </BODY>
6832 </HTML>
6833 ======= h_view_cmd_whereis =======
6834 <HTML>
6835 <HEAD>
6836 <TITLE>WhereIs Command</TITLE>
6837 </HEAD>
6838 <BODY>
6839 <H1>WhereIs Command</H1>
6840
6841 The WhereIs
6842 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6843 command does a &quot;find in current message&quot; operation.  You
6844 type in text and Alpine will try to find it in the message you are
6845 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
6846 or end (Ctrl-V) of the message.
6847 That is, to rapidly move to the end of a message, hit the
6848 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6849 (or Ctrl-W) key followed
6850 by Ctrl-V.  Similarly,
6851 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6852 followed by Ctrl-Y will take you to the beginning of a message.
6853
6854 <P>
6855 &lt;End of help on this topic&gt;
6856 </BODY>
6857 </HTML>
6858 ======= h_view_cmd_hilite =======
6859 <HTML>
6860 <HEAD>
6861 <TITLE>View Hilite and Next item/Previous item</TITLE>
6862 </HEAD>
6863 <BODY>
6864 <H1>View Hilite and Next item/Previous item</H1>
6865
6866 Sometimes messages may be in the form of formatted HTML text
6867 or they may contain URLs or Web server hostnames.
6868 When any of the features
6869 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
6870 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
6871 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
6872 or
6873 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
6874 are enabled, Alpine will represent such selectable items in the text
6875 in bold typeface.  One of the selectable items will be displayed in
6876 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
6877 Press the Return key to view the currently selected item.
6878 <P>
6879
6880 The Up and Down Arrows keys can be used to change the selected item
6881 (also see the feature
6882 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
6883 If there are no selectable items in the direction of the arrow you
6884 pressed, Alpine will scroll the display in that direction until one
6885 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
6886 items in the message text, use the Previous and Next item commands,
6887 <!--chtml if pinemode="function_key"-->F5 and F6
6888 <!--chtml else-->^B and ^F<!--chtml endif-->.
6889
6890 <P>
6891 &lt;End of help on this topic&gt;
6892 </BODY>
6893 </HTML>
6894 ======= h_view_cmd_viewattch =======
6895 <HTML>
6896 <HEAD>
6897 <TITLE>ViewAttch Command</TITLE>
6898 </HEAD>
6899 <BODY>
6900 <H1>ViewAttch Command</H1>
6901
6902
6903 The View/Save Attachment
6904 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
6905 command allows you to handle MIME attachments to a message you have
6906 received.  Alpine shows you a list of the message attachments -- you just
6907 choose the attachment you want.  You may either view or save the
6908 selected attachment.
6909
6910 <P>
6911 Because many attachments require external programs for display, there
6912 is some system configuration that has to happen before you can
6913 actually display attachments.  Hopefully much of that will have been
6914 done already by your system administrator.  MIME configuration is
6915 handled with the &quot;mailcap&quot; configuration file.  (See the section
6916 on configuration in the
6917 <A HREF="h_news">release notes</A> for more information.)
6918
6919 <P>
6920 &lt;End of help on this topic&gt;
6921 </BODY>
6922 </HTML>
6923 ======= h_index_cmd_expunge =======
6924 <HTML>
6925 <HEAD>
6926 <TITLE>Expunge/Exclude Command</TITLE>
6927 </HEAD>
6928 <BODY>
6929 <H1>Expunge/Exclude Command</H1>
6930
6931 Expunge/Exclude
6932 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
6933 is the command Alpine uses to actually remove all messages
6934 marked for deletion.  With regular email files, expunge literally deletes
6935 the text from the current folder.  With newsgroups or shared mailboxes,
6936 you don't have permission to actually remove the message, so it is an
6937 exclude -- Alpine removes the message from your view of the folder even
6938 though it is not technically gone.
6939
6940 <P> A selective expunge command is available in IMAP folders that support
6941 the UID EXPUNGE extension in <A
6942 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
6943 other folders (local folders in all formats, POP3 inbox, and newsgroups)
6944 as a subcommand of the apply command. If some selected messages are marked
6945 deleted, then the apply command will offer the eXpunge command, which when
6946 executed will only expunge those messages that are selected and deleted.
6947
6948 <P>
6949 Observe that the expunge command (when not used from the apply command)
6950 will expunge/exclude all deleted messages from the folder, and so all
6951 messages marked deleted will be expunged, regardless of if they are
6952 selected or not. In other words, there is no protection against
6953 potentially expunging more messages than only those that have been
6954 selected and deleted.
6955 <P>
6956
6957 The configuration features
6958 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
6959 and
6960 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
6961 affect the behavior of the Expunge command.
6962
6963 <P>
6964 &lt;End of help on this topic&gt;
6965 </BODY>
6966 </HTML>
6967 ======= h_common_compose =======
6968 <HTML>
6969 <HEAD>
6970 <TITLE>Compose Command</TITLE>
6971 </HEAD>
6972 <BODY>
6973 <H1>Compose Command</H1>
6974
6975 The Compose command takes you into the Alpine message composer where you
6976 can start a new message for sending.  This is where you type in the
6977 message's text and specify its recipient list (the &quot;To:&quot;
6978 address), where copies should be directed (e.g., &quot;Fcc&quot;,
6979 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
6980 be attached to the message.
6981
6982 <P>
6983 When you type this command, Alpine will also automatically check for any
6984 interrupted (i.e., a message that was being composed when your modem
6985 or network connection was broken) or previously postponed messages and
6986 offer you a chance to continue working on those.
6987
6988 <P>
6989 <UL>
6990 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6991 </UL><P>
6992 &lt;End of help on this topic&gt;
6993 </BODY>
6994 </HTML>
6995 ======= h_common_index =======
6996 <HTML>
6997 <HEAD>
6998 <TITLE>Message Index Command</TITLE>
6999 </HEAD>
7000 <BODY>
7001 <H1>Message Index Command</H1>
7002
7003 The Index command takes you to the MESSAGE INDEX screen that displays a
7004 summary caption for each message in the currently-open folder. One
7005 message will be highlighted; this is the &quot;Current&quot; message.
7006 The message commands available from this screen (e.g. View, Reply,
7007 Forward, Delete, Print, Save, etc) apply to the current message.
7008
7009 <P>
7010 &lt;End of help on this topic&gt;
7011 </BODY>
7012 </HTML>
7013 ======= h_common_folders =======
7014 <HTML>
7015 <HEAD>
7016 <TITLE>Folder List Command</TITLE>
7017 </HEAD>
7018 <BODY>
7019 <H1>Folder List Command</H1>
7020
7021 This Folder List command takes you to the FOLDER LIST screen that displays
7022 the names of all your message folders and allows you to view, rename,
7023 delete, and add folders.  You can open (view) a different folder than the
7024 one currently open by highlighting the desired one (using the arrow keys
7025 or their control-key equivalents) and pressing RETURN.
7026
7027 <P>
7028 If you have multiple folder collections defined (see the Help text for
7029 the FOLDER LIST screen to learn more about Collections), you may need
7030 to press Return to expand the collection and display all of the
7031 folders in it.
7032
7033 <P>
7034 &lt;End of help on this topic&gt;
7035 </BODY>
7036 </HTML>
7037 ======= h_main_addrbook =======
7038 <HTML>
7039 <HEAD>
7040 <TITLE>Address Book Command</TITLE>
7041 </HEAD>
7042 <BODY>
7043 <H1>Address Book Command</H1>
7044
7045 This command, available only from the MAIN MENU, takes you
7046 to the ADDRESS BOOK management screen.  From here, your personal address
7047 book(s) may be updated.
7048
7049 <P>
7050 &lt;End of help on this topic&gt;
7051 </BODY>
7052 </HTML>
7053 ======= h_main_setup =======
7054 <HTML>
7055 <HEAD>
7056 <TITLE>Setup Command</TITLE>
7057 </HEAD>
7058 <BODY>
7059 <H1>Setup Command</H1>
7060
7061 The Setup command, available only from the MAIN MENU, prompts you for
7062 one of several configuration screens, including the SETUP CONFIGURATION
7063 screen, by which you may activate optional Alpine features.
7064
7065 <P>
7066 &lt;End of help on this topic&gt;
7067 </BODY>
7068 </HTML>
7069 ======= h_main_release_notes =======
7070 <HTML>
7071 <HEAD>
7072 <TITLE>Release Notes Command</TITLE>
7073 </HEAD>
7074 <BODY>
7075 <H1>Release Notes Command</H1>
7076
7077 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
7078 as well as pointers to further information such as history and legal notes.
7079
7080 <P>
7081 &lt;End of help on this topic&gt;
7082 </BODY>
7083 </HTML>
7084 ======= h_main_kblock =======
7085 <HTML>
7086 <HEAD>
7087 <TITLE>Keyboard Lock Command</TITLE>
7088 </HEAD>
7089 <BODY>
7090 <H1>Keyboard Lock Command</H1>
7091
7092 This command allows your Alpine session to be protected
7093 during a temporary absence from your terminal.
7094
7095 <P>
7096 &lt;End of help on this topic&gt;
7097 </BODY>
7098 </HTML>
7099 ======= h_main_journal =======
7100 <HTML>
7101 <HEAD>
7102 <TITLE>Journal Command</TITLE>
7103 </HEAD>
7104 <BODY>
7105 <H1>Journal Command</H1>
7106
7107 This command displays a list of all the status messages Alpine has
7108 displayed (on the third line from the bottom of the screen). This may
7109 be useful if a message disappeared before you had a chance to read it.
7110
7111 <P>
7112 &lt;End of help on this topic&gt;
7113 </BODY>
7114 </HTML>
7115 ======= h_common_role =======
7116 <HTML>
7117 <HEAD>
7118 <TITLE>Role Command</TITLE>
7119 </HEAD>
7120 <BODY>
7121 <H1>Role Command</H1>
7122
7123 The Role command is similar to the Compose command except that it starts
7124 off by letting you select a <A HREF="h_rules_roles">role</A>
7125 to be used for the composition.
7126 You may set up alternate roles by using Setup/Rules/Roles.
7127
7128 <P>
7129 &lt;End of help on this topic&gt;
7130 </BODY>
7131 </HTML>
7132 ======= h_common_conditional_cmds =======
7133 <HTML>
7134 <HEAD>
7135 <TITLE>Conditional Commands</TITLE>
7136 </HEAD>
7137 <BODY>
7138 <H1>Conditional Commands</H1>
7139
7140 The presence or absence of certain commands, particularly in the
7141 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
7142 whether or not specific features are set in your Alpine configuration.
7143 (You can access the SETUP CONFIGURATION screen, where they are found, from
7144 Alpine's MAIN MENU.)  To see if a desired command's availability is
7145 conditioned on a feature setting, see the command's help text (highlight
7146 the phrase associated with the command and hit Return).
7147
7148 <P>
7149 Also note that some
7150 commands may be administratively disabled by your system manager;
7151 if they don't work, please check with your local help desk.
7152
7153 <P>
7154 <UL>
7155 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7156 </UL><P>
7157 &lt;End of help on this topic&gt;
7158 </BODY>
7159 </HTML>
7160 ======= h_common_pipe =======
7161 <HTML>
7162 <HEAD>
7163 <TITLE>Pipe Command</TITLE>
7164 </HEAD>
7165 <BODY>
7166 <H1>Pipe Command</H1>
7167
7168 Pipe
7169 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
7170 allows you to send a message to a specified Unix command for external
7171 processing.
7172 This command's availability is controlled by the
7173 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
7174 feature.
7175 By default, the processed text of the message is sent to the command
7176 you specify and the output is captured by Alpine and shown to you.
7177 When you run the pipe command, there are some sub-commands which may be
7178 used to alter this behavior.
7179 These sub-commands are described <A HREF="h_pipe_command">here</A>.
7180
7181 <P>
7182 &lt;End of help on this topic&gt;
7183 </BODY>
7184 </HTML>
7185 ======= h_common_goto =======
7186 <HTML>
7187 <HEAD>
7188 <TITLE>Goto Command</TITLE>
7189 </HEAD>
7190 <BODY>
7191 <H1>Goto Command</H1>
7192
7193 Goto
7194 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
7195 is the command that lets you bypass Alpine's folder selection screens
7196 and jump directly to a new folder.  You can select any folder in the
7197 world: one in your current collection, one in a different collection or
7198 one in a collection you've never even used before.
7199 <P>
7200
7201 Alpine will help you as much as possible to narrow in on the folder you want.
7202 However, if the folder is outside of your defined collections, you are
7203 going to have to enter the exact folder location using the correct
7204 <A HREF="h_valid_folder_names">syntax</A>
7205 for a remote folder and/or fully-qualified path name.
7206
7207 <P>
7208 &lt;End of help on this topic&gt;
7209 </BODY>
7210 </HTML>
7211 ======= h_common_nextnew =======
7212 <HTML>
7213 <HEAD>
7214 <TITLE>NextNew Command</TITLE>
7215 </HEAD>
7216 <BODY>
7217 <H1>NextNew Command</H1>
7218
7219 When you press the TAB key, Alpine advances to the next
7220 &quot;interesting&quot; message.
7221 This will be the next message you have not seen before, or the next message
7222 you have flagged Important, whichever comes first.
7223 Unread messages that have been deleted are not considered interesting.
7224 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
7225 articles after you have read them if you want to remove them from future
7226 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
7227 more information.)
7228
7229 <P>
7230 The NextNew command is affected by the feature
7231 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
7232 which causes Alpine to only consider Unread messages interesting, not messages
7233 flagged Important.
7234
7235 <P>
7236 This command behaves a little differently when it finds there are no more
7237 interesting messages left in the current folder.
7238 If the current folder is one of your Incoming Message Folders
7239 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
7240 or it is a newsgroup, then Alpine will try to find the next folder or
7241 newsgroup that contains <EM>Recent</EM> messages and will ask you
7242 if you want to open that folder.
7243 This behavior may be modified by using the
7244 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
7245 feature that causes Alpine to look for Unseen messages instead of Recent
7246 messages.
7247 The NextNew command's behavior is also affected by the configuration features
7248 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
7249 and
7250 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
7251
7252 <P>
7253 &lt;End of help on this topic&gt;
7254 </BODY>
7255 </HTML>
7256 ======= h_common_jump =======
7257 <HTML>
7258 <HEAD>
7259 <TITLE>Jump Command</TITLE>
7260 </HEAD>
7261 <BODY>
7262 <H1>Jump Command</H1>
7263
7264 This is Alpine's way of allowing you to go straight to a specific message.
7265 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
7266 configured such that typing in any number automatically jumps you to that
7267 message
7268 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
7269 in the SETUP CONFIGURATION).
7270
7271 <P>
7272 &lt;End of help on this topic&gt;
7273 </BODY>
7274 </HTML>
7275 ======= h_common_flag =======
7276 <HTML>
7277 <HEAD>
7278 <TITLE>Flag Command</TITLE>
7279 </HEAD>
7280 <BODY>
7281 <H1>Flag Command</H1>
7282
7283 Flag
7284 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7285 is the command that allows users to manipulate the status flags that
7286 appear on the left side of the MESSAGE INDEX screen.  The most common
7287 use of this is to mark a message as important. This is something of a
7288 note to yourself to get back to that message.  You may also use the
7289 flag command to set (or unset) the flags that indicate that a message
7290 is new, answered, deleted, or forwarded.<P>
7291
7292 Provided the mail server supports it,
7293 you may also manipulate user-defined keywords
7294 for a message using the flag command.
7295 These keywords will be available if you use the Flag Details screen that you
7296 can get to after typing the
7297 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7298 command.
7299 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
7300 which are always present.
7301 You may add new keywords by using the Add KW command from the Flag Details screen
7302 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
7303
7304 The availability of the flag command is determined by the
7305 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
7306 feature in your Alpine configuration. Also, it is possible that Flag could be
7307 administratively disabled by your system manager; if it doesn't work,
7308 please check with your local help desk before reporting a bug.
7309 The behavior of the flag command may be modified by the
7310 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
7311 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
7312
7313 <P>
7314 &lt;End of help on this topic&gt;
7315 </BODY>
7316 </HTML>
7317 ======= h_common_hdrmode =======
7318 <HTML>
7319 <HEAD>
7320 <TITLE>HdrMode Command</TITLE>
7321 </HEAD>
7322 <BODY>
7323 <H1>HdrMode Command</H1>
7324
7325 Every email message comes with some header lines that you normally
7326 don't see (and don't want to see).
7327 These include anywhere from 3-20 lines (or more) added by the
7328 Internet mail transport system to record the route your message took,
7329 for diagnostic purposes.
7330 These are normally of no import and simply
7331 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
7332 This also includes other non-standard headers the message may contain.
7333 If you want to see these headers, there is a way to reveal them.
7334 <P>
7335
7336 The Header Mode
7337 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7338 command is a toggle that controls Alpine's handling of these header
7339 lines.  Normally, full headers is &quot;off&quot; and you only see a
7340 few lines about who a message is to and who it is from.  When you
7341 press
7342 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7343 to turn full headers on, Alpine will show you
7344 the normal header lines as well as delivery headers, comment headers,
7345 MIME headers, and any other headers present.
7346 <P>
7347
7348 Several different Alpine commands honor the header mode -- it affects how
7349 messages are displayed, how they appear in forward and reply email, how
7350 they are printed, how they are saved, and how they are exported.
7351 <!--chtml if pinemode="os_windows"-->
7352 <!--chtml else-->
7353 The pipe command is also affected.
7354 <!--chtml endif-->
7355 <P>
7356
7357 The presence or absence of the Header Mode command is determined by the
7358 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7359 Feature-List option in your Alpine configuration.
7360
7361 <P>
7362 If you have also turned on the
7363 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
7364 option then the HdrMode command actually rotates through three states
7365 instead of just two.
7366 The first is the normal view with long quotes suppressed.
7367 The second is the normal view but with the long quotes included.
7368 The last enables the display of all headers in the message.
7369 When using Export, Pipe, Print, Forward, or Reply the quotes are
7370 never suppressed, so the first two states are identical.
7371
7372 <P>
7373 The behavior of the Header Mode command may be altered slightly by
7374 turning on the
7375 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
7376 Feature-List option in your Alpine configuration.
7377 In particular, it will cause the Header Mode to be persistent when moving
7378 from message to message instead of resetting to the default for each message.
7379
7380 <P>
7381 <UL>
7382 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7383 </UL><P>
7384 &lt;End of help on this topic&gt;
7385 </BODY>
7386 </HTML>
7387 ======= h_common_print =======
7388 <HTML>
7389 <HEAD>
7390 <TITLE>Print Command</TITLE>
7391 </HEAD>
7392 <BODY>
7393 <H1>Print Command</H1>
7394
7395 The Print
7396 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
7397 command allows you to print a copy of a message.
7398 There are many SETUP CONFIGURATION features that affect the
7399 Print command, including
7400 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
7401 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
7402 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
7403 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
7404 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
7405 You set up for printing by using the Printer option of the Setup command
7406 on the MAIN MENU.
7407 <P>
7408
7409 <P>
7410 &lt;End of help on this topic&gt;
7411 </BODY>
7412 </HTML>
7413 ======= h_common_take =======
7414 <HTML>
7415 <HEAD>
7416 <TITLE>TakeAddr Command</TITLE>
7417 </HEAD>
7418 <BODY>
7419 <H1>TakeAddr Command</H1>
7420
7421
7422 With the Take Address
7423 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
7424 command, you can extract email addresses from an
7425 incoming message and save them in an address book.  This is an easy way
7426 to add to your address book and avoid having to remember the email
7427 addresses of the people who write to you.
7428 <P>
7429
7430 If the message is just to you individually, then you will only need to
7431 provide a nickname.  If the message contains more than one email address,
7432 then you will see an address
7433 selection screen that lets you choose the address you want to save into
7434 your address book, or lets you choose several of them add to a
7435 personal distribution list.
7436 <P>
7437
7438 Once you've added an entry to your address book, you can use it from the
7439 message composer by typing the nickname of the entry into one of the
7440 header fields (for example, into the To: field), or you can use ^T from
7441 the header field to select the entry from your address book.
7442 <P>
7443
7444 If the configuration feature
7445 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
7446 is set, the behavior of the Take command is altered slightly.
7447
7448 <P>
7449 &lt;End of help on this topic&gt;
7450 </BODY>
7451 </HTML>
7452 ======= h_ge_import =======
7453 <HTML>
7454 <HEAD>
7455 <TITLE>Import File Selection</TITLE>
7456 </HEAD>
7457 <BODY>
7458 <H1>Import File Selection</H1>
7459
7460 You are importing a file that you previously
7461 exported from Alpine.
7462 You are now being asked for the name of that file.
7463 The easiest way to select a file is probably with the &quot;^T&quot;
7464 &quot;To Files&quot; command.
7465 Alternatively, you may type in a file name.
7466 It may be an absolute pathname.
7467 Otherwise, it is a file located in your home directory
7468 or current working directory
7469 <!--chtml if pinemode="running"-->
7470 (which, at least for your current Alpine &quot;session,&quot;
7471 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7472 <!--chtml endif-->, depending on the
7473 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7474 In any case, you finish by typing a carriage return to accept the
7475 file name that is displayed.
7476 When the feature
7477 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7478 is turned on you may use TAB to complete partially typed in names.
7479 <P>
7480 You may cancel the import operation by typing &quot;^C&quot; after exiting
7481 this help.
7482 <P>
7483 &lt;End of help on this topic&gt;
7484 </BODY>
7485 </HTML>
7486 ======= h_ge_allparts =======
7487 <HTML>
7488 <HEAD>
7489 <TITLE>Export Message File Selection</TITLE>
7490 </HEAD>
7491 <BODY>
7492 <H1>Export Message File Selection</H1>
7493
7494 You are Exporting a message from an Alpine mail folder
7495 to a plain text file.
7496 You also have the option of exporting all of the attachments associated
7497 with the message.
7498 You are now being asked for the name of the file to export <EM>to</EM>.
7499 The easiest way to select a file is probably with the &quot;^T&quot;
7500 &quot;To Files&quot; subcommand.
7501 After returning from that subcommand you will still be allowed to
7502 edit the name you have selected.
7503 Alternatively, you may type in a file name.
7504 It may be an absolute pathname.
7505 Otherwise, it is a file located in your home directory
7506 or current working directory
7507 <!--chtml if pinemode="running"-->
7508 (which, at least for your current Alpine &quot;session,&quot;
7509 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7510 <!--chtml endif-->, depending on the
7511 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7512 In any case, you finish by typing a carriage return to accept the
7513 file name that is displayed.
7514 When the feature
7515 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7516 is turned on you may use TAB to complete partially typed in names.
7517 <P>
7518 The message you are exporting appears to have some attachments.
7519 If you wish to save <EM>all</EM> of the attachments at once,
7520 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
7521 saving of the attachments.
7522 You may turn it back off by typing &quot;^P&quot; again, which will now
7523 be labeled &quot;NoAllParts&quot; instead.
7524 If you want to save the parts the command displayed should be
7525 &quot;NoAllParts&quot;!
7526 When you choose to save attachments like this, the attachments will be saved
7527 in a newly created directory.
7528 That directory will have the same name as the file name you choose here,
7529 with the letters &quot;.d&quot; appended.
7530 If that directory already exists, then the letters &quot;.d_1&quot; will
7531 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
7532 is found.
7533 For example, if you select the file name
7534 <P>
7535 <CENTER><SAMP>filename</SAMP></CENTER>
7536 <P>
7537 to export the message to, then the directory used for the attachments will be
7538 <P>
7539 <CENTER><SAMP>filename.d</SAMP></CENTER>
7540 <P>
7541 or perhaps
7542 <P>
7543 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
7544 <P>
7545 The attachments will then be put into files inside that directory.
7546 The names for the attachment files will be derived from the attachments
7547 if possible.
7548 This is done in the same way as the default values are derived if you
7549 save them one at a time.
7550 (The &quot;filename&quot; parameter from the Content-Disposition header
7551 is the first choice. If that doesn't exist, the &quot;name&quot;
7552 parameter from the Content-Type header is used.)
7553 If a name for a particular attachment is not available, then the
7554 part number of the attachment is used, with the characters &quot;part_&quot;
7555 prepended.
7556 An example of that would be
7557 <P>
7558 <CENTER><SAMP>part_2.1</SAMP></CENTER>
7559 <P>
7560 If you want to save only some of the attachments or if you want more control
7561 over the directory and filename where an attachment is saved you may
7562 cancel out of this command and View the attachment list.
7563 From there you can save each attachment individually.
7564 <P>
7565 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7566 this help.
7567 <P>
7568 &lt;End of help on this topic&gt;
7569 </BODY>
7570 </HTML>
7571 ======= h_ge_export =======
7572 <HTML>
7573 <HEAD>
7574 <TITLE>Export File Selection</TITLE>
7575 </HEAD>
7576 <BODY>
7577 <H1>Export File Selection</H1>
7578
7579 You are Exporting or Saving something from within the Alpine world
7580 (a message, an attachment, etc.)
7581 to a plain text file.
7582 You are now being asked for the name of the file to export <EM>to</EM>.
7583 The easiest way to select a file is probably with the &quot;^T&quot;
7584 &quot;To Files&quot; subcommand.
7585 After returning from that subcommand you will still be allowed to
7586 edit the name you have selected.
7587 Alternatively, you may type in a file name.
7588 It may be an absolute pathname.
7589 Otherwise, it is a file located in your home directory
7590 or current working directory
7591 <!--chtml if pinemode="running"-->
7592 (which, at least for your current Alpine &quot;session,&quot;
7593 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7594 <!--chtml endif-->, depending on the
7595 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7596 In any case, you finish by typing a carriage return to accept the
7597 file name that is displayed.
7598 When the feature
7599 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7600 is turned on you may use TAB to complete partially typed in names.
7601 <P>
7602 If the object you are exporting is a message with some attachments,
7603 you may wish to save all of the attachments by typing the &quot;^P&quot;
7604 &quot;AllParts&quot; command to turn on saving of the attachments.
7605 This subcommand will only be visible if the message actually has attachments.
7606 You may also View the attachment list and save individual attachments from
7607 there.
7608 <P>
7609 If you are SAVING a text part (text/plain, text/html, etc.) you can use
7610 the Control-R subcommand to toggle if saving will be done in binary mode,
7611 meaning that the attachment will be decoded, but will not be transformed
7612 to UTF-8 for further processing (either in internal filters, or user
7613 supplied filters.) This is useful in case you either want to preserve
7614 the text as it was encoded originally to you, or the attachment was
7615 incorrectly attached (the attachment is not of text type) and you need
7616 the original text to process the attachment.
7617 <P>
7618 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7619 this help.
7620 <P>
7621 &lt;End of help on this topic&gt;
7622 </BODY>
7623 </HTML>
7624 ======= h_common_save =======
7625 <HTML>
7626 <HEAD>
7627 <TITLE>Save and Export Commands</TITLE>
7628 </HEAD>
7629 <BODY>
7630 <H1>Save and Export Commands</H1>
7631
7632 Save
7633 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
7634 and Export
7635 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
7636 are the two alternatives Alpine gives you to keep a copy of the message
7637 you are reading. If you want to keep the message within Alpine's email
7638 world, use &quot;Save&quot;; if you want to use the message in another
7639 program, use &quot;Export&quot;.
7640 <P>
7641
7642 When you Save a message, it is put into an existing folder or into a new
7643 folder in one of your existing folder collections.  The message stays in
7644 email format and can be read by Alpine again.  Alpine may use a special format
7645 for its mail folders -- never edit an Alpine folder by hand or with any
7646 program other than Alpine.  The exact behavior of the Save command can be
7647 configured with the
7648 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
7649 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
7650 and
7651 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
7652 feature list settings.
7653 The name of the folder offered as a default is controlled by the option
7654 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
7655 <P>
7656
7657 When you use Export, the message is placed in a plain text file in your
7658 home directory
7659 <!--chtml if pinemode="running"-->
7660 (which, in the present configuration of your system, is
7661  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7662 <!--chtml endif-->
7663 or current working directory
7664 <!--chtml if pinemode="running"-->
7665 (which, at least for your current Alpine &quot;session,&quot;
7666 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7667 <!--chtml endif-->, depending on the
7668 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7669 configuration setting.  In the normal case, only minimal
7670 headers are exported with the message; however, if the full header mode
7671 (whose availability may be disabled  by setting the feature
7672 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7673 in SETUP CONFIGURATION) is
7674 toggled on, then complete headers are exported along with the message
7675 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
7676 defined, they may affect the contents of the exported file.)
7677
7678 <P>
7679 &lt;End of help on this topic&gt;
7680 </BODY>
7681 </HTML>
7682 ======= h_common_bounce =======
7683 <HTML>
7684 <HEAD>
7685 <TITLE>Bounce Command</TITLE>
7686 </HEAD>
7687 <BODY>
7688 <H1>Bounce Command</H1>
7689
7690 The Bounce
7691 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
7692 command allows you to re-send, or &quot;remail&quot;, a
7693 message, as if you were never in the loop.  It is analogous to crossing
7694 out your address on a postal letter, writing a different address on the
7695 envelope, and putting it into the mailbox. Bounce is used primarily to
7696 redirect email that was sent to you in error.
7697 Also, some owners of email
7698 lists need the bounce command to handle list traffic.
7699 Bounce is not anonymous.
7700 A ReSent-From header is added to the message so that the recipient may
7701 tell that you Bounced it to them.
7702 <P>
7703
7704 The presence or absence of the Bounce command is determined by the
7705 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
7706 feature in your Alpine configuration.
7707 The feature
7708 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
7709 affects the behavior of the Bounce command.
7710 Also, it is possible that Bounce could be
7711 administratively disabled by your system manager; if it doesn't work,
7712 please check with your local help desk before reporting a bug.
7713
7714 <P>
7715 &lt;End of help on this topic&gt;
7716 </BODY>
7717 </HTML>
7718 ======= h_common_reply =======
7719 <HTML>
7720 <HEAD>
7721 <TITLE>Reply and Forward Commands</TITLE>
7722 </HEAD>
7723 <BODY>
7724
7725 <H1>Reply and Forward Commands</H1>
7726
7727 Replying
7728 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
7729 and Forwarding
7730 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
7731 are your two alternatives for following up on the
7732 message you are reading.  You would use reply if you want to get email
7733 back to the author of the message and/or the other people who have
7734 already seen it.  You use forward if you want somebody new to see the
7735 message.
7736 <P>
7737
7738 In the normal case, the only thing that you must supply when forwarding a
7739 message is the name/email address of the new recipient.
7740 Alpine will include the text of the forwarded message.
7741 Alpine will also include any attachments to the message.
7742 There is space above the forwarded text for you to include additional comments.
7743 <P>
7744
7745 When replying, you usually have to answer some questions.
7746 If the message is to multiple people and/or specified with a Reply-To: header,
7747 then you will have to decide who should get the reply.
7748 You also need to decide whether or not to include the previous
7749 message in your reply.
7750 Some of this is configurable.
7751 Specifically, see the
7752 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
7753 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
7754 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
7755 and
7756 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
7757 configuration features.
7758 <P>
7759
7760 Both the Reply and Forward commands react to the full header mode toggle.
7761 If the full header mode is on, then all the header and delivery lines are
7762 included with the text of the message in your reply/forward.
7763 <P>
7764
7765 Other configuration features that affect the Reply command are
7766 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
7767 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
7768 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
7769
7770 <P>
7771 &lt;End of help on this topic&gt;
7772 </BODY>
7773 </HTML>
7774 ======= h_common_delete =======
7775 <HTML>
7776 <HEAD>
7777 <TITLE>Delete and Undelete Commands</TITLE>
7778 </HEAD>
7779 <BODY>
7780 <H1>Delete and Undelete Commands</H1>
7781
7782 Delete
7783 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
7784 and Undelete
7785 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
7786 allow you to change the Deleted flag for the current message.
7787 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
7788 removes the mark.
7789 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
7790 at the left hand edge of the index line.
7791 When viewing a deleted message, the letters &quot;DEL&quot; will be present
7792 in the upper right hand corner of the screen.
7793 Delete simply <EM>marks</EM> a message Deleted, it does not actually
7794 get rid of the message.
7795 The eXpunge command (available from the MESSAGE INDEX screen) actually
7796 removes all of the deleted messages in a folder.
7797 Once a message is eXpunged, it can't be retrieved.
7798 <P>
7799
7800 The Delete command is affected by the setting of the configuration feature
7801 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
7802
7803 <P>
7804 &lt;End of help on this topic&gt;
7805 </BODY>
7806 </HTML>
7807 ======= h_common_postpone =======
7808 <HTML>
7809 <HEAD>
7810 <TITLE>Postpone Command</TITLE>
7811 </HEAD>
7812 <BODY>
7813 <H1>Postpone Command</H1>
7814
7815 The postpone
7816 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
7817 command allows you to temporarily stop working on the current
7818 message so you may read
7819 other messages or compose another message.  When you want to resume a
7820 message later, start to compose and answer &quot;yes&quot; to the
7821 &quot;Continue postponed composition?&quot; question.  You may
7822 postpone as many messages as you like.
7823
7824 <P>
7825 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
7826 in the Setup/Config screen, then the Postpone command will prompt you for
7827 the folder in which to store your outgoing message.
7828
7829 <P>
7830 &lt;End of help on this topic&gt;
7831 </BODY>
7832 </HTML>
7833 ======= h_compose_cancel =======
7834 <HTML>
7835 <HEAD>
7836 <TITLE>Cancel Command</TITLE>
7837 </HEAD>
7838 <BODY>
7839 <H1>Cancel Command</H1>
7840
7841 Cancel
7842 <!--chtml if pinemode="function_key"-->
7843 (F2)
7844 <!--chtml else-->
7845 (^C)
7846 <!--chtml endif-->
7847
7848 The Cancel command returns you to Alpine's normal mail processing and
7849 causes the message currently under composition to be thrown out.
7850 The message text <EM>will be lost</EM>.
7851
7852 <P>
7853 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
7854 will be preserved in the file named
7855 <!--chtml if pinemode="os_windows"-->
7856 &quot;DEADLETR&quot;.
7857 <!--chtml else-->
7858 &quot;dead.letter&quot; in your home directory.
7859 <!--chtml endif-->
7860 If you unintentionally cancel a message, look there for its text.
7861
7862 <P>
7863 &lt;End of help on this topic&gt;
7864 </BODY>
7865 </HTML>
7866 ======= h_compose_addrcomplete =======
7867 <HTML>
7868 <HEAD>
7869 <TITLE>Address Completion</TITLE>
7870 </HEAD>
7871 <BODY>
7872 <H1>Address Completion</H1>
7873
7874 When entering addresses in the address fields of the composer (To, Cc, etc.)
7875 the TAB key may be used to help complete the address.
7876 Type a partial nickname and tap the TAB key to complete the typing.
7877 The unambiguous part of the name will be filled in automatically.
7878 Typing TAB twice in succession will bring up a selection list of possibilities,
7879 making it easy to find and choose the correct address.
7880
7881 <P>
7882 The matching algorithm is rather ad hoc.
7883 The search starts with a search of your address book.
7884 It counts as a match if the nickname, address, or fullname field of an
7885 entry begins with the text typed in so far. It is also a match if
7886 a later word in the fullname (for example, the middle name or last name)
7887 begins with the entered text.
7888 <P>
7889 Next comes an LDAP search.
7890 The search will happen for any servers that have the
7891 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
7892 feature set. You can set or unset the feature for each server independently
7893 in the Setup/Directory screen.
7894 <P>
7895 Finally, if you are replying to or forwarding a message, that message is
7896 searched for likely candidate addresses that match the typed-in text.
7897
7898 <P>
7899 &lt;End of help on this topic&gt;
7900 </BODY>
7901 </HTML>
7902 ======= h_compose_richhdr =======
7903 <HTML>
7904 <HEAD>
7905 <TITLE>Rich Header Command</TITLE>
7906 </HEAD>
7907 <BODY>
7908 <H1>Rich Header Command</H1>
7909
7910 The Rich Header command allows you to toggle between the list of
7911 all message headers available for editing and those that are most
7912 common.
7913
7914 <P>
7915 Use this toggle to expose headers that are not normally visible by
7916 default.
7917 This set usually includes the
7918 &quot;Bcc:&quot;,
7919 &quot;Fcc:&quot;,
7920 &quot;Lcc:&quot;,
7921 and &quot;Newsgroups&quot;
7922 headers.
7923 If you are posting to a newsgroup the set of defaults is a little different.
7924 Obviously, in that case, the Newsgroups header is of interest so is not
7925 hidden.
7926 For news posting the hidden set includes the
7927 &quot;To:&quot;,
7928 &quot;Cc:&quot;,
7929 &quot;Bcc:&quot;,
7930 &quot;Fcc:&quot;,
7931 and &quot;Lcc:&quot;
7932 headers.
7933 You won't normally want to edit these, which is why they are hidden,
7934 but it is sometimes useful to be able to set them manually.
7935
7936 <P>
7937 The default sets of headers listed above can be altered.
7938 Any header that you have added to the
7939 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
7940 option, but not to the
7941 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
7942 option will appear when you use the Rich Headers command to
7943 make the Rich Headers visible.
7944 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
7945 even without toggling the Rich Headers command.)
7946
7947 <P>
7948 &lt;End of help on this topic&gt;
7949 </BODY>
7950 </HTML>
7951 ======= h_compose_send =======
7952 <HTML>
7953 <HEAD>
7954 <TITLE>Send Command</TITLE>
7955 </HEAD>
7956 <BODY>
7957 <H1>Send Command</H1>
7958
7959 The Send command
7960 <!--chtml if pinemode="function_key"-->
7961 (F3)
7962 <!--chtml else-->
7963 (^X)
7964 <!--chtml endif-->
7965 tells Alpine you are finished composing.
7966 Before actually sending it, though, Alpine will ask you to confirm
7967 your intention, and, at the same time, redisplayed the message text
7968 with the recipients at the top of the screen to give you the opportunity
7969 to review and verify that the message is addressed to the people
7970 you intended.
7971 <P>
7972 If the feature
7973 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
7974 then this confirmation prompt and any options it allows are skipped.
7975
7976 <P>
7977 This confirmation prompt may also offer, depending
7978 on your particular Setup/Config, options allowing you to set
7979 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
7980 include attachments in the &quot;Fcc&quot; (if you had previously
7981 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
7982 observe details of the
7983 <A HREF="h_config_verbose_post">message submission process</A>,
7984 choose the filter through which the
7985 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
7986 or turn of flowed text generation.
7987
7988 <P>
7989 &lt;End of help on this topic&gt;
7990 </BODY>
7991 </HTML>
7992 ======= h_compose_markcutpaste =======
7993 <HTML>
7994 <HEAD>
7995 <TITLE>Mark, Cut and Paste Commands</TITLE>
7996 </HEAD>
7997 <BODY>
7998 <H1>Mark, Cut and Paste Commands</H1>
7999
8000 You can define a &quot;block&quot; of text, which can subsequently
8001  be deleted or
8002 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
8003 then moving the cursor to the end of the desired text block.  You can then
8004 &quot;cut&quot; the block out
8005 <!--chtml if pinemode="function_key"-->
8006 &quot;F9&quot;,
8007 <!--chtml else-->
8008 &quot;Ctrl-K&quot;,
8009 <!--chtml endif-->
8010 move the cursor, and &quot;paste&quot; it
8011 <!--chtml if pinemode="function_key"-->
8012 &quot;F10&quot;,
8013 <!--chtml else-->
8014 &quot;Ctrl-U&quot;,
8015 <!--chtml endif-->
8016 in the new location.  Also, you can paste more than once, allowing you
8017 to use this feature to copy a block of text.<P>
8018
8019 If you press
8020 <!--chtml if pinemode="function_key"-->
8021 &quot;F9&quot;
8022 <!--chtml else-->
8023 &quot;^K&quot;
8024 <!--chtml endif-->
8025 without having marked anything, Alpine will delete
8026 a single line.  If you delete a group of lines together, Alpine keeps them
8027 in the same buffer, so
8028 <!--chtml if pinemode="function_key"-->
8029 F10
8030 <!--chtml else-->
8031 ^U
8032 <!--chtml endif-->
8033 will restore them as a block.  About
8034 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
8035 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
8036 &quot;type the character ^&quot;.
8037
8038 <P>
8039 &lt;End of help on this topic&gt;
8040 </BODY>
8041 </HTML>
8042 ======= h_compose_justify =======
8043 <HTML>
8044 <HEAD>
8045 <TITLE>Justify Command</TITLE>
8046 </HEAD>
8047 <BODY>
8048 <H1>Justify Command</H1>
8049
8050 The Justify
8051 <!--chtml if pinemode="function_key"-->
8052 (F4)
8053 <!--chtml else-->
8054 (^J)
8055 <!--chtml endif-->
8056 command reformats the text in the paragraph the cursor is in.
8057 Paragraphs are separated by one blank line or a line beginning with a space.
8058 This is useful when you have been editing a paragraph and the lines become
8059 uneven.  The text is left aligned or justified and the right is ragged.  If
8060 the text is already justified as typed with auto-wrap, no justification will
8061 be done.
8062
8063 <P>
8064 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
8065 block of text, the Justify command is modified.
8066 Instead of automatically justifying the current paragraph you will be
8067 asked if you want to justify the paragraph, justify the selected region,
8068 or adjust the quote level of the selected region.
8069 Adjusting the quote level only works if you are using standard
8070 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
8071 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
8072
8073 <P>
8074 When composing a reply containing included text, the justify command
8075 will reformat text to the right of the
8076 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
8077 adding or removing indented lines as needed.  Paragraphs are separated
8078 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
8079 line containing the indent string and one or more blank spaces.
8080 Included text that was previously indented (or &quot;quoted&quot;) is
8081 not preserved.
8082
8083 <P>
8084 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
8085 in 1999 and its wide-spread adoption since then, you will usually be better off if you
8086 use the standard
8087 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
8088
8089 <P>
8090 &lt;End of help on this topic&gt;
8091 </BODY>
8092 </HTML>
8093 ======= h_compose_spell =======
8094 <HTML>
8095 <HEAD>
8096 <TITLE>Spell Check Command</TITLE>
8097 </HEAD>
8098 <BODY>
8099 <H1>Spell Check Command</H1>
8100
8101 The &quot;To Spell&quot;
8102 <!--chtml if pinemode="function_key"-->
8103 (F12)
8104 <!--chtml else-->
8105 (^T)
8106 <!--chtml endif-->
8107 command calls an external spell checking program to look over the
8108 message you are composing.  By default, Alpine uses
8109 <P>
8110 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
8111 <P>
8112 if it knows where to find &quot;aspell&quot;.
8113 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
8114 then the command used is
8115 <P>
8116 <CENTER><SAMP>ispell -l</SAMP></CENTER>
8117 <P>
8118 Otherwise, the ancient &quot;spell&quot; command is used.
8119 <P>
8120 For PC-Alpine, you must install the aspell library code that you
8121 may get from
8122 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
8123
8124 <P>
8125 &lt;End of help on this topic&gt;
8126 </BODY>
8127 </HTML>
8128 ======= h_compose_alted =======
8129 <HTML>
8130 <HEAD>
8131 <TITLE>Alt Editor Command</TITLE>
8132 </HEAD>
8133 <BODY>
8134 <H1>Alt Editor Command</H1>
8135
8136 The &quot;Alt Editor&quot; command's availability depends on the
8137 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
8138
8139 <P>
8140 When the variable specifies a valid editor on your system, this
8141 command will launch it with the current text of your message
8142 already filled in.
8143
8144 <P>
8145 &lt;End of help on this topic&gt;
8146 </BODY>
8147 </HTML>
8148 ======= h_compose_readfile =======
8149 <HTML>
8150 <HEAD>
8151 <TITLE>Read File Command</TITLE>
8152 </HEAD>
8153 <BODY>
8154 <H1>Read File Command</H1>
8155
8156 The &quot;Read File&quot;
8157 <!--chtml if pinemode="function_key"-->
8158 (F5)
8159 <!--chtml else-->
8160 (^R)
8161 <!--chtml endif-->
8162 command allows you to copy in text from an existing file. You will be
8163 prompted for the name of a file to be inserted into the message.  The file
8164 name is relative to your home directory
8165 <!--chtml if pinemode="running"-->
8166 (which, in the present configuration of your system, is
8167  &quot;<!--#echo var="HOME_DIR"-->&quot;)
8168 <!--chtml endif-->
8169 or current working directory
8170 <!--chtml if pinemode="running"-->
8171 (which, at least for your current Alpine &quot;session,&quot;
8172 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8173 <!--chtml endif-->, depending on the
8174 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
8175 configuration setting; or, the file name must be specified as a full path name
8176 <!--chtml if pinemode="os_windows"-->
8177 -- for example: &quot;A:&#92;PAPER.TXT&quot;
8178 <!--chtml else-->
8179 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
8180 <!--chtml endif-->
8181 (without the quotation marks).
8182
8183 <P>
8184 The file will be inserted where the cursor is located.  <B>The
8185 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
8186 Unix machine but have files on a PC or Mac, the files must be transferred
8187 to the system Alpine is running on before they can be read.  Please ask your
8188 local computer support people about the correct way to transfer a file to
8189 your Alpine system.
8190
8191 <P>
8192 &lt;End of help on this topic&gt;
8193 </BODY>
8194 </HTML>
8195 ======= h_config_tray_icon =======
8196 <HTML>
8197 <HEAD>
8198 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
8199 </HEAD>
8200 <BODY>
8201 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
8202
8203 PC-Alpine only.
8204 <P>
8205 This option restores a behavior of previous versions of PC-Alpine.
8206 These
8207 versions, when started, installed a PC-Alpine icon in the notification
8208 tray of Window's Taskbar.  The primary use of this icon was to indicate
8209 new mail arrival by turning red (while the Taskbar icon remained green).
8210 Additionally, the icon now changes to yellow to signify that a mail folder
8211 has been closed unexpectedly.
8212
8213 <P>
8214 Rather than add another icon to the Taskbar, this version of PC-Alpine will
8215 color its Taskbar entry's icon red (as well as the icon in the Window
8216 Title).  This feature is only provided for backwards compatibility.
8217
8218 <P>
8219 &lt;End of help on this topic&gt;
8220 </BODY>
8221 </HTML>
8222 ======= h_common_suspend =======
8223 <HTML>
8224 <HEAD>
8225 <TITLE>Suspend Command</TITLE>
8226 </HEAD>
8227 <BODY>
8228 <H1>Suspend Command</H1>
8229
8230 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
8231 enabled, you can, at almost any time, temporarily halt your Alpine session,
8232 <!--chtml if pinemode="os_windows"-->
8233 minimizing it into an icon.
8234 <!--chtml else-->
8235 and return to your system prompt.
8236 <!--chtml endif-->
8237
8238 <P>
8239 &lt;End of help on this topic&gt;
8240 </BODY>
8241 </HTML>
8242 ======= h_pipe_command =======
8243 <HTML>
8244 <HEAD>
8245 <TITLE>Pipe Command SubOptions</TITLE>
8246 </HEAD>
8247 <BODY>
8248 <H1>Pipe Command SubOptions</H1>
8249
8250 By default, when you use the Pipe command, the processed text of the
8251 message is sent to the Unix command
8252 you specify and the output is captured by Alpine and shown to you.
8253 (This command is available in PC-Alpine, as well, but there aren't many
8254 Windows commands that work well with piping.)
8255 There are some sub-commands that may be used to alter this behavior.
8256 These are toggles that switch the behavior between two possibilities.
8257 They can be combined in any way you wish.
8258 <P>
8259 By default, the prompt at the bottom of the screen looks like
8260 <P>
8261 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
8262 <P>
8263 or
8264 <P>
8265 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
8266 <P>
8267 if you are piping more than one message.
8268 <P>
8269 The sub-command options are:
8270 <DL>
8271    <DT>Shown Text or Raw Text</DT>
8272    <DD>This option toggles between sending the shown (processed) text
8273 of the message to the Unix command, and sending the
8274 raw (unprocessed) text of the message to the Unix command.
8275 The default is to send the shown text.
8276 The raw version of the message will contain all of the headers and any
8277 MIME encoding that the message contains.
8278 If you've selected the Raw Text then the prompt will have the additional word
8279 &quot;RAW&quot; in it, like
8280 <P>
8281 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
8282 <P>
8283 You can experiment with this option by piping to something simple like the
8284 Unix &quot;cat&quot; command.
8285    </DD>
8286    <DT>Captured Output or Free Output</DT>
8287    <DD>This option toggles between having Alpine capture the output of
8288 the Unix pipe command for display, and not capturing it.
8289 If the command you are piping to is a filter that will produce output
8290 you want to view, then you want to capture that output
8291 for display (the default).
8292 If the Unix command doesn't produce output or handles the display itself,
8293 then you want free output.
8294 When you've selected the Free Output option the prompt will change to
8295 <P>
8296 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
8297 <P>
8298    </DD>
8299    <DT>No Delimiter or With Delimiter</DT>
8300    <DD>This option controls whether or not a Unix mailbox style delimiter
8301 will come before the text of the message.
8302 This is the delimiter used in the common Unix mailbox format.
8303 It's the single line that begins with the five characters
8304 &quot;From&quot; followed by a &lt;SPACE&gt; character.
8305 You'll usually only want to include this if the Unix command requires
8306 input in the format of a traditional Unix mailbox file.
8307 When you've selected the With Delimiter option the prompt will change to
8308 <P>
8309 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
8310 <P>
8311    </DD>
8312    <DT>To Same Pipe or To Individual Pipes</DT>
8313    <DD>This option only shows up if you are running an aggregate
8314 pipe command.
8315 That is, the command was Apply Pipe, not just Pipe.
8316 You have the option of piping all of the selected messages through a
8317 single pipe to a single instance of the Unix command,
8318 or piping each individual message through a separate pipe to separate
8319 instances of the Unix command.
8320 The default is that all of the output will go through a single pipe
8321 to a single instance of the command.
8322 You can try this option with a command like &quot;less&quot;, with Free
8323 Output enabled.
8324 When you've selected the Individual Pipes option the prompt will change to
8325 <P>
8326 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
8327 <P>
8328    </DD>
8329 </DL>
8330
8331 <P>
8332 As mentioned earlier, the options can be combined in any way you wish.
8333 You may leave them all off, turn them all on, or turn some of them on
8334 and some of them off.
8335 If you use the pipe command a second time in the same session the default
8336 options will be what you used the last time.
8337
8338 <P>
8339 &lt;End of help on this topic&gt;
8340 </BODY>
8341 </HTML>
8342 ========== h_emptydir_subfolder_name =========
8343 <HTML>
8344 <HEAD>
8345 <TITLE>ENTER SUBFOLDER NAME</TITLE>
8346 </HEAD>
8347 <BODY>
8348 <H1>Enter Subfolder Name</H1>
8349
8350 <P>
8351 This is the name of a new subfolder in the directory you are creating.
8352 Because empty directories are hidden and therefore not useful, you must also
8353 create a subfolder in the directory you are creating in order that the
8354 directory remains visible.
8355 <P>
8356 Alternatively, you may turn off the configuration feature
8357 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
8358 so that empty directories remain visible.
8359 If you do that, you will not be required to create the subfolder when you
8360 create a directory.
8361
8362 <P>
8363 &lt;End of help on this topic&gt;
8364 </BODY>
8365 </HTML>
8366 ========== h_incoming_add_folder_name =========
8367 <HTML>
8368 <HEAD>
8369 <TITLE>ENTER FOLDER NAME</TITLE>
8370 </HEAD>
8371 <BODY>
8372 <H1>Enter Folder Name</H1>
8373
8374 <P>
8375 This is the name of the folder on the previously specified server.
8376 By default the folder name is interpreted as defining a section of your personal
8377 folder area.  This area and how you specify it are defined by the
8378 server, if one is specified.
8379
8380 <P>
8381 To define a folder outside the default area, prefix
8382 the path with the namespace to use when interpreting the
8383 given path.  If a namespace is specified, the folder name begins with the
8384 sharp (#) character followed by the name of the namespace
8385 and then the namespace's path-element-delimiter.  Aside from the
8386 name's format, namespaces can also imply access rights, content
8387 policy, audience, location, and, occasionally, access methods.
8388
8389 <P>
8390 Each server exports its own set (possibly of size one) of
8391 namespaces.
8392 For a more detailed explanation read about
8393 <A HREF="h_folder_name_namespaces">Namespaces</A>.
8394
8395 <P>
8396 To specify the default for INBOX on the server you can usually just enter
8397 &quot;INBOX&quot;, and the server will understand the special meaning of
8398 that word.
8399
8400 <P>
8401 &lt;End of help on this topic&gt;
8402 </BODY>
8403 </HTML>
8404 ========== h_incoming_add_folder_host =========
8405 <HTML>
8406 <HEAD>
8407 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
8408 </HEAD>
8409 <BODY>
8410 <H1>Enter Incoming Folder Server</H1>
8411
8412 You are being asked for the name of the server for use with this incoming
8413 folder.
8414 If the folder is on the machine where Alpine is running, then just enter
8415 RETURN without typing a server name.
8416
8417 <P>
8418 If the folder is on an IMAP server then type the server's name followed
8419 by RETURN.
8420 You may use the ^X command if the server is the same as the server that
8421 the INBOX is on.
8422
8423 <P>
8424 You may have to add optional extra information to the server name.
8425 For example, if the IMAP server is using a non-standard port number you
8426 would specify that by appending a colon (:) followed by the port number
8427 to the server name
8428
8429 <P>
8430 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8431 <P>
8432
8433 or you may need to specify a different protocol if the server is not an
8434 IMAP server. For example:
8435
8436 <P>
8437 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8438 <P>
8439
8440 for a POP server or
8441
8442 <P>
8443 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8444 <P>
8445
8446 for an NNTP news server.
8447 For an explanation of all of the possibilities, see
8448 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8449 for folders.
8450
8451 <P>
8452 There is a special command (^W) if you want to set up a folder that gets its
8453 mail from a
8454 <A HREF="h_maildrop">Mail Drop</A>.
8455 If you type that command, you will be prompted for the information for
8456 both the Mail Drop folder and the destination folder.
8457
8458 <P>
8459 &lt;End of help on this topic&gt;
8460 </BODY>
8461 </HTML>
8462 ========== h_incoming_add_inbox =========
8463 <HTML>
8464 <HEAD>
8465 <TITLE>ENTER INBOX SERVER</TITLE>
8466 </HEAD>
8467 <BODY>
8468 <H1>Enter INBOX Server</H1>
8469
8470 You are being asked for the name of the server for use with
8471 the INBOX folder.
8472 Type the server's name followed by RETURN.
8473
8474 <P>
8475 You may have to add optional extra information to the server name.
8476 For example, if the server is using a non-standard port number you
8477 would specify that by appending a colon (:) followed by the port number
8478 to the server name
8479
8480 <P>
8481 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8482 <P>
8483
8484 or you may need to specify a different protocol if the server is not an
8485 IMAP server. For example:
8486
8487 <P>
8488 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8489 <P>
8490
8491 for a POP server.
8492 <P>
8493
8494 For an explanation of all of the possibilities, see
8495 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8496 for folders.
8497
8498 <P>
8499 If the INBOX folder is on the machine where Alpine is running, then just enter
8500 RETURN without typing a server name.
8501
8502 <P>
8503 There is a special command (^W) if you want to set up a folder that gets its
8504 mail from a
8505 <A HREF="h_maildrop">Mail Drop</A>.
8506 If you type that command, you will be prompted for the information for
8507 both the Mail Drop folder and the destination folder, which will be used
8508 as your INBOX folder.
8509
8510 <P>
8511 &lt;End of help on this topic&gt;
8512 </BODY>
8513 </HTML>
8514 ========== h_incoming_add_maildrop_destn =========
8515 <HTML>
8516 <HEAD>
8517 <TITLE>ENTER DESTINATION SERVER</TITLE>
8518 </HEAD>
8519 <BODY>
8520 <H1>Enter Destination Server</H1>
8521
8522 You are being asked for the name of the server where the destination
8523 folder is for use with this Mail Drop incoming folder.
8524 That is, you are using a Mail Drop for this incoming folder and
8525 you've already entered
8526 the server and folder name for the Mail Drop.
8527 Now you need to enter the server for the destination folder
8528 where the mail should be copied to.
8529 Mail will come from the Mail Drop and be copied to the destination folder.
8530
8531 <P>
8532 Type the server's name followed by RETURN.
8533 If the folder is local to this computer, just type RETURN without entering
8534 a server name.
8535
8536 <P>
8537 You may have to add optional extra information to the server name.
8538 For example, if the server is using a non-standard port number you
8539 would specify that by appending a colon (:) followed by the port number
8540 to the server name
8541
8542 <P>
8543 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8544 <P>
8545
8546 For an explanation of all of the possibilities, see
8547 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8548 for folders.
8549
8550 <P>
8551 &lt;End of help on this topic&gt;
8552 </BODY>
8553 </HTML>
8554 ========== h_inbox_add_maildrop_destn =========
8555 <HTML>
8556 <HEAD>
8557 <TITLE>ENTER DESTINATION SERVER</TITLE>
8558 </HEAD>
8559 <BODY>
8560 <H1>Enter Destination Server</H1>
8561
8562 You are being asked for the name of the server where the destination
8563 folder is for use with your Mail Drop INBOX.
8564 That is, you are using a Mail Drop for your INBOX and you've already entered
8565 the server and folder name for the Mail Drop.
8566 Now you need to enter the server for the destination folder
8567 where the mail should be copied to.
8568 Mail will come from the Mail Drop and be copied to the destination folder.
8569
8570 <P>
8571 Type the server's name followed by RETURN.
8572 If the folder is local to this computer, just type RETURN without entering
8573 a server name.
8574
8575 <P>
8576 You may have to add optional extra information to the server name.
8577 For example, if the server is using a non-standard port number you
8578 would specify that by appending a colon (:) followed by the port number
8579 to the server name
8580
8581 <P>
8582 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8583 <P>
8584
8585 For an explanation of all of the possibilities, see
8586 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8587 for folders.
8588
8589 <P>
8590 &lt;End of help on this topic&gt;
8591 </BODY>
8592 </HTML>
8593 ========== h_inbox_add_maildrop =========
8594 <HTML>
8595 <HEAD>
8596 <TITLE>ENTER MAILDROP SERVER</TITLE>
8597 </HEAD>
8598 <BODY>
8599 <H1>Enter Mail Drop Server</H1>
8600
8601 You are being asked for the name of the Mail Drop server for use with
8602 your INBOX.
8603
8604 <P>
8605 Type the server's name followed by RETURN.
8606
8607 <P>
8608 You may have to add optional extra information to the server name.
8609 For example, if the server is using a non-standard port number you
8610 would specify that by appending a colon (:) followed by the port number
8611 to the server name
8612
8613 <P>
8614 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8615 <P>
8616
8617 or you may need to specify a different protocol if the server is not an
8618 IMAP server. For example:
8619
8620 <P>
8621 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8622 <P>
8623
8624 for a POP server or
8625
8626 <P>
8627 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8628 <P>
8629
8630 for an NNTP news server.
8631 For an explanation of all of the possibilities, see
8632 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8633 for folders.
8634
8635 <P>
8636 &lt;End of help on this topic&gt;
8637 </BODY>
8638 </HTML>
8639 ========== h_incoming_add_maildrop =========
8640 <HTML>
8641 <HEAD>
8642 <TITLE>ENTER MAILDROP SERVER</TITLE>
8643 </HEAD>
8644 <BODY>
8645 <H1>Enter Mail Drop Server</H1>
8646
8647 You are being asked for the name of the Mail Drop server for use with
8648 this incoming folder.
8649
8650 <P>
8651 Type the server's name followed by RETURN.
8652 You may use the ^X command if the server is the same as the server that
8653 the INBOX is on.
8654
8655 <P>
8656 You may have to add optional extra information to the server name.
8657 For example, if the server is using a non-standard port number you
8658 would specify that by appending a colon (:) followed by the port number
8659 to the server name
8660
8661 <P>
8662 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8663 <P>
8664
8665 or you may need to specify a different protocol if the server is not an
8666 IMAP server. For example:
8667
8668 <P>
8669 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8670 <P>
8671
8672 for a POP server or
8673
8674 <P>
8675 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8676 <P>
8677
8678 for an NNTP news server.
8679 For an explanation of all of the possibilities, see
8680 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8681 for folders.
8682
8683 <P>
8684 If the Mail Drop folder is on the machine where Alpine is running, then just enter
8685 RETURN without typing a server name.
8686
8687 <P>
8688 &lt;End of help on this topic&gt;
8689 </BODY>
8690 </HTML>
8691 ========== h_maildrop =========
8692 <HTML>
8693 <HEAD>
8694 <TITLE>WHAT IS A MAIL DROP?</TITLE>
8695 </HEAD>
8696 <BODY>
8697 <H1>What is a Mail Drop?</H1>
8698
8699 In some situaions it may make sense to have your mail delivered to one
8700 folder (the Mail Drop) and then when you want to read mail that has been
8701 delivered to the Mail Drop folder Alpine will move it to another
8702 destination folder.
8703 Often the Mail Drop will be a remote folder and messages will be moved from
8704 there to a local destination folder.
8705
8706 <P>
8707 One example where this might make sense is if the Mail Drop folder is accessible
8708 only with the POP protocol.
8709 You could designate your POP inbox as the Mail Drop folder and have Alpine move
8710 mail from there to a local (on the same machine Alpine is running on)
8711 destination folder, where you'll read it.
8712
8713 <P>
8714 A Mail Drop may only be used as your Inbox or as an
8715 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
8716
8717 <P>
8718 There is no attempt to synchronize the contents of the destination folder
8719 with the contents of the Mail Drop folder.
8720 All that happens is that all of the messages in the Mail Drop folder are
8721 copied to the destination folder and then they are deleted and expunged (if possible)
8722 from the Mail Drop folder.
8723 The next time a check for new mail is made, any messages in the Mail
8724 Drop folder are once again copied to the destination folder and deleted
8725 and expunged from the Mail Drop folder.
8726 (If the Mail Drop folder is a news group, then the messages can't be
8727 expunged from the newsgroup. Instead, only Recent messages are copied from
8728 the newsgroup to the destination folder.)
8729
8730 <P>
8731 Configuration of a Mail Drop is a little different from configuration of
8732 a folder that does not use a Mail Drop because you have to specify two
8733 folder names instead of one.
8734 The two folders may be any types of folders that Alpine can normally use.
8735 They don't have to be a remote folder and a local folder, that is
8736 simply the most common usage.
8737 When you use a Mail Drop folder Alpine will periodically re-open the Mail
8738 Drop to check for new mail.
8739 The new-mail checks will happen at the frequency set with the
8740 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
8741 but with a minimum time
8742 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
8743 between checks.
8744 Because of this minimum you may notice that new mail does not
8745 appear promptly when you expect it.
8746 The reason for this is to protect the server from over-zealous opening and
8747 closing of the Mail Drop folder.
8748 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
8749 the end of the folder index, then the check will happen, regardless of how
8750 long it has been since the previous check.
8751 <P>
8752 If there is new mail, that mail will be copied to the destination folder
8753 and then will be deleted from the Mail Drop.
8754 Note that using a Mail Drop with a local destination folder does not make
8755 sense if you read mail from more than one machine, because the mail is
8756 downloaded to the destination folder (which is accessible from only one
8757 machine) and deleted from the Mail Drop.
8758 <P>
8759 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
8760
8761 <P>
8762 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
8763
8764 <P>
8765 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
8766 <P>
8767 The brackets are not literal.
8768 <P>
8769 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
8770 <P>
8771 is a single character that does not appear in the MailDropFolder name.
8772 If the name doesn't contain spaces then it can be a space character.
8773 The two folder names are full technical
8774 <A HREF="h_valid_folder_names">folder names</A>
8775 as used by Alpine.
8776 Here are a couple examples to give you an idea what is being talked about:
8777
8778 <P>
8779 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
8780 <P>
8781 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
8782 <P>
8783
8784 A #move folder may only be used as an
8785 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
8786 an Inbox.
8787 When you are in the FOLDER LIST of Incoming Message Folders (after turning
8788 on the
8789 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8790 option)
8791 the Add command has a subcommand &quot;Use Mail Drop&quot;
8792 which may be helpful for defining the folder in your Alpine configuration.
8793 The same is true when you edit the
8794 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
8795 option in Setup/Config.
8796 Each of these configuration methods will also create the DestinationFolder
8797 if it doesn't already exist.
8798 If you are having problems, make sure the DestinationFolder exists.
8799
8800 <P>
8801 &lt;End of help on this topic&gt;
8802 </BODY>
8803 </HTML>
8804 ========== h_save =========
8805 <HTML>
8806 <HEAD>
8807 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
8808 </HEAD>
8809 <BODY>
8810 <H1>Choose a Folder to Save Into</H1>
8811
8812 After Exiting from this help text,
8813 type the name of the folder you want to save into and press RETURN.
8814 <P>
8815 Press ^T to get a list of your folders to choose from.
8816 Press ^C to cancel the Save.
8817 <P>
8818 If you have Folder Collections defined you may use
8819 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
8820 the collection being saved to.
8821 <P>
8822 If Tab Completion is enabled (it is enabled by default)
8823 you may type a Tab character to have Alpine complete the folder name for you.
8824 <P>
8825 If Partial Match Lists is enabled (it is enabled by default) you may type
8826 Ctrl-X to get a list of matches to the prefix you've typed in so far.
8827 <P>
8828 If the Ctrl-R subcommand is present that means you can decide to Delete or
8829 not Delete the message you are saving after you save it.
8830 The label on that key gives the action to switch to.
8831 If it says Delete and you type Ctrl-R the label displayed will change to
8832 No Delete and the source message will be deleted after the save. If it
8833 says No Delete and you type Ctrl-R the label displayed will change to
8834 Delete and the message will not be deleted.
8835 You can control the default for the Delete parameter with the
8836 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
8837 <P>
8838 Similarly, if the Ctrl-W subcommand is present that means you can decide
8839 to Preserve the order of the messages being saved or not.
8840 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
8841 will be in the same order as you see them in the source folder now.
8842 The opposite action (which is usually the default) is that you don't care
8843 about the order.
8844 The Saved messages may or may not be in the same order in the destination folder.
8845 There may be a performance penalty for choosing to save the messages in order.
8846 You can control the default for the Preserve Order parameter with the
8847 configuration feature
8848 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
8849
8850 <P>
8851 If you haven't disabled the Save Input History and you've already done a
8852 Save earlier in this session then you may use the Up and Down arrows to retrieve
8853 a folder name used in a previous Save.
8854
8855 <P>
8856 &lt;End of help on this topic&gt;
8857 </BODY>
8858 </HTML>
8859 ============= h_simple_index ========================
8860 <HTML>
8861 <HEAD>
8862 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
8863 </HEAD>
8864 <BODY>
8865 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
8866 <!--chtml if pinemode="function_key"-->
8867 <PRE>
8868 Navigating the List of Messages               General Alpine Commands
8869 -------------------------------               -----------------------
8870  F5   Move to previous message                 F1   Show this help text
8871  F6   Move to next message
8872  F7   Show previous screen of messages
8873  F8   Show next screen of messages
8874
8875 Message Selection Commands
8876 --------------------------
8877  F3   Exit the Message Select menu (canceling Send command)
8878  F4   Select the currently highlighted message
8879  F9   Mark the currently highlighted message as deleted
8880  F10  Undelete (remove deletion mark from) the highlighted message
8881 </PRE>
8882 <!--chtml else-->
8883 <PRE>
8884 Navigating the List of Messages               General Alpine Commands
8885 -------------------------------               -----------------------
8886   P  Move to previous message                  ?  Show this help text
8887   N  Move to next message
8888   -  Show previous screen of messages
8889  Spc (space bar) Show next screen of messages
8890
8891 Message Selection Commands
8892 --------------------------
8893   E  Exit the Message Select menu (canceling Send command)
8894   S  Select the currently highlighted message
8895   D  Mark the currently highlighted message as deleted
8896   U  Undelete (remove deletion mark from) the highlighted message
8897 </PRE>
8898 <!--chtml endif-->
8899 <P>
8900 <H2>Description of the Select Postponed Message Screen</H2>
8901
8902 This screen allows you to select one of several previously postponed
8903 messages in order to continue composition.  Your options are very limited
8904 -- the screen is not meant to let you manipulate these messages.  However,
8905 you may now delete messages from this list.  Once you choose a message,
8906 Alpine reads it in and puts you into the regular message composer.
8907 <P>
8908
8909 Messages do not stay in this postponed state automatically.  If you select
8910 a message and then want to postpone it again, use the normal postpone
8911 (Ctrl-O) command in the composer.
8912 <P>
8913
8914 If you exit this screen without selecting a message, the Compose command
8915 that got you here is canceled.  Other than messages explicitly marked
8916 &quot;Deleted&quot;, no messages will be removed.
8917
8918 <P>
8919 &lt;End of help on this topic&gt;
8920 </BODY>
8921 </HTML>
8922 ============= h_collection_screen ========================
8923 <HTML>
8924 <HEAD>
8925 <TITLE>COLLECTION LIST screen</TITLE>
8926 </HEAD>
8927 <BODY>
8928 <H1>COLLECTION LIST screen</H1>
8929
8930 The COLLECTION LIST screen is used to select one of your
8931 collection definitions to display the folders they contain.  See
8932 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
8933 detailed explanation of collections.<P>
8934
8935 To manage your collection definitions (Add, Change, Delete, etc.), use
8936 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
8937 MAIN MENU.
8938
8939 <P>
8940 &lt;End of help on this topic&gt;
8941 </BODY>
8942 </HTML>
8943 ============= h_collection_maint ========================
8944 <HTML>
8945 <HEAD>
8946 <TITLE>SETUP COLLECTION LIST screen</TITLE>
8947 </HEAD>
8948 <BODY>
8949 <H1>SETUP COLLECTION LIST screen</H1>
8950
8951 The SETUP COLLECTION LIST screen lets you manage your collection
8952 definitions.  See
8953 <A HREF="h_what_are_collections">Folder Collections Explained</A>
8954 for detailed explanation of collections.<P>
8955
8956 Maintenance commands include:
8957 <DL>
8958 <DT>Change
8959 <!--chtml if pinemode="function_key"-->
8960 (F4)
8961 <!--chtml else-->
8962 (C)
8963 <!--chtml endif-->
8964 </DT>
8965
8966 <DD>Modify attributes of the selected collection definition.
8967
8968 <DT>Add Cltn
8969 <!--chtml if pinemode="function_key"-->
8970 (F9)
8971 <!--chtml else-->
8972 (A)
8973 <!--chtml endif-->
8974 </DT>
8975
8976 <DD>Create a new collection definition.
8977 </DD>
8978
8979 <DT>Del Cltn
8980 <!--chtml if pinemode="function_key"-->
8981 (F10)
8982 <!--chtml else-->
8983 (D)
8984 <!--chtml endif-->
8985 </DT>
8986
8987 <DD>Delete the selected collection definition.<BR>
8988 NOTE: The folders and directories referred to by the
8989 collection definition are <EM>NOT</EM> deleted.  Folders must
8990 be deleted, if that's what you wish to do, from the
8991 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
8992 individual folders in a collection.
8993 </DD>
8994
8995 <DT>Shuffle
8996 <!--chtml if pinemode="function_key"-->
8997 (F11)
8998 <!--chtml else-->
8999 ($)
9000 <!--chtml endif-->
9001 </DT>
9002
9003 <DD>Change the order of the displayed collections.  Alpine will offer
9004 to move the currently selected collection one position UP
9005 or DOWN.
9006 </DD>
9007 </DL>
9008
9009 <P>
9010 &lt;End of help on this topic&gt;
9011 </BODY>
9012 </HTML>
9013 ============ h_what_are_collections ==========
9014 <HTML>
9015 <HEAD>
9016 <TITLE>Folder Collections Explained</TITLE>
9017 </HEAD>
9018 <BODY>
9019 <H1>Folder Collections Explained</H1>
9020
9021
9022 Those of you with simple mail configurations will just see a list of all the
9023 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
9024 The special folders for INBOX, sent mail and saved messages
9025 will appear at the top of the list.  All others are in alphabetical order.
9026 <P>
9027 If you
9028 or your system administrator have defined more than one collection or if
9029 you have a collection (for newsgroups or email folders) defined on your
9030 system, then you will see the COLLECTION LIST screen first when choosing
9031 FOLDER LIST from Alpine's MAIN MENU.
9032 <P>
9033 <H2>Why have multiple folder collections?</H2>
9034 <P>
9035 For Alpine users who only maintain email folders (and not too many) on one host,
9036 a single folder collection is probably sufficient.<P>
9037
9038 However, people who have more than one email account - for example, one
9039 at their university, and one with their personal Internet Service Provider -
9040 will have different sets of folders on different hosts, and they may want to
9041 access them all from the same installation of Alpine, rather than use different
9042 software and/or log into other hosts to manipulate messages in different
9043 accounts.  (If in doubt whether one of your email accounts can be accessed
9044 with Alpine, contact the technical support people for that account.)  Even people
9045 who have only one email account on one host, but have dozens or
9046 hundreds of email folders, may want to arrange these folders together in a
9047 meaningful way.<BR>
9048 That is where multiple collections come in.
9049
9050 <H2>Types of Collections</H2>
9051 <DL>
9052 <DT>INCOMING FOLDERS</DT>
9053 <DD>&quot;Incoming Message Folders&quot;
9054 is a special collection typically used to supplement your single INBOX.
9055 All the folders here are meant to be ones that receive incoming messages,
9056 which you intend to check more or less frequently.
9057 You may have multiple folders like this because you or your systems
9058 administrator have set up an external program or you may have set up
9059 Alpine to filter incoming
9060 messages into different folders, based on certain criteria such as
9061 sender, recipient, or subject; or because you have multiple accounts and
9062 wish to check their INBOXes easily.  This collection is established by
9063 setting the
9064 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
9065 feature in the SETUP CONFIGURATION screen, which is accessed from the
9066 MAIN MENU.
9067 </DD>
9068
9069 <DT>NEWS</DT>
9070 <DD>You can also define a collection specifically for
9071 newsgroups.  Alpine does this for you implicitly when you
9072 <A HREF="h_config_nntp_server">define an NNTP Server</A>
9073 in your Alpine configuration.  The news collection appears last in the
9074 COLLECTION LIST (though you can shuffle it up in the order of presentation),
9075 and Alpine knows not to save messages there.
9076 </DD>
9077
9078 <DT>DEFAULT COLLECTION</DT>
9079 <DD>This is the default collection for your saved and sent messages folders.
9080 </DD>
9081 </DL>
9082
9083 <P>
9084
9085 <H2>Defining Collections</H2>
9086 <P>
9087 In the absence of any folder-collection definitions, Alpine will assume a
9088 single default folder collection.
9089 <!--chtml if pinemode="os_windows"-->
9090 <!--chtml else-->
9091 If necessary, Alpine will create the directory
9092 &quot;mail&quot; in your Unix home directory
9093 to hold your folders.
9094 <!--chtml endif-->
9095 <P>
9096 You can use the
9097 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
9098 the MAIN MENU, to manage your collection list.
9099 <P>
9100 &lt;End of help on this topic&gt;
9101 </BODY>
9102 </HTML>
9103 ===== h_select_address_screen =====
9104 <HTML>
9105 <HEAD>
9106 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
9107 </HEAD>
9108 <BODY>
9109 <H1>SELECT AN ADDRESS SCREEN</H1>
9110 <H2>COMMANDS</H2>
9111 <!--chtml if pinemode="function_key"-->
9112 <PRE>
9113 Available  Commands
9114 -------------------------------
9115 F1  Show Help Text
9116 F3  Exit without selecting anything
9117 F4  Select the highlighted address
9118 F5  Move highlight to previous address
9119 F6  Move highlight to next address
9120 F7  Previous page of addresses
9121 F8  Next page of addresses
9122 F11 Print
9123 F12 WhereIs
9124 </PRE>
9125 <!--chtml else-->
9126 <PRE>
9127 Navigation                     General Alpine Commands
9128 -------------------------      -----------------------
9129  P  Prev Address                ?  Display this help text
9130  N  Next Address                E  Exit without selecting anything
9131  -  Previous page               %  Print
9132 Spc (space bar) Next page
9133  W  WhereIs
9134
9135 Select Command
9136 ------------------------------------------------
9137  S  Select the highlighted address
9138 </PRE>
9139 <!--chtml endif-->
9140
9141 <H2>Description of the Select Address Screen</H2>
9142
9143 This screen gives you an easy way to select an address from all of
9144 the address book entries that match the prefix typed so far.
9145
9146 <P><UL>
9147 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9148 </UL>
9149 <P>
9150 &lt;End of help on this topic&gt;
9151 </BODY>
9152 </HTML>
9153 ===== h_select_rule_screen =====
9154 <HTML>
9155 <HEAD>
9156 <TITLE>SELECT A RULE SCREEN</TITLE>
9157 </HEAD>
9158 <BODY>
9159 <H1>SELECT A RULE SCREEN</H1>
9160 <H2>COMMANDS</H2>
9161 <!--chtml if pinemode="function_key"-->
9162 <PRE>
9163 Available  Commands
9164 -------------------------------
9165 F1  Show Help Text
9166 F3  Exit without selecting anything
9167 F4  Select the highlighted rule
9168 F5  Move highlight to previous rule
9169 F6  Move highlight to next rule
9170 F7  Previous page of rules
9171 F8  Next page of rules
9172 F11 Print
9173 F12 WhereIs
9174 </PRE>
9175 <!--chtml else-->
9176 <PRE>
9177 Navigation                     General Alpine Commands
9178 -------------------------      -----------------------
9179  P  Prev Rule                   ?  Display this help text
9180  N  Next Rule                   E  Exit without selecting anything
9181  -  Previous page               %  Print
9182 Spc (space bar) Next page
9183  W  WhereIs
9184
9185 Select Command
9186 ------------------------------------------------
9187  S  Select the highlighted rule
9188 </PRE>
9189 <!--chtml endif-->
9190
9191 <H2>Description of the Select Rule Screen</H2>
9192
9193 This screen just gives you an easy way to select a rule from all of your
9194 defined rules.
9195 The list of rules presented is the list of nicknames of all of the rules
9196 defined using Setup/Rules.
9197 For selecting messages, it is likely that the Indexcolor rules and possibly
9198 the Roles rules will be most useful.
9199 The others are there also, in case you find a use for them.
9200 <P>
9201 In order for this to be useful for selecting messages, the nicknames of
9202 the rules have to be different.
9203 Alpine actually just gets the nickname of the rule that you select and then
9204 looks up that rule using the nickname.
9205 So if there are duplicate nicknames, the first rule that has that
9206 nickname will be used.
9207
9208 <P><UL>
9209 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9210 </UL>
9211 <P>
9212 &lt;End of help on this topic&gt;
9213 </BODY>
9214 </HTML>
9215 ===== h_select_priority_screen =====
9216 <HTML>
9217 <HEAD>
9218 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
9219 </HEAD>
9220 <BODY>
9221 <H1>SELECT A PRIORITY SCREEN</H1>
9222 <H2>COMMANDS</H2>
9223 <!--chtml if pinemode="function_key"-->
9224 <PRE>
9225 Available  Commands
9226 -------------------------------
9227 F1  Show Help Text
9228 F3  Exit without selecting anything
9229 F4  Select the highlighted priority
9230 F5  Move highlight to previous priority
9231 F6  Move highlight to next priority
9232 F7  Previous page of priorities
9233 F8  Next page of priorities
9234 F11 Print
9235 F12 WhereIs
9236 </PRE>
9237 <!--chtml else-->
9238 <PRE>
9239 Navigation                     General Alpine Commands
9240 -------------------------      -----------------------
9241  P  Prev Priority               ?  Display this help text
9242  N  Next Priority               E  Exit without selecting anything
9243  -  Previous page               %  Print
9244 Spc (space bar) Next page
9245  W  WhereIs
9246
9247 Select Command
9248 ------------------------------------------------
9249  S  Select the highlighted priority
9250 </PRE>
9251 <!--chtml endif-->
9252
9253 <H2>Description of the Select Priority Screen</H2>
9254
9255 This screen gives you a way to select a priority for the message you are sending.
9256 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
9257 Some mail programs will display an indication of the priority level to
9258 the recipient of the message, some will ignore it.
9259 Even in cases where the mail programs of both the sender and the recipient
9260 agree on the meaning of this header, keep in mind that it is
9261 something that the sender sets so it is only an indication
9262 of the priority that the sender attaches to the mail.
9263 Alpine can be made to display an indication of this priority in incoming
9264 messages by use of one of the tokens
9265 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
9266 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
9267 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
9268
9269 <P><UL>
9270 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9271 </UL>
9272 <P>
9273 &lt;End of help on this topic&gt;
9274 </BODY>
9275 </HTML>
9276 ===== h_select_keyword_screen =====
9277 <HTML>
9278 <HEAD>
9279 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
9280 </HEAD>
9281 <BODY>
9282 <H1>SELECT A KEYWORD SCREEN</H1>
9283 <H2>COMMANDS</H2>
9284 <!--chtml if pinemode="function_key"-->
9285 <PRE>
9286 Available  Commands
9287 -------------------------------
9288 F1  Show Help Text
9289 F3  Exit without selecting anything
9290 F4  Select the highlighted keyword
9291 F5  Move highlight to previous keyword
9292 F6  Move highlight to next keyword
9293 F7  Previous page of keywords
9294 F8  Next page of keywords
9295 F11 Print
9296 F12 WhereIs
9297 </PRE>
9298 <!--chtml else-->
9299 <PRE>
9300 Navigation                     General Alpine Commands
9301 -------------------------      -----------------------
9302  P  Prev Keyword                ?  Display this help text
9303  N  Next Keyword                E  Exit without selecting anything
9304  -  Previous page               %  Print
9305 Spc (space bar) Next page
9306  W  WhereIs
9307
9308 Select Command
9309 ------------------------------------------------
9310  S  Select the highlighted keyword
9311 </PRE>
9312 <!--chtml endif-->
9313
9314 <H2>Description of the Select Keyword Screen</H2>
9315
9316 This screen just gives you an easy way to select a keyword.
9317 The list of keywords presented is the list of all keywords defined in your
9318 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9319 If you have given a keyword a nickname, that nickname is displayed
9320 instead of the actual keyword.
9321
9322 <P><UL>
9323 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9324 </UL>
9325 <P>
9326 &lt;End of help on this topic&gt;
9327 </BODY>
9328 </HTML>
9329 ===== h_select_charset_screen =====
9330 <HTML>
9331 <HEAD>
9332 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
9333 </HEAD>
9334 <BODY>
9335 <H1>SELECT A CHARACTER SET SCREEN</H1>
9336 <H2>COMMANDS</H2>
9337 <!--chtml if pinemode="function_key"-->
9338 <PRE>
9339 Available  Commands
9340 -------------------------------
9341 F1  Show Help Text
9342 F3  Exit without selecting anything
9343 F4  Select the highlighted character set
9344 F5  Move highlight to previous character set
9345 F6  Move highlight to next character set
9346 F7  Previous page of character sets
9347 F8  Next page of character sets
9348 F11 Print
9349 F12 WhereIs
9350 </PRE>
9351 <!--chtml else-->
9352 <PRE>
9353 Navigation                     General Alpine Commands
9354 -------------------------      -----------------------
9355  P  Prev Character Set          ?  Display this help text
9356  N  Next Character Set          E  Exit without selecting anything
9357  -  Previous page               %  Print
9358 Spc (space bar) Next page
9359  W  WhereIs
9360
9361 Select Command
9362 ------------------------------------------------
9363  S  Select the highlighted character set
9364 </PRE>
9365 <!--chtml endif-->
9366
9367 <H2>Description of the Select A Character Set Screen</H2>
9368
9369 This screen just gives you an easy way to select a character set from the
9370 set of character sets Alpine knows about.
9371 The list presented will vary slightly depending on what option you are
9372 selecting the character set for.
9373
9374 <P><UL>
9375 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9376 </UL>
9377 <P>
9378 &lt;End of help on this topic&gt;
9379 </BODY>
9380 </HTML>
9381 ===== h_select_multcharsets_screen =====
9382 <HTML>
9383 <HEAD>
9384 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
9385 </HEAD>
9386 <BODY>
9387 <H1>SELECT CHARACTER SETS SCREEN</H1>
9388 <H2>COMMANDS</H2>
9389 <!--chtml if pinemode="function_key"-->
9390 <PRE>
9391 Available  Commands
9392 -------------------------------
9393 F1  Show Help Text
9394 F3  Exit without selecting anything
9395 F4  Select the highlighted charset (or chosen charsets in ListMode)
9396 F5  Move highlight to previous charset
9397 F6  Move highlight to next charset
9398 F7  Previous page of charsets
9399 F8  Next page of charsets
9400 F9  Toggle choices when using ListMode
9401 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
9402 F11 Print
9403 F12 WhereIs
9404 </PRE>
9405 <!--chtml else-->
9406 <PRE>
9407 Navigation                     General Alpine Commands
9408 -------------------------      -----------------------
9409  P  Prev Charset                ?  Display this help text
9410  N  Next Charset                E  Exit without selecting anything
9411  -  Previous page               %  Print
9412 Spc (space bar) Next page
9413  W  WhereIs
9414
9415 Select Command
9416 ------------------------------------------------
9417  S  Select the highlighted charset (or chosen charsets in ListMode)
9418  L  Turn on ListMode (makes it easy to choose multiple charsets)
9419  1  Turn off ListMode
9420  X  Toggle choices when using ListMode
9421 </PRE>
9422 <!--chtml endif-->
9423
9424 <H2>Description of the Select Character Set Screen</H2>
9425
9426 This screen just gives you an easy way to select a character set or a list of
9427 character sets.
9428 The list of character sets presented is the list of all character sets known to
9429 Alpine.
9430 You may select other character sets by typing them in directly.
9431
9432 <P><UL>
9433 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9434 </UL>
9435 <P>
9436 &lt;End of help on this topic&gt;
9437 </BODY>
9438 </HTML>
9439 ===== h_select_multkeyword_screen =====
9440 <HTML>
9441 <HEAD>
9442 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
9443 </HEAD>
9444 <BODY>
9445 <H1>SELECT KEYWORDS SCREEN</H1>
9446 <H2>COMMANDS</H2>
9447 <!--chtml if pinemode="function_key"-->
9448 <PRE>
9449 Available  Commands
9450 -------------------------------
9451 F1  Show Help Text
9452 F3  Exit without selecting anything
9453 F4  Select the highlighted keyword (or chosen keywords in ListMode)
9454 F5  Move highlight to previous keyword
9455 F6  Move highlight to next keyword
9456 F7  Previous page of keywords
9457 F8  Next page of keywords
9458 F9  Toggle choices when using ListMode
9459 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
9460 F11 Print
9461 F12 WhereIs
9462 </PRE>
9463 <!--chtml else-->
9464 <PRE>
9465 Navigation                     General Alpine Commands
9466 -------------------------      -----------------------
9467  P  Prev Keyword                ?  Display this help text
9468  N  Next Keyword                E  Exit without selecting anything
9469  -  Previous page               %  Print
9470 Spc (space bar) Next page
9471  W  WhereIs
9472
9473 Select Command
9474 ------------------------------------------------
9475  S  Select the highlighted keyword (or chosen keywords in ListMode)
9476  L  Turn on ListMode (makes it easy to choose multiple keywords)
9477  1  Turn off ListMode
9478  X  Toggle choices when using ListMode
9479 </PRE>
9480 <!--chtml endif-->
9481
9482 <H2>Description of the Select Keyword Screen</H2>
9483
9484 This screen just gives you an easy way to select a keyword or a list of
9485 keywords.
9486 The list of keywords presented is the list of all keywords defined in your
9487 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9488 If you have given a keyword a nickname, that nickname is displayed
9489 instead of the actual keyword.
9490
9491 <P><UL>
9492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9493 </UL>
9494 <P>
9495 &lt;End of help on this topic&gt;
9496 </BODY>
9497 </HTML>
9498 ===== h_select_incoming_to_monitor =====
9499 <HTML>
9500 <HEAD>
9501 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
9502 </HEAD>
9503 <BODY>
9504 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
9505 <H2>COMMANDS</H2>
9506 <!--chtml if pinemode="function_key"-->
9507 <PRE>
9508 Available  Commands
9509 -------------------------------
9510 F1  Show Help Text
9511 F3  Exit without selecting anything
9512 F4  Select the marked folders
9513 F5  Move highlight to previous folder
9514 F6  Move highlight to next folder
9515 F7  Previous page of folders
9516 F8  Next page of folders
9517 F9  Toggle choices on or off
9518 F11 Print
9519 F12 WhereIs
9520 </PRE>
9521 <!--chtml else-->
9522 <PRE>
9523 Navigation                     General Alpine Commands
9524 -------------------------      -----------------------
9525  P  Prev Folder                 ?  Display this help text
9526  N  Next Folder                ^C  exit without changing anything
9527  -  Previous page               %  Print
9528 Spc (space bar) Next page
9529  W  WhereIs
9530
9531 Select Command
9532 ------------------------------------------------
9533  S  Select the marked folders
9534  X  Toggle choices on or off
9535 </PRE>
9536 <!--chtml endif-->
9537
9538 <H2>Description of the Select Folders to Check Screen</H2>
9539
9540 This screen is only useful if the feature
9541 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
9542 is set.
9543 By default, when you set that feature all of your incoming folders
9544 will be checked periodically for Unseen messages.
9545 By using this screen, you may restrict the set of monitored folders to
9546 a subset of all of the incoming folders.
9547 <P>
9548 Mark the folders you want to monitor for Unseen messages with
9549 an &quot;X&quot;.
9550 When you've finished marking all your selections use the Select
9551 command to register your choices.
9552 To return to the default of checking all incoming folders
9553 delete all folders or unmark all folders.
9554
9555 <P><UL>
9556 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9557 </UL>
9558 <P>
9559 &lt;End of help on this topic&gt;
9560 </BODY>
9561 </HTML>
9562 ===== h_role_select =====
9563 <HTML>
9564 <HEAD>
9565 <TITLE>ROLES SCREEN</TITLE>
9566 </HEAD>
9567 <BODY>
9568 <H1>ROLES SCREEN</H1>
9569 <H2>ROLES COMMANDS</H2>
9570 <!--chtml if pinemode="function_key"-->
9571 <PRE>
9572 Available  Commands
9573 -------------------------------
9574 F1  Show Help Text
9575 F3  Exit without a selection
9576 F4  Select a role to use in composition
9577 F5  Move to previous role
9578 F6  Move to next role
9579 F7  Previous page of roles
9580 F8  Next page of roles
9581 F11 Change Default Role
9582 F12 Whereis (search role nicknames)
9583 </PRE>
9584 <!--chtml else-->
9585 <PRE>
9586 Navigation                     General Alpine Commands
9587 -------------------------      -----------------------
9588  P  Prev Role                     ?  Display this help text
9589  N  Next Role                     E  Exit without a selection
9590  -  Previous page
9591 Spc (space bar) Next page
9592  W  WhereIs (search for word in role nicknames)
9593
9594 Select Role Commands
9595 ------------------------------------------------
9596  [Return]  Select highlighted role
9597  D         Change Default Role
9598 </PRE>
9599 <!--chtml endif-->
9600
9601 <H2>Description of the Roles Screen</H2>
9602
9603 With this screen you select a role to be used in the composition of a
9604 message.
9605 Use the Previous and Next commands to highlight the role you wish to
9606 use.
9607 When you type carriage return you will be placed in the composer using the highlighted role.
9608 <P>
9609 You don't have any non-default <A HREF="h_rules_roles">roles</A>
9610 available unless you set them up.
9611 You may do so by using the Setup/Rules command on the MAIN MENU.
9612 <P>
9613 By using the D command, you may set a default role that will persist until
9614 you change it or until you exit Alpine.
9615 The D command toggles through three states: set the default role, unset the
9616 default role, and leave the default role as it is.
9617 <P><UL>
9618 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9619 </UL>
9620 <P>
9621 &lt;End of help on this topic&gt;
9622 </BODY>
9623 </HTML>
9624 ===== h_role_abook_select =====
9625 <HTML>
9626 <HEAD>
9627 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
9628 </HEAD>
9629 <BODY>
9630 <H1>SELECT ADDRESS BOOK SCREEN</H1>
9631 <H2>COMMANDS</H2>
9632 <!--chtml if pinemode="function_key"-->
9633 <PRE>
9634 Available  Commands
9635 -------------------------------
9636 F1  Show Help Text
9637 F3  Exit screen without selecting anything
9638 F4  Select highlighted address book
9639 F5  Move to previous address book
9640 F6  Move to next address book
9641 F7  Previous page of address books
9642 F8  Next page of address books
9643 F12 Whereis
9644 </PRE>
9645 <!--chtml else-->
9646 <PRE>
9647 Navigation                     General Alpine Commands
9648 -------------------------      -----------------------
9649  P  Previous addrbook          ?  Display this help text
9650  N  Next addrbook
9651  -  Previous page
9652 Spc (space bar) Next page
9653  W  WhereIs
9654
9655 Select Role Commands
9656 ------------------------------------------------
9657  S  Select highlighted address book
9658  E  Exit screen without selecting anything
9659 </PRE>
9660 <!--chtml endif-->
9661
9662 <H2>Description of the Select Address Book Screen</H2>
9663
9664 This screen helps you select one of your address books.
9665 Use the Previous and Next commands to highlight the address book you wish to
9666 select.
9667 <P><UL>
9668 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9669 </UL>
9670 <P>
9671 &lt;End of help on this topic&gt;
9672 </BODY>
9673 </HTML>
9674 ======== h_rule_patterns =============
9675 <HTML>
9676 <HEAD>
9677 <TITLE>PATTERNS</TITLE>
9678 </HEAD>
9679 <BODY>
9680 <H1>PATTERNS</H1>
9681 Patterns are used with Roles, Filtering, Index Coloring,
9682 Scoring, Other Rules, and Search Rules.
9683 Patterns are compared with a message to see if there is a match.
9684 For Filtering, the messages being checked are all the messages in the
9685 folder, one at a time.
9686 For Index Line Coloring, each message that is visible on the screen is
9687 checked for matches with the Index Coloring Patterns.
9688 Roles are used with the Reply, Forward, and Compose commands.
9689 For Reply, the message used to compare the Pattern with is the message
9690 being replied to;
9691 for Forward, the message used to compare the Pattern with is the message
9692 being forwarded;
9693 and for Compose, there is no message, so the parts of the Pattern that depend
9694 on a message (everything other than Current Folder Type and the
9695 Beginning of Month and Year)
9696 are not used.
9697 Only the Current Folder Type matters for Compose (plus the Beginning of
9698 Month or Year, which you wouldn't usually use for a Role).
9699 For Scoring, the message being scored is compared with all of the Score
9700 Patterns, and the Score Values from the ones that match are added together to
9701 get the message's score.
9702 For Other Rules, there is no message. Only the Current Folder Type is checked
9703 for Other Rules.
9704 <P>
9705 Each Pattern has several possible parts, all of which are optional.
9706 In order for there to be a match, <EM>ALL</EM> of the
9707 <EM>defined</EM> parts of the Pattern must match the message.
9708 If a part is not defined it is considered a match, but note that a filtering
9709 Pattern must have at least one defined part or it will be ignored.
9710 For example, if the To pattern is not defined it will be
9711 displayed as
9712 <P>
9713 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
9714 <P>
9715 That is considered a match because it is not defined.
9716 This means that the Pattern with nothing defined is a match if the
9717 Current Folder Type matches, but there is an exception that was mentioned
9718 in the previous paragraph.
9719 Because filtering is a potentially destructive action, filtering Patterns
9720 with nothing other than Current Folder Type defined are ignored.
9721 If you really want a filtering Pattern to match all messages (subject to
9722 Current Folder Type) the best way to do it is to define a Score interval
9723 that includes all possible scores.
9724 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
9725 This can be used even if you haven't defined any rules to Set Scores.
9726 <P>
9727 There are six predefined header patterns called the To, From, Sender, Cc, News,
9728 and Subject patterns.
9729 Besides those six predefined header patterns, you may add
9730 additional header patterns with header fieldnames of your choosing.
9731 You add an extra header pattern by placing the cursor on one of the
9732 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
9733 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
9734 and the Partic pattern is a header pattern that stands for
9735 Participant (From OR To OR Cc).
9736 (Defining the Recip pattern does not have the same effect as defining both
9737 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
9738 Similar to the header patterns are the AllText pattern and the BodyText pattern.
9739 Instead of comparing this pattern's text against only the contents of
9740 a particular header field, the text for the AllText pattern is compared
9741 with text anywhere in the message's header or body, and the text for the
9742 BodyText pattern is compared with text anywhere in the message's body.
9743 <P>
9744 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
9745 &quot;!&quot; &quot;toggle NOT&quot; command.
9746 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9747 &quot;!&quot; at the beginning of the pattern line.
9748 When the &quot;!&quot; is present, it reverses the meaning of the match.
9749 That is, if the pattern matches then it is considered to NOT be a match, and
9750 if it does not match it is considered to be a match.
9751 <P>
9752 Don't make the mistake of putting the &quot;!&quot; in the data field for
9753 a pattern.
9754 For example, if you type the characters &quot;!urgent&quot; into the Subject
9755 pattern, the pattern will look like:
9756 <P>
9757 <PRE>
9758  Subject pattern = !urgent
9759 </PRE>
9760 <P>
9761 This means you want to match the 7 character sequence &quot;!urgent&quot;.
9762 In order to match messages that do not have &quot;urgent&quot; in
9763 their Subject field, first type the characters &quot;urgent&quot; followed
9764 by carriage return for the value of the Subject pattern, then negate it
9765 by typing the &quot;!&quot; command.
9766 It should look like
9767 <P>
9768 <PRE>
9769  ! Subject pattern = urgent
9770 </PRE>
9771 <P>
9772 The contents of each of these header patterns (or the AllText or BodyText patterns) may
9773 be a complete email address, part of an address, or a random set of
9774 characters to match against.
9775 It may also be a list of such patterns, which means you
9776 are looking for a match against the first pattern in the list <EM>OR</EM>
9777 the second pattern <EM>OR</EM> the third and so on.
9778 For example, a Subject pattern equal to
9779 <P>
9780 <PRE>
9781  Subject pattern = urgent
9782                    emergency
9783                    alert
9784 </PRE>
9785 <P>
9786 would match all messages with a subject that contained at least one
9787 of those words.
9788 It would also match subjects containing the words &quot;alerts&quot; or
9789 &quot;Urgently&quot;.
9790 <P>
9791 The same example with &quot;NOT&quot; turned on would be
9792 <P>
9793 <PRE>
9794  ! Subject pattern = urgent
9795                      emergency
9796                      alert
9797 </PRE>
9798 <P>
9799 which would match all messages with a subject that did <EM>NOT</EM> contain any of
9800 those words.
9801 You can use the &quot;Add Value&quot; command to add new words to the list,
9802 or you can enter them as a comma-separated list.
9803 <P>
9804 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
9805 present for a match.
9806 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
9807 pattern2 must be present,
9808 and that is exactly what using a list does.)
9809 <P>
9810 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
9811 also part of the Pattern, although the &quot;Score Interval&quot; is not used
9812 when checking for matches for Scoring.
9813 There are five similar settings that relate to the status of the message.
9814 These settings rely on the message being New or not, Deleted or not,
9815 Answered or not, Important or not, and Recent or not.
9816 There are also some other miscellaneous settings.
9817 The first is the Age of the message in days.
9818 Another is the Size of the message, in bytes.
9819 The third is a setting that detects whether or not the Subject of a
9820 message contains raw 8-bit characters (unencoded characters with the most
9821 significant bit set).
9822 There is a setting that detects whether or not this is the first time
9823 Alpine has been run this month (doesn't depend on individual messages),
9824 and another that detects whether or not this is the first time Alpine has
9825 been run this year.
9826 Other parts of the Pattern detect whether or not the From address of a
9827 message appears in your address book, whether or not certain keywords
9828 are set for a message, and whether or not certain character sets are
9829 used in a message.
9830
9831 <H2>Parts of a Pattern</H2>
9832
9833 <H3>Header patterns</H3>
9834
9835 A header pattern is simply text that is searched for in the corresponding
9836 header field.
9837 For example, if a Pattern has a From header pattern with the value
9838 &quot;@company.com&quot;, then only messages that have a From header
9839 that contains the text &quot;@company.com&quot; will be possible
9840 matches.
9841 Matches don't have to be exact.
9842 For example, if the relevant field of a message contains the text
9843 &quot;mailbox@domain&quot; somewhere
9844 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
9845 &quot;mailbox@domain&quot; are all matches.
9846 <P>
9847 All parts of the Pattern must match so, for example,
9848 if a message matches a defined
9849 From pattern, it still must be checked against the other parts of the
9850 Pattern that have been defined.
9851 The To header pattern is a slightly special case.
9852 If the message being checked has a Resent-To header
9853 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
9854 there are used in place of the addresses in the To header.
9855 This is only true for the To header.
9856 Resent-cc and Resent-From headers are never used unless you add them
9857 with the eXtraHdrs command.
9858 <P>
9859 The meaning of a header pattern may be negated with the
9860 &quot;!&quot; &quot;toggle NOT&quot; command.
9861 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9862 &quot;!&quot; at the beginning of the pattern line.
9863 It would look something like
9864 <P>
9865 <PRE>
9866  ! From pattern = susan@example.com
9867 </PRE>
9868 <P>
9869 When the &quot;!&quot; is present, it reverses the meaning of the match.
9870 <P>
9871 If you want to check for the presence of a header field but don't care
9872 about its value, then
9873 the empty pattern that you get by entering a pair of
9874 double quotes (&quot;&quot;) should match any message that
9875 has the corresponding header field.
9876
9877 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
9878
9879 AllText patterns are just like header patterns except that the text is
9880 searched for anywhere in the message's headers or body, not just in the
9881 contents of a particular header field.
9882 <P>
9883
9884 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
9885
9886 BodyText patterns are just like header patterns except that the text is
9887 searched for anywhere in the message's body, not just in the
9888 contents of a particular header field.
9889 <P>
9890
9891 If there is more than one header pattern or AllText pattern or BodyText pattern
9892 for which you want to take the
9893 same action there is a shorthand notation that may be used.
9894 Any of these patterns may be a list of patterns instead of
9895 just a single pattern.
9896 If any one of the patterns in the list matches the message
9897 then it is considered a match.
9898 For example, if &quot;company1&quot; and &quot;company2&quot; both required
9899 you to use the same role when replying to messages, you might have
9900 a To pattern that looks like
9901 <P>
9902 <PRE>
9903  To pattern = company1.com
9904               company2.com
9905 </PRE>
9906 <P>
9907 This means that if the mail you are replying to was addressed to
9908 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
9909 then this Pattern is a match and the same actions will be taken.
9910 <P>
9911 The meaning of an AllText or BodyText pattern may be negated with the
9912 &quot;!&quot; &quot;toggle NOT&quot; command.
9913 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9914 &quot;!&quot; at the beginning of the pattern line.
9915 When the &quot;!&quot; is present, it reverses the meaning of the match.
9916 <P>
9917 A technicality: Since comma is the character used to separate multiple values
9918 in any of the fields that may have multiple values (such as header patterns,
9919 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
9920 you must escape comma with a
9921 backslash (&#92;) if you want to include a literal comma in one of those fields.
9922 In other words, if you type a backslash followed by a comma it will
9923 be interpreted as a comma by Alpine, instead of as a separator between
9924 pattern values.
9925 All other backslashes (those not followed by a comma) are literal
9926 backslashes and should not be escaped.
9927 It's unlikely you'll ever need to enter a literal comma or backslash in
9928 any of the patterns.
9929
9930 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
9931
9932 The &quot;Current Folder Type&quot; may be set to one of four different
9933 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
9934 &quot;Specific&quot;.
9935 If the value is set to &quot;News&quot;, then the
9936 Pattern will only match if the currently open folder is a newsgroup.
9937 The value &quot;Email&quot; only matches if the current folder is not news and
9938 the value &quot;Any&quot; causes any folder to match.
9939 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
9940 then you must fill in a value for &quot;Folder&quot;, which is on the line
9941 below the &quot;Specific&quot; line.
9942 In this case you will only get a match if the currently open folder is
9943 the specific folder you list.
9944 You may give a list of folders instead of just a single
9945 folder name, in which case the Pattern will match if the open folder is
9946 any one of the folders in the list.
9947 The name of each folder in the list may be either &quot;INBOX&quot;,
9948 the technical specification
9949 of the folder (like what appears in your configuration file) or, if the
9950 folder is one of your incoming folders, it may be the nickname you've given
9951 the folder.
9952 Here are some samples of specific folder names:
9953 <P>
9954 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
9955 <P>
9956 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
9957 <P>
9958 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
9959 <P>
9960 The easiest way to fill in the &quot;Folder&quot; field is to use
9961 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
9962 highlighted, or to use the &quot;Take&quot; command with the configuration
9963 feature
9964 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
9965 turned on.
9966 <P>
9967 When reading a newsgroup, there may be a performance penalty
9968 incurred when collecting the information necessary to check whether
9969 or not a Pattern matches a message.
9970 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
9971 If you have Patterns with a Current Folder Type of either
9972 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
9973 Index Line Coloring or Scoring, you may experience
9974 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
9975
9976 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
9977
9978 The &quot;Age Interval&quot; may be set to an interval of message
9979 ages that should be considered a match.
9980 Like the other parts of the Pattern, if it is unset it will be ignored.
9981 The Age Interval looks like
9982 <P>
9983 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
9984 <P>
9985 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
9986 than or equal to zero.
9987 The special value &quot;INF&quot; may be used for
9988 the max value. It represents infinity.
9989 <P>
9990 Actually, this option may be defined as a list of intervals instead
9991 of just a single interval.
9992 The list is separated by commas.
9993 It can look like
9994 <P>
9995 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
9996 <P>
9997 When there is an Age Interval defined, it is a match if the age, in days, of
9998 the message is contained in any of the intervals.
9999 The intervals include both endpoints.
10000 <P>
10001 Even though this option is called Age, it isn't actually
10002 the <EM>age</EM> of the message.
10003 Instead, it is how many days ago the message arrived in one of your folders.
10004 If the current time is a little past midnight, then a message that arrived
10005 just before midnight arrived yesterday, even though the message is only
10006 a few minutes old.
10007 By default, the date being used is not the date in the Date
10008 header of the message.
10009 It is the date that the message arrived in one of your folders.
10010 When you Save a message from one folder to another that arrival date
10011 is preserved.
10012 If you would like to use the date in the Date header that is possible.
10013 Turn on the option
10014 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
10015 near the bottom of the rule definition.
10016 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
10017
10018 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
10019
10020 The &quot;Size Interval&quot; may be set to an interval of message
10021 sizes that should be considered a match.
10022 Like the other parts of the Pattern, if it is unset it will be ignored.
10023 The Size Interval looks like
10024 <P>
10025 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
10026 <P>
10027 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
10028 than or equal to zero.
10029 The special value &quot;INF&quot; may be used for
10030 the max value. It represents infinity.
10031 <P>
10032 Actually, this option may be defined as a list of intervals instead
10033 of just a single interval.
10034 The list is separated by commas.
10035 It can look like
10036 <P>
10037 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
10038 <P>
10039 When there is a Size Interval defined, it is a match if the size, in bytes, of
10040 the message is contained in any of the intervals.
10041 The intervals include both endpoints.
10042
10043 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
10044
10045 The &quot;Score Interval&quot; may be set to an interval of message
10046 scores that should be considered a match.
10047 Like the other parts of the Pattern, if it is unset it will be ignored.
10048 The Score Interval looks like
10049 <P>
10050 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
10051 <P>
10052 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
10053 negative integers, with min_score less than or equal to max_score.
10054 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
10055 the min and max values to represent negative and positive infinity.
10056 <P>
10057 Actually, a list of intervals may be used if you wish.
10058 A list would look like
10059 <P>
10060 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
10061 <P>
10062 When there is a Score Interval defined, it is a match if the score for
10063 the message is contained in any of the intervals in the list.
10064 The intervals include the endpoints.
10065 The score for a message is calculated by looking at every Score rule defined and
10066 adding up the Score Values for the ones that match the message.
10067 When deciding whether or not a Pattern matches a message for purposes of
10068 calculating the score, the Score Interval is ignored.
10069
10070 <H3><A NAME="pattern_message_status">Message Status</A></H3>
10071
10072 There are five separate message status settings.
10073 By default, all five are set to the value &quot;Don't care&quot;, which
10074 will match any message.
10075 The value &quot;Yes&quot; means that the particular status must be true
10076 for a match, and the value &quot;No&quot; means that the particular
10077 status must not be true for a match.
10078 For example, one of the five Message Status settings is whether a message
10079 is marked Important or not.
10080 A &quot;Yes&quot; means that the message must be Important to be
10081 considered a match and &quot;No&quot; means that the message must not be
10082 Important to be considered a match.
10083 The same is true of the other four message status settings that depend
10084 on whether or not the message is New; whether the message has
10085 been Answered or not; whether the message has been Deleted or not, and
10086 whether the message is Recent or not.
10087 <P>
10088 The nomenclature for New and Recent is a bit confusing:
10089 <P>
10090 New means that the message is Unseen.
10091 It could have been in your mailbox for a long time but if you haven't looked
10092 at it, it is still considered New.
10093 That matches the default Alpine index display that shows an N for such a
10094 message.
10095 <P>
10096 Recent means that the message was added to this folder since the last time
10097 you opened the folder.
10098 Alpine also shows an N by default for these types of messages.
10099 If you were to run two copies of Alpine that opened a folder one right after
10100 the other, a message would only show up as Recent in (at most) the first
10101 Alpine session.
10102
10103 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
10104
10105 Keywords are similar to Message Status, but they are chosen by the user.
10106 Provided the mail server allows for it, you may add a set of possible keywords
10107 to a folder and then you may set those keywords or not for each message
10108 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
10109 The syntax of this part of the Pattern is similar to the header patterns.
10110 It is a list of keywords.
10111 The Keyword part of the Pattern is a match if the message has any of
10112 the keywords in the list set.
10113 Like other parts of the Pattern, if this is unset it will be ignored.
10114
10115 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
10116
10117 A message may use one or more character sets.
10118 This part of the Pattern matches messages that make use of one or more of
10119 the character sets specified in the pattern.
10120 It will be considered a match if a message uses any of the character
10121 sets in the list you give here.
10122
10123 <P>
10124 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
10125 GB2312) you may also use some shorthand names that Alpine provides.
10126 These names are more understandable shorthand names for sets of
10127 character set names.
10128 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
10129 Selecting one of these shorthand names is equivalent to selecting all of
10130 the character sets that make up the set.
10131 You can see all of these shorthand names and the lists of character sets
10132 they stand for by typing the &quot;T&quot; command with the Character
10133 Set pattern highlighted.
10134 The syntax of this part of the Pattern is similar to the header patterns
10135 and the Message Keywords pattern.
10136 It is a list of character sets (or shorthand names).
10137 The Character Set part of the Pattern is a match if the message uses any
10138 of the character sets in the list.
10139 Like other parts of the Pattern, if this is unset it will be ignored.
10140
10141 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
10142
10143 It seems that lots of unwanted email contains unencoded 8-bit characters
10144 in the Subject.
10145 Normally, characters with the 8th bit set are not allowed in the Subject
10146 header unless they are MIME-encoded.
10147 This option gives you a way to match messages that have Subjects that
10148 contain unencoded 8-bit characters.
10149 By default, the value of this option is &quot;Don't care&quot;, which
10150 will match any message.
10151 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
10152 the Subject of the message in order for there to be a match,
10153 and the value &quot;No&quot; is the opposite.
10154 Setting this option will affect performance in large folders because the
10155 subject of each message in the folder has to be checked.
10156
10157 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
10158
10159 This option gives you a way to take some action once per month.
10160 By default, the value of this option is &quot;Don't care&quot;, which
10161 will always match.
10162 The value &quot;Yes&quot; means that this must be the first time Alpine has
10163 been run this month in order to count as a match,
10164 and the value &quot;No&quot; is the opposite.
10165
10166 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
10167
10168 This option gives you a way to take some action once per year.
10169 By default, the value of this option is &quot;Don't care&quot;, which
10170 will always match.
10171 The value &quot;Yes&quot; means that this must be the first time Alpine has
10172 been run this year in order to count as a match,
10173 and the value &quot;No&quot; is the opposite.
10174
10175 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
10176
10177 This option gives you a way to match messages that have an address
10178 that is in one of your address books.
10179 Only the simple entries in your address books are searched.
10180 Address book distribution lists are ignored!
10181 By default, the value of this option is &quot;Don't care&quot;, which
10182 will match any message.
10183 The value &quot;Yes, in any address book&quot; means the address
10184 from the message must be in at least one of your
10185 address books in order to be a match.
10186 The value &quot;No, not in any address book&quot;
10187 means none of the addresses may
10188 be in any of your address books in order to be a match.
10189 The values &quot;Yes, in specific address books&quot; and
10190 &quot;No, not in any of specific address books&quot; are similar but instead
10191 of depending on all address books you are allowed to give a list of address
10192 books to look in.
10193 The addresses from the message that are checked for are determined by the
10194 setting you have for &quot;Types of addresses to check for in address book&quot;.
10195 If you set this to &quot;From&quot; the From address from the message will
10196 be looked up in the address book.
10197 If you set it to only &quot;To&quot; then the To addresses will be used.
10198 If any of the To addresses are in the address book then it is considered
10199 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
10200 You could set it to both From and To, in which case all of the From and To
10201 addresses are used.
10202 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
10203 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
10204 exists or the From address if there is no Reply-To address.
10205 Same for the Sender address.
10206 Setting this option may affect performance in large folders because the
10207 From and Reply-To of each message in the folder have to be checked.
10208
10209 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
10210
10211 This is a command that is run with its standard input set to the message
10212 being checked and its standard output discarded.
10213 The full directory path should be specified.
10214 The command will be run and then its exit status will be checked against
10215 the Exit Status Interval, which defaults to just the value zero.
10216 If the exit status of the command falls in the interval, it is considered
10217 a match, otherwise it is not a match.
10218 <P>
10219
10220 This option may actually be a list of commands.
10221 The first one that exists and is executable is used.
10222 That makes it possible to use the same configuration with Unix Alpine and
10223 PC-Alpine.
10224 <P>
10225
10226 If none of the commands in the list exists and is executable then the rule
10227 is <EM>not</EM> a match.
10228 If it is possible that the command may not exist, you should be careful
10229 to structure your rules so that nothing destructive
10230 happens when the command does not exist.
10231 For example, you might have a filter that filters away spam when there is
10232 a match but does nothing when there is not a match.
10233 That would continue to work correctly if the command didn't exist.
10234 However, if you have a filter that filters away spam when there is not
10235 a match and keeps it when there is a match, that would filter everything
10236 if the categorizer command didn't exist.
10237 <P>
10238 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
10239 setup for the bogofilter filter.
10240
10241 <P>
10242 &lt;End of help on this topic&gt;
10243 </BODY>
10244 </HTML>
10245 ===== h_rules_roles =====
10246 <HTML>
10247 <HEAD>
10248 <TITLE>SETUP ROLES SCREEN</TITLE>
10249 </HEAD>
10250 <BODY>
10251 <H1>SETUP ROLES SCREEN</H1>
10252 <H2>SETUP ROLES COMMANDS</H2>
10253 <!--chtml if pinemode="function_key"-->
10254 <PRE>
10255 Available  Commands -- Group 1         Available Commands -- Group 2
10256 -------------------------------        ------------------------------
10257 F1  Show Help Text                      F1  Show Help Text
10258 F2  See commands in next group          F2  See commands in next group
10259 F3  Back to MAIN Alpine menu
10260 F4  Change configuration for role
10261 F5  Move to previous role               F5  Include file in role config
10262 F6  Move to next role                   F6  Exclude file from config
10263 F7  Previous page of roles
10264 F8  Next page of roles
10265 F9  Add new role                        F9  Replicate existing role
10266 F10 Delete existing role
10267 F11 Shuffle the order of roles
10268 F12 Whereis (search role nicknames)
10269 </PRE>
10270 <!--chtml else-->
10271 <PRE>
10272 Navigation                     General Alpine Commands
10273 -------------------------      -----------------------
10274  P  Prev Role                     ?  Display this help text
10275  N  Next Role                     E  Back to MAIN Alpine menu
10276  -  Previous page
10277 Spc (space bar) Next page
10278  W  WhereIs (search for word in role nicknames)
10279
10280 Setup Roles Commands
10281 ------------------------------------------------
10282  A  Add new role                  $  Shuffle the order of roles
10283  D  Delete existing role          C  Change configuration for highlighted role
10284  R  Replicate existing role
10285  I  Include file in role config   X  Exclude file from role config
10286 </PRE>
10287 <!--chtml endif-->
10288
10289 <H2>Description of the Setup Roles Screen</H2>
10290
10291 This screen lets you add, delete, modify, or change the order of the rules
10292 that determine the role you are playing when composing a message.
10293 <P>
10294 You may play different roles depending on who you are replying to.
10295 For example, if you are replying to a message addressed to help-desk you
10296 may be acting as a Help Desk Worker.
10297 That role may require that you use a different return address and/or
10298 a different signature.
10299 <P>
10300 Roles are optional.
10301 If you set up roles they work like this:  Each role has a set of
10302 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
10303 considered for a particular use; a &quot;Pattern&quot;,
10304 which is used to decide which of the eligible roles is used; and a set
10305 of &quot;Actions&quot;, which are taken when that role is used.
10306 When you reply to a message, the message you are replying to is compared
10307 with the Patterns of the roles marked as eligible for use when replying.
10308 The comparisons start with the first eligible role and keep going until there
10309 is a match.
10310 If a match is found, the matching role's Actions are taken.
10311 <P>
10312 It is also possible to set a default role and to change that role during
10313 your Alpine session.
10314 When you start Alpine no default role will be set.
10315 You may set or change the current default role by using the &quot;D&quot;
10316 command in the role selection screen.
10317 You'll see that screen while composing a message and being asked to select
10318 a role.
10319 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
10320 compose a message.
10321 You may find a default role useful if you normally perform the duties of one
10322 of your roles for a while, then you switch to another role and stay in the
10323 new role for another period of time.
10324 It may be easier than using the Role Command to select the role each time you
10325 compose a message.
10326
10327 <H2>Role Uses</H2>
10328
10329 There are three types of use to be configured;
10330 one for Replying, one for Forwarding, and one for Composing.
10331 These indicate whether or not you want a role to be considered when you
10332 type the Reply, Forward, or Compose commands.
10333 (The Role command is an alternate form of the Compose command, and it is
10334 not affected by these settings.)
10335 Each of these Use types has three possible values.
10336 The value &quot;Never&quot;
10337 means that the role will never be considered as a candidate for use with
10338 the corresponding command.
10339 For example, if you set a role's Reply Use to Never, then when you Reply to
10340 a message, that role won't even be considered.
10341 (That isn't quite true. If the message you are replying to matches some other
10342 role that requires confirmation,
10343 then there will be a ^T command available which allows you to select a role
10344 from all of your roles, not just the reply-eligible roles.)
10345 <P>
10346
10347 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
10348 both mean that you do want to consider this role when using the corresponding
10349 command.
10350 For either of these settings the role's Pattern will
10351 be checked to see if it matches the message.
10352 For Reply Use, the message used to compare the Pattern with is the message
10353 being replied to.
10354 For Forward Use, the message used to compare the Pattern with is the message
10355 being forwarded.
10356 For Compose Use, there is no message, so the parts of the Pattern that depend
10357 on a message (everything other than Current Folder Type) are ignored.
10358 In all cases, the Current Folder Type is checked if defined.
10359 If there is a match then this role will either be used without confirmation
10360 or will be the default when confirmation is asked for, depending on
10361 which of the two options is selected.
10362 If confirmation is requested, you will have a chance to
10363 choose No Role instead of the offered role, or to
10364 change the role to any one of your other roles (with the ^T command).
10365
10366 <H2>Role Patterns</H2>
10367
10368 In order to determine whether or not a message matches a role the message is
10369 compared with the Role's Pattern.
10370 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10371 Scoring, Other Rules, and Search Rules, so are described in only one place,
10372 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10373 <P>
10374 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
10375 a role that has all header patterns unset, the AllText pattern unset,
10376 the BodyText pattern unset,
10377 the Score Interval unset, and the Current Folder Type set to
10378 &quot;Any&quot; may be used as a default role.
10379 It should be put last in the list of roles since the matching
10380 starts at the beginning and proceeds until one of the roles is a match.
10381 If no roles at all match, then Alpine will
10382 use its regular methods of defining the role.
10383 If you wanted to, you could define a different &quot;default&quot; role
10384 for Replying, Forwarding, and Composing by setting the
10385 &quot;Use&quot; fields appropriately.
10386
10387 <H2>Role Actions</H2>
10388
10389 Once a role match is found, the role's Actions are taken.
10390 For each role there are several possible actions that may be defined.
10391 They are actions to set the From address, the Reply-To address,
10392 the Fcc, the Signature, the Template file, and Other Headers.
10393
10394 <H3>Set From</H3>
10395
10396 The From address is the address used on the From line of the message
10397 you are sending.
10398
10399 <H3>Set Reply-To</H3>
10400
10401 The Reply-To address is the address used on the Reply-To line of the message
10402 you are sending.
10403 You don't need a Reply-To address unless it is different from the From address.
10404
10405 <H3>Set Other Headers</H3>
10406
10407 If you want to set the value of the From or Reply-To headers, use
10408 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
10409 If you want to set the values of other headers, use this field.
10410 This field is similar to the
10411 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
10412 Each header you specify here must include the header tag
10413 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
10414 and may optionally include a value for that header.
10415 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
10416 for a header here will replace any value that already exists.
10417 For example, if you are Replying to a message there will be at least one
10418 address in the To header (the address you are Replying to).
10419 However, if you Reply using a role that sets the To header, that role's
10420 To header value will be used instead.
10421
10422 <H3>Set Fcc</H3>
10423
10424 The Fcc is used as the Fcc for the message you are sending.
10425
10426 <H3>Set Signature or Set LiteralSig</H3>
10427
10428 The Signature is the name of a file to be used as the signature file when
10429 this role is being used.
10430 If the name of the file has a vertical bar following it (|)
10431 then it is assumed that the file is a program that should be run to
10432 produce the signature.
10433 If the LiteralSig is set, then it is used instead of the signature file.
10434 LiteralSig is just a different way to store the signature.
10435 It is stored in the pine configuration file instead of in a separate
10436 signature file.
10437 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
10438 either in the role or as the default signature in the Setup/Config screen,
10439 then the signature file is ignored.
10440
10441 <H3>Set Template</H3>
10442
10443 A Template is the name of a file to be included in the message when this
10444 role is being used.
10445 If the name of the file has a vertical bar following it (|)
10446 then it is assumed that the file is a program that should be run to
10447 produce the template.
10448
10449 <P>
10450 Both signature files and template files may be stored remotely on an IMAP
10451 server.
10452 In order to do that you just give the file a remote name.
10453 This works just like the regular
10454 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
10455 option that is configured from the Setup/Configuration screen.
10456 A remote signature file name might look like:
10457 <P>
10458 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
10459 <P>
10460 Once you have named the remote signature or template file you create its
10461 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
10462 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
10463 line of the role editor.
10464
10465 <P>
10466 Both signature files and template files (or the output of signature programs
10467 and template file programs) may contain special tokens
10468 that are replaced with contents
10469 that depend on the message being replied to or forwarded.
10470 See the help for the individual fields inside the role editor for more
10471 information on tokens.
10472
10473 <H3>Use SMTP Server</H3>
10474
10475 If this field has a value, then it will be used as the SMTP server
10476 to send mail when this role is being used (unless the SMTP server variable
10477 is set in the system-wide fixed configuration file).
10478 It has the same semantics as the
10479 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
10480 variable in the Setup/Config screen.
10481 When you postpone the composition this SMTP server list will be saved
10482 with the postponed composition and it cannot be changed later.
10483 Because of that, you may want to make this a list of SMTP servers
10484 with the preferred server at the front of the list and alternate servers
10485 later in the list.
10486
10487 <P>
10488 If any of the actions are left unset, then the action depends on what
10489 is present in the &quot;Initialize settings using role&quot; field.
10490 If you've listed the nickname of another one of your roles there, then the
10491 corresponding action from that role will be used here.
10492 If that action is also blank, or if there is no nickname specified,
10493 then Alpine will do whatever it normally does to set these actions.
10494 This depends on other configuration options and features you've set.
10495
10496 <H2>Command Descriptions</H2>
10497
10498 <H3>Add</H3>
10499
10500 The Add command is used to add a new role definition to your set of
10501 roles.
10502 The new role will be added after the highlighted role.
10503
10504 <H3>Delete</H3>
10505
10506 The Delete command deletes the currently highlighted role.
10507
10508 <H3>Change</H3>
10509
10510 The Change command lets you edit the nickname, Uses, Pattern,
10511 and Actions of the currently highlighted role.
10512
10513 <H3>Shuffle</H3>
10514
10515 The Shuffle command allows you to change the order of the roles.
10516 You may move the currently highlighted role up or down in the list.
10517 The order of the roles is important since the roles are tested for a
10518 match starting with the first role and continuing until a match is found.
10519 You should place the roles with more specific Patterns near the beginning
10520 of the list, and those with more general Patterns near the end so that
10521 the more specific matches will happen when appropriate.
10522
10523 <H3>Replicate</H3>
10524
10525 The Replicate command is used to copy an existing role and modify it.
10526 The new role will be added after the highlighted role.
10527
10528 <H3>IncludeFile</H3>
10529
10530 The IncludeFile command allows you to add a roles file to your configuration.
10531 Usually, your roles will be contained in your Alpine configuration file.
10532 If you wish, some or all of your roles may be stored in a separate file.
10533 If a roles file already exists (maybe it was made by somebody else using
10534 Alpine), you may insert it before the currently highlighted role.
10535 You may also insert an empty file or a file that does not yet exist.
10536 Once you have an empty roles file in your configuration, you may use
10537 the Shuffle command to move roles into it.
10538 In fact, that's the only way to get the initial role into the file.
10539
10540 <H3>eXcludeFile</H3>
10541
10542 The eXcludeFile command removes a roles file from your roles configuration.
10543 A limitation of the program is that in order to exclude a roles file
10544 that file must have at least one role
10545 in it, otherwise you won't be able to highlight a line in the file.
10546 So you may have to add a dummy role to the file in order to exclude the file.
10547 <P><UL>
10548 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10549 </UL>
10550 <P>
10551 &lt;End of help on this topic&gt;
10552 </BODY>
10553 </HTML>
10554 ===== h_rules_other =====
10555 <HTML>
10556 <HEAD>
10557 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
10558 </HEAD>
10559 <BODY>
10560 <H1>SETUP OTHER RULES SCREEN</H1>
10561 <H2>SETUP OTHER RULES COMMANDS</H2>
10562 <!--chtml if pinemode="function_key"-->
10563 <PRE>
10564 Available  Commands -- Group 1         Available Commands -- Group 2
10565 -------------------------------        ------------------------------
10566 F1  Show Help Text                      F1  Show Help Text
10567 F2  See commands in next group          F2  See commands in next group
10568 F3  Back to MAIN Alpine menu
10569 F4  Change configuration for rule
10570 F5  Move to previous rule               F5  Include file in rule config
10571 F6  Move to next rule                   F6  Exclude file from config
10572 F7  Previous page of rules
10573 F8  Next page of rules
10574 F9  Add new rule                        F9  Replicate existing rule
10575 F10 Delete existing rule
10576 F11 Shuffle the order of rules
10577 F12 Whereis (search rule nicknames)
10578 </PRE>
10579 <!--chtml else-->
10580 <PRE>
10581 Navigation                     General Alpine Commands
10582 -------------------------      -----------------------
10583  P  Prev rule                     ?  Display this help text
10584  N  Next rule                     E  Back to MAIN Alpine menu
10585  -  Previous page
10586 Spc (space bar) Next page
10587  W  WhereIs (search for word in rule nicknames)
10588
10589 Setup Other Rules Commands
10590 ------------------------------------------------
10591  A  Add new rule                  $  Shuffle the order of rules
10592  D  Delete existing rule          C  Change configuration for highlighted rule
10593  R  Replicate existing rule
10594  I  Include file in rule config   X  Exclude file from rule config
10595 </PRE>
10596 <!--chtml endif-->
10597
10598 <H2>Description of the Setup Other Rules Screen</H2>
10599
10600 This is where you may set various actions that do not fit well into the
10601 other Rules categories.
10602
10603 <H2>Patterns</H2>
10604
10605 Other Rules are a little different from the rest of the Rules because
10606 they depend only on the current folder, and not on a particular message.
10607 In order to determine whether or not a rule's actions should be applied
10608 the current folder is compared with the rule's Pattern, which consists
10609 of only the Current Folder Type.
10610 Current Folder Type works the same for Other Rules as it does for Roles,
10611 Filtering, Index Coloring, and Scoring.
10612 Keep in mind that the only part of the Pattern that applies to Other
10613 Rules is the Current Folder Type when looking at the description of
10614 Patterns given
10615 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10616
10617 <H2>The Actions</H2>
10618
10619 <H3>Set Sort Order</H3>
10620
10621 When you enter a new folder, these rules will be checked to see if you
10622 have set a sort order that is different from your default sort order.
10623 The default is set in the Setup/Config screen with
10624 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
10625 If the Sort Order action is set, then the folder will be displayed sorted in
10626 that sort order instead of in the default order.
10627 <P>
10628 A possible point of confusion arises when you change the configuration
10629 of the Sort Order for the currently open folder.
10630 The folder will normally be re-sorted when you go back to viewing the
10631 index.
10632 However, if you have manually sorted the folder with the
10633 Sort
10634 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
10635 command, then it will not be re-sorted until the next time it is opened.
10636
10637 <H3>Set Index Format</H3>
10638
10639 When you enter a new folder, these rules will be checked to see if you
10640 have set an Index Format that is different from your default Index Format,
10641 which is set with the
10642 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
10643 If so, the index will be displayed with this format instead of the default.
10644
10645 <H3>Set Startup Rule</H3>
10646
10647 When you enter a new folder, these rules will be checked to see if you
10648 have set a startup rule that is different from the default startup rule.
10649 The default for incoming folders is set in the Setup/Config screen with
10650 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
10651 The default for folders other than INBOX that are not part of your
10652 incoming collection
10653 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
10654 is to start with the last message in the folder.
10655 If the Startup Rule is set to something other than &quot;default&quot;,
10656 then the rule will determine which message will be the current message when
10657 the folder is first opened.
10658 <P>
10659 The various startup rule possibilities work the same here as they do in
10660 the incoming collection, so check
10661 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
10662 for more help.
10663
10664 <H2>Command Descriptions</H2>
10665
10666 <H3>Add</H3>
10667
10668 The Add command is used to add a new rule definition to your set of
10669 rules.
10670 The new rule will be added after the highlighted rule.
10671
10672 <H3>Delete</H3>
10673
10674 The Delete command deletes the currently highlighted rule.
10675
10676 <H3>Change</H3>
10677
10678 The Change command lets you edit the nickname, Pattern,
10679 and Action of the currently highlighted rule.
10680
10681 <H3>Shuffle</H3>
10682
10683 The Shuffle command allows you to change the order of the rules.
10684 You may move the currently highlighted rule up or down in the list.
10685 The order of the rules is important since the rules are tested for a
10686 match starting with the first rule and continuing until a match is found.
10687 You should place the rules with more specific Patterns near the beginning
10688 of the list, and those with more general Patterns near the end so that
10689 the more specific matches will happen when appropriate.
10690
10691 <H3>Replicate</H3>
10692
10693 The Replicate command is used to copy an existing rule definition and modify it.
10694 The new rule will be added after the highlighted rule.
10695
10696 <H3>IncludeFile</H3>
10697
10698 The IncludeFile command allows you to add a rules file to your configuration.
10699 Usually, your rules will be contained in your Alpine configuration file.
10700 If you wish, some or all of your rules may be stored in a separate file.
10701 If a rules file already exists (maybe it was made by somebody else using
10702 Alpine), you may insert it before the currently highlighted rule.
10703 You may also insert an empty file or a file that does not yet exist.
10704 Once you have an empty rules file in your configuration, you may use
10705 the Shuffle command to move rules into it.
10706 In fact, that's the only way to get the initial rule into the file.
10707
10708 <H3>eXcludeFile</H3>
10709
10710 The eXcludeFile command removes a rules file from your rules configuration.
10711 A limitation of the program is that in order to exclude a rules file
10712 that file must have at least one rule
10713 in it, otherwise you won't be able to highlight a line in the file.
10714 So you may have to add a dummy rule to the file in order to exclude the file.
10715 <P><UL>
10716 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10717 </UL>
10718 <P>
10719 &lt;End of help on this topic&gt;
10720 </BODY>
10721 </HTML>
10722 ===== h_rules_srch =====
10723 <HTML>
10724 <HEAD>
10725 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
10726 </HEAD>
10727 <BODY>
10728 <H1>SETUP SEARCH RULES SCREEN</H1>
10729 <H2>SETUP SEARCH RULES COMMANDS</H2>
10730 <!--chtml if pinemode="function_key"-->
10731 <PRE>
10732 Available  Commands -- Group 1         Available Commands -- Group 2
10733 -------------------------------        ------------------------------
10734 F1  Show Help Text                      F1  Show Help Text
10735 F2  See commands in next group          F2  See commands in next group
10736 F3  Back to MAIN Alpine menu
10737 F4  Change configuration for rule
10738 F5  Move to previous rule               F5  Include file in rule config
10739 F6  Move to next rule                   F6  Exclude file from config
10740 F7  Previous page of rules
10741 F8  Next page of rules
10742 F9  Add new rule                        F9  Replicate existing rule
10743 F10 Delete existing rule
10744 F11 Shuffle the order of rules
10745 F12 Whereis (search rule nicknames)
10746 </PRE>
10747 <!--chtml else-->
10748 <PRE>
10749 Navigation                     General Alpine Commands
10750 -------------------------      -----------------------
10751  P  Prev rule                     ?  Display this help text
10752  N  Next rule                     E  Back to MAIN Alpine menu
10753  -  Previous page
10754 Spc (space bar) Next page
10755  W  WhereIs (search for word in rule nicknames)
10756
10757 Setup Search Rules Commands
10758 ------------------------------------------------
10759  A  Add new rule                  $  Shuffle the order of rules
10760  D  Delete existing rule          C  Change configuration for highlighted rule
10761  R  Replicate existing rule
10762  I  Include file in rule config   X  Exclude file from rule config
10763 </PRE>
10764 <!--chtml endif-->
10765
10766 <H2>Description of the Setup Search Rules Screen</H2>
10767
10768 One of the commands that becomes available when that feature is turned on
10769 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
10770 screen to select a set of messages.
10771 One way of selecting messages is to use a Rule.
10772 All of the messages that match (or don't match if you wish)
10773 a Rule's Pattern will be selected.
10774 <P>
10775 Any of your Rules may be used for this purpose.
10776 You might already have Rules set up for filtering, index line color, scores, or roles;
10777 and you may use any of those Rules with the Select command.
10778 However, you might find it more convenient to set up a separate set of Rules
10779 just for this purpose without having to worry about what other effects
10780 they may cause.
10781 That is the purpose of these Select Rules.
10782
10783 <P>
10784 Each rule has a &quot;Pattern&quot;
10785 that is used to decide which messages are selected when you use it with
10786 the Select command.
10787
10788 <H2>Patterns</H2>
10789
10790 In order to determine whether or not a message should be selected
10791 the message is compared with the rule's Pattern.
10792 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10793 Scoring, Other Rules, and Search Rules, so are described in only one place,
10794 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10795
10796 <H2>Command Descriptions</H2>
10797
10798 <H3>Add</H3>
10799
10800 The Add command is used to add a new rule definition to your set of
10801 rules.
10802 The new rule will be added after the highlighted rule.
10803
10804 <H3>Delete</H3>
10805
10806 The Delete command deletes the currently highlighted rule.
10807
10808 <H3>Change</H3>
10809
10810 The Change command lets you edit the nickname and Pattern
10811 of the currently highlighted rule.
10812
10813 <H3>Shuffle</H3>
10814
10815 The Shuffle command allows you to change the order of the rules.
10816 This affects only the order they are presented in when you use the
10817 ^T subcommand of the Select by Rule command.
10818 You may move the currently highlighted rule up or down in the list.
10819
10820 <H3>Replicate</H3>
10821
10822 The Replicate command is used to copy an existing rule definition and modify it.
10823 The new rule will be added after the highlighted rule.
10824
10825 <H3>IncludeFile</H3>
10826
10827 The IncludeFile command allows you to add a rules file to your configuration.
10828 Usually, your rules will be contained in your Alpine configuration file.
10829 If you wish, some or all of your rules may be stored in a separate file.
10830 If a rules file already exists (maybe it was made by somebody else using
10831 Alpine), you may insert it before the currently highlighted rule.
10832 You may also insert an empty file or a file that does not yet exist.
10833 Once you have an empty rules file in your configuration, you may use
10834 the Shuffle command to move rules into it.
10835 In fact, that's the only way to get the initial rule into the file.
10836
10837 <H3>eXcludeFile</H3>
10838
10839 The eXcludeFile command removes a rules file from your rules configuration.
10840 A limitation of the program is that in order to exclude a rules file
10841 that file must have at least one rule
10842 in it, otherwise you won't be able to highlight a line in the file.
10843 So you may have to add a dummy rule to the file in order to exclude the file.
10844 <P><UL>
10845 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10846 </UL>
10847 <P>
10848 &lt;End of help on this topic&gt;
10849 </BODY>
10850 </HTML>
10851 ===== h_rules_incols =====
10852 <HTML>
10853 <HEAD>
10854 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
10855 </HEAD>
10856 <BODY>
10857 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
10858 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
10859 <!--chtml if pinemode="function_key"-->
10860 <PRE>
10861 Available  Commands -- Group 1         Available Commands -- Group 2
10862 -------------------------------        ------------------------------
10863 F1  Show Help Text                      F1  Show Help Text
10864 F2  See commands in next group          F2  See commands in next group
10865 F3  Back to MAIN Alpine menu
10866 F4  Change configuration for rule
10867 F5  Move to previous rule               F5  Include file in rule config
10868 F6  Move to next rule                   F6  Exclude file from config
10869 F7  Previous page of rules
10870 F8  Next page of rules
10871 F9  Add new rule                        F9  Replicate existing rule
10872 F10 Delete existing rule
10873 F11 Shuffle the order of rules
10874 F12 Whereis (search rule nicknames)
10875 </PRE>
10876 <!--chtml else-->
10877 <PRE>
10878 Navigation                     General Alpine Commands
10879 -------------------------      -----------------------
10880  P  Prev rule                     ?  Display this help text
10881  N  Next rule                     E  Back to MAIN Alpine menu
10882  -  Previous page
10883 Spc (space bar) Next page
10884  W  WhereIs (search for word in rule nicknames)
10885
10886 Setup Index Color Commands
10887 ------------------------------------------------
10888  A  Add new rule                  $  Shuffle the order of rules
10889  D  Delete existing rule          C  Change configuration for highlighted rule
10890  R  Replicate existing rule
10891  I  Include file in rule config   X  Exclude file from rule config
10892 </PRE>
10893 <!--chtml endif-->
10894
10895 <H2>Description of the Setup Index Line Colors Screen</H2>
10896
10897 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
10898 This action is only available if your terminal is capable of displaying
10899 color and color display has been enabled with the
10900 <A HREF="h_config_color_style">Color Style</A> option within the
10901 Setup Color screen.
10902 (In PC-Alpine, color is always enabled so there is no option to turn on.)
10903 This screen lets you add, delete, modify, or change the order of the rules
10904 that cause the lines in the MESSAGE INDEX to be displayed in different
10905 colors.
10906 <P>
10907 Each rule has a &quot;Pattern&quot;,
10908 which is used to decide which of the rules is used; and the color that
10909 is used if the Pattern matches a particular message.
10910
10911 <H2>Index Color Patterns</H2>
10912
10913 In order to determine whether or not a message matches an Index Color Rule
10914 the message is compared with the rule's Pattern.
10915 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10916 Scoring, Other Rules, and Search Rules, so are described in only one place,
10917 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10918
10919 <P>
10920 If none of the Index Color rules is a match for a particular index line,
10921 then the color used is set using
10922 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10923
10924 <H2>Index Line Color</H2>
10925
10926 This is the color that index lines are colored when there is a matching
10927 Pattern.
10928 This colors the whole index line, except possibly the status letters,
10929 which may be colored separately using
10930 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10931
10932 <H2>Command Descriptions</H2>
10933
10934 <H3>Add</H3>
10935
10936 The Add command is used to add a new rule definition to your set of
10937 rules.
10938 The new rule will be added after the highlighted rule.
10939
10940 <H3>Delete</H3>
10941
10942 The Delete command deletes the currently highlighted rule.
10943
10944 <H3>Change</H3>
10945
10946 The Change command lets you edit the nickname, Pattern,
10947 and Index Line Color of the currently highlighted rule.
10948
10949 <H3>Shuffle</H3>
10950
10951 The Shuffle command allows you to change the order of the rules.
10952 You may move the currently highlighted rule up or down in the list.
10953 The order of the rules is important since the rules are tested for a
10954 match starting with the first rule and continuing until a match is found.
10955 You should place the rules with more specific Patterns near the beginning
10956 of the list, and those with more general Patterns near the end so that
10957 the more specific matches will happen when appropriate.
10958
10959 <H3>Replicate</H3>
10960
10961 The Replicate command is used to copy an existing rule definition and modify it.
10962 The new rule will be added after the highlighted rule.
10963
10964 <H3>IncludeFile</H3>
10965
10966 The IncludeFile command allows you to add a rules file to your configuration.
10967 Usually, your rules will be contained in your Alpine configuration file.
10968 If you wish, some or all of your rules may be stored in a separate file.
10969 If a rules file already exists (maybe it was made by somebody else using
10970 Alpine), you may insert it before the currently highlighted rule.
10971 You may also insert an empty file or a file that does not yet exist.
10972 Once you have an empty rules file in your configuration, you may use
10973 the Shuffle command to move rules into it.
10974 In fact, that's the only way to get the initial rule into the file.
10975
10976 <H3>eXcludeFile</H3>
10977
10978 The eXcludeFile command removes a rules file from your rules configuration.
10979 A limitation of the program is that in order to exclude a rules file
10980 that file must have at least one rule
10981 in it, otherwise you won't be able to highlight a line in the file.
10982 So you may have to add a dummy rule to the file in order to exclude the file.
10983 <P><UL>
10984 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10985 </UL>
10986 <P>
10987 &lt;End of help on this topic&gt;
10988 </BODY>
10989 </HTML>
10990 ===== h_rules_filter =====
10991 <HTML>
10992 <HEAD>
10993 <TITLE>SETUP FILTERING SCREEN</TITLE>
10994 </HEAD>
10995 <BODY>
10996 <H1>SETUP FILTERING SCREEN</H1>
10997 <H2>SETUP FILTERING COMMANDS</H2>
10998 <!--chtml if pinemode="function_key"-->
10999 <PRE>
11000 Available  Commands -- Group 1         Available Commands -- Group 2
11001 -------------------------------        ------------------------------
11002 F1  Show Help Text                      F1  Show Help Text
11003 F2  See commands in next group          F2  See commands in next group
11004 F3  Back to MAIN Alpine menu
11005 F4  Change configuration for filter
11006 F5  Move to previous filter             F5  Include file in filter config
11007 F6  Move to next filter                 F6  Exclude file from config
11008 F7  Previous page of filters
11009 F8  Next page of filters
11010 F9  Add new filter                      F9  Replicate existing filter
11011 F10 Delete existing filter
11012 F11 Shuffle the order of filters
11013 F12 Whereis (search filter nicknames)
11014 </PRE>
11015 <!--chtml else-->
11016 <PRE>
11017 Navigation                     General Alpine Commands
11018 -------------------------      -----------------------
11019  P  Prev Filter                   ?  Display this help text
11020  N  Next Filter                   E  Back to MAIN Alpine menu
11021  -  Previous page
11022 Spc (space bar) Next page
11023  W  WhereIs (search for word in filter nicknames)
11024
11025 Setup Filters Commands
11026 ------------------------------------------------
11027  A  Add new filter                $  Shuffle the order of filters
11028  D  Delete existing filter        C  Change configuration for highlighted filter
11029  R  Replicate existing filter
11030  I  Include file in filter config X  Exclude file from filter config
11031 </PRE>
11032 <!--chtml endif-->
11033
11034 <H2>Description of the Setup Filtering Screen</H2>
11035
11036 This screen lets you add, delete, modify, or change the order of the rules
11037 that determine the filtering Alpine does on folders you view.
11038 <P>
11039 The software that actually delivers mail (the stuff that happens
11040 before Alpine is involved) for you is in a better position to do mail filtering
11041 than Alpine itself.
11042 If possible, you may want to look into using that sort of mail filtering to
11043 deliver mail to different folders, delete it, or forward it.
11044 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
11045 <P>
11046 Filtering is a way to automatically move certain messages from one folder
11047 to another or to delete messages.
11048 It can also be used to set message status (Important, Deleted, New,
11049 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
11050 Alpine doesn't have the ability to forward mail to another address or
11051 to deliver vacation messages.
11052 <P>
11053 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
11054 When a folder is opened, when new mail arrives in an open folder, or
11055 when mail is Expunged from a folder; each
11056 message is compared with the Patterns of your filtering rules.
11057 The comparisons start with the first rule and keep going until there
11058 is a match.
11059 If a match is found, the message may be deleted or moved, depending on
11060 the setting of the Filter Action.
11061 If the message is not deleted, it may have its status altered.
11062
11063 <P>
11064 <EM>NOTE:</EM>
11065 When setting up a Pattern used to delete messages,
11066 it is recommended that you test the Pattern first with a &quot;Move&quot;
11067 folder specified in
11068 case unintended matches occur.  Messages that are deleted will be removed
11069 from the folder and <EM>unrecoverable</EM> from within Alpine after the
11070 next Expunge command or once the folder being filtered has been closed.
11071
11072 <H2>Filter Patterns</H2>
11073
11074 In order to determine whether or not a message matches a filter the message is
11075 compared with the Filter's Pattern.
11076 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11077 Scoring, Other Rules, and Search Rules, so are described in only one place,
11078 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11079 <P>
11080 Since filtering is a potentially destructive action, if you have a filtering
11081 Pattern with nothing other than Current Folder Type set, that filtering
11082 rule is ignored.
11083
11084 <H2>Filter Actions</H2>
11085
11086 Once a filter match is found for a particular message, there are some actions
11087 that may be taken.
11088 First, the message may have its status changed.
11089 This is the same message status that you can manipulate manually using the
11090 <a href="h_common_flag">Flag Command</a>.
11091 There are always four elements of message status that you can control.
11092 You can set or clear the Important status, the New status, the Deleted
11093 status, and the Answered status.
11094 Of course, if the filter is going to delete the message,
11095 then there is no point in setting message status.
11096 You may also be able to set user-defined keywords for a message.
11097 Read a little about keywords in the help text for the
11098 <A HREF="h_common_flag">Flag</A> command.
11099 <P>
11100 Second, the filter may delete or move the message.
11101 Deleting the message marks it Deleted and removes it from view.
11102 It is effectively gone forever (though it technically is still there until
11103 the next expunge command, which may happen implicitly).
11104 Moving the message moves it from the open folder into the folder
11105 listed on the &quot;Folder List&quot; line of the filter configuration.
11106 If you list more than one folder name (separated by commas) then the message
11107 will be copied to each of those folders.
11108 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
11109 message is removed from the current folder.
11110 If you just want to set the messages status without deleting it from
11111 the folder, then set the filter action to
11112 &quot;Just Set Message Status&quot;.
11113 <P>
11114 (There is no way to do a Copy instead of a Move, due to the difficulties
11115 involved in keeping track of whether or not a message has
11116 already been copied.)
11117
11118 <H2>Command Descriptions</H2>
11119
11120 <H3>Add</H3>
11121
11122 The Add command is used to add a new filter definition to your set of
11123 filters.
11124 The new filter will be added after the highlighted filter.
11125
11126 <H3>Delete</H3>
11127
11128 The Delete command deletes the currently highlighted filter.
11129
11130 <H3>Change</H3>
11131
11132 The Change command lets you edit the nickname, Pattern,
11133 and Folder of the currently highlighted filter.
11134
11135 <H3>Shuffle</H3>
11136
11137 The Shuffle command allows you to change the order of the filters.
11138 You may move the currently highlighted filter up or down in the list.
11139 The order of the filters is important since the filters are tested for a
11140 match starting with the first filter and continuing until a match is found.
11141 You should place the filters with more specific Patterns near the beginning
11142 of the list, and those with more general Patterns near the end so that
11143 the more specific matches will happen when appropriate.
11144
11145 <H3>Replicate</H3>
11146
11147 The Replicate command is used to copy an existing filter and modify it.
11148 The new filter will be added after the highlighted filter.
11149
11150 <H3>IncludeFile</H3>
11151
11152 The IncludeFile command allows you to add a filters file to your configuration.
11153 Usually, your filters will be contained in your Alpine configuration file.
11154 If you wish, some or all of your filters may be stored in a separate file.
11155 If a filters file already exists (maybe it was made by somebody else using
11156 Alpine), you may insert it before the currently highlighted filter.
11157 You may also insert an empty file or a file that does not yet exist.
11158 Once you have an empty filters file in your configuration, you may use
11159 the Shuffle command to move filters into it.
11160 In fact, that's the only way to get the initial filter into the file.
11161
11162 <H3>eXcludeFile</H3>
11163
11164 The eXcludeFile command removes a filters file from your filters configuration.
11165 A limitation of the program is that in order to exclude a filters file
11166 that file must have at least one filter
11167 in it, otherwise you won't be able to highlight a line in the file.
11168 So you may have to add a dummy filter to the file in order to exclude the file.
11169 <P><UL>
11170 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11171 </UL>
11172 <P>
11173 <H3>Performance Considerations</H3>
11174 The number and type of patterns being tested can
11175 adversely effect performance.  Issues to be aware
11176 of include:
11177 <P>
11178 <UL>
11179   <LI> The more filters you have defined the longer it will take to run down
11180 the list.  Deleting unused filters is a good idea.
11181   <LI> Filtering in newsgroups served by an NNTP server will be slow
11182 if your patterns include tests other than &quot;From:&quot;
11183 or &quot;Subject:&quot;.
11184 </UL>
11185 <P>
11186 &lt;End of help on this topic&gt;
11187 </BODY>
11188 </HTML>
11189 ===== h_rules_score =====
11190 <HTML>
11191 <HEAD>
11192 <TITLE>SETUP SCORING SCREEN</TITLE>
11193 </HEAD>
11194 <BODY>
11195 <H1>SETUP SCORING SCREEN</H1>
11196 <H2>SETUP SCORING COMMANDS</H2>
11197 <!--chtml if pinemode="function_key"-->
11198 <PRE>
11199 Available  Commands -- Group 1         Available Commands -- Group 2
11200 -------------------------------        ------------------------------
11201 F1  Show Help Text                      F1  Show Help Text
11202 F2  See commands in next group          F2  See commands in next group
11203 F3  Back to MAIN Alpine menu
11204 F4  Change configuration for rule
11205 F5  Move to previous rule               F5  Include file in rule config
11206 F6  Move to next rule                   F6  Exclude file from config
11207 F7  Previous page of rules
11208 F8  Next page of rules
11209 F9  Add new rule                        F9  Replicate existing rule
11210 F10 Delete existing rule
11211 F11 Shuffle the order of rules
11212 F12 Whereis (search rule nicknames)
11213 </PRE>
11214 <!--chtml else-->
11215 <PRE>
11216 Navigation                     General Alpine Commands
11217 -------------------------      -----------------------
11218  P  Prev rule                     ?  Display this help text
11219  N  Next rule                     E  Back to MAIN Alpine menu
11220  -  Previous page
11221 Spc (space bar) Next page
11222  W  WhereIs (search for word in rule nicknames)
11223
11224 Setup Scoring Commands
11225 ------------------------------------------------
11226  A  Add new rule                  $  Shuffle the order of rules
11227  D  Delete existing rule          C  Change configuration for highlighted rule
11228  R  Replicate existing rule
11229  I  Include file in rule config   X  Exclude file from rule config
11230 </PRE>
11231 <!--chtml endif-->
11232
11233 <H2>Description of the Setup Scoring Screen</H2>
11234
11235 Most people will not use scores at all, but if you do use them, here's how
11236 they work in Alpine.
11237 Using this screen, you may define Scoring rules.
11238 The score for a message is calculated by looking at every Score rule defined
11239 and adding up the Score Values for the ones that match the message.
11240 If there are no matches for a message, it has a score of zero.
11241 Message scores may be used a couple of ways in Alpine.
11242
11243 <H3>Sorting by Score</H3>
11244
11245 One of the methods you may use to sort message indexes is to sort by
11246 score.
11247 The scores of all the messages in a folder will be calculated and then
11248 the index will be ordered by placing the messages in order of ascending or
11249 descending score.
11250
11251 <H3>Scores for use in Patterns</H3>
11252
11253 The Patterns used for Roles, Index Line Coloring, and Filtering have a
11254 category labeled &quot;Score Interval&quot;.
11255 When a message is being compared with a Pattern to check for a match, if
11256 the Score Interval is set only messages that have a score somewhere in
11257 the interval are a match.
11258
11259 <H2>Scoring Rule Patterns</H2>
11260
11261 In order to determine whether or not a message matches a scoring rule
11262 the message is compared with the rule's Pattern.
11263 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11264 Scoring, Other Rules, and Search Rules, so are described in only one place,
11265 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11266
11267 <P>
11268 Actually, Scoring rule Patterns are slightly different from the other types of
11269 Patterns because Scoring rule Patterns don't contain a Score Interval.
11270 In other words, when calculating the score for a message, which is done
11271 by looking at the Scoring rule Patterns, scores aren't used.
11272
11273 <H2>Score Value</H2>
11274
11275 This is the value that will be added to the score for a message if the
11276 rule's Pattern is a match.
11277 Each individual Score Value is an integer between -100 and 100, and the
11278 values from matching rules are added together to get a message's score.
11279 There is also a way to extract the value from a particular header of each
11280 message. See the help text for Score Value for further information.
11281
11282 <H2>Command Descriptions</H2>
11283
11284 <H3>Add</H3>
11285
11286 The Add command is used to add a new scoring rule definition.
11287 The new rule will be added after the highlighted rule.
11288
11289 <H3>Delete</H3>
11290
11291 The Delete command deletes the currently highlighted scoring rule.
11292
11293 <H3>Change</H3>
11294
11295 The Change command lets you edit the nickname, Pattern,
11296 and Score Value of the currently highlighted scoring rule.
11297
11298 <H3>Shuffle</H3>
11299
11300 The Shuffle command allows you to change the order of the scoring rules.
11301 You may move the currently highlighted rule up or down in the list.
11302 The order of the rules is important since the rules are tested for a
11303 match starting with the first rule and continuing until a match is found.
11304 You should place the rules with more specific Patterns near the beginning
11305 of the list, and those with more general Patterns near the end so that
11306 the more specific matches will happen when appropriate.
11307
11308 <H3>Replicate</H3>
11309
11310 The Replicate command is used to copy an existing rule and modify it.
11311 The new rule will be added after the highlighted rule.
11312
11313 <H3>IncludeFile</H3>
11314
11315 The IncludeFile command allows you to add a rules file to your configuration.
11316 Usually, your rules will be contained in your Alpine configuration file.
11317 If you wish, some or all of your rules may be stored in a separate file.
11318 If a rules file already exists (maybe it was made by somebody else using
11319 Alpine), you may insert it before the currently highlighted rule.
11320 You may also insert an empty file or a file that does not yet exist.
11321 Once you have an empty rules file in your configuration, you may use
11322 the Shuffle command to move rules into it.
11323 In fact, that's the only way to get the initial rule into the file.
11324
11325 <H3>eXcludeFile</H3>
11326
11327 The eXcludeFile command removes a rules file from your rules configuration.
11328 A limitation of the program is that in order to exclude a rules file
11329 that file must have at least one rule
11330 in it, otherwise you won't be able to highlight a line in the file.
11331 So you may have to add a dummy rule to the file in order to exclude the file.
11332 <P><UL>
11333 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11334 </UL>
11335 <P>
11336 &lt;End of help on this topic&gt;
11337 </BODY>
11338 </HTML>
11339 ===== h_direct_config =====
11340 <HTML>
11341 <HEAD>
11342 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
11343 </HEAD>
11344 <BODY>
11345 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
11346 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
11347 <!--chtml if pinemode="function_key"-->
11348 <PRE>
11349 Available  Commands
11350 -------------------------------
11351 F1  Show Help Text
11352 F3  Back to MAIN Alpine menu
11353 F4  Change configuration for directory server
11354 F5  Move to previous directory server
11355 F6  Move to next directory server
11356 F7  Previous page of directory servers
11357 F8  Next page of directory servers
11358 F9  Add new directory server
11359 F10 Delete existing directory server
11360 F11 Shuffle the order of directory servers
11361 F12 Whereis (search directory server titles)
11362 </PRE>
11363 <!--chtml else-->
11364 <PRE>
11365 Navigation                     General Alpine Commands
11366 -------------------------      -----------------------
11367  P  Prev Directory Server         ?  Display this help text
11368  N  Next Directory Server         E  Back to MAIN Alpine menu
11369  -  Previous page
11370 Spc (space bar) Next page
11371  W  WhereIs (search for word in directory server titles)
11372
11373 Setup LDAP Directory Server Commands
11374 ------------------------------------------------
11375  A  Add new directory server      $  Shuffle the order of directory servers
11376  D  Delete existing dir server    C  Change configuration for highlighted server
11377 </PRE>
11378 <!--chtml endif-->
11379
11380 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
11381
11382 This screen lets you add, delete, modify, or change the order of your
11383 directory servers. You may also set some optional behavior for each server.
11384 The &quot;Add Dir&quot; command brings up a blank form to
11385 fill in. You will have to supply at least the name of the LDAP server.
11386 You will often have to supply a search base to be used with that server,
11387 as well. Once the form has been brought up on your screen, there is help
11388 available for each of the options you may set.
11389 <P>
11390 The &quot;Del Dir&quot; command allows you to remove a directory server
11391 from your configuration.
11392 <P>
11393 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
11394 The difference is that instead of bringing up a form for a new server
11395 configuration, you are changing the configuration of an existing entry.
11396 For example, you might want to correct a typing error, change a
11397 nickname, or change one of the options set for that server.
11398 <P>
11399 The &quot;Shuffle&quot; command is used to change the order of directory
11400 servers.
11401 <P><UL>
11402 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11403 </UL>
11404 <P>
11405 &lt;End of help on this topic&gt;
11406 </BODY>
11407 </HTML>
11408 ============= h_address_display ========================
11409 <HTML>
11410 <HEAD>
11411 <TITLE>SEARCH RESULTS INDEX</TITLE>
11412 </HEAD>
11413 <BODY>
11414 <H1>SEARCH RESULTS INDEX</H1>
11415 This screen shows the results, if any, of your Directory Server search.
11416 Commands (besides those for screen navigation) are:
11417 <DL>
11418 <DT>View
11419 <!--chtml if pinemode="function_key"-->
11420 (F4)
11421 <!--chtml else-->
11422 (V)
11423 <!--chtml endif-->
11424 </DT>
11425 <DD>See the full information for the selected entry.
11426
11427 <DT>Compose
11428 <!--chtml if pinemode="function_key"-->
11429 (F9)
11430 <!--chtml else-->
11431 (C)
11432 <!--chtml endif--></DT>
11433 <DD>Compose a message with the selected entry as the recipient.
11434
11435 <DT>Role
11436 <!--chtml if pinemode="function_key"-->
11437 (F2)
11438 <!--chtml else-->
11439 (#)
11440 <!--chtml endif--></DT>
11441 <DD>Compose a message with the selected entry as the recipient. This differs
11442 from Compose in that you may select a role before beginning your composition.
11443
11444 <DT>Forward
11445 <!--chtml if pinemode="function_key"-->
11446 (F10)
11447 <!--chtml else-->
11448 (F)
11449 <!--chtml endif--></DT>
11450 <DD>Send the full information for the selected entry as an
11451 email message to someone else.
11452
11453 <DT>Save
11454 <!--chtml if pinemode="function_key"-->
11455 (F11)
11456 <!--chtml else-->
11457 (S)
11458 <!--chtml endif-->
11459 </DT>
11460 <DD>Save to your address book:
11461 <UL>
11462 <LI>the result of the search (as just found through your query) for the
11463 selected entry; or
11464 <LI>the selected entry for repeated Directory Server searching when used
11465 in the future.
11466 </UL>
11467 or<BR>
11468 Export to a file (external to Alpine):
11469 <UL>
11470 <LI>the full information for the selected entry; or
11471 <LI>the email address from the selected entry; or
11472 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
11473 </UL>
11474 <DT>WhereIs
11475 <!--chtml if pinemode="function_key"-->
11476 (F12)
11477 <!--chtml else-->
11478 (W)
11479 <!--chtml endif-->
11480 </DT>
11481 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
11482 displayed text, not the full records for each entry.)
11483 </DL>
11484 &lt;End of help on this topic&gt;
11485 </BODY>
11486 </HTML>
11487 ============= h_address_select ========================
11488 <HTML>
11489 <HEAD>
11490 <TITLE>SEARCH RESULTS INDEX</TITLE>
11491 </HEAD>
11492 <BODY>
11493 <H1>SEARCH RESULTS INDEX</H1>
11494 This screen shows the results, if any, of your Directory Server search.
11495 Commands (besides those for screen navigation) are:
11496 <DL>
11497 <DT>Select
11498 </DT>
11499 <DD>Select this entry for use.
11500
11501 <DT>ExitSelect
11502 <DD>Exit without selecting any of the entries.
11503
11504 <DT>WhereIs
11505 </DT>
11506 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
11507 displayed text, not the full records for each entry.)
11508 </DL>
11509 &lt;End of help on this topic&gt;
11510 </BODY>
11511 </HTML>
11512 ===== h_folder_maint =====
11513 <HTML>
11514 <HEAD>
11515 <TITLE>Help for Folder List</TITLE>
11516 </HEAD>
11517 <BODY>
11518 <H1>FOLDER LIST COMMANDS</H1>
11519 <!--chtml if pinemode="function_key"-->
11520 <PRE>
11521 Available Commands -- Group 1        Available Commands -- Group 2
11522 -------------------------------      ------------------------------
11523 F1  Show Help Text                    F1  Show Help Text
11524 F2  See commands in next group        F2  See commands in next group
11525 F3  MAIN MENU Screen                  F3  Quit Alpine
11526 F4  Select folder and view it         F4  MAIN MENU Screen
11527 F5  Move to previous folder
11528 F6  Move to next folder               F6  Specify a folder to go to
11529 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
11530 F8  Show next screen of listing       F8  Compose a message
11531 F9  Add a new folder                  F9  Print folder listing
11532 F10 Delete selected folder
11533 F11 Rename selected folder
11534 F12 Whereis (search folder names)
11535
11536 Available Commands -- Group 3
11537 F1  Show Help Text
11538 F2  See commands in next group
11539 F5  Go to next new message
11540     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
11541 F8  Compose a message using roles
11542 F9  Export folder to a file
11543 F10 Import the file back to a folder
11544 </PRE>
11545 <!--chtml else-->
11546 <PRE>
11547 Navigating the Folder Screen            Operations on the Selected Folder
11548 ----------------------------            ---------------------------------
11549  P   Move to previous folder              V  View Index of selected folder
11550  N   Move to next folder                  D  Delete
11551  -   Show previous page of listing        R  Rename
11552 Spc  (space bar) Show next page           E  Export to file
11553                                           U  Import from file to folder
11554
11555 FOLDER LIST Screen Commands              General Alpine Command
11556 ---------------------------              -----------------------
11557  A  Add a folder                          O  Show all other available commands
11558  G  Specify a folder to go to             ?  Show Help text
11559  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
11560  W  Whereis (search folder names)         Q  Quit Alpine
11561  %  Print folder listing                  C  Compose a message
11562                                           #  Compose a message using roles
11563 </PRE>
11564 <!--chtml endif-->
11565 <P>
11566 These commands are only available in the FOLDER LIST screen when the
11567 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
11568 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
11569 <DT>Select:</DT>
11570 <DD>Select folders by certain criteria:<UL>
11571 <LI>All: of limited use, since there is no Apply command.
11572 <LI>by Property: <UL>
11573         <LI>folder contains messages not yet seen
11574         <LI>folder contains new messages
11575         <LI>folder contains exactly as many, more, or fewer messages
11576 than a given number
11577         </UL>
11578 <LI>by Text: <UL>
11579         <LI>contained in name of folder (Name Select)
11580         <LI>contained in messages in folder (Content Select)
11581         </UL>
11582 </UL></DD>
11583
11584 <DT>Select current:</DT>
11585 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
11586 add one or more folders to a set created with the Select command described
11587 above.)</DD>
11588 <DT>Zoom mode:</DT>
11589 <DD>Toggles display of only selected folders or all folders on and off.</DD>
11590 </DL>
11591 <P>
11592 If the feature
11593 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
11594 is set then the TAB key will display the number of recent messages and
11595 the total number of messages in the highlighted folder.
11596 <P>
11597 The &quot;Export&quot; command causes the lowest common denominator style
11598 mailbox to be written to a file.
11599 If the file already exists, you are asked if you want to delete it.
11600 If you say No, then the operation is aborted.
11601 Export might be a reasonable way to store a backup or an archival copy of
11602 a folder.
11603 The exported-to file is a local file on the system where you are running Alpine.
11604 The &quot;Import&quot; command is the opposite of the Export command.
11605 It reads a file created by Export and asks where it should save it in your
11606 folders.
11607 This could be a new folder or an existing folder.
11608 If the folder already exists, the messages from the exported file will be
11609 appended to the folder.
11610 <P>
11611 <CENTER>Description of the FOLDER LIST Screen</CENTER>
11612
11613 The purpose of the FOLDER LIST screen is to help you browse and manage
11614 the folders and directories (also known as &quot;hierarchy&quot;)
11615 contained within a collection.
11616
11617 <P>
11618 Folders and directories are arranged alphabetically across lines of
11619 the screen.  Directories, if present, are denoted by a special
11620 character at the end of the name known as the hierarchy delimiter
11621 (typically, &quot;/&quot;).  By default, folders and directories are
11622 mixed together.  The
11623 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
11624 configuration option can be used to group directories toward the
11625 beginning or end of the list.
11626
11627 <P>
11628 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
11629 commands change the &quot;selected&quot; (i.e., highlighted) folder or
11630 directory, and the View Fldr/Dir commands will &quot;open&quot; the
11631 selected item.  Folder and directory management is provided via the
11632 Rename, Delete and Add commands.
11633
11634 <P><CENTER>About Folders</CENTER>
11635 What are Folders?<P>
11636
11637 Folders are simply files where messages are kept.  Every message has to be
11638 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
11639 folder for sent mail and a folder for saved messages.<P>
11640
11641 You may create as many other folders as you wish.  They must be given
11642 names that can be filenames on the filesystem.
11643 <P>
11644
11645 You can move messages from one folder to another by opening the original
11646 folder and saving messages into the other folder just as you can save
11647 message from your INBOX to any other folder.<P>
11648
11649 Folders are typically just files in the filesystem.  However, the files
11650 that are
11651 folders have some special formatting in them (so that Alpine knows where one
11652 message ends and another begins) and should <EM>not</EM> be edited outside of
11653 Alpine.  If you want copies of your messages in text files that you can edit
11654 or otherwise manipulate, use the Export command to copy them from Alpine into
11655 your regular file area.
11656
11657 <P>
11658 FOR MORE INFORMATION: See the section on
11659 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11660 <P>
11661 <CENTER>About Directories</CENTER>
11662 <P>
11663 A directory is simply a container used to group folders within a
11664 folder list.  You can create as many directories as you like.  And
11665 directories can even contain directories themselves.
11666
11667 <P>
11668 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
11669 to note that not all IMAP servers support directories.  If you find that
11670 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
11671 then it's likely that directories are not supported by the server serving
11672 in that collection.
11673
11674 <P>
11675 Similarly, servers that do provide for directories may not do so in
11676 the same way.  On some servers, for example, each folder name you
11677 create is at the same time capable of being a directory.  When this
11678 happens, Alpine will display both the folder name and the name of the
11679 directory (with trailing hierarchy delimiter) in the folder list.
11680
11681 <P>
11682 Another issue with IMAP access, though with a much smaller set of servers,
11683 is that not all servers accept the request to list out the available
11684 folders and directories in the same way.  If you find yourself having
11685 trouble viewing folders on your server, you might investigate the
11686 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
11687 feature.
11688 <P>
11689 <UL>
11690 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11691 </UL>
11692 <P>
11693 &lt;End of help on this topic&gt;
11694 </BODY>
11695 </HTML>
11696 ========= h_valid_folder_names ========
11697 <HTML>
11698 <HEAD>
11699 <TITLE>Explanation of Valid Folder Names</TITLE>
11700 </HEAD>
11701 <BODY>
11702 <H1>Folder Name Syntax Explained</H1>
11703
11704 Once your folder collections are defined, you can usually refer to
11705 folders by their simple (unqualified) name, or pick from a FOLDER LIST
11706 display.  However, understanding the complete syntax for folder names,
11707 both local and remote, is handy when using the Goto command and when
11708 you are adding new folder collections via the Setups/collectionList screen.
11709 <P>
11710 An Alpine folder name looks like
11711
11712 <P>
11713 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
11714 <P>
11715
11716 The square brackets ([]) mean that the part is optional.
11717
11718 <P>
11719 If there is no remote-specification, then the folder name is interpreted
11720 locally on the computer running Alpine.
11721 Local folder names depend on the operating system used by the computer
11722 running Alpine, as well as the configuration of that system.  For example,
11723 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
11724 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
11725 system running Unix.
11726
11727 <P>
11728 Alpine users have the option of using folders that are stored on some other
11729 computer.  Alpine accesses remote folders via IMAP (the Internet Message
11730 Access Protocol), or in the case of news, via NNTP (the Network News
11731 Transport Protocol).  To be able to access remote folders in Alpine, the
11732 remote host must be running the appropriate server software (imapd or
11733 nntpd) and you must correctly specify the name of the folder to Alpine,
11734 including the domain name of the remote machine. For example,
11735 <P>
11736 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
11737 <P>
11738 could be a remote folder specification, and so could
11739 <P>
11740 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
11741 and
11742 <P>
11743 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
11744 <P>
11745 Note that in the case of remote folders, the directory/file path in the specification is
11746 determined by the operating system of the remote computer, <B>not</B> by
11747 the operating system of the computer on which you are running Alpine.
11748 <P>
11749 As you can tell, the name of the computer is in &#123;} brackets
11750 followed immediately by the name of the folder.  (In each of these cases the
11751 optional namespace is missing.)  If, as in these
11752 examples, there is no remote access protocol specified, then IMAP is
11753 assumed.  Check
11754 <A HREF="h_folder_server_syntax">here</A>
11755 for a more detailed look at what options can be placed between the brackets.
11756 If there are no brackets at all, then the folder name is interpreted locally
11757 on the computer on which you are running Alpine.
11758
11759 <P>
11760 To the right of the brackets when a server name is present, or at the
11761 start of the foldername if no server is present, the sharp sign,
11762 &quot;#&quot;, holds special meaning.  It indicates a folder name
11763 outside the area reserved for your personal folders.  In fact, it's
11764 used to indicate both the name of the folder, and a special phrase
11765 telling Alpine how to interpret the name that follows.
11766
11767 <P>
11768 So, for example, Alpine can be used to access a newsgroup that might be
11769 available on your computer using:
11770 <P>
11771 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11772 <P>
11773 The sharp sign indicates the folder name is outside your personal
11774 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
11775 interpret the remainder of the name as a newsgroup.
11776
11777 <P>
11778 Similarly, to access a newsgroup on your IMAP server, you might
11779 use something like:
11780 <P>
11781 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
11782
11783 <P>
11784 There are a number of such special phrases (or &quot;namespaces&quot;)
11785 available.  For a more detailed explanation read about
11786 <A HREF="h_folder_name_namespaces">Namespaces</A>.
11787
11788 <P>
11789 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
11790 names.  The name INBOX refers to your &quot;principal incoming
11791 message folder&quot; and will be mapped to the actual file name used for your
11792 INBOX on any given host.  Therefore, a name like
11793 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
11794 store incoming mail for you on that particular host.
11795
11796 <P>
11797 &lt;End of help on this topic&gt;
11798 </BODY>
11799 </HTML>
11800 ======= h_folder_name_namespaces =======
11801 <HTML>
11802 <HEAD>
11803 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
11804 </HEAD>
11805 <BODY>
11806 <H1>Folder Name Namespaces Explained</H1>
11807
11808 An Alpine folder name looks like
11809
11810 <P>
11811 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
11812 <P>
11813
11814 The local part of a folder name has an optional &quot;Namespace&quot; which
11815 tells Alpine how to interpret the rest of the name.
11816
11817 <P>
11818 By default the folder name is interpreted as defining a section of your personal
11819 folder area.  This area and how you specify it are defined by the
11820 server, if one is specified, or, typically, the home
11821 directory, if no server is defined.
11822
11823 <P>
11824 If a namespace is specified, it begins with the
11825 sharp, &quot;#&quot;, character followed by the name of the namespace
11826 and then the namespace's path-element-delimiter.  Aside from the
11827 path's format, namespaces can also imply access rights, content
11828 policy, audience, location, and, occasionally, access methods.
11829
11830 <P>
11831 Each server exports its own set (possibly of size one) of
11832 namespaces.  Hence, it's likely communication with your server's
11833 administrator will be required for specific configurations.  Some of
11834 the more common namespaces, however, include:
11835
11836 <DL>
11837 <DT>#news.</DT>
11838 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
11839 names are hierarchically defined with each level delimited by a period.
11840 <P>
11841 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11842 <P>
11843 </DD>
11844 <DT>#public/</DT>
11845 <DD>This specifies a folder area that the server may export to the general
11846 public.
11847 </DD>
11848 <DT>#shared/</DT>
11849 <DD>This specifies a folder area that the server may export to groups
11850 of users.
11851 </DD>
11852 <DT>#ftp/</DT>
11853 <DD>This specifies a folder area that is the same as that it may have
11854 exported via the &quot;File Transfer Protocol&quot;.
11855 </DD>
11856 <DT>#mh/</DT>
11857 <DD>This specifies the personal folder area associated with folders
11858 and directories that were created using the MH message handling system.
11859 </DD>
11860 <DT>#move/</DT>
11861 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
11862 <P>
11863 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
11864 <P>
11865 The #move namespace is followed by two folder names separated by a delimiter
11866 character.
11867 The delimiter character may be any character that does not appear in
11868 the MailDropFolder name.
11869 The meaning of #move is that mail will be copied from the MailDropFolder to
11870 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
11871 Periodic checks at frequency
11872 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
11873 time between checks set by
11874 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
11875 are made for new mail arriving in the MailDropFolder.
11876 An example that copies mail from a POP inbox to a local folder follows
11877 <P>
11878 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
11879 <P>
11880 To you it appears that mail is being delivered to the local folder when it
11881 is copied from the MailDropFolder, and you read mail from the local folder.
11882 <P>
11883 Note that if the DestinationFolder does not exist then the messages are not
11884 copied from the MailDropFolder.
11885 A #move folder may only be used as an
11886 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
11887 an Inbox.
11888 When you are in the FOLDER LIST of Incoming Message Folders (after turning
11889 on the
11890 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
11891 option)
11892 the Add command has a subcommand &quot;Use Mail Drop&quot;
11893 which may be helpful for defining the folder in your Alpine configuration.
11894 The same is true when you edit the
11895 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
11896 option in Setup/Config.
11897 Each of these configuration methods will also create the DestinationFolder
11898 if it doesn't already exist.
11899 If you are having problems, make sure the DestinationFolder exists.
11900 You may find some more useful information about Mail Drops at
11901 <A HREF="h_maildrop">What is a Mail Drop?</A>.
11902 </DD>
11903 </DL>
11904 <P>
11905
11906 In addition, the server may support access to other user's folders,
11907 provided you have suitable permissions.  Common methods use a prefix
11908 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
11909 indicate the root of the other user's folder area.
11910
11911 <P>
11912 No, nothing's simple.
11913
11914 <P>
11915 &lt;End of help on this topic&gt;
11916 </BODY>
11917 </HTML>
11918 ============= h_whatis_vcard ========================
11919 <HTML>
11920 <HEAD>
11921 <TITLE>VCARD EXPLAINED</TITLE>
11922 </HEAD>
11923 <BODY>
11924 <H1>What is the vCard format?</H1>
11925 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
11926 information about and among people and organizations electronically.
11927 More information about vCard can be found (as of May 1998) on the WWW site
11928 of the Internet Mail Consortium at the URL:
11929 <P>
11930 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
11931 <P>
11932 &lt;End of help on this topic&gt;
11933 </BODY>
11934 </HTML>
11935 ===== h_folder_open =====
11936 <HTML>
11937 <HEAD>
11938 <TITLE>Explanation of Folder Selection</TITLE>
11939 </HEAD>
11940 <BODY>
11941 <BR>
11942 <BR>
11943 This screen is designed to allow you to quickly and easily survey your
11944 folders and select one to open.
11945 <!--chtml if pinemode="function_key"-->
11946 <PRE>
11947 Navigating the List of Folders             General Alpine Commands
11948 ------------------------------             -----------------------
11949  P   Move to previous folder               ?   Show this help text
11950  N   Move to next folder
11951  -   Show previous screen of folders
11952 Spc  (space bar) Show next screen
11953  W   WhereIs (search folder names)
11954
11955 Folder Selection Commands
11956 -------------------------
11957  E   Exit the Folder Select menu (without selecting a folder)
11958  S   Select the currently highlighted folder
11959 </PRE>
11960 <!--chtml else-->
11961 <PRE>
11962 Navigating the List of Folders             General Alpine Commands
11963 ------------------------------             -----------------------
11964 F5   Move to previous folder               F1  Show this help text
11965 F6   Move to next folder
11966 F7   Show previous screen of folders
11967 F8   Show next screen of folders
11968 F12  WhereIs (search folder names)
11969
11970 Folder Selection Commands
11971 -------------------------
11972 F3   Exit the Folder Select menu (without selecting a folder)
11973 F4   Select the currently highlighted folder
11974 </PRE>
11975 <!--chtml endif-->
11976 <P>
11977 FOR MORE INFORMATION: See the section on
11978 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11979 <P>
11980 &lt;End of help on this topic&gt;
11981 </BODY>
11982 </HTML>
11983 ===== h_folder_subscribe =====
11984 <HTML>
11985 <HEAD>
11986 <TITLE>Newsgroup Subscribe Screen explained</TITLE>
11987 </HEAD>
11988 <BODY>
11989 <H1>FOLDER SUBSCRIBE HELP</H1>
11990
11991 This screen is designed to help you subscribe to newsgroups you are
11992 not currently subscribed to.  The screen display is a list of all
11993 available newsgroups (or possibly a partial list if you specified a
11994 partial name when entering the screen).  Groups you have already
11995 subscribed to have the letters &quot;SUB&quot; next to them.  You may
11996 select a single new group to subscribe to by moving the cursor to that
11997 group and pressing &quot;S&quot; or carriage return.  Alternatively,
11998 you may change into ListMode with the &quot;ListMode&quot; command.
11999 The display will change slightly so that each group has a checkbox in
12000 front of it.  Use the cursor and the Set/Unset command to place an
12001 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
12002 <P>
12003
12004 When you are finished marking groups, the &quot;Subscribe&quot;
12005 command will subscribe you to those groups you have marked.  Note, you
12006 may not unsubscribe to groups with this command.  Instead of the
12007 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
12008 UnSbscrbe command.
12009 <P>
12010
12011 <!--chtml if pinemode="function_key"-->
12012 <PRE>
12013 Navigating the List of Newsgroups          General Alpine Commands
12014 ---------------------------------          -----------------------
12015 F5   Move to previous group                F1   Show this help text
12016 F6   Move to next group
12017 F7   Show previous screen of groups
12018 F8   Show next screen of groups
12019 F12  WhereIs (search group names)
12020 F9   Use ListMode
12021
12022 Group Selection Commands
12023 -------------------------
12024 F3  Exit the News Subscribe menu (without selecting any groups)
12025 F4  Subscribe to the currently highlighted newsgroup
12026 </PRE>
12027 <!--chtml else-->
12028 <PRE>
12029 Navigating the List of Newsgroups          General Alpine Commands
12030 ---------------------------------          -----------------------
12031  P   Move to previous group                ?   Show this help text
12032  N   Move to next group
12033  -   Show previous screen of groups
12034 Spc  (space bar) Show next screen
12035  W   WhereIs (search group names)
12036  L   Use ListMode
12037
12038 Group Selection Commands
12039 -------------------------
12040  E   Exit the News Subscribe menu (without selecting any groups)
12041  S   Subscribe to the currently highlighted newsgroup
12042 </PRE>
12043 <!--chtml endif-->
12044 <P>
12045 When in ListMode, there is an additional command for marking groups to
12046 subscribe to:
12047 <P>
12048 <!--chtml if pinemode="function_key"-->
12049 <PRE>
12050 ListMode Commands
12051 -------------------------
12052 F9  Set or unset the highlighted group
12053 </PRE>
12054 <!--chtml else-->
12055 <PRE>
12056 ListMode Commands
12057 -------------------------
12058 X   Set or unset the highlighted group
12059 </PRE>
12060 <!--chtml endif-->
12061 <P>
12062 &lt;End of help on this topic&gt;
12063 </BODY>
12064 </HTML>
12065 ===== h_folder_postnews =====
12066 <HTML>
12067 <HEAD>
12068 <TITLE>Newsgroup selecting for Posting explained</TITLE>
12069 </HEAD>
12070 <BODY>
12071 This screen is designed to allow you to quickly and easily survey
12072 the available newsgroups and select one to post news to.
12073 <P>
12074 <!--chtml if pinemode="function_key"-->
12075 <PRE>
12076 Navigating the List of Newsgroups          General Alpine Commands
12077 ---------------------------------          -----------------------
12078 F5   Move to previous group                F1  Show this help text
12079 F6   Move to next group
12080 F7   Show previous screen of groups
12081 F8   Show next screen of groups
12082 F12  WhereIs (search group names)
12083
12084 Group Selection Commands
12085 -------------------------
12086 F3   Exit the Selection menu (without selecting a group)
12087 F4   Select the currently highlighted newsgroup
12088 </PRE>
12089 <!--chtml else-->
12090 <PRE>
12091 Navigating the List of Newsgroups          General Alpine Commands
12092 ---------------------------------          -----------------------
12093  P   Move to previous group                ?  Show this help text
12094  N   Move to next group
12095  -   Show previous screen of groups
12096 Spc  (space bar) Show next screen of groups
12097  W   WhereIs (search group names)
12098
12099 Group Selection Commands
12100 -------------------------
12101  E   Exit the Selection menu (without selecting a group)
12102  S   Select the currently highlighted newsgroup
12103 </PRE>
12104 <!--chtml endif-->
12105 <P>
12106 &lt;End of help on this topic&gt;
12107 </BODY>
12108 </HTML>
12109 ===== h_folder_save =====
12110 <HTML>
12111 <HEAD>
12112 <TITLE>Folder Select for Save Explained</TITLE>
12113 </HEAD>
12114 <BODY>
12115 This screen is designed to allow you to quickly and easily survey your
12116 folders and select one to use for saving the current message.
12117 <P>
12118
12119 <!--chtml if pinemode="function_key"-->
12120 <PRE>
12121 Navigating the List of Folders             General Alpine Commands
12122 ------------------------------             -----------------------
12123 F5   Move to previous folder               F1  Show this help text
12124 F6   Move to next folder
12125 F7   Show previous screen of folders
12126 F8   Show next screen of folders
12127 F12  WhereIs (search folder names)
12128
12129 Folder Selection Commands
12130 -------------------------
12131 F3   Exit the Folder Select menu (without selecting a folder)
12132 F4   Select the currently highlighted folder
12133 F11  AddNew folder (just like Select, but you type in a new folder name)
12134 </PRE>
12135 <!--chtml else-->
12136 <PRE>
12137 Navigating the List of Folders             General Alpine Commands
12138 ------------------------------             -----------------------
12139  P   Move to previous folder               ?  Show this help text
12140  N   Move to next folder
12141  -   Show previous screen of folders
12142 Spc  (space bar) Show next screen of folders
12143  W   WhereIs (search folder names)
12144
12145 Folder Selection Commands
12146 -------------------------
12147  E   Exit the Folder Select menu (without selecting a folder)
12148  S   Select the currently highlighted folder
12149  A   AddNew folder (just like Select, but you type in a new folder name)
12150 </PRE>
12151 <!--chtml endif-->
12152 <P>
12153 FOR MORE INFORMATION: See the section on
12154 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12155 <P>
12156 &lt;End of help on this topic&gt;
12157 </BODY>
12158 </HTML>
12159 ===== h_folder_fcc =====
12160 <HTML>
12161 <HEAD>
12162 <TITLE>Folder Select for Fcc Explained</TITLE>
12163 </HEAD>
12164 <BODY>
12165 This screen is designed to allow you to quickly and easily survey your
12166 folders and select one to use as the file carbon copy (fcc) for the
12167 current message.
12168 <P>
12169
12170 <!--chtml if pinemode="function_key"-->
12171 <PRE>
12172 Navigating the List of Folders             General Alpine Commands
12173 ------------------------------             -----------------------
12174 F5   Move to previous folder               F1  Show this help text
12175 F6   Move to next folder
12176 F7   Show previous screen of folders
12177 F8   Show next screen of folders
12178 F12  WhereIs (search folder names)
12179
12180 Folder Selection Commands
12181 -------------------------
12182 F3   Exit the Folder Select menu (without selecting a folder)
12183 F4   Select the currently highlighted folder
12184 F11  AddNew folder (just like Select, but you type in a new folder name)
12185 </PRE>
12186 <!--chtml else-->
12187 <PRE>
12188 Navigating the List of Folders             General Alpine Commands
12189 ------------------------------             -----------------------
12190  P   Move to previous folder               ?  Show this help text
12191  N   Move to next folder
12192  -   Show previous screen of folders
12193 Spc  (space bar) Show next screen of folders
12194  W   WhereIs (search folder names)
12195
12196 Folder Selection Commands
12197 -------------------------
12198  E   Exit the Folder Select menu (without selecting a folder)
12199  S   Select the currently highlighted folder
12200  A   AddNew folder (just like Select, but you type in a new folder name)
12201 </PRE>
12202 <!--chtml endif-->
12203 <P>
12204 FOR MORE INFORMATION: See the section on
12205 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12206 <P>
12207 &lt;End of help on this topic&gt;
12208 </BODY>
12209 </HTML>
12210 ===== h_folder_pattern_roles =====
12211 <HTML>
12212 <HEAD>
12213 <TITLE>Folder Select for Current Folder Explained</TITLE>
12214 </HEAD>
12215 <BODY>
12216 This screen is designed to allow you to quickly and easily survey your
12217 folders and select one to use as the specific Current Folder
12218 in a Pattern.
12219 <P>
12220
12221 <!--chtml if pinemode="function_key"-->
12222 <PRE>
12223 Navigating the List of Folders             General Alpine Commands
12224 ------------------------------             -----------------------
12225 F5   Move to previous folder               F1  Show this help text
12226 F6   Move to next folder
12227 F7   Show previous screen of folders
12228 F8   Show next screen of folders
12229 F12  WhereIs (search folder names)
12230
12231 Folder Selection Commands
12232 -------------------------
12233 F3   Exit the Folder Select menu (without selecting a folder)
12234 F4   Select the currently highlighted folder
12235 F11  AddNew folder (just like Select, but you type in a new folder name)
12236 </PRE>
12237 <!--chtml else-->
12238 <PRE>
12239 Navigating the List of Folders             General Alpine Commands
12240 ------------------------------             -----------------------
12241  P   Move to previous folder               ?  Show this help text
12242  N   Move to next folder
12243  -   Show previous screen of folders
12244 Spc  (space bar) Show next screen of folders
12245  W   WhereIs (search folder names)
12246
12247 Folder Selection Commands
12248 -------------------------
12249  E   Exit the Folder Select menu (without selecting a folder)
12250  S   Select the currently highlighted folder
12251  A   AddNew folder (just like Select, but you type in a new folder name)
12252 </PRE>
12253 <!--chtml endif-->
12254 <P>
12255 FOR MORE INFORMATION: See the section on
12256 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12257 <P>
12258 &lt;End of help on this topic&gt;
12259 </BODY>
12260 </HTML>
12261 ===== h_folder_stayopen_folders =====
12262 <HTML>
12263 <HEAD>
12264 <TITLE>Folder Select Explained</TITLE>
12265 </HEAD>
12266 <BODY>
12267 This screen is designed to allow you to quickly and easily survey your
12268 folders and select one to use as a Stay-Open folder.
12269 <P>
12270
12271 <!--chtml if pinemode="function_key"-->
12272 <PRE>
12273 Navigating the List of Folders             General Alpine Commands
12274 ------------------------------             -----------------------
12275 F5   Move to previous folder               F1  Show this help text
12276 F6   Move to next folder
12277 F7   Show previous screen of folders
12278 F8   Show next screen of folders
12279 F12  WhereIs (search folder names)
12280
12281 Folder Selection Commands
12282 -------------------------
12283 F3   Exit the Folder Select menu (without selecting a folder)
12284 F4   Select the currently highlighted folder
12285 F11  AddNew folder (just like Select, but you type in a new folder name)
12286 </PRE>
12287 <!--chtml else-->
12288 <PRE>
12289 Navigating the List of Folders             General Alpine Commands
12290 ------------------------------             -----------------------
12291  P   Move to previous folder               ?  Show this help text
12292  N   Move to next folder
12293  -   Show previous screen of folders
12294 Spc  (space bar) Show next screen of folders
12295  W   WhereIs (search folder names)
12296
12297 Folder Selection Commands
12298 -------------------------
12299  E   Exit the Folder Select menu (without selecting a folder)
12300  S   Select the currently highlighted folder
12301  A   AddNew folder (just like Select, but you type in a new folder name)
12302 </PRE>
12303 <!--chtml endif-->
12304 <P>
12305 FOR MORE INFORMATION: See the section on
12306 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12307 <P>
12308 &lt;End of help on this topic&gt;
12309 </BODY>
12310 </HTML>
12311 ===== h_folder_action_roles =====
12312 <HTML>
12313 <HEAD>
12314 <TITLE>Folder Select Explained</TITLE>
12315 </HEAD>
12316 <BODY>
12317 This screen is designed to allow you to quickly and easily survey your
12318 folders and select one to use as the folder into which messages
12319 matching this filter will be moved.
12320 <P>
12321
12322 <!--chtml if pinemode="function_key"-->
12323 <PRE>
12324 Navigating the List of Folders             General Alpine Commands
12325 ------------------------------             -----------------------
12326 F5   Move to previous folder               F1  Show this help text
12327 F6   Move to next folder
12328 F7   Show previous screen of folders
12329 F8   Show next screen of folders
12330 F12  WhereIs (search folder names)
12331
12332 Folder Selection Commands
12333 -------------------------
12334 F3   Exit the Folder Select menu (without selecting a folder)
12335 F4   Select the currently highlighted folder
12336 F11  AddNew folder (just like Select, but you type in a new folder name)
12337 </PRE>
12338 <!--chtml else-->
12339 <PRE>
12340 Navigating the List of Folders             General Alpine Commands
12341 ------------------------------             -----------------------
12342  P   Move to previous folder               ?  Show this help text
12343  N   Move to next folder
12344  -   Show previous screen of folders
12345 Spc  (space bar) Show next screen of folders
12346  W   WhereIs (search folder names)
12347
12348 Folder Selection Commands
12349 -------------------------
12350  E   Exit the Folder Select menu (without selecting a folder)
12351  S   Select the currently highlighted folder
12352  A   AddNew folder (just like Select, but you type in a new folder name)
12353 </PRE>
12354 <!--chtml endif-->
12355 <P>
12356 FOR MORE INFORMATION: See the section on
12357 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12358 <P>
12359 &lt;End of help on this topic&gt;
12360 </BODY>
12361 </HTML>
12362 ===== h_abook_config =====
12363 <HTML>
12364 <HEAD>
12365 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
12366 </HEAD>
12367 <BODY>
12368 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
12369 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
12370 <!--chtml if pinemode="function_key"-->
12371 <PRE>
12372 Available  Commands
12373 -------------------------------
12374 F1  Show Help Text
12375 F3  Back to MAIN Alpine menu
12376 F4  Change configuration for address book
12377 F5  Move to previous address book
12378 F6  Move to next address book
12379 F7  Previous page of address books
12380 F8  Next page of address books
12381 F9  Add new address book
12382 F10 Delete existing address book
12383 F11 Shuffle the order of address books
12384 F12 Whereis (search address book titles)
12385 </PRE>
12386 <!--chtml else-->
12387 <PRE>
12388 Navigation                     General Alpine Commands
12389 -----------------------        -----------------------
12390  P  Prev Address Book           ?  Display this help text
12391  N  Next Address Book           E  Back to MAIN Alpine menu
12392  -  Previous page
12393 Spc (space bar) Next page
12394  W  WhereIs (search for word in address book titles)
12395
12396 Setup Address Books Commands
12397 ------------------------------------------------
12398  A  Add new address book          $  Shuffle the order of address books
12399  D  Delete existing address book  C  Change configuration for address book
12400 </PRE>
12401 <!--chtml endif-->
12402
12403 <H2>Description of the Setup Address Books Screen</H2>
12404
12405 This screen lets you add, delete, modify, or change the order of your
12406 address books.  The &quot;Add Abook&quot; command brings up a blank form to
12407 fill in.  If you are adding a remote address book on an IMAP server
12408 you should fill in the name of the IMAP server.  Otherwise, leave
12409 that field blank.  (Note that remote IMAP address books are an Alpine
12410 concept and are unlikely to interoperate with other mail clients.)
12411 For a remote address book, fill in the name of the remote folder
12412 in the Folder field.  This should be a folder that is used only for
12413 this one purpose, not a general purpose folder you expect to store
12414 messages in.
12415 <P>If you are adding a local address book, fill in the
12416 Folder Name field with a local file name (e.g., .addressbook).
12417 <P>
12418 <B>Please note:</B> Remote address books stored on an IMAP server are
12419 of an entirely different format (namely, a special-purpose
12420 &quot;mail folder&quot;) than that of the local addressbook familiar
12421 to Alpine users.  Therefore,
12422 you cannot use &quot;add a remote address book&quot; to make an existing
12423 Alpine .addressbook file you may have on a remote IMAP server accessible to
12424 Alpine running on a different host.
12425 <P>
12426
12427 The &quot;Del Abook&quot; command allows you to remove an address book
12428 from your configuration.  It will also ask you if you wish to remove
12429 the data for that address book, which would erase all traces of the
12430 address book if you answer Yes.
12431 <P>
12432
12433 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
12434 The difference is that instead of adding a new address book to your
12435 configuration, you are changing the configuration of an existing entry.
12436 For example, you might want to correct a typing error or change a
12437 nickname.  The &quot;Change&quot; command is not a move command.  If you
12438 change the folder name or server name the data will not be moved for you.
12439 <P>
12440
12441 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
12442 an address book toward another address book in the same group then
12443 the order of those two address books will be swapped.  If you shuffle
12444 the last Personal address book down towards the Global address book
12445 section, it will become a Global address book.  If you shuffle
12446 the first Global address book up it will become a Personal address
12447 book.  The main difference between Personal and Global address
12448 books is that Global address books are forced read-only.
12449 <P><UL>
12450 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12451 </UL>
12452 <P>
12453 &lt;End of help on this topic&gt;
12454 </BODY>
12455 </HTML>
12456 ===== h_abook_top =====
12457 <HTML>
12458 <HEAD>
12459 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
12460 </HEAD>
12461 <BODY>
12462 <H1>ADDRESS BOOK LIST COMMANDS</H1>
12463 <!--chtml if pinemode="function_key"-->
12464 <PRE>
12465 Available  Commands -- Group 1         Available Commands -- Group 2
12466 -------------------------------        ------------------------------
12467 F1  Show Help Text                      F1  Show Help Text
12468 F2  See commands in next group          F2  See commands in next group
12469 F3  Exit to MAIN MENU                   F3  Quit Alpine
12470 F4  View/Edit selected address book
12471 F5  Move to previous address book       F5  FOLDER LIST screen
12472 F6  Move to next address book           F6  Specify a folder to go to
12473 F7  Previous page                       F7  MESSAGE INDEX screen
12474 F8  Next page                           F9  Print list of address books
12475 F12 Whereis (search for word)
12476 </PRE>
12477 <!--chtml else-->
12478 <PRE>
12479 Navigation                       General Alpine Commands
12480 -----------------------          -----------------------
12481  P  Previous Entry                ?  Display this help text
12482  N  Next Entry                    O  Show all other available commands
12483  -  Previous page                 &lt;  Back to MAIN Alpine menu
12484 Spc (space bar) Next page         Q  Quit Alpine
12485  W  WhereIs (search for word)     L  FOLDER LIST screen
12486                                   G  Specify a folder to go to
12487 Address Book Commands             I  MESSAGE INDEX screen
12488 ------------------------------------------------
12489  &gt;  View/Edit selected address book
12490               or
12491  &gt;  Search on selected directory server
12492
12493  %  Print list of address books and directory servers
12494 </PRE>
12495 <!--chtml endif-->
12496
12497 <H2>Description of the Address Book List Screen</H2>
12498
12499 From this screen you may choose which address book you wish to view
12500 or edit. For more information on address books, view one of your
12501 address books (with
12502 <!--chtml if pinemode="function_key"-->
12503 F4
12504 <!--chtml else-->
12505 &quot;&gt;&quot;
12506 <!--chtml endif-->)
12507 and see the Help Text there.<P>
12508
12509 You may also choose a directory server on which to search for entries.
12510 You do that by highlighting the directory server line and using
12511 <!--chtml if pinemode="function_key"-->
12512 F4
12513 <!--chtml else-->
12514 &quot;&gt;&quot;
12515 <!--chtml endif-->.<P>
12516
12517 If you wish to define new address books or directory servers go to the Main
12518 menu and choose Setup. You may then either choose to setup AddressBooks or
12519 Directory (among other things). It's possible that the Directory option
12520 will not be there if the Alpine you are using does not contain LDAP directory
12521 lookup functionality.
12522
12523 <P><UL>
12524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12525 </UL><P>
12526 &lt;End of help on this topic&gt;
12527 </BODY>
12528 </HTML>
12529 ===== h_abook_opened =====
12530 <HTML>
12531 <HEAD>
12532 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
12533 </HEAD>
12534 <BODY>
12535 <H1>THE ALPINE ADDRESS BOOK</H1>
12536 <H2>ADDRESS BOOK COMMANDS</H2>
12537 <PRE>
12538 <!--chtml if pinemode="function_key"-->
12539 Available  Commands -- Group 1         Available Commands -- Group 2
12540 -------------------------------        ------------------------------
12541 F1  Show Help Text                      F1  Show Help Text
12542 F2  See commands in next group          F2  See commands in next group
12543 F3  Exit this screen                    F3  Quit Alpine
12544 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
12545 F5  Move to previous entry              F5  FOLDER LIST screen
12546 F6  Move to next entry                  F6  Specify a folder to go to
12547 F7  Previous page of address book       F7  MESSAGE INDEX screen
12548 F8  Next page of address book           F8  Compose to entry using roles
12549 F9  Add new entry to address book       F9  Print address book
12550 F10 Delete selected entry               F10 TakeAddr to another addrbook
12551 F11 Compose to selected entry           F11 Save or Export addrbook selections
12552 F12 Whereis (search address book)       F12 Forward entry by mail
12553
12554 Available Commands -- Group 3
12555 ------------------------------
12556 F3  Select                              F6  Zoom (or unZoom)
12557 F5  Select Current                      F7  Apply Command to Selection
12558 <!--chtml else-->
12559 Address Book Navigation        General Alpine Commands
12560 -----------------------        -----------------------
12561  P  Prev Address                  ?  Display this help text
12562  N  Next Address                  O  Show all other available commands
12563  -  Previous page of address book M  Back to MAIN MENU
12564 Spc (space bar) Next page         Q  Quit Alpine
12565  W  WhereIs (search for word      C  Compose message to selected addr
12566      or name in address book)     #  Compose to addr using roles
12567  &lt;  To List of Address Books if   L  FOLDER LIST screen
12568      more than one, else to MAIN  G  Specify a folder to go to
12569                                   I  MESSAGE INDEX screen
12570
12571 Address Book Commands
12572 ----------------------------------------------------
12573  &gt;  View/Update selected entry    D  Delete selected entries
12574  %  Print address book            S  Save or Export address book selections
12575  F  Forward entries by mail       @  Add new entry to address book
12576
12577  ;  Select command                Z  Toggle Zoom Mode
12578  :  Select highlighted entry      A  Apply command to selected entries
12579
12580 <!--chtml endif-->
12581 </PRE>
12582 Note:  The presence or absence of the final four commands above is
12583 controlled by the option
12584 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
12585 <P>
12586
12587 <H2>Description of the Address Book Screen</H2>
12588
12589 This screen lets you edit and manage entries in your address book.  It
12590 also acts as a short-cut for composing messages to people in the address
12591 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
12592 message starts &quot;pre-addressed&quot; to whatever address book entry is
12593 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
12594 role to use in your composition.
12595 <P>
12596 Alpine's address book helps you keep a list of addresses you send email to so
12597 you do not have to remember addresses that are often complex.  Each entry
12598 in the address book has five fields, all of them optional.  The three
12599 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
12600
12601         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
12602         This is what you type in as you are addressing the message in the
12603         composer.  If there is a matching entry in your address book(s),
12604         Alpine will extract the corresponding FullName and Address fields to
12605         generate the actual address for your message.
12606
12607         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
12608 of the
12609         person or organization.  Usually the full names are put in last
12610         name first so they sort nicely in alphabetical order.  Whatever
12611         you put as the name here will appear on the message when it is
12612         finally delivered.  Examples:<PRE>
12613            Garcia Marquez, Gabriel
12614            Henscheid, Eckhard
12615            Alpine-Info mailing list
12616            Library materials renewal requests
12617            Kim An-guk
12618            &quot;George III, King of Great Britain, 1738-1820&quot;
12619 </PRE>
12620 (In the second-to-last example, no comma is used in the name so that
12621 the family name appears first in the address book and when the entry is
12622 used in the composer.
12623 In the last example, retaining the commas is intended;
12624 double-quotation marks surround the name to
12625 prevent the transposition of its parts when the entry is used in
12626 the composer.)
12627
12628         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
12629         a valid Internet address that conforms to the Internet message
12630         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
12631
12632 The two fields that aren't usually visible are:<DL>
12633
12634   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
12635         message to this address to be saved in.  If this field is set, and
12636         this address is the first one in the message's To: header, then
12637         Alpine will use this folder name for the FCC in lieu of the normal
12638         FCC folder name.
12639
12640   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
12641         </DL>
12642 <P>
12643 Due to screen width limitations, these last two fields do not show up in
12644 the normal ADDRESS BOOK display.  You may select the
12645 &quot;View/Update&quot; command to
12646 view or modify them.  You may use the configuration variable
12647 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
12648 to add these fields to your ADDRESS BOOK
12649 display, or to modify the format of the display.
12650
12651 <H2>Sorting the Address book</H2>
12652
12653 By default, address book entries are sorted alphabetically on the full
12654 name with distribution lists sorted to the end.  Sorting can be changed by
12655 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
12656 --assuming you have &quot;write&quot; permission for the address book file.
12657 <P>
12658 Unlike the sorting of folders (which only changes presentation), sorting an
12659 address book actually changes the file as it is kept on the computer.  For
12660 this reason you won't be able to sort a shared or system-wide address
12661 book.
12662
12663 <H2>Adding New Entries</H2>
12664
12665 The easiest way to add new entries to your address book is to use the
12666 &quot;TakeAddr&quot; command when viewing a message.
12667 This command allows you to take addresses from the header and body of the
12668 message and put them into your address book, without having to type
12669 them in.
12670 <P>
12671
12672 To manually add a new entry from within the address book screen, use the AddNew
12673 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
12674 Use this command both for adding a simple alias and for adding a
12675 distribution list.
12676
12677 <H2>Distribution Lists</H2>
12678
12679 Address book entries can be simple cases of aliases (a single nickname is linked
12680 to a single email address) or distribution lists (a single nickname
12681 pointing at more than one email address).  Each distribution list has a
12682 nickname, a full name and a list of addresses.  The addresses may be
12683 actual addresses or they may be other nicknames in your address book.
12684 They may even refer to other distribution lists.
12685 There's really no difference between a simple alias and a distribution list,
12686 other than the number of addresses.
12687 Therefore, you can turn a simple alias with one address into a distribution
12688 list simply by adding more addresses.
12689 To add entries to an existing list or alias
12690 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
12691 a single address from the list if the cursor is placed on the address;
12692 it will delete the entire distribution list if the cursor is on the
12693 nickname/fullname line.  View/Update may also be used to delete addresses
12694 from a list.
12695 <P>
12696 Address field entries in distribution lists may take any one of three
12697 forms: a nickname existing in any of the defined address books, a normal
12698 address of the form &quot;jsmith@art.example.com&quot;, or a complete
12699 fullname/address combination, e.g. &quot;John Smith
12700 &lt;jsmith@art.example.com&gt;&quot;.
12701 <P>
12702 Distribution lists in Alpine address books can only be used by the person or
12703 people who have access to that address book.  They are not usually used to
12704 implement discussion groups, but can be used to facilitate small
12705 discussion groups if all the participants have access to the same shared
12706 address book.
12707
12708 <H2>FCC and Comments</H2>
12709
12710 As mentioned above, each entry in the address book also has two other optional
12711 fields, Fcc and Comments.  The command to look at or change either of these
12712 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
12713 Comments field is just for your own use.  The Fcc field overrides the
12714 default Fcc if this address is the first one on the To line.  The WhereIs
12715 command may be used to search for particular strings in the address book,
12716 including fields that are not visible (like Comment and Fcc by default).
12717
12718 <H2>Aggregate Operations</H2>
12719
12720 If the feature
12721 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
12722 is turned on (the default), then the four commands &quot;Select&quot;,
12723 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
12724 are available.  The two selection commands allow you to mark a set of
12725 address book entries as being selected.  If you have more than one address
12726 book, the selections may be in more than one of those address books.
12727 The &quot;Zoom&quot; command will toggle between displaying only the selected
12728 entries and all of the entries.  The &quot;Apply&quot; command allows you to
12729 apply one of the regular address book commands to all of the selected
12730 entries.  Usually the address book commands apply to only the entry
12731 highlighted by the cursor.  The &quot;Apply&quot; command works with the
12732 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
12733 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
12734
12735 <H2>Exporting and Forwarding Address book entries</H2>
12736
12737 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
12738 address book entry is placed in a plain text file in your home directory
12739 <!--chtml if pinemode="running"-->
12740 (which, in the present configuration of your system, is
12741  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12742 <!--chtml endif-->
12743 or current working directory
12744 <!--chtml if pinemode="running"-->
12745 (which, at least for your current Alpine &quot;session,&quot;
12746 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12747 <!--chtml endif-->, depending on the
12748 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12749 configuration setting.  If you have some entries selected and use the
12750 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
12751 placed in the text file.
12752 <P>
12753 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
12754 address book entry is placed in a special attachment and you are put into
12755 the composer.  You can fill in some comments in the body of the message,
12756 if you'd like, and send it to somebody else who uses Alpine.  The recipient
12757 may use the TakeAddr command on that message to insert the address book
12758 entry you sent in their own address book.  If you have some entries
12759 selected and use the Apply Forward command all of the selected entries
12760 will be forwarded in a single message.  You may
12761 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.
12762 The recipient must be using Alpine in order to receive this correctly.
12763 One way for the recipient to handle this might be to create an empty
12764 address book and then &quot;Take&quot; your forwarded address book entries into
12765 that empty address book.
12766
12767 <H2>Multiple and/or Site-Wide Address books</H2>
12768
12769 You may have more than one personal address book.  In addition, there may
12770 be one or more global address books.  This capability allows you to have
12771 multiple personal address books (some of which may be shared) and it also
12772 allows system administrators to implement site-wide address books that
12773 contain entries for users on multiple machines within the organization.
12774 <P><DL>
12775 <DT>Searching
12776   <DD> If you enter a nickname when composing a message, your
12777   personal address books will be searched through in order, and then the
12778   global address book(s) searched. If more than one address book has an entry
12779   for the nickname, Alpine uses the first one that it finds, so an entry in
12780   your personal address book would override a global address book entry. If
12781   after searching all the address books there is still no match, (Unix) Alpine
12782   then searches the local host password file on the assumption that you have
12783   entered a local user name rather than an address book nickname.
12784   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
12785   command, but global address books are always searched after personal
12786   address books.
12787
12788   <P><DT>Tab completion
12789   <DD> If the
12790   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
12791   feature is turned on (the default) then the Tab key may be used
12792   in the composer to complete partially typed nicknames in the To
12793   or Cc lines. You type the first few letters of a nickname and then
12794   press the Tab key. It there is only one nickname that matches it will
12795   be filled in by Alpine. If there is more than one the unambiguous part
12796   of the nicknames will be filled in. For example, if your address book or
12797   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
12798   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
12799   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
12800   If you then type a second Tab character you will be presented with a list
12801   of matching nicknames to select from. Alternatively, you could type another
12802   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
12803   in the entire &quot;barbecue&quot; entry.
12804
12805   <P><DT>Defining
12806   <DD> You define multiple personal address books in the
12807   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
12808   from the MAIN MENU.
12809   You may add as many as you like.  Global address books are usually
12810   site-wide address books defined by the System administrator, but
12811   you may define global address books of your own just like you define
12812   personal address books.
12813
12814   <P><DT>Creating and updating
12815   <DD> Personal address books are normally created empty
12816   and populated by explicit additions from within Alpine, e.g. via the
12817   TakeAddr command.  Unlike personal address books, global address books may
12818   not be modified/updated from within Alpine; that is, they are Read-Only.
12819   Thus, global address books are created, populated and updated outside of
12820   Alpine. They might be hand-edited, generated by a program from another
12821   database, or by copying an existing address book.  They might also be
12822   some other user's personal address book, and so be modified normally by
12823   that user but accessed Read-Only by you.  See the Alpine Technical
12824   Notes document (included in the Alpine distribution) for more information on
12825   this.
12826
12827   <P><DT>Accessing
12828   <DD>There are two different types of address books in Alpine.
12829   A local address book is stored in a regular file and the normal file
12830   access permissions apply.  A remote address book is stored on an IMAP
12831   server in a special folder that contains only messages pertaining to
12832   that address book.  The last message in the remote folder contains a
12833   copy of the address book data, and that data is copied to a local cache
12834   file in your home directory.  From there it is accessed just like a local
12835   address book.  The name of the cache file is kept track of in a special
12836   file called the
12837   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
12838   the name of which is stored in
12839   your Alpine configuration file the first time you use a remote address book.
12840   Just as local Alpine address books use a format that only Alpine understands,
12841   remote Alpine address books do the same and other mail reading programs
12842   are unlikely to be able to understand them.<P>
12843   While global address books are explicitly intended to be shared, there is
12844   nothing to prevent you from sharing a personal address book with other
12845   Alpine users. This might be useful in the case of a small workgroup.
12846   However, it is recommended that updates to shared personal address books
12847   be done when other Alpine users are not accessing the address book. Alpine
12848   does not do any file-locking to manage concurrent updates to the
12849   addressbook, but it does check to see if the file has been modified before
12850   making any changes.  Consequently, inadvertent concurrent updates will
12851   only cause other Alpine users to have to restart their address book
12852   operation, which will cause Alpine to reopen the updated file.
12853
12854   <P><DT>Converting to Remote
12855   <DD>The easiest way to convert an existing local
12856   address book into a remote address book is to create an empty new remote
12857   personal address book by typing &quot;A&quot; to execute the
12858   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
12859   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
12860   address book.
12861   After you have added the empty
12862   remote address book, go into the screen for the address book you wish
12863   to copy and &quot;Select&quot; &quot;All&quot;.
12864   This selects every entry in that
12865   address book.  Then type the command &quot;Apply Save&quot;.
12866   You will be asked for the address book to save to.  You may use ^P and ^N
12867   to get to the new empty address book, then hit RETURN and the addresses
12868   will be copied.
12869   At this point you'll probably want to unselect all the entries in the local
12870   address book before proceeding. You do that with
12871   &quot;Select&quot; &quot;unselect All&quot;.
12872
12873 </DL>
12874 <UL>
12875 <LI><A HREF="h_address_format">Explanation of Address formats</A>
12876 </UL>
12877 <P><UL>
12878 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12879 </UL>
12880 <P>
12881 &lt;End of help on this topic&gt;
12882 </BODY>
12883 </HTML>
12884 ===== h_abook_select_addr =====
12885 <HTML>
12886 <HEAD>
12887 <TITLE>Addressbook Selection Explained</TITLE>
12888 </HEAD>
12889 <BODY>
12890 <H1>SELECT ADDRESS</H1>
12891 <!--chtml if pinemode="function_key"-->
12892 <PRE>
12893 Navigating the List of Messages               General Alpine Commands
12894 -------------------------------               -----------------------
12895 F5   Move to previous entry                   F1  Show this help text
12896 F6   Move to next entry
12897 F7   Show previous screen of address book
12898 F8   Show next screen of address book
12899 F12  WhereIs (search through address book)
12900
12901 Address Selection Commands
12902 --------------------------
12903 F3   Exit the Address Select screen (without selecting an address)
12904 F4   Select the currently highlighted entry
12905 </PRE>
12906 <!--chtml else-->
12907 <PRE>
12908 Navigating the List of Messages               General Alpine Commands
12909 -------------------------------               -----------------------
12910  P   Move to previous entry                    ?  Show this help text
12911  N   Move to next entry
12912  -   Show previous screen of address book
12913 Spc  (space bar) Show next screen of address book
12914  W   WhereIs (search through address book)
12915
12916 Address Selection Commands
12917 --------------------------
12918  E   Exit the Address Select screen (without selecting an address)
12919  S   Select the currently highlighted entry
12920 </PRE>
12921 <!--chtml endif-->
12922 <P>
12923
12924 This screen is designed to let you easily scan your address book(s) in
12925 order to select an entry for the message you are composing.  You cannot
12926 edit your address book in any way at this time, for address book
12927 maintenance, select the address book command when not composing a message.
12928 <P>
12929
12930 If you are composing a message and know the nickname of the person/list you
12931 want, you can bypass this screen by simply typing in the nickname on the
12932 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12933 selecting an entry does not cancel your message.
12934 <P>
12935
12936 FOR MORE INFORMATION on addressing see
12937 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12938 <A HREF="h_abook_opened">Address Book Screen's</A>
12939 help text.
12940 <P>
12941 &lt;End of help on this topic&gt;
12942 </BODY>
12943 </HTML>
12944 ===== h_abook_select_top =====
12945 <HTML>
12946 <HEAD>
12947 <TITLE>Addressbook Selection Navigation Explained</TITLE>
12948 </HEAD>
12949 <BODY>
12950 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
12951 <!--chtml if pinemode="function_key"-->
12952 <PRE>
12953 Navigating the List of Address Books       General Alpine Commands
12954 ------------------------------------       -----------------------
12955 F4   View the highlighted address book
12956 F5   Move to previous address book         F1  Show this help text
12957 F6   Move to next address book
12958 F7   Show previous screen of address books
12959 F8   Show next screen of address books
12960 F12  WhereIs (search through address books)
12961
12962 Address Selection Commands
12963 --------------------------
12964 F3   Exit the Address Select screen (without selecting an address)
12965 F4   Select the currently selected entries (if using ListMode)
12966 F9   Change to ListMode
12967 </PRE>
12968 <!--chtml else-->
12969 <PRE>
12970 Navigating the List of Address Books       General Alpine Commands
12971 ------------------------------------       -----------------------
12972  &gt;   View the highlighted address book
12973  P   Move to previous address book         ?  Show this help text
12974  N   Move to next address book
12975  -   Show previous screen of address books
12976 Spc  (space bar) Show next screen of address books
12977  W   WhereIs (search through address books)
12978
12979 Address Selection Commands
12980 --------------------------
12981  E   Exit the Address Select screen (without selecting an address)
12982  S   Select the currently selected entries (if using ListMode)
12983  L   Change to ListMode
12984 </PRE>
12985 <!--chtml endif-->
12986 <P>
12987
12988 This screen is designed to let you easily scan your address book(s) in
12989 order to select entries for the message you are composing.  You cannot
12990 edit your address book in any way at this time.  For address book
12991 maintenance, select the address book command when not composing a message.
12992 <P>
12993
12994 If you are composing a message and know the nickname of the person/list you
12995 want, you can bypass this screen by simply typing in the nickname on the
12996 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12997 selecting an entry does not cancel your message.
12998 <P>
12999
13000 The ListMode command will add a column at the left edge of the screen.
13001 You mark the entries that you wish to select with the &quot;X&quot; command.
13002 This allows you to choose more than one entry at a time.
13003 <P>
13004
13005 An alternative method of composing a message to entries in your
13006 address book(s) is to first use the &quot;Select&quot; command from
13007 the address book maintenance screen and then the &quot;Apply&quot;
13008 &quot;ComposeTo&quot; command to start the composer composing to the
13009 selected entries.
13010 <P>
13011
13012 FOR MORE INFORMATION on addressing see
13013 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13014 <A HREF="h_abook_opened">Address Book Screen's</A>
13015 help text.
13016 <P>
13017 &lt;End of help on this topic&gt;
13018 </BODY>
13019 </HTML>
13020 ===== h_abook_select_listmode =====
13021 <HTML>
13022 <HEAD>
13023 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
13024 </HEAD>
13025 <BODY>
13026 <H1>COMPOSER: SELECT ADDRESSES</H1>
13027 <!--chtml if pinemode="function_key"-->
13028 <PRE>
13029 Navigating the List of Messages                 General Alpine Commands
13030 -------------------------------                 -----------------------
13031 F5   Move to previous entry                     F1  Show this help text
13032 F6   Move to next entry
13033 F7   Show previous screen of address book
13034 F8   Show next screen of address book
13035 F12  WhereIs (search through address book)
13036
13037 Address Selection Commands
13038 --------------------------
13039 F3   Exit the Address Select screen (without selecting an address)
13040 F4   Select the currently highlighted entry
13041 F9   Change to ListMode
13042 </PRE>
13043 <!--chtml else-->
13044 <PRE>
13045 Navigating the List of Messages                 General Alpine Commands
13046 -------------------------------                 -----------------------
13047  P   Move to previous entry                     ?  Show this help text
13048  N   Move to next entry
13049  -   Show previous screen of address book
13050 Spc  (space bar) Show next screen of address book
13051  W   WhereIs (search through address book)
13052
13053 Address Selection Commands
13054 --------------------------
13055  E   Exit the Address Select screen (without selecting an address)
13056  S   Select the currently highlighted entry
13057  L   Change to ListMode
13058 </PRE>
13059 <!--chtml endif-->
13060 <P>
13061
13062 This screen is designed to let you easily scan your address book(s) in
13063 order to select entries for the message you are composing.  You cannot
13064 edit your address book in any way at this time, for address book
13065 maintenance, select the address book command when not composing a message.
13066 <P>
13067
13068 If you are composing a message and know the nickname of the person/list you
13069 want, you can bypass this screen by simply typing in the nickname on the
13070 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
13071 selecting an entry does not cancel your message.
13072 <P>
13073
13074 The ListMode command will add a column at the left edge of the screen.
13075 You mark the entries that you wish to select with the &quot;X&quot; command.
13076 This allows you to choose more than one entry at a time.
13077 <P>
13078
13079 An alternative method of composing a message to entries in your
13080 address book(s) is to first use the &quot;Select&quot; command from
13081 the address book maintenance screen and then the &quot;Apply&quot;
13082 &quot;ComposeTo&quot; command to start the composer composing to the
13083 selected entries.
13084 <P>
13085
13086 FOR MORE INFORMATION on addressing see
13087 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13088 <A HREF="h_abook_opened">Address Book Screen's</A>
13089 help text.
13090 <P>
13091 &lt;End of help on this topic&gt;
13092 </BODY>
13093 </HTML>
13094 ===== h_abook_select_checks =====
13095 <HTML>
13096 <HEAD>
13097 <TITLE>Address Selection from Composer Explained</TITLE>
13098 </HEAD>
13099 <BODY>
13100 <H1>COMPOSER: SELECT ADDRESSES</H1>
13101 <!--chtml if pinemode="function_key"-->
13102 <PRE>
13103 Navigating the List of Messages                 General Alpine Commands
13104 -------------------------------                 -----------------------
13105 F5   Move to previous entry                     F1  Show this help text
13106 F6   Move to next entry
13107 F7   Show previous screen of address book
13108 F8   Show next screen of address book
13109 F12  WhereIs (search through address book)
13110
13111 Address Selection Commands
13112 --------------------------
13113 F3   Exit the Address Select screen (without selecting an address)
13114 F4   Select the currently highlighted entry
13115 F8   Either Sets or Unsets all entries in this address book
13116 F9   Set or Unset the highlighted entry
13117 </PRE>
13118 <!--chtml else-->
13119 <PRE>
13120 Navigating the List of Messages                 General Alpine Commands
13121 -------------------------------                 -----------------------
13122  P   Move to previous entry                     ?  Show this help text
13123  N   Move to next entry
13124  -   Show previous screen of address book
13125 Spc  (space bar) Show next screen of address book
13126  W   WhereIs (search through address book)
13127
13128 Address Selection Commands
13129 --------------------------
13130  E   Exit the Address Select screen (without selecting an address)
13131  S   Select the currently highlighted entry
13132  X   Set or Unset the highlighted entry
13133  A   Either Sets or Unsets all entries in this address book
13134 </PRE>
13135 <!--chtml endif-->
13136 <P>
13137
13138 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
13139 command.  Type &quot;S Select&quot; to select all of the entries you
13140 have marked, just as if you had typed them in by hand.
13141 <P>
13142
13143 An alternative method of composing a message to entries in your
13144 address book(s) is to first use the &quot;Select&quot; command from
13145 the address book maintenance screen and then the &quot;Apply&quot;
13146 &quot;ComposeTo&quot; command to start the composer composing to the
13147 selected entries.
13148 <P>
13149
13150 FOR MORE INFORMATION on addressing see
13151 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13152 <A HREF="h_abook_opened">Address Book Screen's</A>
13153 help text.
13154 <P>
13155 &lt;End of help on this topic&gt;
13156 </BODY>
13157 </HTML>
13158 ===== h_abook_select_nicks_take =====
13159 <HTML>
13160 <HEAD>
13161 <TITLE>Take Address Nickname Selection Explained</TITLE>
13162 </HEAD>
13163 <BODY>
13164 <H1>TAKEADDR: SELECT NICKNAME</H1>
13165 <!--chtml if pinemode="function_key"-->
13166 <PRE>
13167 Navigating the List of Messages                 General Alpine Commands
13168 -------------------------------                 -----------------------
13169 F5   Move to previous entry                     F1  Show this help text
13170 F6   Move to next entry
13171 F7   Show previous screen of address book
13172 F8   Show next screen of address book
13173 F12  WhereIs (search through address book)
13174
13175 Message Selection Commands
13176 --------------------------
13177 F3   Exit the Nickname Select screen (without selecting an address)
13178 F4   Select the currently highlighted entry
13179 </PRE>
13180 <!--chtml else-->
13181 <PRE>
13182 Navigating the List of Messages                 General Alpine Commands
13183 -------------------------------                 -----------------------
13184  P   Move to previous entry                     ?  Show this help text
13185  N   Move to next entry
13186  -   Show previous screen of address book
13187 Spc  (space bar) Show next screen of address book
13188  W   WhereIs (search through address book)
13189
13190 Message Selection Commands
13191 --------------------------
13192  E   Exit the Nickname Select screen (without selecting an address)
13193  S   Select the currently highlighted entry
13194 </PRE>
13195 <!--chtml endif-->
13196 <P>
13197
13198 This screen is designed to let you modify or add to an existing
13199 address book entry.  You have already selected the name(s) and
13200 address(es) through &quot;Take Address&quot;.  This screen simply lets
13201 you scan your address books and select the nickname to be
13202 changed/augmented.  If you want to add a new entry, then you are in
13203 the wrong place-- Select &quot;Exit&quot; command.
13204 <P>
13205
13206 FOR MORE INFORMATION on addressing see
13207 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13208 <A HREF="h_abook_opened">Address Book Screen's</A>
13209 help text.
13210 <P>
13211 &lt;End of help on this topic&gt;
13212 </BODY>
13213 </HTML>
13214 ===== h_abook_select_nick =====
13215 <HTML>
13216 <HEAD>
13217 <TITLE>Nickname Selection Explained</TITLE>
13218 </HEAD>
13219 <BODY>
13220 <H1>SELECT NICKNAME</H1>
13221 <!--chtml if pinemode="function_key"-->
13222 <PRE>
13223 Navigating the List of Messages                 General Alpine Commands
13224 -------------------------------                 -----------------------
13225 F5   Move to previous entry                     F1  Show this help text
13226 F6   Move to next entry
13227 F7   Show previous screen of address book
13228 F8   Show next screen of address book
13229 F12  WhereIs (search through address book)
13230
13231 Message Selection Commands
13232 --------------------------
13233 F3   Exit the Nickname Select screen (without selecting an address)
13234 F4   Select the currently highlighted entry
13235 </PRE>
13236 <!--chtml else-->
13237 <PRE>
13238 Navigating the List of Messages                 General Alpine Commands
13239 -------------------------------                 -----------------------
13240  P   Move to previous entry                     ?  Show this help text
13241  N   Move to next entry
13242  -   Show previous screen of address book
13243 Spc  (space bar) Show next screen of address book
13244  W   WhereIs (search through address book)
13245
13246 Message Selection Commands
13247 --------------------------
13248  E   Exit the Nickname Select screen (without selecting an address)
13249  S   Select the currently highlighted entry
13250 </PRE>
13251 <!--chtml endif-->
13252 <P>
13253
13254 This screen is designed to let you look at the nicknames in your address
13255 books before choosing a new one.
13256 <P>
13257
13258 FOR MORE INFORMATION on addressing see
13259 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13260 <A HREF="h_abook_opened">Address Book Screen's</A>
13261 help text.
13262 <P>
13263 &lt;End of help on this topic&gt;
13264 </BODY>
13265 </HTML>
13266 ===== h_takeaddr_screen =====
13267 <HTML>
13268 <HEAD>
13269 <TITLE>Take Address Screen Explained</TITLE>
13270 </HEAD>
13271 <BODY>
13272 <H1>TAKE ADDRESS COMMANDS</H1>
13273 <!--chtml if pinemode="function_key"-->
13274 <PRE>
13275 Navigating the List of Addresses       Address Selection Commands
13276 --------------------------------       --------------------------
13277  F5  Move to previous entry            F3  Exit without taking address
13278  F6  Move to next entry                F4  Take current address(es)
13279  F7  Show previous page of address list
13280  F8  Show next page of address list
13281  F2  WhereIs (search list)
13282                                --------------
13283 Mode Toggle            F9  Set/Unset current address
13284 -----------            F10 Set all
13285  F12 Toggle between List and single mode       F11 Unset all
13286 </PRE>
13287 <!--chtml else-->
13288 <PRE>
13289 Navigating the List of Addresses       Address Selection Commands
13290 --------------------------------       --------------------------
13291  P  Move to previous entry              &lt;  Exit without taking address
13292  N  Move to next entry                  T  Take address
13293  -  Show previous page of address list
13294 Spc (space bar) Show next page of address list
13295  W  WhereIs (search list)              List Mode
13296                                        ---------
13297 Single Mode                             X  Set/Unset current address
13298 -----------                             A  Set all addresses
13299  L  Switch to list mode                 U  Unset all addresses
13300                                         S  Switch to single mode
13301 </PRE>
13302 <!--chtml endif-->
13303
13304 <H2>Description of the Take Address Screen</H2>
13305
13306 This screen is designed to let you select one or more address/name
13307 combinations from the current message and put them into your address book.
13308 The cursor is initially placed on the line with the message author.
13309 Other lines include the names of people and/or mailing lists who also
13310 received the message.  Other people &quot;involved&quot; in the
13311 message (e.g. the person named as Reply-To:) are also listed here.
13312 <P>
13313
13314 The simple case is adding a new, single entry into your address book. To
13315 do this, simply highlight the correct line and press
13316 <!--chtml if pinemode="function_key"-->
13317 F4.
13318 <!--chtml else-->
13319 &quot;T&quot;.
13320 <!--chtml endif-->
13321 To create a new list or add to an existing list, switch the screen display
13322 into List Mode by pressing
13323 <!--chtml if pinemode="function_key"-->
13324 F12.
13325 <!--chtml else-->
13326 &quot;L&quot;.
13327 <!--chtml endif-->
13328 In List Mode, you select the
13329 group of addresses you wish to manipulate by marking them with an
13330 &quot;X&quot;.
13331 The Set/Unset
13332 <!--chtml if pinemode="function_key"-->
13333 (F9)
13334 <!--chtml else-->
13335 (&quot;X&quot;)
13336 <!--chtml endif-->
13337 command will turn the &quot;X&quot; on for the
13338 highlighted address if it was off or turn it off if it was previously on.
13339 The SetAll command will select all of the addresses, and the UnSetAll
13340 command will turn off all the selections.  Once you've gotten the
13341 selection the way you want it, you may create a new list by pressing
13342 <!--chtml if pinemode="function_key"-->
13343 F4.
13344 <!--chtml else-->
13345 &quot;T&quot;.
13346 <!--chtml endif-->
13347 <P>
13348
13349 In both the simple and list cases, after choosing to take the address,
13350 you will be asked for the nickname of the entry.  Typing in a new name
13351 creates the new entry/list.  Entering an existing nickname will replace
13352 the entry (simple case) or add to the list (list case).  Alternatively,
13353 you can press Ctrl-T at the nickname prompt and select an existing
13354 nickname from your address book.
13355 <P>
13356
13357 You will normally start in Single Mode, unless you used the Apply command
13358 to startup the TakeAddr screen, in which case you will start in List Mode.
13359 You may switch between the two modes at any time.  If you've already
13360 selected several addresses in List Mode, those will be remembered when you
13361 switch to Single Mode and then back to List Mode.  The set of addresses
13362 that are pre-selected when you start in List Mode are the From addresses
13363 of all of the messages you are operating on.  You may, of course, easily
13364 erase those selections with the UnSetAll command.
13365 <P>
13366
13367 If you have more than one writable address book, you will be prompted for
13368 the name of the address book you wish to add the new entry to before
13369 anything else. You can use ^N and ^P to choose among the defined address
13370 books, or type in the address book name.
13371 <P>
13372
13373 FOR MORE INFORMATION on addressing see
13374 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13375 <A HREF="h_abook_opened">Address Book Screen's</A>
13376 help text.
13377 <P>
13378 &lt;End of help on this topic&gt;
13379 </BODY>
13380 </HTML>
13381 ===== h_takeexport_screen =====
13382 <HTML>
13383 <HEAD>
13384 <TITLE>Take Export Screen Explained</TITLE>
13385 </HEAD>
13386 <BODY>
13387 <H1>TAKE EXPORT COMMANDS</H1>
13388 <!--chtml if pinemode="function_key"-->
13389 <PRE>
13390 Navigating the List of Addresses       Address Selection Commands
13391 --------------------------------       --------------------------
13392  F5  Move to previous entry            F3  Exit without taking address
13393  F6  Move to next entry                F4  Take current address(es)
13394  F7  Show previous page of address list
13395  F8  Show next page of address list
13396  F2  WhereIs (search list)
13397                                --------------
13398 Mode Toggle            F9  Set/Unset current address
13399 -----------            F10 Set all
13400  F12 Toggle between List and single mode       F11 Unset all
13401 </PRE>
13402 <!--chtml else-->
13403 <PRE>
13404 Navigating the List of Addresses       Address Selection Commands
13405 --------------------------------       --------------------------
13406  P  Move to previous entry              &lt;  Exit without taking address
13407  N  Move to next entry                  T  Take address
13408  -  Show previous page of address list
13409 Spc (space bar) Show next page of address list
13410  W  WhereIs (search list)              List Mode
13411                                        ---------
13412 Single Mode                             X  Set/Unset current address
13413 -----------                             A  Set all addresses
13414  L  Switch to list mode                 U  Unset all addresses
13415                                         S  Switch to single mode
13416 </PRE>
13417 <!--chtml endif-->
13418
13419 <H2>Description of the Take Export Screen</H2>
13420
13421 This screen is designed to let you select one or more addresses
13422 from the current message and put them into a file.
13423 Only the user@domain_name part of each address is put into the file.
13424 <P>
13425
13426 To put a single entry into a file simply highlight the correct line and press
13427 <!--chtml if pinemode="function_key"-->
13428 F4.
13429 <!--chtml else-->
13430 &quot;T&quot;.
13431 <!--chtml endif-->
13432 To put more than one entry into a file
13433 switch the screen display
13434 into List Mode by pressing
13435 <!--chtml if pinemode="function_key"-->
13436 F12.
13437 <!--chtml else-->
13438 &quot;L&quot;.
13439 <!--chtml endif-->
13440 In List Mode, you select the
13441 group of addresses you wish to manipulate by marking them with an
13442 &quot;X&quot;.
13443 The Set/Unset
13444 <!--chtml if pinemode="function_key"-->
13445 (F9)
13446 <!--chtml else-->
13447 (&quot;X&quot;)
13448 <!--chtml endif-->
13449 command will turn the &quot;X&quot; on for the
13450 highlighted address if it was off or turn it off if it was previously on.
13451 The SetAll command will select all of the addresses, and the UnSetAll
13452 command will turn off all the selections.  Once you've gotten the
13453 selection the way you want it, you may put the addresses in a file by typing
13454 <!--chtml if pinemode="function_key"-->
13455 F4.
13456 <!--chtml else-->
13457 &quot;T&quot;.
13458 <!--chtml endif-->
13459 <P>
13460
13461 You will be asked for the name of a file to put the addresses in.
13462 If the file already exists, you will be asked whether you want to Overwrite
13463 (replace) the contents of the file or Append to the contents of the file.
13464 <P>
13465
13466 &lt;End of help on this topic&gt;
13467 </BODY>
13468 </HTML>
13469 ============= h_abook_view ========================
13470 <HTML>
13471 <HEAD>
13472 <TITLE>Address Book View Explained</TITLE>
13473 </HEAD>
13474 <BODY>
13475 This function allows you to view the contents of an address book entry. You
13476 can only view one entry at a time.
13477 <P>
13478 <DL>
13479 <DT>Help
13480 <!--chtml if pinemode="function_key"-->
13481 (F1)
13482 <!--chtml else-->
13483 (?)
13484 <!--chtml endif-->
13485 </DT>
13486 <DD>
13487 Display this help text.
13488
13489 <DT>Abook
13490 <!--chtml if pinemode="function_key"-->
13491 (F3)
13492 <!--chtml else-->
13493 (&lt;)
13494 <!--chtml endif-->
13495 </DT>
13496 <DD>
13497 Go back to index of address book entries.
13498
13499 <DT>Update
13500 <!--chtml if pinemode="function_key"-->
13501 (F4)
13502 <!--chtml else-->
13503 (U)
13504 <!--chtml endif-->
13505 </DT>
13506 <DD>
13507 Update (modify) this entry.
13508
13509 <DT>ComposeTo
13510 <!--chtml if pinemode="function_key"-->
13511 (F5)
13512 <!--chtml else-->
13513 (C)
13514 <!--chtml endif-->
13515 </DT>
13516 <DD>Compose a message to the address(es) in this entry.
13517
13518 <DT>Role
13519 <!--chtml if pinemode="function_key"-->
13520 (F6)
13521 <!--chtml else-->
13522 (#)
13523 <!--chtml endif-->
13524 </DT>
13525 <DD>Compose a message to the address(es) in this entry using roles.
13526
13527 <DT>Prev Page
13528 <!--chtml if pinemode="function_key"-->
13529 (F7)
13530 <!--chtml else-->
13531 (-)
13532 <!--chtml endif-->
13533 </DT>
13534 <DD>
13535 Show the previous page of the current entry.
13536
13537 <DT>Next Page
13538 <!--chtml if pinemode="function_key"-->
13539 (F8)
13540 <!--chtml else-->
13541 (Space)
13542 <!--chtml endif-->
13543 </DT>
13544 <DD>
13545 Show the next page of the current entry.
13546
13547 <DT>Print
13548 <!--chtml if pinemode="function_key"-->
13549 (F9)
13550 <!--chtml else-->
13551 (%)
13552 <!--chtml endif-->
13553 </DT>
13554 <DD>Print the current entry.  You can select the
13555 printer or the print command via the &quot;Setup&quot; command
13556 on the MAIN MENU.
13557
13558 <DT>WhereIs
13559 <!--chtml if pinemode="function_key"-->
13560 (F10)
13561 <!--chtml else-->
13562 (W)
13563 <!--chtml endif-->
13564 </DT>
13565 <DD>Search the entry for a string of letters.  If it is
13566 found, move to it.  The string can be one word or a phrase.
13567 If there are multiple occurrences, the cursor moves to the
13568 first occurrence beyond the current cursor position.
13569
13570 <DT>Fwd Email
13571 <!--chtml if pinemode="function_key"-->
13572 (F11)
13573 <!--chtml else-->
13574 (F)
13575 <!--chtml endif-->
13576 </DT>
13577 <DD>Begin composition of a new mail message with the displayed
13578 text already inserted in the message body.
13579
13580 </DL>
13581 <P>
13582 &lt;End of help on this topic&gt;
13583 </BODY>
13584 </HTML>
13585 ============= h_ldap_view ========================
13586 <HTML>
13587 <HEAD>
13588 <TITLE>LDAP Response View Explained</TITLE>
13589 </HEAD>
13590 <BODY>
13591 This function allows you to view the contents of a directory entry. You
13592 can only view one entry at a time.
13593 <P>
13594 <DL>
13595 <DT>Help
13596 <!--chtml if pinemode="function_key"-->
13597 (F1)
13598 <!--chtml else-->
13599 (?)
13600 <!--chtml endif-->
13601 </DT>
13602 <DD>
13603 Display this help text.
13604
13605 <DT>Results Index
13606 <!--chtml if pinemode="function_key"-->
13607 (F3)
13608 <!--chtml else-->
13609 (&lt;)
13610 <!--chtml endif-->
13611 </DT>
13612 <DD>Go back to index of search results.
13613
13614 <DT>ComposeTo
13615 <!--chtml if pinemode="function_key"-->
13616 (F5)
13617 <!--chtml else-->
13618 (C)
13619 <!--chtml endif-->
13620 </DT>
13621 <DD>Compose a message to the address(es) in this entry.
13622
13623 <DT>Role
13624 <!--chtml if pinemode="function_key"-->
13625 (F6)
13626 <!--chtml else-->
13627 (#)
13628 <!--chtml endif-->
13629 </DT>
13630 <DD>Compose a message to the address(es) in this entry using roles.
13631
13632 <DT>Prev Page
13633 <!--chtml if pinemode="function_key"-->
13634 (F7)
13635 <!--chtml else-->
13636 (-)
13637 <!--chtml endif-->
13638 </DT>
13639 <DD>
13640 Show the previous page of the current entry.
13641
13642 <DT>Next Page
13643 <!--chtml if pinemode="function_key"-->
13644 (F8)
13645 <!--chtml else-->
13646 (Space)
13647 <!--chtml endif-->
13648 </DT>
13649 <DD>
13650 Show the next page of the current entry.
13651
13652 <DT>Print
13653 <!--chtml if pinemode="function_key"-->
13654 (F9)
13655 <!--chtml else-->
13656 (%)
13657 <!--chtml endif-->
13658 </DT>
13659 <DD>Print the current entry on paper.  You can select the
13660 printer or the print command via the &quot;Setup&quot; command
13661 on the MAIN MENU.
13662
13663 <DT>WhereIs
13664 <!--chtml if pinemode="function_key"-->
13665 (F10)
13666 <!--chtml else-->
13667 (W)
13668 <!--chtml endif-->
13669 </DT>
13670 <DD>Search the entry for a string of letters.  If it is
13671 found, move to it.  The string can be one word or a phrase.
13672 If there are multiple occurrences, the cursor moves to the
13673 first occurrence beyond the current cursor position.
13674
13675 <DT>Fwd Email
13676 <!--chtml if pinemode="function_key"-->
13677 (F11)
13678 <!--chtml else-->
13679 (F)
13680 <!--chtml endif-->
13681 </DT>
13682 <DD>Begin composition of a new mail message with the displayed
13683 text already inserted in the message body.
13684
13685 <DT>Save
13686 <!--chtml if pinemode="function_key"-->
13687 (F12)
13688 <!--chtml else-->
13689 (S)
13690 <!--chtml endif-->
13691 </DT>
13692 <DD>Save the displayed entry to one of your address books or export
13693 it to a file.
13694 </DL>
13695 <P>
13696 &lt;End of help on this topic&gt;
13697 </BODY>
13698 </HTML>
13699 ===== h_attachment_screen =====
13700 <HTML>
13701 <HEAD>
13702 <TITLE>Attachment Index Screen Explained</TITLE>
13703 </HEAD>
13704 <BODY>
13705 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
13706 message's attachments, and allows various operations on them.  The
13707 first attachment is usually the message text, but does not include the
13708 header portion of the message.
13709 <P>
13710 Available commands include:
13711 <P>
13712 <DL>
13713
13714 <DT>Help</DT>
13715 <DD>Show this help text.
13716
13717 <DT>Msg #<I>num</I></DT>
13718 <DD>Leave this screen without displaying or saving any attachments.
13719
13720 <DT>View</DT>
13721 <DD>View the currently selected attachment.
13722
13723 <DT>External</DT>
13724 <DD>Passes a TEXT/HTML message to an external browser for its display.
13725
13726 <DT>Prev Attach</DT>
13727 <DD>Move to previous attachment.
13728
13729 <DT>Next Attach</DT>
13730 <DD>Move to next attachment.
13731
13732 <DT>Prev Page</DT>
13733 <DD>Previous page of the listed attachments.
13734
13735 <DT>Next Page</DT>
13736 <DD>Next page of the listed attachments.
13737
13738 <DT>Delete</DT>
13739 <DD>Mark the currently selected attachment for Deletion.
13740 This does not modify the current message by deleting the attachment from
13741 it, but instead the delete flag <EM>only</EM> has an effect when saving
13742 the message to a folder.
13743 Attachments marked for deletion are not copied to the destination folder
13744 along with the rest of the message when it is saved.
13745 It is ok for the destination folder to be the same as the current folder.
13746 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
13747
13748 <DT>Undelete</DT>
13749 <DD>Turn off the Delete flag for the selected attachment.
13750
13751 <DT>Save</DT>
13752 <DD>Save the selected attachment to a file.  If the attachment is of
13753 type &quot;RFC822/Message&quot;, then the attachment will be saved to
13754 the specified mail folder.
13755
13756 <DT>Export</DT>
13757 <DD>If the attachment is of
13758 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13759 copy the message to a file in the same way this command works on
13760 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13761
13762 <DT>Pipe</DT>
13763 <DD>Pipe the attachment contents into a UNIX command (if enabled).
13764 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
13765
13766 <DT>WhereIs</DT>
13767 <DD>Find a matching string in the attachment list.
13768
13769 <DT>AboutAttch</DT>
13770 <DD>Examine various aspects of the selected attachment.
13771
13772 <DT>Print</DT>
13773 <DD>Print the selected attachment.
13774
13775 <DT>Forward</DT>
13776 <DD>Forward the selected attachment as an attachment.
13777 </DL>
13778
13779 <P>
13780
13781 All attachments can be saved or piped into a UNIX command, but some may
13782 not be readily displayed by either Alpine or an external tool.  In such
13783 cases, the reason why the message cannot be displayed is displayed on
13784 Alpine's message line.
13785 <P>
13786 &lt;End of help on this topic&gt;
13787 </BODY>
13788 </HTML>
13789 ============= h_mail_text_att_view ========================
13790 <HTML>
13791 <HEAD>
13792 <TITLE>Attachment View Screen Explained</TITLE>
13793 </HEAD>
13794 <BODY>
13795 This function allows you to view the contents of a text attachment. You
13796 can only view one attachment at a time.
13797 <P>
13798 Available commands include:
13799 <P>
13800 <DL>
13801
13802 <DT>Help</DT>
13803 <DD>Display this help text
13804
13805 <DT>AttchIndex</DT>
13806 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
13807
13808 <DT>Prev Page</DT>
13809 <DD>Show the previous page of the current attachment.
13810
13811 <DT>Next Page</DT>
13812 <DD>Show the next page of the current attachment by pressing the space bar.
13813
13814 <DT>Delete</DT>
13815 <DD>Mark the viewed attachment for Deletion.  The delete
13816 flag <EM>only</EM> has affect when saving the message to a folder.
13817 Attachments marked for deletion are excluded from the message when
13818 it is saved.  In addition, the delete mark <EM>only</EM> applies to
13819 this Alpine session.
13820
13821 <DT>Undelete</DT>
13822 <DD>Turn off the Delete flag for the selected attachment.
13823
13824 <DT>Save</DT>
13825 <DD>Copy the current attachment to a file.  If you just enter
13826 a filename, the attachment will be saved with that name in
13827 your home directory
13828 <!--chtml if pinemode="running"-->
13829 (which, in the present configuration of your system, is
13830  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13831 <!--chtml endif-->
13832 or current working directory
13833 <!--chtml if pinemode="running"-->
13834 (which, at least for your current Alpine &quot;session,&quot;
13835 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13836 <!--chtml endif-->, depending on the
13837 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13838 configuration setting.  You may enter the full
13839 path and filename to save it in another directory instead.
13840
13841 <DT>Export</DT>
13842 <DD>If the attachment is of
13843 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13844 copy the message to a file in the same way this command works on
13845 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13846 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
13847 defined, they may affect the contents of the exported file.)
13848
13849 <DT>Pipe</DT>
13850 <DD>Pipe the attachment contents into a UNIX command (if enabled)
13851
13852 <DT>WhereIs</DT>
13853 <DD>Search the attachment for a string of letters.  If it is
13854 found, move to it.  The string can be one word or a phrase.
13855 If there are multiple occurrences, the cursor moves to the
13856 first occurrence beyond the current cursor position.
13857
13858 <DT>Print</DT>
13859 <DD>Print the current attachment on paper.  You can select the
13860 printer or the print command via the &quot;Setup&quot; command
13861 on the MAIN MENU.
13862
13863 <DT>Forward</DT>
13864 <DD>Forward the selected attachment as an attachment.
13865 </DL>
13866 <P>
13867 &lt;End of help on this topic&gt;
13868 </BODY>
13869 </HTML>
13870 ============= h_journal ==============
13871 <HTML>
13872 <HEAD>
13873 <TITLE>Recent Message Journal Explained</TITLE>
13874 </HEAD>
13875 <BODY>
13876
13877 The following commands are available on this screen:
13878 <P>
13879 <DL>
13880 <DT>Help</DT>
13881 <DD>Show this help text
13882
13883 <DT>Exit</DT>
13884 <DD>Exit Viewer, and go back to mail processing
13885
13886 <DT>Prev Page</DT>
13887 <DD>Show the previous page text
13888
13889 <DT>Next Page</DT>
13890 <DD>Show the next page of text by pressing the space bar
13891
13892 <DT>Print</DT>
13893 <DD>Print the displayed text on paper.  You can select the
13894 printer or the print command via the &quot;Setup&quot; command
13895 on the MAIN MENU.
13896
13897 <DT>Fwd Email</DT>
13898 <DD>Begin composition of a new mail message with the displayed
13899 text already inserted in the message body.
13900
13901 <DT>Save</DT>
13902 <DD>Copy the displayed text to a file.  If you just enter
13903 a filename, the text will be saved with that name in
13904 your
13905 home directory
13906 <!--chtml if pinemode="running"-->
13907 (which, in the present configuration of your system, is
13908  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13909 <!--chtml endif-->
13910 or current working directory
13911 <!--chtml if pinemode="running"-->
13912 (which, at least for your current Alpine &quot;session,&quot;
13913 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13914 <!--chtml endif-->, depending on the
13915 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13916 configuration setting.   You may enter the full
13917 path and filename to save it in another directory instead.
13918
13919 <DT>WhereIs</DT>
13920 <DD>Search the text for a string of letters.  If it is
13921 found, move to it.  The string can be one word or a phrase.
13922 If there are multiple occurrences, the cursor moves to the
13923 first occurrence beyond the current cursor position.
13924 </DL>
13925 <P>
13926 &lt;End of help on this topic&gt;
13927 </BODY>
13928 </HTML>
13929 ============= h_debugjournal ==============
13930 <HTML>
13931 <HEAD>
13932 <TITLE>Debug Journal Explained</TITLE>
13933 </HEAD>
13934 <BODY>
13935
13936 The following commands are available on this screen:
13937 <P>
13938 <DL>
13939 <DT>Help</DT>
13940 <DD>Show this help text
13941
13942 <DT>Exit</DT>
13943 <DD>Exit Viewer, and go back to mail processing
13944
13945 <DT>Timestamps</DT>
13946 <DD>Turn on or off timestamps.
13947
13948 <DT>DebugView</DT>
13949 <DD>Set the level of debugging you want to see. The level may be any number
13950 in the range 0-9. Higher numbers show more debugging detail. Note that the
13951 debugging information has already been captured. This setting just causes the
13952 debugging information that you see to be filtered. If you set this to
13953 the number &quot;5&quot; then you will be shown all of the debugging information
13954 at levels 5 and below.
13955 It's actually a bit more complicated than that. A fixed amount of memory
13956 is used to store the debug information.
13957 Since the amount of memory used is limited the debugging information
13958 has to be trimmed back when it gets too large.
13959
13960 <DT>Prev Page</DT>
13961 <DD>Show the previous page text
13962
13963 <DT>Next Page</DT>
13964 <DD>Show the next page of text by pressing the space bar
13965
13966 <DT>Print</DT>
13967 <DD>Print the displayed text on paper.  You can select the
13968 printer or the print command via the &quot;Setup&quot; command
13969 on the MAIN MENU.
13970
13971 <DT>Fwd Email</DT>
13972 <DD>Begin composition of a new mail message with the displayed
13973 text already inserted in the message body.
13974
13975 <DT>Save</DT>
13976 <DD>Copy the displayed text to a file.  If you just enter
13977 a filename, the text will be saved with that name in
13978 your
13979 home directory
13980 <!--chtml if pinemode="running"-->
13981 (which, in the present configuration of your system, is
13982  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13983 <!--chtml endif-->
13984 or current working directory
13985 <!--chtml if pinemode="running"-->
13986 (which, at least for your current Alpine &quot;session,&quot;
13987 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13988 <!--chtml endif-->, depending on the
13989 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13990 configuration setting.   You may enter the full
13991 path and filename to save it in another directory instead.
13992
13993 <DT>WhereIs</DT>
13994 <DD>Search the text for a string of letters.  If it is
13995 found, move to it.  The string can be one word or a phrase.
13996 If there are multiple occurrences, the cursor moves to the
13997 first occurrence beyond the current cursor position.
13998 </DL>
13999 <P>
14000 &lt;End of help on this topic&gt;
14001 </BODY>
14002 </HTML>
14003 ============= h_simple_text_view ==============
14004 <HTML>
14005 <HEAD>
14006 <TITLE>Simple Text View Screen Explained</TITLE>
14007 </HEAD>
14008 <BODY>
14009
14010 The following commands are available on this screen:
14011 <P>
14012 <DL>
14013 <DT>Help</DT>
14014 <DD>Show this help text
14015
14016 <DT>Exit</DT>
14017 <DD>Exit Viewer, and go back to mail processing
14018
14019 <DT>Prev Page</DT>
14020 <DD>Show the previous page text
14021
14022 <DT>Next Page</DT>
14023 <DD>Show the next page of text by pressing the space bar
14024
14025 <DT>Print</DT>
14026 <DD>Print the displayed text on paper.  You can select the
14027 printer or the print command via the &quot;Setup&quot; command
14028 on the MAIN MENU.
14029
14030 <DT>Fwd Email</DT>
14031 <DD>Begin composition of a new mail message with the displayed
14032 text already inserted in the message body.
14033
14034 <DT>Save</DT>
14035 <DD>Copy the displayed text to a file.  If you just enter
14036 a filename, the attachment will be saved with that name in
14037 your
14038 home directory
14039 <!--chtml if pinemode="running"-->
14040 (which, in the present configuration of your system, is
14041  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14042 <!--chtml endif-->
14043 or current working directory
14044 <!--chtml if pinemode="running"-->
14045 (which, at least for your current Alpine &quot;session,&quot;
14046 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14047 <!--chtml endif-->, depending on the
14048 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14049 configuration setting.   You may enter the full
14050 path and filename to save it in another directory instead.
14051
14052 <DT>WhereIs</DT>
14053 <DD>Search the attachment for a string of letters.  If it is
14054 found, move to it.  The string can be one word or a phrase.
14055 If there are multiple occurrences, the cursor moves to the
14056 first occurrence beyond the current cursor position.
14057 </DL>
14058 <P>
14059 &lt;End of help on this topic&gt;
14060 </BODY>
14061 </HTML>
14062 ======= h_pine_for_windows ========
14063 <HTML>
14064 <HEAD>
14065 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
14066 </HEAD>
14067 <BODY>
14068 <H1>Getting Help In PC-Alpine</H1>
14069
14070 <P>
14071 PC-Alpine offers general and specific help text. From the <A
14072 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
14073 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
14074 specific help for that screen is available from the toolbar Help menu or
14075 with the
14076 <!--chtml if pinemode="function_key"-->
14077 &quot;F1&quot; key.
14078 <!--chtml else-->
14079 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
14080 typing &quot;?&quot; would be mistaken as entering text.
14081 <!--chtml endif-->
14082
14083 <P>
14084 Although this version of Alpine is for Microsoft Windows, it is not
14085 considered a full &quot;Graphical User Interface&quot; application.
14086 Yet, many of the controls that Windows users are accustomed to seeing,
14087 such as scrollbars and toolbars, are available.
14088
14089 <P>
14090 PC-Alpine offers considerable mouse support.  You can view what is
14091 &quot;click-able&quot; by dragging your mouse over any screen; when the
14092 arrow cursor changes into a hand, you found something. Mouse-click
14093 possibilities include navigating between screens and folders and
14094 double-clicking on hyperlinks to open your Web browser.
14095 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
14096 screen.  Examples of right-click options include &quot;copy&quot; after
14097 selecting text to copy and &quot;View in New Window&quot; when you click
14098 on a particular message in the Message Index. The menu choices available
14099 to you will vary based upon what screen is open, where on the screen your
14100 cursor is located, and even what action you have already taken.
14101
14102 <P>
14103 &lt;End of help on this topic&gt;
14104 </BODY>
14105 </HTML>
14106 ===== h_composer =====
14107 <HTML>
14108 <HEAD>
14109 <TITLE>COMPOSER COMMANDS</TITLE>
14110 </HEAD>
14111 <BODY>
14112 <H1>COMPOSER COMMANDS</H1>
14113
14114 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>
14115 &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>
14116 &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>
14117 &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>
14118 &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>
14119 &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>
14120 &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>
14121 &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>
14122 &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>
14123 &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>
14124 ---------------------------------------|&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>
14125 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>
14126 &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>
14127 &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>
14128 &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>
14129
14130 <P>
14131 NOTE:
14132 <OL>
14133  <LI>For help on a particular command, highlight the bold text associated
14134 with it above and hit Return.
14135  <LI> The availability of certain commands
14136 is determined by Alpine configuration files and system capabilities.
14137 At some sites, certain commands may not be available due to security or
14138 support concerns.
14139  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14140 Ctrl-&#92;, ESC.
14141  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14142 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14143 </OL>
14144
14145 <P>
14146 HINT: To move rapidly to the bottom of a message you are composing,
14147 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
14148 with the Mark and Cut commands to eliminate large amounts of unwanted
14149 text in a Reply.
14150
14151 <H2>Description of Composer</H2>
14152
14153 Alpine has a built-in editing program that allows you to compose messages
14154 without having to leave Alpine.  The editor is designed to be very simple to
14155 use so that you can get started writing email right away.
14156
14157 <P>
14158 Messages are usually just text, about 80 columns wide.  Using upper and
14159 lower case is encouraged.  On some systems the size limit of the message
14160 is about 100,000 characters, which is about 2,000 lines.  You can include
14161 punctuation and special characters found on most keyboards, but you can't
14162 include characters with diacritical marks and certain special symbols.
14163
14164 <P>
14165 Text automatically wraps as you type past the end of a line so you do not
14166 have to hit return.  Using the
14167 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
14168 you can also reformat text explicitly, perhaps after you have
14169 deleted some text.
14170
14171 <P>
14172 You can include other text files with the
14173 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
14174 which will prompt you for the name of the file to insert at the
14175 current cursor position.
14176
14177 <P>
14178 <UL>
14179 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14180 </UL>
14181 <P>
14182 &lt;End of help on this topic&gt;
14183 </BODY>
14184 </HTML>
14185 ====== h_composer_browse =====
14186 <HTML>
14187 <HEAD>
14188 <TITLE>BROWSER</TITLE>
14189 </HEAD>
14190 <BODY>
14191 <H1>BROWSER</H1>
14192 This screen lets you browse your files and directories.  To go to another
14193 directory (identified by &quot;(dir)&quot;), move the cursor to it and
14194 choose &quot;Select&quot; (the default choice on the menu);
14195 or choose &quot;Goto&quot; and enter the name of the directory.
14196 <!--chtml if pinemode="os_windows"-->
14197 <!--chtml else-->
14198 In Unix Alpine, you may use
14199 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
14200 to another's home directory.
14201 <!--chtml endif--><P>
14202 To select a file, move the cursor to it and
14203 choose &quot;Select&quot; (the default choice on the menu).
14204 <P>
14205 <UL>
14206 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
14207 inclusion in the
14208 message body (that is, you chose &quot;Read File&quot; with the cursor under
14209 the
14210 &quot;----- Message Text -----&quot; line
14211 while composing, then &quot;To Files&quot;):  Since the file
14212 selected will become part of the message text, it must be in a format
14213 suitable for that (Alpine does not check!), such as a plain text file.
14214 Files of other formats (for example, graphics, databases, software
14215 programs) should be
14216 <B>attached</B> to the message instead --
14217 by moving the cursor in the COMPOSE MESSAGE screen into the
14218 message header area and pressing
14219 <!--chtml if pinemode="function_key"-->
14220 F6.
14221 <!--chtml else-->
14222 Ctrl-J.
14223 <!--chtml endif-->
14224
14225 <P><LI>
14226 Note <B>if</B> you are currently using the BROWSER for saving a message
14227 attachment, or exporting a message, to a file: You can use the Add command to
14228 provide the name for a new file to save/export to, and then select that name
14229 to use it for the save/export operation.  Back at the prompt
14230 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
14231 either Overwrite or Append (it doesn't make a difference, since the file is
14232 so far empty).  Note: If you cancel the
14233 operation at that point, the file created with the Add command will remain
14234 0 bytes in size.
14235
14236 </UL>
14237 <P><UL>
14238 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14239 </UL>
14240 <P>
14241 &lt;End of help on this topic&gt;
14242 </BODY>
14243 </HTML>
14244 ====== h_composer_ins =====
14245 <HTML>
14246 <HEAD>
14247 <TITLE>INSERT TEXT FILE</TITLE>
14248 </HEAD>
14249 <BODY>
14250 <H1>INSERT TEXT FILE</H1>
14251
14252 Use this function to insert a text file. The file name
14253 given can be an absolute file path name for your system
14254 <!--chtml if pinemode="os_windows"-->
14255 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14256 with a relative pathname, or simply a file name without
14257 drive or directory specification.
14258 <!--chtml else-->
14259 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14260 a file in your home directory, or a file path relative to your
14261 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14262 your home directory or &quot;~user&quot; to refer to another
14263 account's home directory.
14264 <!--chtml endif-->
14265 <P>
14266 No wild card characters may be used.
14267 The file must reside on the system running Alpine.
14268 <P>
14269 If the
14270 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14271 feature is set, names are relative to your current working directory
14272 <!--chtml if pinemode="running"-->
14273 (which, at least for your current Alpine &quot;session,&quot;
14274 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14275 <!--chtml endif-->
14276 rather than your home directory
14277 <!--chtml if pinemode="running"-->
14278 (which, in the present configuration of your system, is
14279  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14280 <!--chtml endif-->
14281 .
14282 <P><UL>
14283 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14284 </UL>
14285 <P>
14286 &lt;End of help on this topic&gt;
14287 </BODY>
14288 </HTML>
14289 ====== h_composer_ins_m =====
14290 <HTML>
14291 <HEAD>
14292 <TITLE>INSERT MESSAGE</TITLE>
14293 </HEAD>
14294 <BODY>
14295 <H1>INSERT MESSAGE</H1>
14296
14297 Type in the number of a message in the currently open folder to insert it
14298 into your message.
14299 <P><UL>
14300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14301 </UL>
14302 <P>
14303 &lt;End of help on this topic&gt;
14304 </BODY>
14305 </HTML>
14306 ====== h_composer_search =====
14307 <HTML>
14308 <HEAD>
14309 <TITLE>Explanation of Composer Whereis Command </TITLE>
14310 </HEAD>
14311 <BODY>
14312 <H1>Help For Whereis Command</H1>
14313
14314 Whereis is used to search the message for a word or part of a word.
14315 When searching in the composer, only the message part of your mail is
14316 searched, and the cursor is put on the first occurrence appearing
14317 after the location of the cursor.  The search will wrap to the
14318 beginning of the message when it no longer finds matches in the
14319 remainder of the message.
14320
14321 To search for the same string a second time, press
14322 <!--chtml if pinemode="function_key"-->
14323 &quot;F6&quot;
14324 <!--chtml else-->
14325 &quot;^W&quot;
14326 <!--chtml endif-->
14327 to begin search and then just press RETURN to accept the previous
14328 search string shown in square brackets rather than entering a new
14329 search string.<P>
14330
14331 The &quot;Search&quot; prompt has several sub-command available:
14332
14333 <DL>
14334 <DT>Get Help</DT>
14335 <DD> Takes you to this help page.
14336
14337 <DT>Cancel</DT>
14338 <DD> Cancels the prompt.  No search takes place.
14339
14340 <DT>First Line</DT>
14341 <DD> Takes you back to the composer with the cursor on the first character
14342 of the first line of text.
14343
14344 <DT>Last Line</DT>
14345 <DD> Takes you back to the composer with the cursor on the last character
14346 of the last line of text.
14347
14348 <DT>Replace (Optional)</DT>
14349 <DD> This sub-command is enabled by the
14350 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14351 feature (which is on by default); see its help screen for details on how replacing works.
14352
14353 </DL>
14354
14355 &lt;End of help on this topic&gt;
14356 </BODY>
14357 </HTML>
14358 ====== h_sigedit_search =====
14359 <HTML>
14360 <HEAD>
14361 <TITLE>Explanation of Whereis Command </TITLE>
14362 </HEAD>
14363 <BODY>
14364 <H1>Help For Whereis Command</H1>
14365
14366 Whereis is used to search for a word or part of a word.
14367 When searching the cursor is put on the first occurrence appearing
14368 after the location of the cursor.  The search will wrap to the
14369 beginning of the signature when it no longer finds matches in the
14370 remainder of the signature.
14371
14372 To search for the same string a second time, press
14373 <!--chtml if pinemode="function_key"-->
14374 &quot;F6&quot;
14375 <!--chtml else-->
14376 &quot;^W&quot;
14377 <!--chtml endif-->
14378 to begin search and then just press RETURN to accept the previous
14379 search string shown in square brackets rather than entering a new
14380 search string.<P>
14381
14382 The &quot;Search&quot; prompt has several sub-command available:
14383
14384 <DL>
14385 <DT>Get Help</DT>
14386 <DD> Takes you to this help page.
14387
14388 <DT>Cancel</DT>
14389 <DD> Cancels the prompt.  No search takes place.
14390
14391 <DT>First Line</DT>
14392 <DD> Takes you back to the composer with the cursor on the first character
14393 of the first line of text.
14394
14395 <DT>Last Line</DT>
14396 <DD> Takes you back to the composer with the cursor on the last character
14397 of the last line of text.
14398
14399 <DT>Replace (Optional)</DT>
14400 <DD> This sub-command is enabled by the
14401 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14402 feature (which is on by default); see its help screen for details on how replacing works.
14403
14404 </DL>
14405
14406 &lt;End of help on this topic&gt;
14407 </BODY>
14408 </HTML>
14409 ======= h_composer_to ====
14410 <HTML>
14411 <HEAD>
14412 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
14413 </HEAD>
14414 <BODY>
14415 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
14416
14417 <H2>The &quot;To:&quot; field</H2>
14418 The address you enter here must be a valid email address that is reachable
14419 from your site.
14420
14421 <H2>Email Address Format</H2>
14422 You may enter a full name and email address,
14423 <!--chtml if pinemode="os_windows"-->
14424 <!--chtml else-->
14425 a local (meaning, on the same
14426 host as the one you are running Alpine on) username that Alpine will
14427 complete for you,
14428 <!--chtml endif-->
14429 the nickname of someone in a
14430 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
14431 mail alias defined by your system administrator.  When you move the cursor
14432 out of this field, the nicknames will be expanded to the addresses in your
14433 address book, and the local usernames will be expanded to include the
14434 persons' actual names.  You may enter as many addresses as you wish, but they
14435 must be separated by commas.  You can move around this and other header fields
14436 with the arrow keys and use many of the usual composer editing keys.
14437 <P>
14438 <UL>
14439 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14440 </UL>
14441
14442 <P>
14443 <H2>MESSAGE HEADER COMMANDS</H2>
14444 <!--chtml if pinemode="function_key"-->
14445 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14446 ^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>
14447 ^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>
14448 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
14449 ^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>
14450 ^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>
14451 ^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>
14452 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>
14453 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>
14454 ^@&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>
14455 ----------------------------------------|<BR>
14456 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
14457 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>
14458 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>
14459 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>
14460 <!--chtml else-->
14461 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14462 ^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>
14463 ^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>
14464 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
14465 ^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>
14466 ^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>
14467 ^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>
14468 ^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>
14469 ^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>
14470 ^@&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>
14471 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
14472 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>
14473 ^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>
14474 ^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>
14475 ^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>
14476 <!--chtml endif-->
14477
14478 <P>
14479 NOTE:
14480 <OL>
14481  <LI>For help on a particular command, highlight the bold text associated
14482 with it above and hit Return.
14483  <LI> The availability of certain commands
14484 is determined by Alpine configuration files and system capabilities.
14485 At some sites, certain commands may not be available due to security or
14486 support concerns.
14487 </OL>
14488
14489 <P>
14490 <UL>
14491 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14492 </UL><P>
14493 &lt;End of help on this topic&gt;
14494 </BODY>
14495 </HTML>
14496 ======= h_composer_cc ====
14497 <HTML>
14498 <HEAD>
14499 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
14500 </HEAD>
14501 <BODY>
14502 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
14503 The Cc: field is just like the To: field, except it is used for addressees
14504 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
14505 not directly meant directly &quot;for&quot; these recipients, but you wanted
14506 them to see the message.  The only difference the recipients see is that their
14507 name is in the Cc: field, rather than the To: field.
14508 <P>
14509 For help with Cc: field editing
14510 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14511 <P>
14512 <UL>
14513 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14514 </UL>
14515 <P>
14516 <UL>
14517 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14518 </UL><P>
14519 &lt;End of help on this topic&gt;
14520 </BODY>
14521 </HTML>
14522 ======= h_composer_bcc ====
14523 <HTML>
14524 <HEAD>
14525 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
14526 </HEAD>
14527 <BODY>
14528 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
14529 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
14530 a copy of the message to one or more people whose addresses you do not
14531 wish disclosed, either to reduce clutter or for confidentiality.
14532 <P>
14533 The format of the Bcc: field is just the same as the To: and Cc: fields in
14534 the way the addresses are entered.  The recipients listed here will
14535 receive a copy of the message, but --assuming your site's mail transport
14536 software is properly configured-- their addresses will not show up in the
14537 headers of the message, as delivered to all of the recipients.  The To:
14538 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
14539 <P>
14540 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
14541 will automatically generate and place in the To: field a pseudo-address of
14542   &quot;undisclosed-recipients: ;&quot;
14543 or whatever string has been specified in the
14544 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14545 variable.
14546 <P>
14547 The reason for this is to avoid embarrassment caused by some Internet
14548 mail transfer software that interprets a &quot;missing&quot; To: header as
14549 an error and replaces it with an Apparently-to: header that may contain
14550 the addresses you entered on the Bcc: line.  In addition, it may be
14551 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
14552 <P>
14553 You can manipulate what text ends up on the (originally) empty To:
14554 field.  Just remember to put a colon and semicolon at the end of the
14555 field, which is a special notation denoting that it is not a real address.
14556 <P>
14557 For information on message header editing
14558 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14559 <P>
14560 <UL>
14561 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14562 </UL>
14563 <P>
14564 <UL>
14565 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14566 </UL><P>
14567 &lt;End of help on this topic&gt;
14568 </BODY>
14569 </HTML>
14570 ======= h_composer_lcc ====
14571 <HTML>
14572 <HEAD>
14573 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
14574 </HEAD>
14575 <BODY>
14576 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
14577 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
14578 you wish to send a message to a list of people but avoid having all
14579 of their addresses visible, in order to reduce clutter when the
14580 message is received.
14581 <P>
14582 It is similar to the
14583 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
14584 in that individual
14585 addressees are hidden, but Lcc is designed to work specifically with
14586 distribution lists you have created in your
14587 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
14588 the nickname of the list on the Lcc line will result in the full name of
14589 your Alpine Address Book list being placed on the To: line of the message,
14590 using a special notation that distinguishes it from a real address. You
14591 must leave the To: line blank for your list name to appear there.
14592 <P>
14593 For example, if you have this list entered in your Address Book:<PRE>
14594
14595         largo         Key Largo List       DISTRIBUTION LIST:
14596                                            bogie@mgm.com
14597                                            lauren@mgm.com
14598                                            walter@mgm.com</PRE>
14599
14600
14601 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
14602 the result is:<PRE>
14603
14604         To      : Key Largo List: ;
14605         Cc      :
14606         Bcc     :
14607         Fcc     : sent-mail
14608         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
14609                   lauren@mgm.com,
14610                   walter@mgm.com
14611         Subject :</PRE>
14612
14613 Each recipient listed on the Lcc: line receives a copy of the message
14614 without their address being visible (as though they were listed on the
14615 Bcc: line). The colon-semicolon notation used to put the full-name of the
14616 list on the To: line is a special address format that doesn't specify any
14617 actual addressees, but does give some information to the recipients of the
14618 message.
14619 <P>
14620 Note: if after entering an LCC, you delete the list name that is placed
14621 on the To: line, then recipients will see <PRE>
14622        To: undisclosed-recipients: ;</PRE>
14623
14624 (or whatever string is defined in the
14625 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14626 variable) just as in the BCC case.
14627 <P>
14628 For help with Lcc: field editing
14629 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14630 <P>
14631 <UL>
14632 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14633 </UL>
14634 <P>
14635 <UL>
14636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14637 </UL><P>
14638 &lt;End of help on this topic&gt;
14639 </BODY>
14640 </HTML>
14641 ======= h_composer_from =======
14642 <HTML>
14643 <HEAD>
14644 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
14645 </HEAD>
14646 <BODY>
14647 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
14648
14649 This header carries your return address.  It is the address toward which
14650 replies (and often, future unrelated correspondence) will be directed,
14651 unless you have <A HREF="h_config_custom_hdrs">defined an optional
14652 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
14653 sure this address is correct.
14654 <P>
14655 For help with message header editing
14656 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14657 <P>
14658 <UL>
14659 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14660 </UL>
14661 <P>
14662 <UL>
14663 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14664 </UL><P>
14665 &lt;End of help on this topic&gt;
14666 </BODY>
14667 </HTML>
14668 ======= h_composer_reply_to =======
14669 <HTML>
14670 <HEAD>
14671 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
14672 </HEAD>
14673 <BODY>
14674 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
14675
14676 Most people should not need this header. The Reply-To: header is used in
14677 cases where you would like replies to your messages to be directed to an
14678 address other than your normal &quot;From:&quot; address.  This is atypical,
14679 but can happen when you use multiple machines and do not have the same account
14680 name on each one, or when you wish to direct certain replies to accounts
14681 or folders designated for specific classes of correspondence.
14682 <P>
14683 For help with message header editing
14684 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14685 <P>
14686 <UL>
14687 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14688 </UL>
14689
14690 <P>
14691 <UL>
14692 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14693 </UL><P>
14694 &lt;End of help on this topic&gt;
14695 </BODY>
14696 </HTML>
14697 ======= h_composer_custom_addr ====
14698 <HTML>
14699 <HEAD>
14700 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14701 </HEAD>
14702 <BODY>
14703 <H1>CUSTOMIZED HEADER FIELD</H1>
14704 This is a customized header, i.e. not one that is part of Alpine's normal
14705 set of Compose headers.
14706 <P>
14707 For help with message header editing
14708 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14709 <P>
14710 <UL>
14711 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14712 </UL>
14713 <P>
14714 <UL>
14715 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14716 </UL><P>
14717 &lt;End of help on this topic&gt;
14718 </BODY>
14719 </HTML>
14720 ======= h_composer_custom_free ====
14721 <HTML>
14722 <HEAD>
14723 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14724 </HEAD>
14725 <BODY>
14726 <H1>CUSTOMIZED HEADER FIELD</H1>
14727 This is a customized header, i.e. not one that is part of Alpine's normal
14728 set of Compose headers.
14729 <P>
14730 This field consists of arbitrary text.
14731 <P>
14732 For help with message header editing
14733 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14734 <P>
14735 <UL>
14736 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14737 </UL><P>
14738 &lt;End of help on this topic&gt;
14739 </BODY>
14740 </HTML>
14741 ====== h_composer_news =====
14742 <HTML>
14743 <HEAD>
14744 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
14745 </HEAD>
14746 <BODY>
14747 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
14748 Use the newsgroups line to specify any and all USENET newsgroups to which
14749 your message should be posted.  When composing a message from scratch, this
14750 line may be hidden.  If so, just press the rich headers command
14751 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
14752 to make it visible.
14753 <P>
14754 <EM>Be aware</EM> that when you post to a newsgroup thousands of
14755 people will be reading your message.  Also, you or your system manager
14756 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
14757 in order for you to be able to post.
14758 <P>
14759 For help with message header editing
14760 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14761 <P><UL>
14762 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14763 </UL>
14764 <P>
14765 &lt;End of help on this topic&gt;
14766 </BODY>
14767 </HTML>
14768 ======= h_composer_fcc ====
14769 <HTML>
14770 <HEADER>
14771 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
14772 </HEADER>
14773 <BODY>
14774 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
14775 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
14776 each outgoing message.  The default value can be configured with the
14777 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
14778 the file carbon copy on any message you send by editing the FCC header.<p>
14779
14780 You may type ^T to get a list of all your folders and select one to use as
14781 the FCC for this message.<P>
14782
14783 For help with message header editing
14784 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14785 <P>
14786 <UL>
14787 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14788 </UL><P>
14789 &lt;End of help on this topic&gt;
14790 </BODY>
14791 </HTML>
14792 ======= h_composer_subject ====
14793 <HTML>
14794 <HEADER>
14795 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
14796 </HEADER>
14797 <BODY>
14798 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
14799
14800 The subject header provides a place to enter a few words that summarize
14801 the topic of the message you are sending.  You may leave this line blank,
14802 but it is considered a courtesy to use a meaningful subject.<p>
14803
14804 For help with message header editing
14805 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14806 <P>
14807 <UL>
14808 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14809 </UL><P>
14810 &lt;End of help on this topic&gt;
14811 </BODY>
14812 </HTML>
14813 ======= h_composer_attachment ====
14814 <HTML>
14815 <HEAD>
14816 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
14817 </HEAD>
14818 <BODY>
14819 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
14820
14821 The &quot;Attchmnt:&quot; field is where you specify what file or
14822 files you'd like attached to
14823 the message you are composing.  Those files must reside on the machine
14824 running Alpine. If your file is on a PC or Mac and you run Alpine with an
14825 account on a Unix machine, you'll have to transfer it before attaching it.
14826 Contact local computer support people for assistance with transferring.
14827
14828 <P>
14829 The file name
14830 given can be an absolute file path name for your system
14831 <!--chtml if pinemode="os_windows"-->
14832 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14833 with a relative pathname, or simply a file name without
14834 drive or directory specification.
14835 <!--chtml else-->
14836 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14837 a file in your home directory, or a file path relative to your
14838 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14839 your home directory or &quot;~user&quot; to refer to another
14840 account's home directory.
14841 <!--chtml endif--><P>
14842 No wild card characters may be used.
14843 <P>If the
14844 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14845 feature is set, names are relative to your current working directory
14846 <!--chtml if pinemode="running"-->
14847 (which, at least for your current Alpine &quot;session,&quot;
14848 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14849 <!--chtml endif-->
14850 rather than your home directory
14851 <!--chtml if pinemode="running"-->
14852 (which, in the present configuration of your system, is
14853  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14854 <!--chtml endif-->
14855 .
14856 <P>
14857 Alpine uses MIME encoding for attachments, so binaries and files of any
14858 length can safely be delivered to any MIME-capable mail reading program.
14859 If you send an attachment to someone who does not have a MIME-capable mail
14860 reading program yet, then the main message text will be readable, but
14861 attachments (even attachments that are just plain text) are not.
14862 <P>
14863
14864 Typing the filename on the Attchmnt: line achieves the same
14865 result as using the
14866 <!--chtml if pinemode="function_key"-->
14867 F6
14868 <!--chtml else-->
14869 Ctrl-J
14870 <!--chtml endif--> command.
14871 <P>
14872
14873 If you Forward a message with attachments, you may delete them from your
14874 Forwarded message by editing the Attchmnt header line.
14875 <P>
14876
14877 For help with message header editing
14878 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14879 <P>
14880 <UL>
14881 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14882 </UL><P>
14883 &lt;End of help on this topic&gt;
14884 </BODY>
14885 </HTML>
14886 ======= h_composer_ctrl_j ====
14887 <HTML>
14888 <HEAD>
14889 <TITLE>COMPOSER ATTACH</TITLE>
14890 </HEAD>
14891 <BODY>
14892 After the
14893 <!--chtml if pinemode="function_key"-->
14894 F6
14895 <!--chtml else-->
14896 Ctrl-J
14897 <!--chtml endif--> command:
14898 At the &quot;File to attach:&quot; prompt, enter the name of the
14899 existing file to attach to your message.
14900 When the feature
14901 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
14902 is set
14903 you need only enter the beginning of the filename (enough of it to uniquely
14904 identify the file) and press TAB to complete it.
14905
14906 Or, press ^T to use the BROWSER screen for
14907 selecting the file.  <P>
14908 For more information on attaching files, see the help screen for the
14909 composer's
14910 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
14911 but can be revealed using the
14912 <!--chtml if pinemode="function_key"-->
14913 F5
14914 <!--chtml else-->
14915 Ctrl-R
14916 <!--chtml endif-->
14917 command with the cursor positioned above the
14918 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
14919 <P>
14920 &lt;End of help on this topic&gt;
14921 </BODY>
14922 </HTML>
14923 ======= h_edit_nav_cmds =========
14924 <HTML>
14925 <HEAD>
14926 <TITLE>Composer Editing Commands Explained</TITLE>
14927 </HEAD>
14928 <BODY>
14929 <H1>EDITING and NAVIGATION COMMANDS</H1>
14930 <!--chtml if pinemode="function_key"-->
14931 <PRE>
14932 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14933 ^B (Left Arrow)    Back character       | ^D       Delete current character
14934 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14935 ^P (Up Arrow)      Previous line        |
14936 ^N (Down Arrow)    Next line            | F9       Cut marked text or
14937 ^A                 Beginning of line    |            delete current line
14938 ^E                 End of line          | F10      Undelete line(s)
14939 F7                 Previous page        |
14940 F8                 Next page            |-------------------------------------
14941 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14942 ----------------------------------------|
14943 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
14944 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
14945 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
14946 </PRE>
14947 <!--chtml else-->
14948 <PRE>
14949 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14950 ^B (Left Arrow)    Back character       | ^D       Delete current character
14951 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14952 ^P (Up Arrow)      Previous line        |
14953 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
14954 ^A                 Beginning of line    |            delete current line
14955 ^E                 End of line          | ^U       Undelete line(s)
14956 ^Y                 Previous page        |
14957 ^V                 Next page            |-------------------------------------
14958 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14959 ----------------------------------------|
14960 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
14961 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
14962 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
14963 </PRE>
14964 <!--chtml endif-->
14965 &lt;End of help on this topic&gt;
14966 </BODY>
14967 </HTML>
14968 ===== h_composer_sigedit =====
14969 <HTML>
14970 <HEAD>
14971 <TITLE>Signature Editor Commands Explained</TITLE>
14972 </HEAD>
14973 <BODY>
14974 <H1>SIGNATURE EDITOR COMMANDS</H1>
14975 <!--chtml if pinemode="function_key"-->
14976 <PRE>
14977 CURSOR MOTION KEYS                     |EDITING KEYS
14978   ^B (Left Arrow)   Back character     | ^D       Delete current character
14979   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14980   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14981   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14982   ^A                Beginning of line  |           delete current line
14983   ^E                End of line        | F10       Paste text, undelete lines
14984   F7                Previous page      |           cut with ^K, or unjustify
14985   F8                Next page          |-------------------------------------
14986   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14987 ---------------------------------------| F6       Whereis (search for string)
14988 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14989  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14990                  |  ^Z    Suspend      | ^L       Redraw Screen
14991  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14992 </PRE>
14993 <!--chtml else-->
14994 <PRE>
14995 CURSOR MOTION KEYS                     |EDITING KEYS
14996   ^B (Left Arrow)   Back character     | ^D       Delete current character
14997   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14998   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14999   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
15000   ^A                Beginning of line  |           delete current line
15001   ^E                End of line        | ^U        Paste text, undelete lines
15002   ^Y                Previous page      |           cut with ^K, or unjustify
15003   ^V                Next page          |-------------------------------------
15004   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15005 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
15006 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
15007  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
15008                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
15009  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
15010 </PRE>
15011 <!--chtml endif-->
15012
15013 NOTE: The presence or absence of the following commands is determined
15014 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
15015 some of these commands may be administratively disabled by your system
15016 manager; if they don't work, please check with your local help desk
15017 before reporting a bug.
15018 <P>
15019 <UL>
15020  <LI>Suspend (suspends Alpine and gives a system prompt)
15021  <LI>Alternate editor (allows you to compose with your own editor)
15022 </UL>
15023 <P>
15024
15025 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
15026 Ctrl-&#92;, ESC
15027 <P>
15028
15029 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
15030 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
15031 <P>
15032 &lt;End of help on this topic&gt;
15033 </BODY>
15034 </HTML>
15035 ===== h_composer_commentedit =====
15036 <HTML>
15037 <HEAD>
15038 <TITLE>Comment Editor Commands Explained</TITLE>
15039 </HEAD>
15040 <BODY>
15041 <H1>COMMENT EDITOR COMMANDS</H1>
15042 <!--chtml if pinemode="function_key"-->
15043 <PRE>
15044 CURSOR MOTION KEYS                     |EDITING KEYS
15045   ^B (Left Arrow)   Back character     | ^D       Delete current character
15046   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15047   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15048   ^N (Down Arrow)   Next line          | F9       Cut marked text or
15049   ^A                Beginning of line  |           delete current line
15050   ^E                End of line        | F10       Paste text, undelete lines
15051   F7                Previous page      |           cut with ^K, or unjustify
15052   F8                Next page          |-------------------------------------
15053   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15054 ---------------------------------------| F6       Whereis (search for string)
15055 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
15056  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
15057                  |  ^Z    Suspend      | ^L       Redraw Screen
15058  F2   Send       |  F6    Alt. editor  | F5       Read in a file
15059 </PRE>
15060 <!--chtml else-->
15061 <PRE>
15062 CURSOR MOTION KEYS                     |EDITING KEYS
15063   ^B (Left Arrow)   Back character     | ^D       Delete current character
15064   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
15065   ^P (Up Arrow)     Previous line      | ^^       Set a mark
15066   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
15067   ^A                Beginning of line  |           delete current line
15068   ^E                End of line        | ^U        Paste text, undelete lines
15069   ^Y                Previous page      |           cut with ^K, or unjustify
15070   ^V                Next page          |-------------------------------------
15071   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
15072 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
15073 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
15074  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
15075                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
15076  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
15077 </PRE>
15078 <!--chtml endif-->
15079
15080 NOTE: The presence or absence of the following commands is determined
15081 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
15082 some of these commands may be administratively disabled by your system
15083 manager; if they don't work, please check with your local help desk
15084 before reporting a bug.
15085 <P>
15086 <UL>
15087  <LI>Suspend (suspends Alpine and gives a system prompt)
15088  <LI>Alternate editor (allows you to compose with your own editor)
15089 </UL>
15090 <P>
15091
15092 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
15093 Ctrl-&#92;, ESC
15094 <P>
15095
15096 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
15097 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
15098 <P>
15099 &lt;End of help on this topic&gt;
15100 </BODY>
15101 </HTML>
15102 ======= h_composer_abook_nick =======
15103 <HTML>
15104 <HEAD>
15105 <TITLE>Addressbook Nickname Explained</TITLE>
15106 </HEAD>
15107 <BODY>
15108 This is a short nickname for this address book entry.  If it is used in
15109 place of an address from the composer, the composer will fill in the
15110 address(es) for the entry that matches the nickname.
15111 <P>
15112
15113 Look <A HREF="h_edit_nav_cmds">here</A>
15114 to see the available Editing and Navigation commands.
15115 <P>
15116 &lt;End of help on this topic&gt;
15117 </BODY>
15118 </HTML>
15119 ======= h_composer_abook_full =======
15120 <HTML>
15121 <HEAD>
15122 <TITLE>Addressbook Fullname Explained</TITLE>
15123 </HEAD>
15124 <BODY>
15125 This is the full name field for this entry.  If this is going to be a
15126 distribution list (more than one address), it should be a descriptive
15127 phrase describing the list.  It will be included in the mail header if you
15128 put the list in the To: or CC: field, or in the To: line if you put the
15129 list in the Lcc: field.  It's OK to leave this field blank (and OK to
15130 leave any of the other fields blank, too). If this address book entry is
15131 going to be a simple entry with just one address, then this field is the
15132 person's name. When you send mail to this entry, this is the field to the
15133 left of the brackets. That is, it is the most readable part of the
15134 address. For example, in the sample address:
15135 <PRE>
15136        John Doe &lt;jdoe@some.domain&gt;
15137 </PRE>
15138 "John Doe" is the full name field. If you are sorting your address book
15139 with one of the options that uses full names, then it might be useful to
15140 enter the full name as "Last, First", for example:
15141 <PRE>
15142        Doe, John
15143 </PRE>
15144 so that it will be sorted using Doe instead of John. This will be changed
15145 back into John Doe when you use it.
15146 <P>
15147 Look <A HREF="h_edit_nav_cmds">here</A>
15148 to see the available Editing and Navigation commands.
15149 <P>
15150 &lt;End of help on this topic&gt;
15151 </BODY>
15152 </HTML>
15153 ======= h_composer_abook_fcc =======
15154 <HTML>
15155 <HEAD>
15156 <TITLE>Addressbook Fcc Explained</TITLE>
15157 </HEAD>
15158 <BODY>
15159 If this entry is the first one in the To: line of an outgoing message,
15160 this field will be used for the Fcc (File Carbon Copy) instead of whatever
15161 you would normally get (which depends on which
15162 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
15163 you've chosen).
15164 <P>
15165 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
15166 that you don't want any Fcc associated with this entry.
15167 <P>
15168 Look <A HREF="h_edit_nav_cmds">here</A>
15169 to see the available Editing and Navigation commands.
15170 <P>
15171 &lt;End of help on this topic&gt;
15172 </BODY>
15173 </HTML>
15174 ====== h_config_combined_abook_display =====
15175 <HTML>
15176 <HEAD>
15177 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
15178 </HEAD>
15179 <BODY>
15180 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
15181
15182 This feature affects the address book display screens.
15183 Normally, expanding an address book from the ADDRESS BOOK LIST screen
15184 will cause the remaining address books and directory servers to disappear
15185 from the screen, leaving only the entries of the expanded address book.
15186 If this feature is set, then the other address books will remain on the screen,
15187 so that all of the address books can be present at once.
15188
15189 <P>
15190 The way that commands work won't be changed.
15191 For example, the Select All command will select all of the entries in the
15192 current address book, not all of the entries in all of the address books.
15193 The WhereIs command will change a little.
15194 It will search through all of the text on the screen plus all of the entries
15195 from expanded address books.
15196
15197 <P>
15198 When this feature is set, the setting of the feature
15199 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
15200 has an effect.
15201 <P>
15202 &lt;End of help on this topic&gt;
15203 </BODY>
15204 </HTML>
15205 ====== h_config_titlebar_color_style =====
15206 <HTML>
15207 <HEAD>
15208 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
15209 </HEAD>
15210 <BODY>
15211 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
15212
15213 This option affects the colors used to display the titlebar (the top
15214 line on the screen) when viewing a message.
15215
15216 <P>
15217 The available options include:
15218 <P>
15219
15220 <DL>
15221 <DT>default</DT>
15222 <DD>The color of the titlebar will be the color you set for the
15223 <A HREF="h_config_title_color">Title Color</A>.
15224 The Title Color may be set by using the
15225 <A HREF="h_color_setup">Setup Kolor</A> screen.
15226 </DD>
15227
15228 <DT>indexline</DT>
15229 <DD>The color of the titlebar will be the same as the color of the
15230 index line corresponding to the message being viewed.
15231 The rules that determine what color the index line will be may be set
15232 up by going to the Setup/Rules/Indexcolor screen.
15233 If the index line for a message is not colored explicitly by the
15234 Indexcolor rules, then the titlebar will be colored the same as for
15235 the &quot;default&quot; option above (which is not the same color that
15236 the index line itself will have).
15237 </DD>
15238
15239 <DT>reverse-indexline</DT>
15240 <DD>This is similar to the &quot;indexline&quot; option except the
15241 foreground and background colors from the corresponding index line will
15242 be reversed.
15243 For example, if the index line color is red letters on a white background,
15244 then the titlebar will be white letters on a red background.
15245 If the index line for a message is not colored explicitly by the
15246 Indexcolor rules, then the titlebar will be colored the same as for
15247 the &quot;default&quot; option above (which is not the same color that
15248 the index line itself will have).
15249 </DD>
15250 </DL>
15251
15252 <P>
15253
15254 <UL>
15255 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15256 </UL><P>
15257 &lt;End of help on this topic&gt;
15258 </BODY>
15259 </HTML>
15260 ====== h_config_index_color_style =====
15261 <HTML>
15262 <HEAD>
15263 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
15264 </HEAD>
15265 <BODY>
15266 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
15267
15268 This option affects the colors used to display the current line in the
15269 MESSAGE INDEX screen.
15270 If you do not have Index Color Rules defined, then this option will
15271 have no effect in the index.
15272 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
15273 <P>
15274 If the option
15275 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
15276 is turned on and the
15277 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
15278 is set to something other than the default, then
15279 this option also affects the color used to display the current folder
15280 in the Incoming FOLDER LIST screen.
15281
15282 <P>
15283 The available options include:
15284 <P>
15285
15286 <DL>
15287 <DT>flip-colors</DT>
15288 <DD>This is the default.
15289 If an index line is colored because it matches one of your
15290 Index Color Rules, then its colors will be reversed when it is the currently
15291 highlighted line.
15292 For example, if the line is normally red text on a blue background, then
15293 when it is the current line it will be drawn as blue text on a red background.
15294 <P>
15295 The rest of the option values all revert to this flip-colors behavior if
15296 there is no Reverse Color defined.
15297 </DD>
15298
15299 <DT>reverse</DT>
15300 <DD>With this option the Reverse color is always used to highlight the
15301 current line.
15302 </DD>
15303
15304 <DT>reverse-fg</DT>
15305 <DD>The foreground part of the Reverse Color is used to highlight
15306 the current line.
15307 If this would cause the text to be unreadable (because the foreground and
15308 background colors are the same) or if it would cause no change in the
15309 color of the index line, then the colors are flipped instead.
15310 <P>
15311 Some people think this works particularly well if you use different
15312 background colors to emphasize &quot;interesting&quot; lines,
15313 but always with the same Normal foreground color,
15314 and you use a different foreground color for the Reverse Color.
15315 </DD>
15316
15317 <DT>reverse-fg-no-ambiguity</DT>
15318 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
15319 the resulting color will be exactly the same as the regular Reverse
15320 Color.
15321 That can lead to some possible confusion because an
15322 &quot;interesting&quot;
15323 line that is the current line will be displayed exactly the same as a
15324 non-interesting line that is current.
15325 You can't tell whether the line is just a regular current line or if it is
15326 an &quot;interesting&quot; current line by looking at the color.
15327 Setting the option to this value removes that ambiguity.
15328 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
15329 interesting current line would look just like a non-interesting current line.
15330 In that case, the interesting line's colors are simply flipped (like in the
15331 default behavior).
15332 <P>
15333 As an alternative way to preserve the line's interestingness in this case,
15334 you may find that using both a different foreground and a different
15335 background color for the interesting line will help.
15336 </DD>
15337
15338 <DT>reverse-bg</DT>
15339 <DD>The background part of the Reverse Color is used to highlight
15340 the current line.
15341 If this would cause the text to be unreadable (because the foreground and
15342 background colors are the same) or if it would cause no change in the
15343 color of the index line, then the colors are flipped instead.
15344 <P>
15345 Some people think this works particularly well if you use different
15346 foreground colors to emphasize &quot;interesting&quot; lines,
15347 but always with the same Normal background color,
15348 and you use a different background color for the Reverse Color.
15349 </DD>
15350
15351 <DT>reverse-bg-no-ambiguity</DT>
15352 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
15353 rule may also result in a color that is exactly the same as the regular
15354 Reverse Color.
15355 Setting the option to this value removes that ambiguity.
15356 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
15357 current line has the same color as the Reverse Color.
15358 In that case, the interesting line's colors are simply flipped (like in the
15359 default behavior).
15360 </DD>
15361 </DL>
15362
15363 <P>
15364
15365 <UL>
15366 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15367 </UL><P>
15368 &lt;End of help on this topic&gt;
15369 </BODY>
15370 </HTML>
15371 ====== h_config_expanded_addrbooks =====
15372 <HTML>
15373 <HEAD>
15374 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
15375 </HEAD>
15376 <BODY>
15377 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
15378
15379 If multiple address books (either personal or global) are defined, and you
15380 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
15381 screen, then set this feature. This feature will have no effect unless the
15382 feature
15383 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
15384 is also set.
15385 <P>
15386 &lt;End of help on this topic&gt;
15387 </BODY>
15388 </HTML>
15389 ====== h_config_combined_folder_display =====
15390 <HTML>
15391 <HEAD>
15392 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
15393 </HEAD>
15394 <BODY>
15395 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
15396
15397 This feature affects the folder list display screens.
15398 Normally, each folder list is viewed within its collection only.  This
15399 command allows folder lists to be viewed within a single screen that
15400 combines the contents of all collections.
15401
15402 <P>
15403 The way that commands work won't be changed.
15404 For example, the Select All command will select all of the folders in the
15405 current collection, not all of the entries in all of the collections.
15406 The WhereIs command will change a little.
15407 It will search through all of the folders in the current collection as well
15408 as all the folder in any other expanded collection.
15409
15410 <P>
15411 When this feature is set, the setting of the feature
15412 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
15413 has an effect.
15414 <P>
15415 &lt;End of help on this topic&gt;
15416 </BODY>
15417 </HTML>
15418 ====== h_config_combined_subdir_display =====
15419 <HTML>
15420 <HEAD>
15421 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
15422 </HEAD>
15423 <BODY>
15424 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
15425
15426 This feature affects the Folder List screen when
15427 the
15428 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
15429 feature is enabled.  Normally, selecting a directory from the Folder
15430 List takes you into a new screen displaying only the contents of
15431 that directory.
15432
15433 <P>
15434 Enabling this feature will cause the contents of the selected
15435 directory to be
15436 displayed within the boundaries of the &quot;Collection&quot; it
15437 is a part of.  All previously displayed collections will remain
15438 in the screen.
15439
15440 <P>
15441 The way that commands work won't be changed.
15442 For example, the Select All command will select all of the folders in the
15443 directory, as opposed to all of the entries in all of the collections.
15444 The WhereIs command will change a little.
15445 It will search through all of the folders in the current collection as well
15446 as all the folder in any other expanded collection.
15447
15448 <P>
15449 &lt;End of help on this topic&gt;
15450 </BODY>
15451 </HTML>
15452 ====== h_config_separate_fold_dir_view =====
15453 <HTML>
15454 <HEAD>
15455 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
15456 </HEAD>
15457 <BODY>
15458 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
15459
15460 This feature affects folder collections wherein a folder
15461 and directory can have the same name.  By default, Alpine displays them
15462 only once, denoting that it is both a folder and directory by appending
15463 the folder name with the hierarchy character enclosed
15464 in square brackets.
15465
15466
15467 <P>
15468 Enabling this feature will cause Alpine to display such names
15469 separately marking the name representing a directory with a trailing
15470 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
15471
15472 <P>
15473 The feature also alters the command set slightly.  By default, the
15474 right-arrow descends into the directory, while hitting the Return key will
15475 cause the folder by that name to be opened.
15476
15477 <P>
15478 With this feature set, the Return key will open the highlighted folder, or
15479 enter the highlighted directory.
15480
15481 <P>
15482 &lt;End of help on this topic&gt;
15483 </BODY>
15484 </HTML>
15485 ====== h_config_expanded_folders =====
15486 <HTML>
15487 <HEAD>
15488 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
15489 </HEAD>
15490 <BODY>
15491 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
15492
15493 If multiple folder collections are defined, and you
15494 wish to have them all expanded implicitly upon entering the FOLDER LIST
15495 screen, then set this feature. This feature will have no effect unless the
15496 feature
15497 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
15498 is also set.
15499 <P>
15500 &lt;End of help on this topic&gt;
15501 </BODY>
15502 </HTML>
15503 ======= h_config_ldap_server =======
15504 <HTML>
15505 <HEAD>
15506 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
15507 </HEAD>
15508 <BODY>
15509 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
15510 This is the name of the host where an LDAP server is running.
15511 For redundancy, this may be a space-delimited set of server names, in which
15512 case the first server that answers is used.
15513 Each of the server names may be optionally followed by
15514 a colon and a port number.
15515 If this form is used then the port number configured below in the
15516 <EM>port</EM> field is not used.
15517 <P>
15518 To find out whether your organization has its own LDAP server,
15519 contact its computing support staff.
15520 <P><UL>
15521 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15522 </UL>
15523 <P>
15524 &lt;End of help on this topic&gt;
15525 </BODY>
15526 </HTML>
15527 ======= h_config_ldap_base =======
15528 <HTML>
15529 <HEAD>
15530 <TITLE>LDAP OPTION: Search-Base</TITLE>
15531 </HEAD>
15532 <BODY>
15533 <H1>LDAP OPTION: Search-Base</H1>
15534
15535 This is the search base to be used on this server.  It functions as a filter
15536 by restricting your searches in the LDAP server database
15537 to the specified contents of the specified fields.  Without it, searches
15538 submitted to this directory server may fail.  It might be something
15539 like:
15540
15541 <PRE>
15542       O = &lt;Your Organization Name&gt;, C = US
15543 </PRE>
15544 or it might be blank.
15545 (Some LDAP servers actually ignore anything specified here.)
15546 <P>
15547 If in doubt what parameters you should specify here,
15548 contact the maintainers of the LDAP server.
15549 <P><UL>
15550 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15551 </UL>
15552 <P>
15553 &lt;End of help on this topic&gt;
15554 </BODY>
15555 </HTML>
15556 ======= h_config_ldap_port =======
15557 <HTML>
15558 <HEAD>
15559 <TITLE>LDAP OPTION: Port</TITLE>
15560 </HEAD>
15561 <BODY>
15562 <H1>LDAP OPTION: Port</H1>
15563
15564 This is the TCP port number to be used with this LDAP server. If you leave
15565 this blank port 389 will be used.
15566 <P>
15567 &lt;End of help on this topic&gt;
15568 </BODY>
15569 </HTML>
15570 ======= h_config_ldap_nick =======
15571 <HTML>
15572 <HEAD>
15573 <TITLE>LDAP OPTION: Nickname</TITLE>
15574 </HEAD>
15575 <BODY>
15576 <H1>LDAP OPTION: Nickname</H1>
15577
15578 This is a nickname to be used in displays. If you don't supply a
15579 nickname the server name
15580 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
15581 will be used instead.  This option is strictly for your convenience.
15582 <P>
15583 &lt;End of help on this topic&gt;
15584 </BODY>
15585 </HTML>
15586 ======= h_config_ldap_binddn =======
15587 <HTML>
15588 <HEAD>
15589 <TITLE>LDAP OPTION: Bind-DN</TITLE>
15590 </HEAD>
15591 <BODY>
15592 <H1>LDAP OPTION: Bind-DN</H1>
15593
15594 You may need to authenticate to the LDAP server before you are able to use it.
15595 This is the Distinguished Name to bind to when authenticating to this server.
15596 Try leaving this blank until you know you need it.
15597 <P>
15598 Alpine only knows about LDAP Simple authentication.
15599 It does not attempt LDAP SASL authentication.
15600 The DN and password will be sent in the clear unless TLS encryption is
15601 being used on this connection.
15602 Because of this, you may want to set the LDAP feature
15603 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
15604 or the feature
15605 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15606 if you are going to be providing a password.
15607 <P><UL>
15608 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15609 </UL>
15610 <P>
15611 &lt;End of help on this topic&gt;
15612 </BODY>
15613 </HTML>
15614 ======= h_config_ldap_opts_impl =======
15615 <HTML>
15616 <HEAD>
15617 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
15618 </HEAD>
15619 <BODY>
15620 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
15621
15622 Set this to have lookups done to this server implicitly from the composer.
15623 If an address doesn't look like a fully-qualified address, it will be looked
15624 up in your address books, and if it doesn't match a nickname there, then it
15625 will be looked up on the LDAP servers that have this feature set.
15626 The lookups will also be done when using the address completion feature
15627 (TAB command) in the composer if any of the serves have this feature set.
15628 Also see the LDAP feature
15629 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
15630 and the Setup/Config feature
15631 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15632 <P>
15633 &lt;End of help on this topic&gt;
15634 </BODY>
15635 </HTML>
15636 ======= h_config_ldap_opts_tls =======
15637 <HTML>
15638 <HEAD>
15639 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
15640 </HEAD>
15641 <BODY>
15642 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
15643
15644 When connecting to this server Alpine will attempt to use TLS encryption
15645 on the connection.
15646 Also see the closely related feature
15647 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15648 <P>
15649 Note that if this option is set, then
15650 <A HREF="h_config_ldap_opts_ldaps">
15651 &quot;Require-LDAPS-On-Connection&quot;</A>
15652 can not be enabled for this server. You must disable this feature in
15653 order to use
15654 <A HREF="h_config_ldap_opts_ldaps">
15655 &quot;Require-LDAPS-On-Connection&quot;</A>
15656 <P>
15657 &lt;End of help on this topic&gt;
15658 </BODY>
15659 </HTML>
15660 ======= h_config_ldap_opts_tlsmust =======
15661 <HTML>
15662 <HEAD>
15663 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
15664 </HEAD>
15665 <BODY>
15666 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
15667
15668 When connecting to this server Alpine will attempt to use TLS encryption
15669 on the connection.
15670 If the StartTLS operation fails then the connection will not be used.
15671 <P>
15672 Note that if this option is set, then
15673 <A HREF="h_config_ldap_opts_ldaps">
15674 &quot;Require-LDAPS-On-Connection&quot;</A>
15675 can not be enabled for this server. You must disable this feature in
15676 order to use
15677 <A HREF="h_config_ldap_opts_ldaps">
15678 &quot;Require-LDAPS-On-Connection&quot;</A>
15679 <P>
15680 &lt;End of help on this topic&gt;
15681 </BODY>
15682 </HTML>
15683 ======= h_config_ldap_opts_ldaps =======
15684 <HTML>
15685 <HEAD>
15686 <TITLE>LDAP FEATURE: Require-LDAPS-On-Connection</TITLE>
15687 </HEAD>
15688 <BODY>
15689 <H1>LDAP FEATURE: Require-LDAPS-On-Connection</H1>
15690
15691 When connecting to this server Alpine will use LDAPS (LDAP over SSL/TLS)
15692 on the connection.
15693 <P>
15694 This feature can not be used along with
15695 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15696  or
15697 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>.
15698 If you want to connect using StartTLS to this server, you must disable
15699 this feature first.
15700 <P>
15701 &lt;End of help on this topic&gt;
15702 </BODY>
15703 </HTML>
15704 ====== h_config_ldap_opts_rhs =====
15705 <HTML>
15706 <HEAD>
15707 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
15708 </HEAD>
15709 <BODY>
15710 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
15711
15712 Normally implicit LDAP lookups from the composer are done only for the
15713 strings you type in from the composer screen. In other words, you type in
15714 something in the To or CC field and press return, then the string is looked up.
15715 First that string is looked up in your address books. If a match is found
15716 there, then the results of that match are looked up again. If you place
15717 a string in your address book that you want to have looked up on the LDAP
15718 directory server, you need to turn on this feature. If you set this feature
15719 for a server, you almost always will also want to set the
15720 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
15721 feature. An example might serve to best illustrate this feature.
15722 <P>
15723 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
15724 entry with an
15725 address of pres@whitehouse.gov, then you might put an entry in your address
15726 book that looks like:
15727 <P>
15728 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
15729 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
15730 <P>
15731 Now, when you type &quot;bill&quot; into an
15732 address field in the composer Alpine will
15733 find the &quot;bill&quot; entry in your address book.
15734 It will replace &quot;bill&quot; with
15735 &quot;William Clinton&quot;.
15736 It will then search for an entry with that nickname
15737 in your address book and not find one. If this feature
15738 is set, Alpine will then attempt to lookup
15739 &quot;William Clinton&quot; on the LDAP server and find the entry with address
15740 pres@whitehouse.gov.
15741 <P>
15742 A better way to accomplish the same thing is probably to use the feature
15743 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
15744 <P>
15745 &lt;End of help on this topic&gt;
15746 </BODY>
15747 </HTML>
15748 ====== h_config_ldap_opts_ref =====
15749 <HTML>
15750 <HEAD>
15751 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
15752 </HEAD>
15753 <BODY>
15754 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
15755
15756 Normally when you save the results of an LDAP directory lookup to your
15757 address book the results of the lookup are saved. If this feature is set
15758 and the entry being saved was found on this directory server, then the
15759 search criteria is saved instead of the results of the search. When this
15760 address book entry is used in the future, instead of copying the results
15761 from the address book the directory lookup will be done again. This could
15762 be useful if the copied result might become stale because the data on
15763 the directory server changes (for example, the entry's email address changes).
15764 You probably don't want to set this feature if the server is at all slow or
15765 unreliable.
15766 <P>
15767 The way this actually works is that instead of saving the email address
15768 in your address book, Alpine saves enough information to look up the same
15769 directory entry again. In particular, it saves the server name and the
15770 distinguished name of the entry. It's possible that the server administrators
15771 might change the format of distinguished names on the server, or that the
15772 entry might be removed from the server. If Alpine notices this, you will be warned
15773 and a backup copy of the email address will be used. You may want to create
15774 a new entry in this case, since you will get the annoying warning every
15775 time you use the old entry. You may do that by Saving the entry to a new
15776 nickname in the same address book. You will be asked whether or not you
15777 want to use the backup email address.
15778 <P>
15779 A related feature in the Setup/Config screen is
15780 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15781 <P>
15782 &lt;End of help on this topic&gt;
15783 </BODY>
15784 </HTML>
15785 ======= h_config_ldap_opts_nosub =======
15786 <HTML>
15787 <HEAD>
15788 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
15789 </HEAD>
15790 <BODY>
15791 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
15792
15793 Spaces in your input are normally handled specially.
15794 Each space character is replaced
15795 by
15796 <P>
15797 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
15798 <P>
15799 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
15800 The reason this is done is so the input string
15801 <P>
15802 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
15803 <P>
15804 (which is converted to &quot;Greg* Donald&quot;) will match
15805 the names &quot;Greg Donald&quot;,
15806 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
15807 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
15808 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
15809 then it would also match the name &quot;Greg Donaldson&quot;.
15810 <P>
15811 Turning on this feature will disable this substitution.
15812 <P>
15813 &lt;End of help on this topic&gt;
15814 </BODY>
15815 </HTML>
15816 ====== h_config_ldap_searchtypes =======
15817 <HTML>
15818 <HEAD>
15819 <TITLE>LDAP OPTION: Search-Type</TITLE>
15820 </HEAD>
15821 <BODY>
15822 <H1>LDAP OPTION: Search-Type</H1>
15823
15824 This affects the way that LDAP searches are done.
15825 In particular, this tells the server where to look for the string to be matched.
15826 If set to &quot;name&quot; then the string that is being searched for will
15827 be compared with the string in the
15828 &quot;Name&quot; field on the server
15829 (technically, it is the &quot;commonname&quot; field on the server).
15830 &quot;Surname&quot; means we're looking for a
15831 match in the &quot;Surname&quot; field on the
15832 server (actually the &quot;sn&quot; field).
15833 &quot;Givenname&quot; really is &quot;givenname&quot;
15834 and &quot;email&quot; is the electronic mail address (this is actually the field
15835 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
15836 The other three types are combinations of
15837 the types listed so far. &quot;Name-or-email&quot;
15838 means the string should appear
15839 in either the &quot;name&quot; field OR the &quot;email&quot; field.
15840 Likewise, &quot;surname-or-givenname&quot;
15841 means &quot;surname&quot; OR &quot;givenname&quot;
15842 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
15843 <P>
15844 This search TYPE is combined with the
15845 search <A HREF="h_config_ldap_searchrules">RULE</A>
15846 to form the actual search query.
15847 <P>
15848 The usual default value for this
15849 option is &quot;sur-or-given-or-name-or-email&quot;.
15850 This type of search may be slow on some servers.
15851 Try &quot;name-or-email&quot;, which is often
15852 faster, or just &quot;name&quot; if the performance seems to be a problem.
15853 <P>
15854 Some servers have been configured with different attribute names for
15855 these four fields.
15856 In other words, instead of using the attribute name &quot;mail&quot;
15857 for the email address field, the server might be configured to use something
15858 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
15859 Alpine can be configured to use these different attribute names by using
15860 the four configuration options:
15861 <P><UL>
15862 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15863 </UL>
15864 <P><UL>
15865 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15866 </UL>
15867 <P><UL>
15868 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15869 </UL>
15870 <P><UL>
15871 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15872 </UL>
15873 <P>
15874 &lt;End of help on this topic&gt;
15875 </BODY>
15876 </HTML>
15877 ====== h_config_ldap_searchrules =======
15878 <HTML>
15879 <HEAD>
15880 <TITLE>LDAP OPTION: Search-Rule</TITLE>
15881 </HEAD>
15882 <BODY>
15883 <H1>LDAP OPTION: Search-Rule</H1>
15884
15885 This affects the way that LDAP searches are done.
15886 If set to &quot;equals&quot; then
15887 only exact matches count.
15888 &quot;Contains&quot; means that the string you type in
15889 is a substring of what you are matching against.
15890 &quot;Begins-with&quot; and &quot;ends-with&quot;
15891 mean that the string starts or ends with the string you type in.
15892 <P>
15893 Spaces in your input are normally handled specially, but you can turn that
15894 special handling off with the
15895 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15896 feature.
15897 <P>
15898 The usual default value for this option is &quot;begins-with&quot;.
15899 <P>
15900 &lt;End of help on this topic&gt;
15901 </BODY>
15902 </HTML>
15903 ======= h_config_ldap_email_attr =======
15904 <HTML>
15905 <HEAD>
15906 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
15907 </HEAD>
15908 <BODY>
15909 <H1>LDAP OPTION: EmailAttribute</H1>
15910
15911 This is the name of the attribute that is searched for when looking for
15912 an email address. The default value for this option is &quot;mail&quot; or
15913 &quot;electronicmail&quot;.
15914 If the server you are using uses a different attribute name for the email
15915 address, put that attribute name here.
15916 <P>
15917 This will affect the search filter used if your Search-Type is one that
15918 contains a search for &quot;email&quot;.
15919 It will also cause the attribute value matching this attribute name to be used
15920 as the email address when you look up an entry from the composer.
15921 <P>
15922 &lt;End of help on this topic&gt;
15923 </BODY>
15924 </HTML>
15925 ======= h_config_ldap_sn_attr =======
15926 <HTML>
15927 <HEAD>
15928 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
15929 </HEAD>
15930 <BODY>
15931 <H1>LDAP OPTION: SurnameAttribute</H1>
15932
15933 This is the name of the attribute that is searched for when looking for
15934 the surname of the entry. The default value for this option is &quot;sn&quot;.
15935 If the server you are using uses a different attribute name for the surname,
15936 put that attribute name here.
15937 This will affect the search filter used if your Search-Type is one that
15938 contains a search for &quot;surname&quot;.
15939 <P>
15940 &lt;End of help on this topic&gt;
15941 </BODY>
15942 </HTML>
15943 ======= h_config_ldap_gn_attr =======
15944 <HTML>
15945 <HEAD>
15946 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
15947 </HEAD>
15948 <BODY>
15949 <H1>LDAP OPTION: GivennameAttribute</H1>
15950
15951 This is the name of the attribute that is searched for when looking for
15952 the given name of the entry. The default value for this option is &quot;givenname&quot;.
15953 If the server you are using uses a different attribute name for the given name,
15954 put that attribute name here.
15955 This will affect the search filter used if your Search-Type is one that
15956 contains a search for &quot;givenname&quot;.
15957 <P>
15958 &lt;End of help on this topic&gt;
15959 </BODY>
15960 </HTML>
15961 ======= h_config_ldap_cn_attr =======
15962 <HTML>
15963 <HEAD>
15964 <TITLE>LDAP OPTION: NameAttribute</TITLE>
15965 </HEAD>
15966 <BODY>
15967 <H1>LDAP OPTION: NameAttribute</H1>
15968
15969 This is the name of the attribute that is searched for when looking for
15970 the name of the entry. The default value for this option is &quot;cn&quot;, which
15971 stands for common name.
15972 If the server you are using uses a different attribute name for the name,
15973 put that attribute name here.
15974 This will affect the search filter used if your Search-Type is one that
15975 contains a search for &quot;name&quot;.
15976 <P>
15977 &lt;End of help on this topic&gt;
15978 </BODY>
15979 </HTML>
15980 ======= h_config_ldap_time =======
15981 <HTML>
15982 <HEAD>
15983 <TITLE>LDAP OPTION: Timelimit</TITLE>
15984 </HEAD>
15985 <BODY>
15986 <H1>LDAP OPTION: Timelimit</H1>
15987
15988 This places a limit on the number of seconds the LDAP search will continue.
15989 The default is 30 seconds. A value of 0 means no limit. Note that some servers
15990 may place limits of their own on searches.
15991 <P>
15992 &lt;End of help on this topic&gt;
15993 </BODY>
15994 </HTML>
15995 ======= h_config_ldap_size =======
15996 <HTML>
15997 <HEAD>
15998 <TITLE>LDAP OPTION: Sizelimit</TITLE>
15999 </HEAD>
16000 <BODY>
16001 <H1>LDAP OPTION: Sizelimit</H1>
16002
16003 This places a limit on the number of entries returned by the LDAP server.
16004 A value of 0 means no limit. The default is 0. Note that some servers
16005 may place limits of their own on searches.
16006 <P>
16007 &lt;End of help on this topic&gt;
16008 </BODY>
16009 </HTML>
16010 ======= h_config_ldap_cust =======
16011 <HTML>
16012 <HEAD>
16013 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
16014 </HEAD>
16015 <BODY>
16016 <H1>LDAP OPTION: Custom-Search-Filter</H1>
16017
16018 This one is for advanced users only! If you define this, then the
16019 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
16020 However, the feature
16021 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
16022 is still in effect.
16023 That is, the space substitution will take place even in a custom filter unless
16024 you disable it.
16025 <P>
16026 If your LDAP service stops working and you suspect it might be because
16027 of your custom filter, just delete this filter and try using the
16028 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
16029 Another option that sometimes causes trouble is the
16030 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
16031 <P>
16032 This variable may be set to the string representation of an LDAP search
16033 filter (see RFC1960). In the places where you want the address string to be
16034 substituted in, put a '%s' in this filter string. Here are some examples:
16035 <P>
16036 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
16037 is equivalent to the &quot;Custom-Search-Filter&quot;
16038 <PRE>
16039      (cn=%s*)
16040 </PRE>
16041 When you try to match against the string &quot;string&quot; the program replaces
16042 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
16043 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
16044 <P>
16045 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
16046 of &quot;contains&quot; is equivalent to
16047 <PRE>
16048      (|(cn=*%s*)(mail=*%s*))
16049 </PRE>
16050 <P>
16051 If your server uses a different attribute <EM>name</EM> than
16052 Alpine uses by default,
16053 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
16054 then you may be able to use one or more of the four attribute configuration
16055 options instead of defining a custom filter:
16056 <P><UL>
16057 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
16058 </UL>
16059 <P><UL>
16060 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
16061 </UL>
16062 <P><UL>
16063 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
16064 </UL>
16065 <P><UL>
16066 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
16067 </UL>
16068 <P>
16069 &lt;End of help on this topic&gt;
16070 </BODY>
16071 </HTML>
16072 ======= h_composer_abook_comment =======
16073 <HTML>
16074 <HEAD>
16075 <TITLE>Addressbook Comment Explained</TITLE>
16076 </HEAD>
16077 <BODY>
16078 This is a comment to help you remember what this entry is. The WhereIs
16079 command searches comments so that it is easier to find an entry with a comment
16080 you know about attached to it. This field is not used in the outgoing message.
16081 <P>
16082 Look <A HREF="h_edit_nav_cmds">here</A>
16083 to see the available Editing and Navigation commands.
16084 <P>
16085 &lt;End of help on this topic&gt;
16086 </BODY>
16087 </HTML>
16088 ======= h_composer_abook_addrs =======
16089 <HTML>
16090 <HEAD>
16091 <TITLE>Addressbook Lists</TITLE>
16092 </HEAD>
16093 <BODY>
16094 <H1>Addressbook Lists</H1>
16095
16096 This is a list of addresses to send to when sending to this address book
16097 entry.  Each member of the list may be an address or another nickname from
16098 any of your address books.  If it is an address, it is OK to include the
16099 full name field as well as the electronic address portion of that address.
16100 For example, the following are all legitimate entries in this field:
16101
16102 <DL><DT>&nbsp;</DT>
16103 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
16104 <DD>jdoe@some.domain
16105 <DD>John Doe &lt;jdoe@some.domain&gt;
16106 </DL>
16107
16108 The addresses should be listed separated by commas, just like you would
16109 enter them from the composer.
16110
16111 <P>
16112
16113 The only difference between a distribution list and a simple entry with a
16114 single address, is that a distribution list has more than one address
16115 listed in the Addresses: field, whereas a simple personal entry has just
16116 one address.
16117
16118 <P>
16119
16120 For individual address book entries, if there is a full name in the
16121 Fullname: field (filling in the Fullname: field is not required), it is
16122 used.  If the full name is specified in the Address: field and not in the
16123 Fullname: field, then the full name from the Address: field is used.
16124
16125 <P>
16126
16127 If you type the nickname of a distribution list from one of your address
16128 books in the Lcc: field, then the full name of that list is used in the
16129 To: field.  If you put a list in the To: or Cc: fields, that list will be
16130 expanded into all of its addresses.  If the list has a full name, then
16131 that will appear at the beginning of the addresses.
16132
16133 <DL><DT>&nbsp;</DT>
16134 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
16135 &lt;sal@here.there&gt;
16136 </DL>
16137
16138 If the first address in the distribution list also has a full name, then
16139 the list full name and that full name are combined into something like the
16140 following:
16141
16142 <DL><DT>&nbsp;</DT>
16143 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
16144 </DL>
16145
16146
16147 If you specify a list via Lcc, the full name is used in the To: line.  If
16148 you specify a list in the To: or Cc: fields, then it uses the same method
16149 as for individual entries for filling in the full name.
16150
16151 <P>
16152
16153 For help with editing and navigation commands, check the Help for the
16154 Nickname: field.
16155
16156 <P>
16157 &lt;End of help on this topic&gt;
16158 </BODY>
16159 </HTML>
16160 ======= h_config_xoauth2_client_id =======
16161 <HTML>
16162 <HEAD>
16163 <TITLE>Client-Id Explained</TITLE>
16164 </HEAD>
16165 <BODY>
16166 <H1>Client-Id Explained</H1>
16167
16168 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16169 someone has shared a client-id and client-secret with you, use this field to input the
16170 client-id.
16171 <P>
16172 The Client-Id field is a string that your provider generates for the program
16173 being registered. However, some providers allow different users to register
16174 the same program. Users of the Mutt email program already do this to use
16175 XOAUTH2 authentication in Gmail.
16176
16177 <P>
16178 &lt;End of help on this topic&gt;
16179 </BODY>
16180 </HTML>
16181 ======= h_config_xoauth2_client_secret =======
16182 <HTML>
16183 <HEAD>
16184 <TITLE>Client-Secret Explained</TITLE>
16185 </HEAD>
16186 <BODY>
16187 <H1>Client-Secret Explained</H1>
16188
16189 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16190 someone has shared a client-id and client-secret with you, use this field to input the
16191 client-secret. Some servers require both a client-id and a client-secret, some other servers do
16192 not require a client-secret. If a client-secret is required, use this field to add one.
16193
16194 <P> The client-secret field is supposed to be kept secret, that is, not
16195 shared with any of the users, but due to the open source nature of Alpine,
16196 it is not possible to keep it secret in any meaningful way. The intention
16197 of this field is so that only the coders of an app can use the codes given
16198 to them and authenticate their users to the services they are requesting.
16199 This means that other coders would not be able to impresonate that app,
16200 and use it to steal data from those users. In the case of Alpine this is
16201 not possible, as Alpine does not steal data from its users, so users are safe
16202 sharing client-secrets. Just make sure you obtain your copy of Alpine from
16203 a reputable provider or compile the source code by yourself. The official
16204 source code of this project is located at
16205
16206 <P><CENTER><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A>.</CENTER>
16207
16208 <P>
16209 &lt;End of help on this topic&gt;
16210 </BODY>
16211 </HTML>
16212 ======= h_config_xoauth2_tenant =======
16213 <HTML>
16214 <HEAD>
16215 <TITLE>Tenant Explained</TITLE>
16216 </HEAD>
16217 <BODY>
16218 <H1>Tenant Explained</H1>
16219
16220 The tenant is a way in which a service can either restrict an app to access
16221 only certain portions of its service. For example, a service may allow
16222 an app to have access to your work data, or school data, and not every app
16223 is allowed to access this data, or the access is not allowed for all accounts,
16224 but only those restructed in the tenant.
16225
16226 <P> When Alpine registers with an email service provider, it does so with the
16227 intention that you can use Alpine for any of your needs (work, school or
16228 personal), and the client-id and tenant that it uses would allow you access to
16229 only your work email, say, and not your personal email, because the app is
16230 trusted only at work, and so the client-id and tenant are good for that
16231 organization only.
16232 <P>
16233 &lt;End of help on this topic&gt;
16234 </BODY>
16235 </HTML>
16236 ======= h_config_xoauth2_flow =======
16237 <HTML>
16238 <HEAD>
16239 <TITLE>Flow Explained</TITLE>
16240 </HEAD>
16241 <BODY>
16242 <H1>Flow Explained</H1>
16243
16244 The first time you connect to a service to authorize Alpine access to your
16245 email, you will have to do a certain number of steps, which typically involve
16246 to login to your account using a browser, and agreeing to give Alpine certain
16247 rights to access your account.
16248
16249 <P>
16250 How this process is going to be done depends on the service. Some services
16251 allow you to give access to Alpine and later generate a code that you
16252 input into Alpine, while others give you a code you have to use before you
16253 approve access to Alpine to access your email.
16254
16255 <P> An example of a service that gives you a code after you authorize
16256 Alpine is Gmail, and this process is called internally as &quot;Authorize&quot;.
16257 An example of a service that gives you a code before you authorize Alpine
16258 is Outlook, and this process is called &quot;Device&quot;. However, some services,
16259 like Outlook, offer both services, and you can choose which flow you would like
16260 to use. You
16261 can choose between the &quot;Authorize&qupt; and &quot;Device&quot; in these servers.
16262 If you forget to configure
16263 this, Alpine will ask you in these situations which method to use before it starts
16264 to setup the process to get your authrization.
16265
16266 <P>
16267 &lt;End of help on this topic&gt;
16268 </BODY>
16269 </HTML>
16270 ======= h_config_xoauth2_username =======
16271 <HTML>
16272 <HEAD>
16273 <TITLE>Username Explained</TITLE>
16274 </HEAD>
16275 <BODY>
16276 <H1>Username Explained</H1>
16277
16278 This variable is a list of usernames for which the configuration for the
16279 given service is valid. You may have more than one username for which this
16280 configuration is correct.
16281
16282 <P>
16283 Alpine will use the usernames in this list to associate your username with
16284 the correct configuration in Alpine. If Alpine cannot determine which configuration
16285 to use, Alpine will offer you a list of client-ids that you have configured
16286 for that service and ask you to pick one. Your answer will be saved  in your
16287 .pinerc file.
16288
16289 <P>
16290 &lt;End of help on this topic&gt;
16291 </BODY>
16292 </HTML>
16293 ======= h_config_role_nick =======
16294 <HTML>
16295 <HEAD>
16296 <TITLE>Nickname Explained</TITLE>
16297 </HEAD>
16298 <BODY>
16299 <H1>Nickname Explained</H1>
16300
16301 This is a nickname to help you.
16302 You should have a different nickname for each role you define.
16303 The nickname will be used in the SETUP ROLE RULES screen to allow you to
16304 pick a role to edit.
16305 It will also be used when you send a message to let you know you are
16306 sending with a different role than you use by default, and
16307 it will be useful for choosing a role when composing with the Role command
16308 or when composing with one of the Role Uses set to With Confirmation.
16309 This field is not used in the outgoing message.
16310 <P>
16311 Look <A HREF="h_edit_nav_cmds">here</A>
16312 to see the available Editing and Navigation commands.
16313 <P>
16314 &lt;End of help on this topic&gt;
16315 </BODY>
16316 </HTML>
16317 ======= h_config_role_comment =======
16318 <HTML>
16319 <HEAD>
16320 <TITLE>Comment Explained</TITLE>
16321 </HEAD>
16322 <BODY>
16323 <H1>Comment Explained</H1>
16324
16325 This is a comment to help you.
16326 This comment does not play any functional role, it is simply an optional
16327 comment to help you remember what the rule is for.
16328 <P>
16329 Look <A HREF="h_edit_nav_cmds">here</A>
16330 to see the available Editing and Navigation commands.
16331 <P>
16332 &lt;End of help on this topic&gt;
16333 </BODY>
16334 </HTML>
16335 ======= h_config_other_nick =======
16336 <HTML>
16337 <HEAD>
16338 <TITLE>Nickname Explained</TITLE>
16339 </HEAD>
16340 <BODY>
16341 <H1>Nickname Explained</H1>
16342
16343 This is a nickname to help you.
16344 You should have a different nickname for each rule you define.
16345 The nickname will be used in the SETUP OTHER RULES screen to allow you to
16346 pick a rule to edit.
16347 <P>
16348 Look <A HREF="h_edit_nav_cmds">here</A>
16349 to see the available Editing and Navigation commands.
16350 <P>
16351 &lt;End of help on this topic&gt;
16352 </BODY>
16353 </HTML>
16354 ======= h_config_score_nick =======
16355 <HTML>
16356 <HEAD>
16357 <TITLE>Nickname Explained</TITLE>
16358 </HEAD>
16359 <BODY>
16360 <H1>Nickname Explained</H1>
16361
16362 This is a nickname to help you.
16363 You should have a different nickname for each scoring rule you define.
16364 The nickname will be used in the SETUP SCORING RULES screen to allow you to
16365 pick a rule to edit.
16366 <P>
16367 Look <A HREF="h_edit_nav_cmds">here</A>
16368 to see the available Editing and Navigation commands.
16369 <P>
16370 &lt;End of help on this topic&gt;
16371 </BODY>
16372 </HTML>
16373 ======= h_config_incol_nick =======
16374 <HTML>
16375 <HEAD>
16376 <TITLE>Nickname Explained</TITLE>
16377 </HEAD>
16378 <BODY>
16379 <H1>Nickname Explained</H1>
16380
16381 This is a nickname to help you.
16382 You should have a different nickname for each color rule you define.
16383 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
16384 pick a rule to edit.
16385 <P>
16386 Look <A HREF="h_edit_nav_cmds">here</A>
16387 to see the available Editing and Navigation commands.
16388 <P>
16389 &lt;End of help on this topic&gt;
16390 </BODY>
16391 </HTML>
16392 ======= h_config_filt_nick =======
16393 <HTML>
16394 <HEAD>
16395 <TITLE>Nickname Explained</TITLE>
16396 </HEAD>
16397 <BODY>
16398 <H1>Nickname Explained</H1>
16399
16400 This is a nickname to help you.
16401 You should have a different nickname for each filtering rule you define.
16402 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
16403 pick a rule to edit.
16404 <P>
16405 Look <A HREF="h_edit_nav_cmds">here</A>
16406 to see the available Editing and Navigation commands.
16407 <P>
16408 &lt;End of help on this topic&gt;
16409 </BODY>
16410 </HTML>
16411 ======= h_config_score_topat =======
16412 <HTML>
16413 <HEAD>
16414 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16415 </HEAD>
16416 <BODY>
16417 <H1>&quot;To:&quot; Pattern Explained</H1>
16418
16419 Any text you enter as the &quot;To pattern&quot;
16420 will be compared to the recipients from the To: line of
16421 the message being scored.
16422 When the text you entered matches
16423 all or part of the To: line of a message, then the Score Value
16424 you have specified will be added to the score for the message.
16425 (Any other non-blank parts of the Pattern must match, too.)
16426 <P>
16427
16428 You may enter a complete email address, part of an address, or a
16429 list of addresses or partial addresses.
16430 For example:
16431 <P>
16432
16433 <PRE>
16434  To pattern = friend@public.com
16435
16436  To pattern = rated.net
16437
16438  To pattern = xxx@adults.com
16439               admin@msn.com
16440               fool@motleyfool.com
16441 </PRE>
16442
16443 <P>
16444 Each of those are valid To patterns.
16445 <P>
16446
16447 Messages match those patterns if any of the
16448 addresses in the To: line of the message contains the pattern.
16449 If the pattern is a list of patterns
16450 (like the last example above) then it is a match if any of the patterns in
16451 the list match any of the addresses in the To: line.
16452 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16453 present for a match.
16454 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16455 address2 must be present.
16456 That is exactly what using a list does.)
16457 <P>
16458
16459 Some messages may be &quot;bounced&quot; to you, and will
16460 have a &quot;Resent-To:&quot; header line.
16461 If the message contains a Resent-To: line
16462 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16463 Alpine will look for
16464 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16465 the original To: line.
16466 <P>
16467
16468 When entering a pattern, you may choose an address from your address book
16469 with the &quot;T&quot; command.
16470 <P>
16471
16472 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16473 &quot;!&quot; &quot;toggle NOT&quot; command.
16474 This changes the meaning of the To pattern so that it has the opposite meaning.
16475 It will be considered a match if there are no matches between the
16476 addresses in the To: line and the list of To patterns.
16477 <P>
16478 Don't make the mistake of putting the &quot;!&quot; in the data field for
16479 the pattern.
16480 For example, if you type the characters &quot;!frizzle&quot; into the To
16481 pattern, the pattern will look like:
16482 <P>
16483 <PRE>
16484  To pattern = !frizzle
16485 </PRE>
16486 <P>
16487 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16488 In order to match messages that do not have &quot;frizzle&quot; in
16489 their To field, first type the characters &quot;frizzle&quot; followed
16490 by carriage return for the value of the To pattern, then negate it
16491 by typing the &quot;!&quot; command.
16492 It should end up looking like
16493 <P>
16494 <PRE>
16495  ! To pattern = frizzle
16496 </PRE>
16497 <P>
16498 You are not limited to using the six standard header patterns that are
16499 normally shown (To, From, Sender, Cc, News, and Subject).
16500 You may add any other header to a Pattern by
16501 using the &quot;eXtraHdr&quot; command to specify a different
16502 message header line; and then the Add or Change command to fill in
16503 a pattern for the new header line, just like you would for a standard header.
16504 <P>
16505 A technicality: Since comma is the character used to separate multiple
16506 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16507 you want to include a literal comma in the field.
16508 In other words, if you type a backslash followed by a comma it will
16509 be interpreted as a comma by Alpine, instead of as a separator between
16510 pattern values.
16511 All other backslashes are literal backslashes and should not be escaped.
16512 <P>
16513 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16514 for more information on Patterns.
16515 <P>
16516 Look <A HREF="h_edit_nav_cmds">here</A>
16517 to see the available Editing and Navigation commands.
16518 <P>
16519 &lt;End of help on this topic&gt;
16520 </BODY>
16521 </HTML>
16522 ======= h_config_incol_topat =======
16523 <HTML>
16524 <HEAD>
16525 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16526 </HEAD>
16527 <BODY>
16528 <H1>&quot;To:&quot; Pattern Explained</H1>
16529
16530 Any text you enter as the &quot;To pattern&quot;
16531 will be compared to the recipients from the To: lines of
16532 the messages in the index.
16533 When the text you entered matches
16534 all or part of the To: line of a message, then the Index Line Color you have
16535 specified will be used for that line in the index.
16536 (Any other non-blank parts of the Pattern must match, too.)
16537 <P>
16538
16539 You may enter a complete email address, part of an address, or a
16540 list of addresses or partial addresses.
16541 For example:
16542 <P>
16543
16544 <PRE>
16545  To pattern = friend@public.com
16546  To pattern = rated.net
16547  To pattern = xxx@adults.com
16548               admin@msn.com
16549               fool@motleyfool.com
16550 </PRE>
16551
16552 <P>
16553 Each of those are valid To patterns.
16554 <P>
16555
16556 Messages match those patterns if any of the
16557 addresses in the To: line of the message contains the pattern.
16558 If the pattern is a list of patterns
16559 (like the last example above) then it is a match if any of the patterns in
16560 the list match any of the addresses in the To: line.
16561 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16562 present for a match.
16563 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16564 address2 must be present.
16565 That is exactly what using a list does.)
16566 <P>
16567
16568 Some messages may be &quot;bounced&quot; to you, and will
16569 have a &quot;Resent-To:&quot; header line.
16570 If the message contains a Resent-To: line
16571 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16572 Alpine will look for
16573 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16574 the original To: line.
16575 <P>
16576
16577 When entering a pattern, you may choose an address from your address book
16578 with the &quot;T&quot; command.
16579 <P>
16580
16581 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16582 &quot;!&quot; &quot;toggle NOT&quot; command.
16583 This changes the meaning of the To pattern so that it has the opposite meaning.
16584 It will be considered a match if there are no matches between the
16585 addresses in the To: line and the list of To patterns.
16586 <P>
16587 Don't make the mistake of putting the &quot;!&quot; in the data field for
16588 the pattern.
16589 For example, if you type the characters &quot;!frizzle&quot; into the To
16590 pattern, the pattern will look like:
16591 <P>
16592 <PRE>
16593  To pattern = !frizzle
16594 </PRE>
16595 <P>
16596 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16597 In order to match messages that do not have &quot;frizzle&quot; in
16598 their To field, first type the characters &quot;frizzle&quot; followed
16599 by carriage return for the value of the To pattern, then negate it
16600 by typing the &quot;!&quot; command.
16601 It should end up looking like
16602 <P>
16603 <PRE>
16604  ! To pattern = frizzle
16605 </PRE>
16606 <P>
16607
16608 You are not limited to using the six standard header patterns that are
16609 normally shown (To, From, Sender, Cc, News, and Subject).
16610 You may add any other header to a Pattern by
16611 using the &quot;eXtraHdr&quot; command to specify a different
16612 message header line; and then the Add or Change command to fill in
16613 a pattern for the new header line, just like you would for a standard header.
16614 <P>
16615 A technicality: Since comma is the character used to separate multiple
16616 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16617 you want to include a literal comma in the field.
16618 In other words, if you type a backslash followed by a comma it will
16619 be interpreted as a comma by Alpine, instead of as a separator between
16620 pattern values.
16621 All other backslashes are literal backslashes and should not be escaped.
16622 <P>
16623 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16624 for more information on Patterns.
16625 <P>
16626 Look <A HREF="h_edit_nav_cmds">here</A>
16627 to see the available Editing and Navigation commands.
16628 <P>
16629 &lt;End of help on this topic&gt;
16630 </BODY>
16631 </HTML>
16632 ======= h_config_other_topat =======
16633 <HTML>
16634 <HEAD>
16635 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16636 </HEAD>
16637 <BODY>
16638 <H1>&quot;To:&quot; Pattern Explained</H1>
16639
16640 For some of the OTHER RULES actions, there is no message that is being
16641 compared against.
16642 If that is the case, then only the Current Folder Type is checked.
16643 In particular, this To pattern is ignored.
16644 Actions that fall into this category include both
16645 Sort Order and Index Format.
16646 <P>
16647 A technicality: Since comma is the character used to separate multiple
16648 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16649 you want to include a literal comma in the field.
16650 In other words, if you type a backslash followed by a comma it will
16651 be interpreted as a comma by Alpine, instead of as a separator between
16652 pattern values.
16653 All other backslashes are literal backslashes and should not be escaped.
16654 <P>
16655 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16656 for more information on Patterns.
16657 <P>
16658 Look <A HREF="h_edit_nav_cmds">here</A>
16659 to see the available Editing and Navigation commands.
16660 <P>
16661 &lt;End of help on this topic&gt;
16662 </BODY>
16663 </HTML>
16664 ======= h_config_filt_topat =======
16665 <HTML>
16666 <HEAD>
16667 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16668 </HEAD>
16669 <BODY>
16670 <H1>&quot;To:&quot; Pattern Explained</H1>
16671
16672 Any text you enter as the &quot;To pattern&quot;
16673 will be compared to the recipients from the To: line of
16674 messages when Alpine opens folders.
16675 When the text you entered matches
16676 all or part of the To: line of a message, then the Filter Action you have
16677 specified will be carried out.
16678 (Any other non-blank parts of the Pattern must match, too.)
16679 <P>
16680
16681 You may enter a complete email address, part of an address, or a
16682 list of addresses or partial addresses.
16683 For example:
16684 <P>
16685
16686 <PRE>
16687  To pattern = friend@public.com
16688  To pattern = rated.net
16689  To pattern = xxx@adults.com
16690               admin@msn.com
16691               fool@motleyfool.com
16692 </PRE>
16693
16694 <P>
16695 Each of those are valid To patterns.
16696 <P>
16697
16698 Messages match those patterns if any of the
16699 addresses in the To: line of the message contains the pattern.
16700 If the pattern is a list of patterns
16701 (like the last example above) then it is a match if any of the patterns in
16702 the list match any of the addresses in the To: line.
16703 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16704 present for a match.
16705 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16706 address2 must be present.
16707 That is exactly what using a list does.)
16708 <P>
16709
16710 Some messages may be &quot;bounced&quot; to you, and will
16711 have a &quot;Resent-To:&quot; header line.
16712 If the message contains a Resent-To: line
16713 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16714 Alpine will look for
16715 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16716 the original To: line.
16717 <P>
16718
16719 When entering a pattern, you may choose an address from your address book
16720 with the &quot;T&quot; command.
16721 <P>
16722
16723 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16724 &quot;!&quot; &quot;toggle NOT&quot; command.
16725 This changes the meaning of the To pattern so that it has the opposite meaning.
16726 It will be considered a match if there are no matches between the
16727 addresses in the To: line and the list of To patterns.
16728 <P>
16729 Don't make the mistake of putting the &quot;!&quot; in the data field for
16730 the pattern.
16731 For example, if you type the characters &quot;!frizzle&quot; into the To
16732 pattern, the pattern will look like:
16733 <P>
16734 <PRE>
16735  To pattern = !frizzle
16736 </PRE>
16737 <P>
16738 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16739 In order to match messages that do not have &quot;frizzle&quot; in
16740 their To field, first type the characters &quot;frizzle&quot; followed
16741 by carriage return for the value of the To pattern, then negate it
16742 by typing the &quot;!&quot; command.
16743 It should end up looking like
16744 <P>
16745 <PRE>
16746  ! To pattern = frizzle
16747 </PRE>
16748 <P>
16749
16750 You are not limited to using the six standard header patterns that are
16751 normally shown (To, From, Sender, Cc, News, and Subject).
16752 You may add any other header to a Pattern by
16753 using the &quot;eXtraHdr&quot; command to specify a different
16754 message header line; and then the Add or Change command to fill in
16755 a pattern for the new header line, just like you would for a standard header.
16756 <P>
16757 A technicality: Since comma is the character used to separate multiple
16758 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16759 you want to include a literal comma in the field.
16760 In other words, if you type a backslash followed by a comma it will
16761 be interpreted as a comma by Alpine, instead of as a separator between
16762 pattern values.
16763 All other backslashes are literal backslashes and should not be escaped.
16764 <P>
16765 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16766 for more information on Patterns.
16767 <P>
16768 Look <A HREF="h_edit_nav_cmds">here</A>
16769 to see the available Editing and Navigation commands.
16770 <P>
16771 &lt;End of help on this topic&gt;
16772 </BODY>
16773 </HTML>
16774 ======= h_config_role_topat =======
16775 <HTML>
16776 <HEAD>
16777 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16778 </HEAD>
16779 <BODY>
16780 <H1>&quot;To:&quot; Pattern Explained</H1>
16781
16782 Any text you enter as the &quot;To pattern&quot;
16783 will be compared to the recipients from the To: line of
16784 the message being replied to or forwarded.
16785 (Any other non-blank parts of the Pattern must match, too.)
16786 In the case of the Compose command, this pattern and the other header
16787 patterns are ignored.
16788 <P>
16789
16790 You may enter a complete email address, part of an address, or a
16791 list of addresses or partial addresses.
16792 For example:
16793 <P>
16794
16795 <PRE>
16796  To pattern = friend@public.com
16797  To pattern = rated.net
16798  To pattern = xxx@adults.com
16799               admin@msn.com
16800               fool@motleyfool.com
16801 </PRE>
16802
16803 <P>
16804 Each of those are valid To patterns.
16805 <P>
16806
16807 Messages match those patterns if any of the
16808 addresses in the To: line of the message contains the pattern.
16809 If the pattern is a list of patterns
16810 (like the last example above) then it is a match if any of the patterns in
16811 the list match any of the addresses in the To: line.
16812 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16813 present for a match.
16814 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16815 address2 must be present.
16816 That is exactly what using a list does.)
16817 <P>
16818
16819 Some messages may be &quot;bounced&quot; to you, and will
16820 have a &quot;Resent-To:&quot; header line.
16821 If the message contains a Resent-To: line
16822 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16823 Alpine will look for
16824 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16825 the original To: line.
16826 <P>
16827
16828 When entering a pattern, you may choose an address from your address book
16829 with the &quot;T&quot; command.
16830 <P>
16831
16832 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16833 &quot;!&quot; &quot;toggle NOT&quot; command.
16834 This changes the meaning of the To pattern so that it has the opposite meaning.
16835 It will be considered a match if there are no matches between the
16836 addresses in the To: line and the list of To patterns.
16837 <P>
16838 Don't make the mistake of putting the &quot;!&quot; in the data field for
16839 the pattern.
16840 For example, if you type the characters &quot;!frizzle&quot; into the To
16841 pattern, the pattern will look like:
16842 <P>
16843 <PRE>
16844  To pattern = !frizzle
16845 </PRE>
16846 <P>
16847 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16848 In order to match messages that do not have &quot;frizzle&quot; in
16849 their To field, first type the characters &quot;frizzle&quot; followed
16850 by carriage return for the value of the To pattern, then negate it
16851 by typing the &quot;!&quot; command.
16852 It should end up looking like
16853 <P>
16854 <PRE>
16855  ! To pattern = frizzle
16856 </PRE>
16857 <P>
16858
16859 You are not limited to using the six standard header patterns that are
16860 normally shown (To, From, Sender, Cc, News, and Subject).
16861 You may add any other header to a Pattern by
16862 using the &quot;eXtraHdr&quot; command to specify a different
16863 message header line; and then the Add or Change command to fill in
16864 a pattern for the new header line, just like you would for a standard header.
16865 <P>
16866 A technicality: Since comma is the character used to separate multiple
16867 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16868 you want to include a literal comma in the field.
16869 In other words, if you type a backslash followed by a comma it will
16870 be interpreted as a comma by Alpine, instead of as a separator between
16871 pattern values.
16872 All other backslashes are literal backslashes and should not be escaped.
16873 <P>
16874 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16875 for more information on Patterns.
16876 <P>
16877 Look <A HREF="h_edit_nav_cmds">here</A>
16878 to see the available Editing and Navigation commands.
16879 <P>
16880 &lt;End of help on this topic&gt;
16881 </BODY>
16882 </HTML>
16883 ======= h_config_role_frompat =======
16884 <HTML>
16885 <HEAD>
16886 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
16887 </HEAD>
16888 <BODY>
16889 <H1>&quot;From:&quot; Pattern Explained</H1>
16890
16891 This is just like the &quot;To pattern&quot; except that it is compared with
16892 the address in the From: line of the message
16893 instead of the addresses from the To: line.
16894 See the help for the To pattern for more information on header patterns.
16895 <P>
16896 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16897 for more information on Patterns.
16898 <P>
16899 Look <A HREF="h_edit_nav_cmds">here</A>
16900 to see the available Editing and Navigation commands.
16901 <P>
16902 &lt;End of help on this topic&gt;
16903 </BODY>
16904 </HTML>
16905 ======= h_config_role_senderpat =======
16906 <HTML>
16907 <HEAD>
16908 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
16909 </HEAD>
16910 <BODY>
16911 <H1>&quot;Sender:&quot; Pattern Explained</H1>
16912
16913 This is just like the &quot;To pattern&quot; except that it is compared with
16914 the address from the Sender: line of the message
16915 instead of the addresses from the To: line.
16916 See the help for the To pattern for more information on header patterns.
16917 <P>
16918 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16919 for more information on Patterns.
16920 <P>
16921 Look <A HREF="h_edit_nav_cmds">here</A>
16922 to see the available Editing and Navigation commands.
16923 <P>
16924 &lt;End of help on this topic&gt;
16925 </BODY>
16926 </HTML>
16927 ======= h_config_role_ccpat =======
16928 <HTML>
16929 <HEAD>
16930 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
16931 </HEAD>
16932 <BODY>
16933 <H1>&quot;Cc:&quot; Pattern Explained</H1>
16934
16935 This is just like the &quot;To pattern&quot; except that it is compared with
16936 the addresses from the Cc: line of the message
16937 instead of the addresses from the To: line.
16938 See the help for the To pattern for more information on header patterns.
16939 <P>
16940 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16941 for more information on Patterns.
16942 <P>
16943 Look <A HREF="h_edit_nav_cmds">here</A>
16944 to see the available Editing and Navigation commands.
16945 <P>
16946 &lt;End of help on this topic&gt;
16947 </BODY>
16948 </HTML>
16949 ======= h_config_role_recippat =======
16950 <HTML>
16951 <HEAD>
16952 <TITLE>Recipient Pattern Explained</TITLE>
16953 </HEAD>
16954 <BODY>
16955 <H1>Recipient Pattern Explained</H1>
16956
16957 This is just like the &quot;To pattern&quot; except that it is compared with
16958 the addresses from both the To: line and the Cc: line of the
16959 message instead of just the addresses from the To: line.
16960 In other words, it is considered a match if the pattern matches
16961 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
16962 in the Cc: line.
16963 (Notice that defining the Recipient pattern does not have the same
16964 effect as defining both the To and Cc patterns.
16965 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
16966 It is equivalent to having two different rules;
16967 one with a To pattern and the other with the same Cc pattern.)
16968 <P>
16969 A technicality: Since comma is the character used to separate multiple
16970 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16971 you want to include a literal comma in the field.
16972 In other words, if you type a backslash followed by a comma it will
16973 be interpreted as a comma by Alpine, instead of as a separator between
16974 pattern values.
16975 All other backslashes are literal backslashes and should not be escaped.
16976 <P>
16977 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16978 for more information on Patterns.
16979 <P>
16980 Look <A HREF="h_edit_nav_cmds">here</A>
16981 to see the available Editing and Navigation commands.
16982 <P>
16983 &lt;End of help on this topic&gt;
16984 </BODY>
16985 </HTML>
16986 ======= h_config_role_particpat =======
16987 <HTML>
16988 <HEAD>
16989 <TITLE>Participant Pattern Explained</TITLE>
16990 </HEAD>
16991 <BODY>
16992 <H1>Participant Pattern Explained</H1>
16993
16994 This is just like the &quot;To pattern&quot; except that it is compared with
16995 the addresses from the From: line, the To: line, and the Cc: line of the
16996 message instead of just the addresses from the To: line.
16997 In other words, it is considered a match if the pattern matches
16998 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
16999 in the To: line, <EM>OR</EM> an address in the Cc: line.
17000 (Notice that defining the Participant pattern does not have the same
17001 effect as defining all of the From, To, and Cc patterns.
17002 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
17003 From <EM>AND</EM> To <EM>AND</EM> Cc.
17004 It is equivalent to having three different rules;
17005 one with a From pattern, another with the same To pattern, and a third with
17006 the same Cc pattern.)
17007 <P>
17008 A technicality: Since comma is the character used to separate multiple
17009 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17010 you want to include a literal comma in the field.
17011 In other words, if you type a backslash followed by a comma it will
17012 be interpreted as a comma by Alpine, instead of as a separator between
17013 pattern values.
17014 All other backslashes are literal backslashes and should not be escaped.
17015 <P>
17016 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17017 for more information on Patterns.
17018 <P>
17019 Look <A HREF="h_edit_nav_cmds">here</A>
17020 to see the available Editing and Navigation commands.
17021 <P>
17022 &lt;End of help on this topic&gt;
17023 </BODY>
17024 </HTML>
17025 ======= h_config_role_newspat =======
17026 <HTML>
17027 <HEAD>
17028 <TITLE>News Pattern Explained</TITLE>
17029 </HEAD>
17030 <BODY>
17031 <H1>News Pattern Explained</H1>
17032
17033 If this pattern is non-blank, then for this rule to be considered a
17034 match, at least one of the newsgroups from
17035 the Newsgroups line of the message must match this pattern.
17036 If this pattern is a list of patterns, then at least one of the
17037 newsgroups must match at least one of the patterns.
17038 (Any other non-blank parts of the Pattern must match, too.)
17039 <P>
17040 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
17041 &quot;!&quot; &quot;toggle NOT&quot; command.
17042 This changes the meaning of the News pattern so that it has the opposite meaning.
17043 It will be considered a match if there are no matches between the
17044 addresses in the Newsgroups: line and the list of News patterns.
17045 <P>
17046 Don't make the mistake of putting the &quot;!&quot; in the data field for
17047 the pattern.
17048 For example, if you type the characters &quot;!frizzle&quot; into the News
17049 pattern, the pattern will look like:
17050 <P>
17051 <PRE>
17052  News pattern = !frizzle
17053 </PRE>
17054 <P>
17055 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17056 In order to match messages that do not have &quot;frizzle&quot; in
17057 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
17058 by carriage return for the value of the News pattern, then negate it
17059 by typing the &quot;!&quot; command.
17060 It should end up looking like
17061 <P>
17062 <PRE>
17063  ! News pattern = frizzle
17064 </PRE>
17065 <P>
17066 A technicality: Since comma is the character used to separate multiple
17067 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17068 you want to include a literal comma in the field.
17069 In other words, if you type a backslash followed by a comma it will
17070 be interpreted as a comma by Alpine, instead of as a separator between
17071 pattern values.
17072 All other backslashes are literal backslashes and should not be escaped.
17073 <P>
17074
17075 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17076 for more information on Patterns.
17077 <P>
17078 Look <A HREF="h_edit_nav_cmds">here</A>
17079 to see the available Editing and Navigation commands.
17080 <P>
17081 &lt;End of help on this topic&gt;
17082 </BODY>
17083 </HTML>
17084 ======= h_config_role_subjpat =======
17085 <HTML>
17086 <HEAD>
17087 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
17088 </HEAD>
17089 <BODY>
17090 <H1>&quot;Subject:&quot; Pattern Explained</H1>
17091
17092 This is similar to the other parts of the Pattern.
17093 It is compared with
17094 the contents from the Subject of the message.
17095 <P>
17096 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17097 for more information on Patterns.
17098 <P>
17099 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
17100 &quot;!&quot; &quot;toggle NOT&quot; command.
17101 This changes the meaning of the Subject pattern so that it has the opposite meaning.
17102 It will be considered a match if there are no matches between the
17103 text in the Subject: line and the list of Subject patterns.
17104 <P>
17105
17106 If you wish to have a header pattern that is not one of the six standard
17107 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
17108 <P>
17109 A technicality: Since comma is the character used to separate multiple
17110 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17111 you want to include a literal comma in the field.
17112 In other words, if you type a backslash followed by a comma it will
17113 be interpreted as a comma by Alpine, instead of as a separator between
17114 pattern values.
17115 All other backslashes are literal backslashes and should not be escaped.
17116 <P>
17117 Look <A HREF="h_edit_nav_cmds">here</A>
17118 to see the available Editing and Navigation commands.
17119 <P>
17120 &lt;End of help on this topic&gt;
17121 </BODY>
17122 </HTML>
17123 ======= h_config_role_alltextpat =======
17124 <HTML>
17125 <HEAD>
17126 <TITLE>AllText Pattern Explained</TITLE>
17127 </HEAD>
17128 <BODY>
17129 <H1>AllText Pattern Explained</H1>
17130
17131 This is similar to the header patterns.
17132 Instead of comparing with text in a particular header field it
17133 is compared with all of the text in the message header and body.
17134 <P>
17135 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
17136 &quot;!&quot; &quot;toggle NOT&quot; command.
17137 This changes the meaning of the AllText pattern so that it has the opposite meaning.
17138 It will be considered a match if there are no matches between the
17139 text of the message and the list of AllText patterns.
17140 <P>
17141 Don't make the mistake of putting the &quot;!&quot; in the data field for
17142 the pattern.
17143 For example, if you type the characters &quot;!frizzle&quot; into the AllText
17144 pattern, the pattern will look like:
17145 <P>
17146 <PRE>
17147  AllText pattern = !frizzle
17148 </PRE>
17149 <P>
17150 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17151 In order to match messages that do not have &quot;frizzle&quot; in
17152 the text of the message, first type the characters &quot;frizzle&quot; followed
17153 by carriage return for the value of the AllText pattern, then negate it
17154 by typing the &quot;!&quot; command.
17155 It should end up looking like
17156 <P>
17157 <PRE>
17158  ! AllText pattern = frizzle
17159 </PRE>
17160 <P>
17161 It is possible that you may notice degraded performance when using
17162 AllText Patterns.
17163 <P>
17164 A technicality: Since comma is the character used to separate multiple
17165 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17166 you want to include a literal comma in the field.
17167 In other words, if you type a backslash followed by a comma it will
17168 be interpreted as a comma by Alpine, instead of as a separator between
17169 pattern values.
17170 All other backslashes are literal backslashes and should not be escaped.
17171 <P>
17172 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17173 for more information on Patterns.
17174 <P>
17175 Look <A HREF="h_edit_nav_cmds">here</A>
17176 to see the available Editing and Navigation commands.
17177 <P>
17178 &lt;End of help on this topic&gt;
17179 </BODY>
17180 </HTML>
17181 ======= h_config_role_bodytextpat =======
17182 <HTML>
17183 <HEAD>
17184 <TITLE>BodyText Pattern Explained</TITLE>
17185 </HEAD>
17186 <BODY>
17187 <H1>BodyText Pattern Explained</H1>
17188
17189 This is similar to the header patterns.
17190 Instead of comparing with text in a particular header field it
17191 is compared with all of the text in the message body.
17192 <P>
17193 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
17194 &quot;!&quot; &quot;toggle NOT&quot; command.
17195 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
17196 It will be considered a match if there are no matches between the
17197 text of the body of the message and the list of BodyText patterns.
17198 <P>
17199 Don't make the mistake of putting the &quot;!&quot; in the data field for
17200 the pattern.
17201 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
17202 pattern, the pattern will look like:
17203 <P>
17204 <PRE>
17205  BdyText pattern = !frizzle
17206 </PRE>
17207 <P>
17208 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17209 In order to match messages that do not have &quot;frizzle&quot; in
17210 their BodyText, first type the characters &quot;frizzle&quot; followed
17211 by carriage return for the value of the BodyText pattern, then negate it
17212 by typing the &quot;!&quot; command.
17213 It should end up looking like
17214 <P>
17215 <PRE>
17216  ! BodyText pattern = frizzle
17217 </PRE>
17218 <P>
17219 It is possible that you may notice degraded performance when using
17220 BodyText Patterns.
17221 <P>
17222 A technicality: Since comma is the character used to separate multiple
17223 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17224 you want to include a literal comma in the field.
17225 In other words, if you type a backslash followed by a comma it will
17226 be interpreted as a comma by Alpine, instead of as a separator between
17227 pattern values.
17228 All other backslashes are literal backslashes and should not be escaped.
17229 <P>
17230 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17231 for more information on Patterns.
17232 <P>
17233 Look <A HREF="h_edit_nav_cmds">here</A>
17234 to see the available Editing and Navigation commands.
17235 <P>
17236 &lt;End of help on this topic&gt;
17237 </BODY>
17238 </HTML>
17239 ======= h_config_role_charsetpat =======
17240 <HTML>
17241 <HEAD>
17242 <TITLE>Character Set Pattern Explained</TITLE>
17243 </HEAD>
17244 <BODY>
17245 <H1>Character Set Pattern Explained</H1>
17246
17247 A message may use one or more character sets.
17248 This part of the Pattern matches messages that make use of
17249 certain specified character sets.
17250 It will be considered a match if a message uses any of the character
17251 sets in the list you give here.
17252
17253 <P>
17254 When filling in a value for this field, you may use
17255 the &quot;T&quot; command, which presents you with a large list of
17256 possible character sets to choose from.
17257 You may also just type in the name of a character set, and it need not
17258 be one that Alpine knows about.
17259
17260 <P>
17261 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
17262 GB2312) you may also use some shorthand names that Alpine provides.
17263 These names are more understandable shorthand names for sets of
17264 character set names.
17265 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
17266 Selecting one of these shorthand names is equivalent to selecting all of
17267 the character sets that make up the set.
17268 You can see all of these shorthand names and the lists of character sets
17269 they stand for by typing the &quot;T&quot; command.
17270
17271 <P>
17272 For the purposes of this Pattern,
17273 Alpine will search through a message for all of the text parts and
17274 collect the character sets declared for each part.
17275 It will also look in the Subject line for a character set used there.
17276 Alpine does not actually look at the text of the message or the text
17277 of the Subject to determine if a declared character set is actually
17278 used, it looks only at the declarations themselves in the MIME part headers
17279 and in the Subject.
17280
17281 <P>
17282 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
17283 &quot;!&quot; &quot;toggle NOT&quot; command.
17284 This changes the meaning of the Character Set pattern so that
17285 it has the opposite meaning.
17286 It will be considered a match if none of the character sets in the
17287 list are used in a message.
17288 <P>
17289 Don't make the mistake of putting the &quot;!&quot; in the data field for
17290 the pattern.
17291 For example, if you type the characters &quot;!GB2312&quot; into the
17292 Character Set pattern, the pattern will look like:
17293 <P>
17294 <PRE>
17295  Charset pattern = !GB2312
17296 </PRE>
17297 <P>
17298 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
17299 In order to match messages that do not have the
17300 character set &quot;GB2312&quot;
17301 set, first type the characters &quot;GB2312&quot; followed
17302 by carriage return for the value of the Character Set pattern, then negate it
17303 by typing the &quot;!&quot; command.
17304 It should end up looking like
17305 <P>
17306 <PRE>
17307  ! Charset pattern = GB2312
17308 </PRE>
17309 <P>
17310 A technicality: Since comma is the character used to separate multiple
17311 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17312 you want to include a literal comma in the field.
17313 In other words, if you type a backslash followed by a comma it will
17314 be interpreted as a comma by Alpine, instead of as a separator between
17315 pattern values.
17316 All other backslashes are literal backslashes and should not be escaped.
17317 <P>
17318 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17319 for more information on Patterns.
17320 <P>
17321 Look <A HREF="h_edit_nav_cmds">here</A>
17322 to see the available Editing and Navigation commands.
17323 <P>
17324 &lt;End of help on this topic&gt;
17325 </BODY>
17326 </HTML>
17327 ======= h_config_role_keywordpat =======
17328 <HTML>
17329 <HEAD>
17330 <TITLE>Keyword Pattern Explained</TITLE>
17331 </HEAD>
17332 <BODY>
17333 <H1>Keyword Pattern Explained</H1>
17334
17335 A folder may have user-defined keywords.
17336 These are similar to the Important flag, which the user may set using the
17337 Flag command.
17338 The difference is that the Important flag is always present for each folder.
17339 User-defined keywords are picked by the user.
17340 You may add new keywords by defining them in the
17341 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
17342 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
17343 the Flag command may be used to set or clear the keyword on individual messages.
17344 If you have given a keyword a nickname when configuring it,
17345 that nickname may be used instead of the actual keyword.
17346
17347 <P>
17348 When filling in a value for this field, it may be easiest to use
17349 the &quot;T&quot; command, which presents you with a list of the keywords
17350 you have defined to choose from.
17351
17352 <P>
17353 This part of the Pattern matches messages with certain keywords set.
17354 It will be considered a match if a message has any of the keywords in the
17355 list set.
17356 A keyword that you have not defined using the
17357 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17358 will not be a match.
17359
17360 <P>
17361 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
17362 &quot;!&quot; &quot;toggle NOT&quot; command.
17363 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
17364 It will be considered a match if none of the keywords in the list are set
17365 for a message.
17366 A keyword that you have not defined using the
17367 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17368 will not be a match, so a <EM>NOT</EM> of that keyword does match.
17369 <P>
17370 Don't make the mistake of putting the &quot;!&quot; in the data field for
17371 the pattern.
17372 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
17373 pattern, the pattern will look like:
17374 <P>
17375 <PRE>
17376  Keyword pattern = !frizzle
17377 </PRE>
17378 <P>
17379 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17380 In order to match messages that do not have the keyword &quot;frizzle&quot;
17381 set, first type the characters &quot;frizzle&quot; followed
17382 by carriage return for the value of the Keyword pattern, then negate it
17383 by typing the &quot;!&quot; command.
17384 It should end up looking like
17385 <P>
17386 <PRE>
17387  ! Keyword pattern = frizzle
17388 </PRE>
17389 <P>
17390 A technicality: Since comma is the character used to separate multiple
17391 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17392 you want to include a literal comma in the field.
17393 In other words, if you type a backslash followed by a comma it will
17394 be interpreted as a comma by Alpine, instead of as a separator between
17395 pattern values.
17396 All other backslashes are literal backslashes and should not be escaped.
17397 <P>
17398 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17399 for more information on Patterns.
17400 <P>
17401 Look <A HREF="h_edit_nav_cmds">here</A>
17402 to see the available Editing and Navigation commands.
17403 <P>
17404 &lt;End of help on this topic&gt;
17405 </BODY>
17406 </HTML>
17407 ======= h_config_role_arbpat =======
17408 <HTML>
17409 <HEAD>
17410 <TITLE>Extra Header Patterns Explained</TITLE>
17411 </HEAD>
17412 <BODY>
17413 <H1>Extra Header Patterns Explained</H1>
17414
17415 The header patterns that come after the Participant pattern but before the
17416 AllText pattern are extra header patterns that you have added to a rule's
17417 Pattern. These are just like the other header patterns except that
17418 the contents of the particular header listed on the left hand side will
17419 be used for comparisons.
17420 <P>
17421 The &quot;eXtraHdr&quot; command may be used to add more of these
17422 header patterns to the rule you are editing.
17423 <P>
17424 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
17425 extra header pattern from the rule you are editing.
17426 <P>
17427 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
17428 &quot;!&quot; &quot;toggle NOT&quot; command.
17429 This changes the meaning of the pattern so that it has the opposite meaning.
17430 It will be considered a match if there are no matches between the
17431 text in the header line and the list of patterns.
17432 <P>
17433 Don't make the mistake of putting the &quot;!&quot; in the data field for
17434 the pattern.
17435 For example, if you type the characters &quot;!frizzle&quot; into the
17436 pattern, the pattern will look like:
17437 <P>
17438 <PRE>
17439  Xyz pattern = !frizzle
17440 </PRE>
17441 <P>
17442 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17443 In order to match messages that do not have &quot;frizzle&quot; in
17444 their Xyz field, first type the characters &quot;frizzle&quot; followed
17445 by carriage return for the value of the pattern, then negate it
17446 by typing the &quot;!&quot; command.
17447 It should end up looking like
17448 <P>
17449 <PRE>
17450  ! Xyz pattern = frizzle
17451 </PRE>
17452
17453 <P>
17454 A technicality: Since comma is the character used to separate multiple
17455 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17456 you want to include a literal comma in the field.
17457 In other words, if you type a backslash followed by a comma it will
17458 be interpreted as a comma by Alpine, instead of as a separator between
17459 pattern values.
17460 All other backslashes are literal backslashes and should not be escaped.
17461 <P>
17462 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17463 for more information on Patterns.
17464 <P>
17465 Look <A HREF="h_edit_nav_cmds">here</A>
17466 to see the available Editing and Navigation commands.
17467 <P>
17468 &lt;End of help on this topic&gt;
17469 </BODY>
17470 </HTML>
17471 ======= h_config_role_cat_cmd =======
17472 <HTML>
17473 <HEAD>
17474 <TITLE>Categorizer Command Explained</TITLE>
17475 </HEAD>
17476 <BODY>
17477 <H1>Categorizer Command Explained</H1>
17478
17479 This is a command that is run with its standard input set to the message
17480 being checked and its standard output discarded.
17481 The full directory path should be specified.
17482 The command will be run and then its exit status will be checked against
17483 the Exit Status Interval, which defaults to just the value zero.
17484 If the exit status of the command falls in the interval, it is considered
17485 a match, otherwise it is not a match.
17486 <P>
17487
17488 This option may actually be a list of commands.
17489 The first one that exists and is executable is used.
17490 That makes it possible to use the same configuration with Unix Alpine and
17491 PC-Alpine.
17492 <P>
17493
17494 If none of the commands in the list exists and is executable then the rule
17495 is <EM>not</EM> a match.
17496 If it is possible that the command may not exist, you should be careful
17497 to structure your rules so that nothing destructive
17498 happens when the command does not exist.
17499 For example, you might have a filter that filters away spam when there is
17500 a match but does nothing when there is not a match.
17501 That would cause no harm if the command didn't exist.
17502 However, if you have a filter that filters away spam when there is not
17503 a match and keeps it when there is a match, that would filter everything
17504 if the categorizer command didn't exist.
17505 <P>
17506 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
17507 setup for the bogofilter filter.
17508
17509 <P>
17510 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17511 for more information on Patterns.
17512 <P>
17513 Look <A HREF="h_edit_nav_cmds">here</A>
17514 to see the available Editing and Navigation commands.
17515 <P>
17516 &lt;End of help on this topic&gt;
17517 </BODY>
17518 </HTML>
17519 ======= h_config_role_cat_cmd_example =======
17520 <HTML>
17521 <HEAD>
17522 <TITLE>Categorizer Command Example</TITLE>
17523 </HEAD>
17524 <BODY>
17525 <H1>Categorizer Command Example</H1>
17526
17527 Bogofilter
17528 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
17529 is a mail filter that attempts to classify mail as spam or
17530 non-spam using statistical analysis of the message content.
17531 When run with no arguments and a message as standard input, it exits with
17532 exit status 0 if it thinks a message is spam and 1 if it thinks
17533 it is not spam.
17534 To use bogofilter as your Categorizer Command you would simply set Command to
17535 the pathname of the bogofilter program.
17536 For example,
17537 <P>
17538 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
17539 <P>
17540 Exit status of zero is what you are interested in, so you'd set the
17541 Exit Status Interval to
17542 <P>
17543 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
17544 <P>
17545
17546 In order to prevent downloading an entire huge message to check for spam, you
17547 might want to set the Character Limit to a few thousand characters (the
17548 assumption being that the spam will reveal itself in those characters)
17549 <P>
17550 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
17551 <P>
17552
17553 You would probably use bogofilter in an Alpine Filter Rule, and have the action
17554 be to move the message to a spam folder.
17555 It would usually be wise to also check the &quot;Message is Recent&quot;
17556 part of the rule so that messages are only checked when they first arrive,
17557 and to restrict the Current Folder Type to just your INBOX.
17558 The reason for checking only Recent messages is to save the time it takes
17559 to run bogofilter on each message.
17560 As an experiment, you might start out by using this in an Indexcolor Rule
17561 instead of a Filter Rule.
17562 In that case, you probably wouldn't check the Recent checkbox.
17563 <P>
17564 The use described above assumes that you are somehow maintaining bogofilter's
17565 database of words associated with spam and non-spam messages.
17566 One way to start your database would be to select a bunch of spam messages
17567 in Alpine (you might Save spam messages to a special folder or use Alpine's
17568 Select command to select several) and then Apply
17569 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
17570 a pipe command to the spam messages.
17571 For example, you could have a shell script or an alias
17572 called <EM>this_is_spam</EM>, which would simply be the command
17573 <P>
17574 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
17575 <P>
17576
17577 It is probably best to use the pipe command's Raw Text, With Delimiter,
17578 and Free Output options,
17579 which are at the bottom of the screen when you type the pipe command.
17580 That's because bogofilter expects the raw message as input, and uses
17581 the Delimiters to tell when a new message starts.
17582 You would not need to use a separate pipe for each message, because
17583 bogofilter can handle multiple messages at once.
17584 <P>
17585 Similarly, you would select a group of non-spam messages
17586 and run them through a <EM>this_is_nonspam</EM> script
17587 that was something like
17588 <P>
17589 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
17590 <P>
17591
17592 For the more adventurous, the next step might be to automate the upkeep of
17593 the bogofilter database.
17594 It might make more sense to have bogofilter be part of the delivery process,
17595 but it is also possible to do it entirely from within Alpine.
17596 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
17597 the &quot;-u&quot; argument will cause bogofilter to update the database.
17598 <P>
17599 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
17600 <P>
17601 You'd want a couple more aliases or shell scripts called something like
17602 <EM>change_to_spam</EM>
17603 <P>
17604 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
17605 <P>
17606 and
17607 <EM>change_to_nonspam</EM>
17608 <P>
17609 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
17610 <P>
17611 When you run across a message in your INBOX that should have been
17612 classified as spam you would pipe it to the change_to_spam script, and
17613 when you run across a message in your spam folder that should have been
17614 left in your INBOX you would pipe it through change_to_nonspam.
17615
17616 <P>
17617 There is a technical problem with this approach.
17618 Alpine may check your filters more than once.
17619 In particular, every time you start Alpine the filters will be checked for
17620 each message.
17621 Also, if you have any filters that depend on message state (New, Deleted, etc.)
17622 then Alpine will recheck for matches in messages that have changed state
17623 at the time you close the folder and before expunging.
17624 This is usually ok.
17625 However, in this case it is a problem because the command
17626 <P>
17627 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
17628 <P>
17629 has the side effect of updating the database.
17630 So you run the risk of updating the database multiple times for a single
17631 message instead of updating it just once per message.
17632 There are some ways to work around this problem.
17633 What you need is a way to mark the message after you have run the filter.
17634 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
17635 Besides having the filter move the message to a spam folder, also have it
17636 set the Bogo keyword.
17637 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
17638 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
17639 This rule can only set the Bogo keyword for the messages that it matches.
17640 You will also need to add a second rule right after this one that
17641 matches all the messages that don't have the Bogo keyword set
17642 (put the keyword in the Keyword pattern and toggle
17643 the Not with the ! command)
17644 and takes the action of setting it.
17645 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
17646 (and so it won't re-run the bogofilter command) if the keyword is already
17647 set.
17648 <P>
17649 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
17650 on all messages that don't have the Bogo keyword set.
17651 This will have the side effect of inserting that message in the bogofilter
17652 database, match or not.
17653 If this rule matches (it is spam), the Bogo keyword will be set and
17654 the message will be moved to a spam folder.
17655 If it does not match, the
17656 following rule will mark the message by turning on the keyword.
17657 This second rule should be a non-terminating
17658 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
17659 rule so that it doesn't stop the filtering process before the rest of
17660 your rules are consulted.
17661
17662 <P>
17663 In summary, the first rule is something like
17664 <PRE>
17665   Nickname          = bogofilter -u rule
17666   Current Folder Type =
17667                (*) Specific
17668                    Folder = INBOX
17669
17670   ! Keyword pattern = Bogo
17671
17672   External Categorizer Commands =
17673        Command              = /usr/local/bin/bogofilter -u
17674        Exit Status Interval = (0,0)
17675        Character Limit      = <No Value Set: using "-1">  (optionally set this)
17676
17677   Filter Action =
17678        (*) Move
17679            Folder = spam
17680
17681   Set These Keywords   = Bogo
17682 </PRE>
17683 <P>
17684 and the following rule is
17685 <PRE>
17686   Nickname          = Set Bogo Keyword
17687   Current Folder Type =
17688                (*) Specific
17689                    Folder = INBOX
17690
17691   ! Keyword pattern = Bogo
17692
17693   Filter Action =
17694        (*) Just Set Message Status
17695
17696   Set These Keywords   = Bogo
17697
17698   Features =
17699       [X]  dont-stop-even-if-rule-matches
17700 </PRE>
17701 <P>
17702 If it is possible for you to insert bogofilter in the delivery process instead
17703 of having it called from Alpine you could prevent having to wait
17704 for the bogofilter processing while you read your mail.
17705 You would have bogofilter add a header to the message at the time of delivery
17706 that identified it as spam or nonspam.
17707 With this method, you could avoid using a Categorizer Command while running Alpine,
17708 and just match on the header instead.
17709 You might still want to use the scripts mentioned above to initialize the
17710 database or to re-classify wrongly classified messages.
17711
17712 <P>
17713 Finally, it isn't for the faint-hearted,
17714 but it is also possible to run bogofilter from PC-Alpine.
17715 You can install Cygwin from
17716 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
17717 then compile bogofilter in the cygwin environment, and run it from
17718 within PC-Alpine.
17719 You would end up with a Categorizer command that looked something like
17720 <P>
17721 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
17722 <P>
17723 Note that the &quot;.exe&quot; extension is explicit,
17724 and that the bogofilter.exe executable should be in the same directory
17725 as cygwin1.dll.
17726
17727 <P>
17728 &lt;End of help on this topic&gt;
17729 </BODY>
17730 </HTML>
17731 ======= h_config_role_cat_status =======
17732 <HTML>
17733 <HEAD>
17734 <TITLE>Exit Status Interval Explained</TITLE>
17735 </HEAD>
17736 <BODY>
17737 <H1>Exit Status Interval Explained</H1>
17738
17739 The categorizer command is run and the result is the exit status of
17740 that command.
17741 If that exit status falls in the Exit Status Interval
17742 then it is considered a match, otherwise it is not a match.
17743 Of course for the entire rule to match, it must also be checked against
17744 the other defined parts of the Pattern.
17745 <P>
17746 The Exit Status Interval defaults to the single value 0 (zero).
17747 If you define it, it should be set to something like:
17748 <P>
17749 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
17750 <P>
17751 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
17752 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
17753 positive and negative integers.
17754 <P>
17755 Actually, a list of intervals may be used if you wish.
17756 A list would look like
17757 <P>
17758 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
17759 <P>
17760 When there is an Exit Status Interval defined, it is a match if the exit status
17761 of the categorizer command is contained in any of the intervals.
17762 The intervals include both endpoints.
17763 <P>
17764 The default interval is
17765 <P>
17766 <CENTER><SAMP>(0,0)</SAMP></CENTER>
17767 <P>
17768 and it matches only if the command exits with exit status equal to zero.
17769
17770 <P>
17771 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17772 for more information on Patterns.
17773 <P>
17774 Look <A HREF="h_edit_nav_cmds">here</A>
17775 to see the available Editing and Navigation commands.
17776 <P>
17777 &lt;End of help on this topic&gt;
17778 </BODY>
17779 </HTML>
17780 ======= h_config_role_cat_limit =======
17781 <HTML>
17782 <HEAD>
17783 <TITLE>Character Limit Explained</TITLE>
17784 </HEAD>
17785 <BODY>
17786 <H1>Character Limit Explained</H1>
17787
17788 Setting this option makes it possible to limit how much of the message
17789 is made available to the categorizer command as input.
17790 The default value (-1) means that the entire message is fed to the
17791 command.
17792 A value of 0 (zero) means that only the headers of the message are
17793 made available.
17794 A positive integer means that the headers plus that many characters from
17795 the body of the message are passed to the categorizer.
17796
17797 <P>
17798 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17799 for more information on Patterns.
17800 <P>
17801 Look <A HREF="h_edit_nav_cmds">here</A>
17802 to see the available Editing and Navigation commands.
17803 <P>
17804 &lt;End of help on this topic&gt;
17805 </BODY>
17806 </HTML>
17807 ======= h_config_role_age =======
17808 <HTML>
17809 <HEAD>
17810 <TITLE>Age Interval Explained</TITLE>
17811 </HEAD>
17812 <BODY>
17813 <H1>Age Interval Explained</H1>
17814
17815 The Age Interval, if defined, is part of the Pattern.
17816 If you use this, it should be set to something like:
17817 <P>
17818 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
17819 <P>
17820 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
17821 The special value &quot;INF&quot; may be used for the max value.
17822 It represents infinity.
17823 <P>
17824 In rare cases it may be useful to use the more general form of the value,
17825 which is a comma-separated list of intervals.
17826 It would look something like:
17827 <P>
17828 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
17829 <P>
17830 When there is an Age Interval defined, it is a match if the age, in days, of
17831 the message is contained in the interval.
17832 The interval includes both endpoints.
17833 If the option is set to a list of intervals then it is a match if the
17834 age of the message is contained in any of the intervals.
17835 <P>
17836 Even though this option is called Age, it isn't actually
17837 the <EM>age</EM> of the message.
17838 Instead, it is how many days ago the message arrived in one of your folders.
17839 If the current time is a little past midnight, then a message that arrived
17840 just before midnight arrived yesterday, even though the message is only
17841 a few minutes old.
17842 By default, the date being used is not the date in the Date
17843 header of the message.
17844 It is the date that the message arrived in one of your folders.
17845 When you Save a message from one folder to another that arrival date
17846 is preserved.
17847 If you would like to use the date in the Date header that is possible.
17848 Turn on the option
17849 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
17850 near the bottom of the rule definition.
17851 <P>
17852 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
17853 The age interval
17854 <P>
17855 <CENTER><SAMP>(2,2)</SAMP></CENTER>
17856 <P>
17857 matches all messages that arrived on the day before yesterday.
17858 The interval
17859 <P>
17860 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
17861 <P>
17862 matches all messages that arrived at least 180 days before today.
17863 The interval
17864 <P>
17865 <CENTER><SAMP>(0,1)</SAMP></CENTER>
17866 <P>
17867 matches all messages that arrived today or yesterday.
17868
17869 <P>
17870 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17871 for more information on Patterns.
17872 <P>
17873 Look <A HREF="h_edit_nav_cmds">here</A>
17874 to see the available Editing and Navigation commands.
17875 <P>
17876 &lt;End of help on this topic&gt;
17877 </BODY>
17878 </HTML>
17879 ======= h_config_role_size =======
17880 <HTML>
17881 <HEAD>
17882 <TITLE>Size Interval Explained</TITLE>
17883 </HEAD>
17884 <BODY>
17885 <H1>Size Interval Explained</H1>
17886
17887 The Size Interval, if defined, is part of the Pattern.
17888 If you use this, it should be set to something like:
17889 <P>
17890 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
17891 <P>
17892 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
17893 The special value &quot;INF&quot; may be used for the max value.
17894 It represents infinity.
17895 <P>
17896 In rare cases it may be useful to use the more general form of the value,
17897 which is a comma-separated list of intervals.
17898 It would look something like:
17899 <P>
17900 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
17901 <P>
17902 When there is a Size Interval defined, it is a match if the size of
17903 the message is contained in the interval.
17904 The interval includes both endpoints.
17905 If the option is set to a list of intervals then it is a match if the
17906 size of the message is contained in any of the intervals.
17907 <P>
17908 The size interval
17909 <P>
17910 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
17911 <P>
17912 matches all messages with sizes greater than or equal to 10000, and less
17913 than or equal to 50000.
17914 The interval
17915 <P>
17916 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
17917 <P>
17918 matches all messages with sizes greater than or equal to 100000.
17919
17920 <P>
17921 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17922 for more information on Patterns.
17923 <P>
17924 Look <A HREF="h_edit_nav_cmds">here</A>
17925 to see the available Editing and Navigation commands.
17926 <P>
17927 &lt;End of help on this topic&gt;
17928 </BODY>
17929 </HTML>
17930 ======= h_config_role_scorei =======
17931 <HTML>
17932 <HEAD>
17933 <TITLE>Score Interval Explained</TITLE>
17934 </HEAD>
17935 <BODY>
17936 <H1>Score Interval Explained</H1>
17937
17938 The Score Interval, if defined, is part of the Pattern.
17939 If you use this, it should be set to something like:
17940 <P>
17941 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
17942 <P>
17943 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
17944 -32000 and 32000.
17945 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
17946 the min and max values.
17947 These represent negative and positive infinity.
17948 <P>
17949 Actually, the value may be a list of intervals rather than just a
17950 single interval if that is useful.
17951 The elements of the list are separated by commas like:
17952 <P>
17953 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
17954 <P>
17955 When there is a Score Interval defined, it is a match if the score for
17956 the message is contained in any of the intervals.
17957 The intervals include both endpoints.
17958 The score for a message is calculated by looking at every scoring rule
17959 defined and adding up the Score Values for the rules that match the message.
17960 Scoring rules are created using the
17961 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
17962
17963 <P>
17964 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17965 for more information on Patterns.
17966 <P>
17967 Look <A HREF="h_edit_nav_cmds">here</A>
17968 to see the available Editing and Navigation commands.
17969 <P>
17970 &lt;End of help on this topic&gt;
17971 </BODY>
17972 </HTML>
17973 ======= h_config_role_fldr_type =======
17974 <HTML>
17975 <HEAD>
17976 <TITLE>Current Folder Type Explained</TITLE>
17977 </HEAD>
17978 <BODY>
17979 <H1>Current Folder Type Explained</H1>
17980
17981 The Current Folder Type is part of the role's Pattern.
17982 It refers to the type of the currently open folder, which is the folder
17983 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
17984 In order for a role to be considered a match, the current folder must
17985 be of the type you set here.
17986 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17987 all what you might think.
17988 <P>
17989 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
17990 example, then
17991 that role will only be a match if the current folder is a newsgroup and
17992 the rest of the Pattern matches.
17993 The value &quot;Specific&quot; may be used when you want to limit the match
17994 to a specific folder (not just a specific type of folder), or to a list of
17995 specific folders.
17996 <P>
17997 In order to match a specific folder you Select the &quot;Specific&quot;
17998 button <EM>AND</EM> fill in
17999 the name (or list of names) of
18000 the folder in the &quot;Folder List&quot; field.
18001 If the current folder is any of the folders in the list, that is considered
18002 a match.
18003 The name of each folder in the list may be either &quot;INBOX&quot;,
18004 the technical specification
18005 of the folder (like what appears in your configuration file) or, if the
18006 folder is one of your incoming folders, it may be the nickname you've given
18007 the folder.
18008 Here are a couple samples of specific folder names:
18009 <P>
18010 <CENTER><SAMP>{monet.art.example.com/user=vincent}mail/art-class</SAMP></CENTER>
18011 <P>
18012 <CENTER><SAMP>{news.example.com/nntp/user=peter}#news.comp.mail.pine</SAMP></CENTER>
18013 <P>
18014 Observe that in order for an external folder (IMAP, POP, News) to be a match,
18015 you must also add the /user= option in the definition of the incoming folder.
18016 <P>
18017 The easiest way to fill in the &quot;Folder List&quot; field is to use
18018 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
18019 highlighted, or to use the &quot;Take&quot; command with the configuration
18020 feature
18021 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
18022 turned on.
18023 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18024 Current Folder Type is set to &quot;Specific&quot;, and any value that
18025 &quot;Folder List&quot; has is ignored unless the type
18026 is set to &quot;Specific&quot;.
18027 <P>
18028 When reading a newsgroup, there may be a performance penalty
18029 incurred when collecting the information necessary to check a Pattern.
18030 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18031 <P>
18032 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18033 for more information on Patterns.
18034 <P>
18035 Look <A HREF="h_edit_nav_cmds">here</A>
18036 to see the available Editing and Navigation commands.
18037 <P>
18038 &lt;End of help on this topic&gt;
18039 </BODY>
18040 </HTML>
18041 ======= h_config_filt_rule_type =======
18042 <HTML>
18043 <HEAD>
18044 <TITLE>Filter Action Explained</TITLE>
18045 </HEAD>
18046 <BODY>
18047 <H1>Filter Action Explained</H1>
18048
18049 The Filter Action specifies the action to be taken when the Pattern is a
18050 match.
18051 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
18052 &quot;Just Set Message Status&quot;.
18053 <P>
18054 If it is set to &quot;Delete&quot;, then the message that matches the
18055 Pattern will be deleted from the open folder.
18056 <P>
18057 If it is set to &quot;Move&quot;, then the name of the folder to which
18058 the matching message should be moved is given in the &quot;Folder List&quot; field on the
18059 next line of the screen.
18060 A list of folders separated by commas may be given, in which case the
18061 message will be copied to all of the folders in the list before it is
18062 deleted.
18063 <P>
18064 If it is set to neither of those two values (it is set to the value
18065 labeled &quot;Just Set Message Status&quot;) then the message status
18066 setting will happen
18067 but the message will not be deleted or moved.
18068 <P>
18069 If you are Moving a message you may also set Message Status if you wish.
18070 <P>
18071 The easiest way to fill in the &quot;Folder List&quot; field is to use
18072 the T command that is available when the &quot;Folder List&quot; line is
18073 highlighted.
18074 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18075 Filter Action is set to &quot;Move&quot;, and any value that
18076 &quot;Folder List&quot; has is ignored unless the type
18077 is set to &quot;Move&quot;.
18078 <P>
18079 There are a few tokens that may be used in the names in the Folder List.
18080 They are all related to the date on which the filtering is taking place.
18081 The tokens are words surrounded by underscores.
18082 For example, if you want your filter to move messages to a folder named
18083 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
18084 you could specify the folder as
18085 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
18086 which would result in a file named something like
18087 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
18088 or
18089 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
18090 which would result in a file named something like
18091 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
18092 The available tokens are listed
18093 <A HREF="h_index_tokens">here</A>.
18094 <P>
18095 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18096 for more information on Patterns.
18097 <P>
18098 Look <A HREF="h_edit_nav_cmds">here</A>
18099 to see the available Editing and Navigation commands.
18100 <P>
18101 &lt;End of help on this topic&gt;
18102 </BODY>
18103 </HTML>
18104 ======= h_config_score_fldr_type =======
18105 <HTML>
18106 <HEAD>
18107 <TITLE>Current Folder Type Explained</TITLE>
18108 </HEAD>
18109 <BODY>
18110 <H1>Current Folder Type Explained</H1>
18111
18112 The Current Folder Type is part of the scoring rule's Pattern.
18113 It refers to the type of the folder that
18114 the message being scored is in.
18115 In order for a rule to be considered a match, the current folder must
18116 be of the type you set here.
18117 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18118 all what you might think.
18119 <P>
18120 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18121 example, then
18122 that Pattern will only match if the current folder is a newsgroup and
18123 the rest of the Pattern matches.
18124 The value &quot;Specific&quot; may be used when you want to limit the match
18125 to a specific folder (not just a specific type of folder), or to a list of
18126 specific folders.
18127 <P>
18128 In order to match a specific folder you Select the &quot;Specific&quot;
18129 button <EM>AND</EM> fill in
18130 the name (or list of names) of
18131 the folder in the &quot;Folder List&quot; field.
18132 If the current folder is any of the folders in the list, that is considered
18133 a match.
18134 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18135 of the folder (like what appears in your configuration file) or, if the
18136 folder is one of your incoming folders, it may be the nickname you've given
18137 the folder.
18138 Here are a couple samples of specific folder names:
18139 <P>
18140 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18141 <P>
18142 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18143 <P>
18144 The easiest way to fill in the &quot;Folder List&quot; field is to use
18145 the T command that is available when the &quot;Folder List&quot; line is
18146 highlighted.
18147 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18148 Current Folder Type is set to &quot;Specific&quot;, and any value that
18149 &quot;Folder List&quot; has is ignored unless the type
18150 is set to &quot;Specific&quot;.
18151 <P>
18152 When reading a newsgroup, there may be a performance penalty
18153 incurred when collecting the information necessary to check a Pattern.
18154 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18155 For example, if you have Index Line Coloring rules that have Score Intervals
18156 defined then the scores for all the visible messages will need to be calculated.
18157 If some of your Scoring rules have
18158 a Current Folder Type of
18159 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
18160 screen to draw more slowly when in a newsgroup.
18161 <P>
18162 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18163 for more information on Patterns.
18164 <P>
18165 Look <A HREF="h_edit_nav_cmds">here</A>
18166 to see the available Editing and Navigation commands.
18167 <P>
18168 &lt;End of help on this topic&gt;
18169 </BODY>
18170 </HTML>
18171 ======= h_config_other_fldr_type =======
18172 <HTML>
18173 <HEAD>
18174 <TITLE>Current Folder Type Explained</TITLE>
18175 </HEAD>
18176 <BODY>
18177 <H1>Current Folder Type Explained</H1>
18178
18179 The Current Folder Type is part of the rule's Pattern.
18180 It refers to the type of the folder being viewed.
18181 In order for a rule to be considered a match, the current folder must
18182 be of the type you set here.
18183 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18184 all what you might think.
18185 <P>
18186 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18187 example, then
18188 that Pattern will only match if the current folder is a newsgroup.
18189 The value &quot;Specific&quot; may be used when you want to limit the match
18190 to a specific folder (not just a specific type of folder), or to a list of
18191 specific folders.
18192 <P>
18193 In order to match a specific folder you Select the &quot;Specific&quot;
18194 button <EM>AND</EM> fill in
18195 the name (or list of names) of
18196 the folder in the &quot;Folder List&quot; field.
18197 If the current folder is any of the folders in the list, that is considered
18198 a match.
18199 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18200 of the folder (like what appears in your configuration file) or, if the
18201 folder is one of your incoming folders, it may be the nickname you've given
18202 the folder.
18203 Here are a couple samples of specific folder names:
18204 <P>
18205 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18206 <P>
18207 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18208 <P>
18209 The easiest way to fill in the &quot;Folder List&quot; field is to use
18210 the T command that is available when the &quot;Folder List&quot; line is
18211 highlighted.
18212 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18213 Current Folder Type is set to &quot;Specific&quot;, and any value that
18214 &quot;Folder List&quot; has is ignored unless the type
18215 is set to &quot;Specific&quot;.
18216 <P>
18217 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18218 for more information on Patterns.
18219 <P>
18220 Look <A HREF="h_edit_nav_cmds">here</A>
18221 to see the available Editing and Navigation commands.
18222 <P>
18223 &lt;End of help on this topic&gt;
18224 </BODY>
18225 </HTML>
18226 ======= h_config_incol_fldr_type =======
18227 <HTML>
18228 <HEAD>
18229 <TITLE>Current Folder Type Explained</TITLE>
18230 </HEAD>
18231 <BODY>
18232 <H1>Current Folder Type Explained</H1>
18233
18234 The Current Folder Type is part of the Line Coloring rule's Pattern.
18235 It refers to the type of the folder for which the MESSAGE INDEX is
18236 being viewed.
18237 In order for a rule to be considered a match, the current folder must
18238 be of the type you set here.
18239 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18240 all what you might think.
18241 <P>
18242 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18243 example, then
18244 that Pattern will only match if the current folder is a newsgroup and
18245 the rest of the Pattern matches.
18246 The value &quot;Specific&quot; may be used when you want to limit the match
18247 to a specific folder (not just a specific type of folder), or to a list of
18248 specific folders.
18249 <P>
18250 In order to match a specific folder you Select the &quot;Specific&quot;
18251 button <EM>AND</EM> fill in
18252 the name (or list of names) of
18253 the folder in the &quot;Folder List&quot; field.
18254 If the current folder is any of the folders in the list, that is considered
18255 a match.
18256 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18257 of the folder (like what appears in your configuration file) or, if the
18258 folder is one of your incoming folders, it may be the nickname you've given
18259 the folder.
18260 Here are a couple samples of specific folder names:
18261 <P>
18262 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18263 <P>
18264 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18265 <P>
18266 The easiest way to fill in the &quot;Folder List&quot; field is to use
18267 the T command that is available when the &quot;Folder List&quot; line is
18268 highlighted.
18269 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18270 Current Folder Type is set to &quot;Specific&quot;, and any value that
18271 &quot;Folder List&quot; has is ignored unless the type
18272 is set to &quot;Specific&quot;.
18273 <P>
18274 When reading a newsgroup, there may be a performance penalty
18275 incurred when collecting the information necessary to check a Pattern.
18276 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18277 For example, a rule with a non-Normal Index Line Color
18278 and a Current Folder Type of
18279 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
18280 screen to draw more slowly when in a newsgroup.
18281 <P>
18282 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18283 for more information on Patterns.
18284 <P>
18285 Look <A HREF="h_edit_nav_cmds">here</A>
18286 to see the available Editing and Navigation commands.
18287 <P>
18288 &lt;End of help on this topic&gt;
18289 </BODY>
18290 </HTML>
18291 ======= h_config_filt_fldr_type =======
18292 <HTML>
18293 <HEAD>
18294 <TITLE>Current Folder Type Explained</TITLE>
18295 </HEAD>
18296 <BODY>
18297 <H1>Current Folder Type Explained</H1>
18298
18299 The Current Folder Type is part of the Filtering rule's Pattern.
18300 It refers to the type of the folder for which the filtering is being done.
18301 In order for a rule to be considered a match, the current folder must
18302 be of the type you set here.
18303 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18304 all what you might think.
18305 <P>
18306 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18307 example, then
18308 that Pattern will only match if the current folder is a newsgroup and
18309 the rest of the Pattern matches.
18310 The value &quot;Specific&quot; may be used when you want to limit the match
18311 to a specific folder (not just a specific type of folder), or to a list of
18312 specific folders.
18313 <P>
18314 In order to match a specific folder you Select the &quot;Specific&quot;
18315 button <EM>AND</EM> fill in
18316 the name (or list of names) of
18317 the folder in the &quot;Folder List&quot; field.
18318 If the current folder is any of the folders in the list, that is considered
18319 a match.
18320 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18321 of the folder (like what appears in your configuration file) or, if the
18322 folder is one of your incoming folders, it may be the nickname you've given
18323 the folder.
18324 Here are a couple samples of specific folder names:
18325 <P>
18326 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18327 <P>
18328 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18329 <P>
18330 The easiest way to fill in the &quot;Folder List&quot; field is to use
18331 the T command that is available when the &quot;Folder List&quot; line is
18332 highlighted.
18333 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18334 Current Folder Type is set to &quot;Specific&quot;, and any value that
18335 &quot;Folder List&quot; has is ignored unless the type
18336 is set to &quot;Specific&quot;.
18337 <P>
18338 When reading a newsgroup, there may be a performance penalty
18339 incurred when collecting the information necessary to check a Pattern.
18340 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18341 For example, a rule with a Current Folder Type of either
18342 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
18343 more slowly when opening a newsgroup.
18344 <P>
18345 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18346 for more information on Patterns.
18347 <P>
18348 Look <A HREF="h_edit_nav_cmds">here</A>
18349 to see the available Editing and Navigation commands.
18350 <P>
18351 &lt;End of help on this topic&gt;
18352 </BODY>
18353 </HTML>
18354 ======= h_config_role_stat_imp =======
18355 <HTML>
18356 <HEAD>
18357 <TITLE>Message Important Status Explained</TITLE>
18358 </HEAD>
18359 <BODY>
18360 <H1>Message Important Status Explained</H1>
18361
18362 This part of the Pattern may have one of three possible values.
18363 The default value is &quot;Don't care&quot;, which matches any message.
18364 The other two values are &quot;Yes&quot;, which means the message must be
18365 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
18366 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
18367 to be a match.
18368 <P>
18369 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18370 for more information on Patterns.
18371 <P>
18372 Look <A HREF="h_edit_nav_cmds">here</A>
18373 to see the available Editing and Navigation commands.
18374 <P>
18375 &lt;End of help on this topic&gt;
18376 </BODY>
18377 </HTML>
18378 ======= h_config_role_stat_new =======
18379 <HTML>
18380 <HEAD>
18381 <TITLE>Message New Status Explained</TITLE>
18382 </HEAD>
18383 <BODY>
18384 <H1>Message New Status Explained</H1>
18385
18386 This part of the Pattern may have one of three possible values.
18387 The default value is &quot;Don't care&quot;, which matches any message.
18388 The other two values are &quot;Yes&quot;, which means the message must be
18389 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
18390 means the message must <EM>not</EM> be &quot;New&quot; in order
18391 to be a match.
18392 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
18393 same as <EM>Seen</EM>.
18394 <P>
18395 The nomenclature for New and Recent is a bit confusing:
18396 <P>
18397 New means that the message is Unseen.
18398 It could have been in your mailbox for a long time but if you haven't looked
18399 at it, it is still considered New.
18400 That matches the default Alpine index display that shows an N for such a
18401 message.
18402 <P>
18403 Recent means that the message was added to this folder since the last time
18404 you opened the folder.
18405 Alpine also shows an N by default for these types of messages.
18406 If you were to run two copies of Alpine that opened a folder one right after
18407 the other, a message would only show up as Recent in (at most) the first
18408 Alpine session.
18409 <P>
18410 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18411 for more information on Patterns.
18412 <P>
18413 Look <A HREF="h_edit_nav_cmds">here</A>
18414 to see the available Editing and Navigation commands.
18415 <P>
18416 &lt;End of help on this topic&gt;
18417 </BODY>
18418 </HTML>
18419 ======= h_config_role_stat_recent =======
18420 <HTML>
18421 <HEAD>
18422 <TITLE>Message Recent Status Explained</TITLE>
18423 </HEAD>
18424 <BODY>
18425 <H1>Message Recent Status Explained</H1>
18426
18427 This part of the Pattern may have one of three possible values.
18428 The default value is &quot;Don't care&quot;, which matches any message.
18429 The other two values are &quot;Yes&quot;, which means the message must be
18430 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
18431 means the message must <EM>not</EM> be &quot;Recent&quot; in order
18432 to be a match.
18433 &quot;Recent&quot; means that the message was added to the folder since
18434 the last time the folder was opened.
18435 If more than one mail client has the folder opened, the message will
18436 appear to be &quot;Recent&quot; to only one of the clients.
18437 <P>
18438 The nomenclature for New and Recent is a bit confusing:
18439 <P>
18440 New means that the message is Unseen.
18441 It could have been in your mailbox for a long time but if you haven't looked
18442 at it, it is still considered New.
18443 That matches the default Alpine index display that shows an N for such a
18444 message.
18445 <P>
18446 Recent means that the message was added to this folder since the last time
18447 you opened the folder.
18448 Alpine also shows an N by default for these types of messages.
18449 If you were to run two copies of Alpine that opened a folder one right after
18450 the other, a message would only show up as Recent in (at most) the first
18451 Alpine session.
18452 <P>
18453 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18454 for more information on Patterns.
18455 <P>
18456 Look <A HREF="h_edit_nav_cmds">here</A>
18457 to see the available Editing and Navigation commands.
18458 <P>
18459 &lt;End of help on this topic&gt;
18460 </BODY>
18461 </HTML>
18462 ======= h_config_role_stat_del =======
18463 <HTML>
18464 <HEAD>
18465 <TITLE>Message Deleted Status Explained</TITLE>
18466 </HEAD>
18467 <BODY>
18468 <H1>Message Deleted Status Explained</H1>
18469
18470 This part of the Pattern may have one of three possible values.
18471 The default value is &quot;Don't care&quot;, which matches any message.
18472 The other two values are &quot;Yes&quot;, which means the message must be
18473 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
18474 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
18475 to be a match.
18476 <P>
18477 If you are thinking of using this part of the Pattern as a way to prevent
18478 messages from being filtered more than once in a Filter Pattern,
18479 take a look at the Filter Option
18480 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
18481 instead.
18482 It should work better than using this field since it will hide the filtered
18483 messages even if they are already Deleted.
18484 That option is at the bottom of the Filter configuration screen.
18485 <P>
18486 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18487 for more information on Patterns.
18488 <P>
18489 Look <A HREF="h_edit_nav_cmds">here</A>
18490 to see the available Editing and Navigation commands.
18491 <P>
18492 &lt;End of help on this topic&gt;
18493 </BODY>
18494 </HTML>
18495 ======= h_config_role_stat_ans =======
18496 <HTML>
18497 <HEAD>
18498 <TITLE>Message Answered Status Explained</TITLE>
18499 </HEAD>
18500 <BODY>
18501 <H1>Message Answered Status Explained</H1>
18502
18503 This part of the Pattern may have one of three possible values.
18504 The default value is &quot;Don't care&quot;, which matches any message.
18505 The other two values are &quot;Yes&quot;, which means the message must be
18506 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
18507 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
18508 to be a match.
18509 <P>
18510 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18511 for more information on Patterns.
18512 <P>
18513 Look <A HREF="h_edit_nav_cmds">here</A>
18514 to see the available Editing and Navigation commands.
18515 <P>
18516 &lt;End of help on this topic&gt;
18517 </BODY>
18518 </HTML>
18519 ======= h_config_role_abookfrom =======
18520 <HTML>
18521 <HEAD>
18522 <TITLE>Address in Address Book Explained</TITLE>
18523 </HEAD>
18524 <BODY>
18525 <H1>Address in Address Book Explained</H1>
18526
18527 This option gives you a way to match messages that contain an address
18528 that is in one of your address books.
18529 Only the simple entries in your address books are searched.
18530 Address book distribution lists are ignored!
18531 <P>
18532 This part of the Pattern may have one of five possible values.
18533 The default value is &quot;Don't care&quot;, which matches any message.
18534 The value &quot;Yes, in any address book&quot; means at least one of the addresses
18535 from the message must be in at least one of your
18536 address books in order to be a match.
18537 The value &quot;No, not in any address book&quot;
18538 means none of the addresses may
18539 be in any of your address books in order to be a match.
18540 <P>
18541 The values &quot;Yes, in specific address books&quot; and
18542 &quot;No, not in any of specific address books&quot; are similar but instead
18543 of depending on all address books you are allowed to give a list of address
18544 books to look in.
18545 Usually this would be a single address book but it may be a
18546 list of address books as well.
18547 For each of these &quot;specific&quot; address book options you Select which
18548 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
18549 name (or list of names) of the address book in the
18550 &quot;Abook List&quot; field.
18551 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
18552 The easiest way to fill in the Abook List field it to use
18553 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
18554 line is highlighted.
18555 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
18556 option is set to one of the two &quot;Specific&quot;, values.
18557 <P>
18558 The addresses from the message that are checked for are determined by the
18559 setting you have for &quot;Types of addresses to check for in address book&quot;.
18560 If you set this to &quot;From&quot; the From address from the message will
18561 be looked up in the address book.
18562 If you set it to &quot;To&quot; instead then the To addresses will be used.
18563 If any of the To addresses are in the address book then it is considered
18564 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
18565 You could set it to both From and To, in which case all of the From and To
18566 addresses are used.
18567 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
18568 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
18569 exists or the From address if there is no Reply-To address.
18570 Same for the Sender address.
18571 <P>
18572 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18573 for more information on Patterns.
18574 <P>
18575 Look <A HREF="h_edit_nav_cmds">here</A>
18576 to see the available Editing and Navigation commands.
18577 <P>
18578 &lt;End of help on this topic&gt;
18579 </BODY>
18580 </HTML>
18581 ======= h_config_inabook_from =======
18582 <HTML>
18583 <HEAD>
18584 <TITLE>From</TITLE>
18585 </HEAD>
18586 <BODY>
18587 <H1>From</H1>
18588
18589 Setting the From line will cause the address from the From header line
18590 of the message to be checked for in the address book.
18591 <P>
18592 &lt;End of help on this topic&gt;
18593 </BODY>
18594 </HTML>
18595 ======= h_config_inabook_replyto =======
18596 <HTML>
18597 <HEAD>
18598 <TITLE>Reply-To</TITLE>
18599 </HEAD>
18600 <BODY>
18601 <H1>Reply-To</H1>
18602
18603 Setting the Reply-To line will cause the address from the Reply-To header line
18604 of the message to be checked for in the address book.
18605 However, if there is no Reply-To header line in the message the From header
18606 line will be used instead.
18607 We understand this is dumb but we don't have an easy way around it.
18608 <P>
18609 &lt;End of help on this topic&gt;
18610 </BODY>
18611 </HTML>
18612 ======= h_config_inabook_sender =======
18613 <HTML>
18614 <HEAD>
18615 <TITLE>Sender</TITLE>
18616 </HEAD>
18617 <BODY>
18618 <H1>Sender</H1>
18619
18620 Setting the Sender line will cause the address from the Sender header line
18621 of the message to be checked for in the address book.
18622 However, if there is no Sender header line in the message the From header
18623 line will be used instead.
18624 We understand this is dumb but we don't have an easy way around it.
18625 <P>
18626 &lt;End of help on this topic&gt;
18627 </BODY>
18628 </HTML>
18629 ======= h_config_inabook_to =======
18630 <HTML>
18631 <HEAD>
18632 <TITLE>To</TITLE>
18633 </HEAD>
18634 <BODY>
18635 <H1>To</H1>
18636
18637 Setting the To line will cause the address from the To header line
18638 of the message to be checked for in the address book.
18639 <P>
18640 &lt;End of help on this topic&gt;
18641 </BODY>
18642 </HTML>
18643 ======= h_config_inabook_cc =======
18644 <HTML>
18645 <HEAD>
18646 <TITLE>CC</TITLE>
18647 </HEAD>
18648 <BODY>
18649 <H1>CC</H1>
18650
18651 Setting the CC line will cause the address from the CC header line
18652 of the message to be checked for in the address book.
18653 <P>
18654 &lt;End of help on this topic&gt;
18655 </BODY>
18656 </HTML>
18657 ======= h_config_role_stat_8bitsubj =======
18658 <HTML>
18659 <HEAD>
18660 <TITLE>Raw 8-bit in Subject Explained</TITLE>
18661 </HEAD>
18662 <BODY>
18663 <H1>Raw 8-bit in Subject Explained</H1>
18664
18665 It seems that lots of unwanted email contains unencoded 8-bit characters
18666 in the Subject.
18667 Normally, characters with the 8th bit set are not allowed in the Subject
18668 header unless they are MIME-encoded.
18669 This option gives you a way to match messages that have Subjects that
18670 contain unencoded 8-bit characters.
18671 <P>
18672 This part of the Pattern may have one of three possible values.
18673 The default value is &quot;Don't care&quot;, which matches any message.
18674 The other two values are &quot;Yes&quot;, which means the Subject of
18675 the message must contain unencoded 8-bit characters (characters with the
18676 most significant bit set)
18677 in order to be a match; or &quot;No&quot;, which
18678 means the Subject must <EM>not</EM>
18679 contain unencoded 8-bit characters in order to be a match.
18680 <P>
18681 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18682 for more information on Patterns.
18683 <P>
18684 Look <A HREF="h_edit_nav_cmds">here</A>
18685 to see the available Editing and Navigation commands.
18686 <P>
18687 &lt;End of help on this topic&gt;
18688 </BODY>
18689 </HTML>
18690 ======= h_config_role_bom =======
18691 <HTML>
18692 <HEAD>
18693 <TITLE>Beginning of Month</TITLE>
18694 </HEAD>
18695 <BODY>
18696 <H1>Beginning of Month</H1>
18697
18698 This option gives you a limited ability to take different actions depending on whether
18699 this is the first time Alpine has been run this month or not.
18700 Though it would be nice to have such an option available, this is not the
18701 same as whether or not this is the first time a paricular folder has been
18702 opened this month.
18703 If you want some action (probably Filtering) to take place in a folder each
18704 month, then you will need to be sure that the folder is opened during the
18705 first Alpine session of the month in order for this option to be helpful.
18706 <P>
18707 This part of the Pattern may have one of three possible values.
18708 The default value is &quot;Don't care&quot;, which matches any message.
18709 The other two values are &quot;Yes&quot;, which means this is the first
18710 time Alpine has been run this month;
18711 or &quot;No&quot;, which
18712 means this is not the first time Alpine has been run this month.
18713 <P>
18714 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18715 for more information on Patterns.
18716 <P>
18717 Here are some technical details.
18718 The way that Alpine decides if it is the beginning of the month or not is
18719 to compare today's date with the date stored in the
18720 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18721 variable in the config file.
18722 If the month of today's date is later than the month stored in the variable,
18723 then this is considered to be the first time you have run Alpine this month, and
18724 that turns the Beginning of the Month option on.
18725 <P>
18726 Look <A HREF="h_edit_nav_cmds">here</A>
18727 to see the available Editing and Navigation commands.
18728 <P>
18729 &lt;End of help on this topic&gt;
18730 </BODY>
18731 </HTML>
18732 ======= h_config_role_boy =======
18733 <HTML>
18734 <HEAD>
18735 <TITLE>Beginning of Year</TITLE>
18736 </HEAD>
18737 <BODY>
18738 <H1>Beginning of Year</H1>
18739
18740 This option gives you a limited ability to take different actions depending on whether
18741 this is the first time Alpine has been run this year or not.
18742 Though it would be nice to have such an option available, this is not the
18743 same as whether or not this is the first time a paricular folder has been
18744 opened this year.
18745 If you want some action (probably Filtering) to take place in a folder each
18746 year, then you will need to be sure that the folder is opened during the
18747 first Alpine session of the year in order for this option to be helpful.
18748 <P>
18749 This part of the Pattern may have one of three possible values.
18750 The default value is &quot;Don't care&quot;, which matches any message.
18751 The other two values are &quot;Yes&quot;, which means this is the first
18752 time Alpine has been run this year;
18753 or &quot;No&quot;, which
18754 means this is not the first time Alpine has been run this year.
18755 <P>
18756 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18757 for more information on Patterns.
18758 <P>
18759 Here are some technical details.
18760 The way that Alpine decides if it is the beginning of the year or not is
18761 to compare today's date with the date stored in the
18762 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18763 variable in the config file.
18764 If the year of today's date is later than the year stored in the variable,
18765 then this is considered to be the first time you have run Alpine this year, and
18766 that turns the Beginning of the Year option on.
18767 <P>
18768 Look <A HREF="h_edit_nav_cmds">here</A>
18769 to see the available Editing and Navigation commands.
18770 <P>
18771 &lt;End of help on this topic&gt;
18772 </BODY>
18773 </HTML>
18774 ======= h_config_role_inick =======
18775 <HTML>
18776 <HEAD>
18777 <TITLE>Initialize Values From Role Explained</TITLE>
18778 </HEAD>
18779 <BODY>
18780 <H1>Initialize Values From Role Explained</H1>
18781
18782 This is a power user feature.
18783 You will usually want to leave this field empty.
18784 The value of this field is the nickname of another one of your roles.
18785 The Action values from that other role
18786 are used as the initial values of the Action items for this role.
18787 If you put something in any of the action fields for this role, that will
18788 override whatever was in the corresponding field of the initializer role.
18789 <P>
18790 You might use this field if the &quot;Action&quot; part of one of your roles
18791 is something you want to use in more than one role.
18792 Instead of filling in those action values again for each role, you
18793 may give the nickname of the role where the values are filled in.
18794 It's just a shortcut way to define Role Actions.
18795 <P>
18796 Here's an example to help explain how this works.
18797 Suppose you have a role with nickname &quot;role1&quot; and role1 has
18798 (among other things)
18799 <P>
18800 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
18801 <P>
18802 set.
18803 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
18804 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
18805 from role1 by default (and any of the other inheritable action values
18806 that are set).
18807 So if role2 had
18808 <P>
18809 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
18810 <P>
18811 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
18812 However, if role2 had
18813 <P>
18814 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
18815 <P>
18816 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
18817 <P>
18818 If you wish,
18819 you may choose a nickname from your list of roles by using the
18820 &quot;T&quot; command.
18821 If the role you are using to initialize also has a role it initializes from,
18822 then that initialization happens first.
18823 That is, inheritance works as expected with the grandparent and
18824 great-grandparent (and so on) roles having the expected effect.
18825 <P>
18826 Look <A HREF="h_edit_nav_cmds">here</A>
18827 to see the available Editing and Navigation commands.
18828 <P>
18829 &lt;End of help on this topic&gt;
18830 </BODY>
18831 </HTML>
18832 ======= h_config_role_setfrom =======
18833 <HTML>
18834 <HEAD>
18835 <TITLE>Set From Explained</TITLE>
18836 </HEAD>
18837 <BODY>
18838 <H1>Set From Explained</H1>
18839
18840 This describes part of the action to be taken if the Pattern for this
18841 role is a match.
18842 This field consists of a single address that will be used as the From
18843 address on the message you are sending.
18844 This should be a fully-qualified address like
18845 <P>
18846 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18847 <P>
18848 or just
18849 <P>
18850 <CENTER><SAMP>user@domain</SAMP></CENTER>
18851 <P>
18852 If you wish,
18853 you may choose an address from your address book with the
18854 &quot;T&quot; command.
18855 <P>
18856 If this is left blank, then your normal From address will be used.
18857 <P>
18858 You may also find it useful to add the changed From address to the
18859 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
18860 configuration option.
18861 <P>
18862 Look <A HREF="h_edit_nav_cmds">here</A>
18863 to see the available Editing and Navigation commands.
18864 <P>
18865 &lt;End of help on this topic&gt;
18866 </BODY>
18867 </HTML>
18868 ======= h_config_role_setreplyto =======
18869 <HTML>
18870 <HEAD>
18871 <TITLE>Set Reply-To Explained</TITLE>
18872 </HEAD>
18873 <BODY>
18874 <H1>Set Reply-To Explained</H1>
18875
18876 This describes part of the action to be taken if the Pattern for this
18877 role is a match.
18878 This field consists of a single address that will be used as the Reply-To
18879 address on the message you are sending.
18880 This may be a fully-qualified address like
18881 <P>
18882 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18883 <P>
18884 or just
18885 <P>
18886 <CENTER><SAMP>user@domain</SAMP></CENTER>
18887 <P>
18888 If you wish,
18889 you may choose an address from your address book with the
18890 &quot;T&quot; command.
18891 <P>
18892 If this is left blank, then there won't be a Reply-To address unless
18893 you have configured one specially with the
18894 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
18895 configuration option.
18896 <P>
18897 Look <A HREF="h_edit_nav_cmds">here</A>
18898 to see the available Editing and Navigation commands.
18899 <P>
18900 &lt;End of help on this topic&gt;
18901 </BODY>
18902 </HTML>
18903 ======= h_config_role_setfcc =======
18904 <HTML>
18905 <HEAD>
18906 <TITLE>Set Fcc Explained</TITLE>
18907 </HEAD>
18908 <BODY>
18909 <H1>Set Fcc Explained</H1>
18910
18911 This describes part of the action to be taken if the Pattern for this
18912 role is a match.
18913 This field consists of a single folder name that will be used in
18914 the Fcc field of the message you are sending.
18915 You may put anything here that you would normally type into the Fcc
18916 field from the composer.
18917 <P>
18918 In addition, an fcc of &quot;&quot; (two double quotation marks) means
18919 no Fcc.
18920 <P>
18921 A blank field here means that Alpine will use its normal rules for deciding
18922 the default value of the Fcc field.
18923 For many roles, perhaps most, it may make more sense for you to use the
18924 other Alpine facilities for setting the Fcc.
18925 In particular, if you want the Fcc to depend on who you are sending the
18926 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
18927 is probably more useful.
18928 In that case, you would want to leave the Fcc field here blank.
18929 However, if you have a role that depends on who the message you are replying
18930 to was From, or what address that message was sent to;
18931 then it might make sense to set the Fcc for that role here.
18932 <P>
18933 If you wish,
18934 you may choose a folder from your folder collections by using the
18935 &quot;T&quot; command.
18936 <P>
18937 Look <A HREF="h_edit_nav_cmds">here</A>
18938 to see the available Editing and Navigation commands.
18939 <P>
18940 &lt;End of help on this topic&gt;
18941 </BODY>
18942 </HTML>
18943 ======= h_config_role_usesmtp =======
18944 <HTML>
18945 <HEAD>
18946 <TITLE>Use SMTP Server Explained</TITLE>
18947 </HEAD>
18948 <BODY>
18949 <H1>Use SMTP Server Explained</H1>
18950
18951 This describes part of the action to be taken if the Pattern for this
18952 role is a match.
18953 If this field has a value, then it will be used as the SMTP server
18954 to send mail when this role is being used (unless the SMTP server variable
18955 is set in the system-wide fixed configuration file).
18956 It has the same semantics as the
18957 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18958 variable in the Setup/Config screen.
18959 <P>
18960 If you are using this to post from home when you are at home and from
18961 work when you are at work you need to be careful about postponing messages.
18962 When you postpone a composition that was using a role with this variable
18963 set, the SMTP server list will be saved
18964 with the postponed composition.
18965 It cannot be changed later.
18966 Because of this, you may want to make this a list of SMTP servers
18967 with the preferred server at the front of the list and alternate servers
18968 later in the list.
18969 In your &quot;Home&quot; role you would put the home SMTP server first and
18970 the work SMTP server last.
18971 In your &quot;Work&quot; role you would put the work SMTP server first and
18972 the home SMTP server last.
18973 Then if you start a composition as &quot;Work&quot;, postpone
18974 it, and then later resume it from home the work SMTP server will fail but
18975 the home SMTP server later in the list will succeed.
18976 <P>
18977 You may be able to simplify things by making the regular
18978 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18979 variable in the Setup/Config screen a list instead of using roles
18980 to set the SMTP server.
18981
18982 <P>
18983 Look <A HREF="h_edit_nav_cmds">here</A>
18984 to see the available Editing and Navigation commands.
18985 <P>
18986 &lt;End of help on this topic&gt;
18987 </BODY>
18988 </HTML>
18989 ======= h_config_role_usenntp =======
18990 <HTML>
18991 <HEAD>
18992 <TITLE>Use NNTP Server Explained</TITLE>
18993 </HEAD>
18994 <BODY>
18995 <H1>Use NNTP Server Explained</H1>
18996
18997 This describes part of the action to be taken if the Pattern for this
18998 role is a match.
18999 If this field has a value, then it will be used as the NNTP server
19000 to post to newsgroups when this role is being used (unless the NNTP server
19001 variable
19002 is set in the system-wide fixed configuration file).
19003 It has the same semantics as the
19004 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
19005 variable in the Setup/Config screen.
19006 <P>
19007 This role setting can facilitate posting to the right nntp server for someone
19008 who reads news from various news sources.  The feature
19009 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
19010 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
19011 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
19012 nntp servers for roles may be more desirable for some people.
19013 <P>
19014 If you are using this to post from home when you are at home and from
19015 work when you are at work you need to be careful about postponing messages.
19016 When you postpone a composition that was using a role with this variable
19017 set, the NNTP server list will be saved
19018 with the postponed composition.
19019 It cannot be changed later.
19020 Because of this, you may want to make this a list of NNTP servers
19021 with the preferred server at the front of the list and alternate servers
19022 later in the list.
19023 In your &quot;Home&quot; role you would put the home NNTP server first and
19024 the work NNTP server last.
19025 In your &quot;Work&quot; role you would put the work NNTP server first and
19026 the home NNTP server last.
19027 Then if you start a composition as &quot;Work&quot;, postpone
19028 it, and then later resume it from home the work NNTP server will fail but
19029 the home NNTP server later in the list will succeed.
19030 <P>
19031 You may be able to simplify things by making the regular
19032 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
19033 variable in the Setup/Config screen a list instead of using roles
19034 to set the NNTP server.
19035
19036 <P>
19037 Look <A HREF="h_edit_nav_cmds">here</A>
19038 to see the available Editing and Navigation commands.
19039 <P>
19040 &lt;End of help on this topic&gt;
19041 </BODY>
19042 </HTML>
19043 ======= h_config_role_setotherhdr =======
19044 <HTML>
19045 <HEAD>
19046 <TITLE>Set Other Headers Explained</TITLE>
19047 </HEAD>
19048 <BODY>
19049 <H1>Set Other Headers Explained</H1>
19050
19051 This describes part of the action to be taken if the Pattern for this
19052 role is a match.
19053 This field gives you a way to set values for headers besides
19054 &quot;From&quot; and &quot;Reply-To&quot;.
19055 If you want to set either of those, use the specific
19056 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
19057 <P>
19058 This field is similar to the
19059 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
19060 Each header you specify here must include the header tag
19061 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
19062 and may optionally include a value for that header.
19063 In order to see these headers when you compose using this role you
19064 must use the rich header
19065 <!--chtml if pinemode="function_key"-->(F5)
19066 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
19067 Here's an example that shows how you might set the To address.
19068 <P>
19069 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
19070 <P>
19071 Headers set in this way are different from headers set with the
19072 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
19073 will replace any value that already exists.
19074 For example, if you are Replying to a message there will already be at
19075 least one address in the To header (the address you are Replying to).
19076 However, if you Reply using a role that sets the To header, that role's
19077 To header value will be used instead.
19078 <P>
19079 Limitation: Because commas are used to separate the list of
19080 Other Headers, it is not possible to have the value of a
19081 header contain a comma;
19082 nor is there currently an &quot;escape&quot; mechanism provided
19083 to make this work.
19084 <P>
19085 Look <A HREF="h_edit_nav_cmds">here</A>
19086 to see the available Editing and Navigation commands.
19087 <P>
19088 &lt;End of help on this topic&gt;
19089 </BODY>
19090 </HTML>
19091 ======= h_config_role_setlitsig =======
19092 <HTML>
19093 <HEAD>
19094 <TITLE>Set Literal Signature Explained</TITLE>
19095 </HEAD>
19096 <BODY>
19097 <H1>Set Literal Signature Explained</H1>
19098
19099 This describes part of the action to be taken if the Pattern for this
19100 role is a match.
19101 This field contains the actual text for your signature, as opposed to
19102 the name of a file containing your signature.
19103 If this is defined it takes precedence over any value set in the
19104 &quot;Set Signature&quot; field.
19105 <P>
19106 This is simply a different way to store the signature.
19107 The signature is stored inside your Alpine configuration file instead of in
19108 a separate file.
19109 Tokens work the same way they do with
19110 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
19111 help text there for more information.
19112 <P>
19113
19114 The two character sequence &#92;n (backslash followed by
19115 the character n) will be used to signify a line-break in your signature.
19116 You don't have to enter the &#92;n, but it will be visible in the
19117 CHANGE THIS ROLE RULE window after you are done editing the signature.
19118 <P>
19119 Look <A HREF="h_edit_nav_cmds">here</A>
19120 to see the available Editing and Navigation commands.
19121 <P>
19122 &lt;End of help on this topic&gt;
19123 </BODY>
19124 </HTML>
19125 ======= h_config_role_setsig =======
19126 <HTML>
19127 <HEAD>
19128 <TITLE>Set Signature Explained</TITLE>
19129 </HEAD>
19130 <BODY>
19131 <H1>Set Signature Explained</H1>
19132
19133 This describes part of the action to be taken if the Pattern for this
19134 role is a match.
19135 <P>
19136 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
19137 option from Setup/Config
19138 or the &quot;Set LiteralSig&quot; option for this role are defined,
19139 then this option will be ignored.
19140 You can tell that that is the case because the value of this
19141 option will show up as
19142 <P>
19143 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
19144 <P>
19145 You may either use all Literal Signatures (signatures stored in your
19146 configuration file) throughout Alpine, or all signature files.
19147 You can't mix the two.
19148 <P>
19149 This field consists of a filename that will be used as the signature
19150 file when using this role.
19151 <P>
19152 If the filename is followed by a vertical bar (|) then instead
19153 of reading the contents of the file the file is assumed to be a
19154 program that will produce the text to be used on its standard output.
19155 The program can't have any arguments and doesn't receive any input from Alpine,
19156 but the rest of the processing works as if the contents came from a file.
19157 <P>
19158 Instead of storing the data in a local file, the
19159 signature data may be stored remotely in an IMAP folder.
19160 In order to do this,
19161 you must use a remote name for the signature.
19162 A remote signature name might look like:
19163 <P>
19164 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
19165 <P>
19166
19167 The syntax used here is the same as the syntax used for a remote
19168 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
19169 Note that you may not access an existing signature file remotely,
19170 you have to create a new <EM>folder</EM> that contains the signature data.
19171 If the name you use here for the signature data is a remote name, then when
19172 you edit the file using the &quot;F&quot; command the data will
19173 be saved remotely in the folder.
19174 You aren't required to do anything special to create the folder, it
19175 gets created if you use a remote name.
19176
19177 <P>
19178 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
19179 the name of the file) you have specified.
19180 If you type &quot;T&quot; you may use a browser to choose an existing filename.
19181 <P>
19182 Besides containing regular text, a signature file may also
19183 contain (or a signature program may produce) tokens that are replaced with text
19184 that depends on the message you are replying to or forwarding.
19185 The tokens all look like _word_ (a word surrounded by underscores).
19186 For example, if the token
19187 <P>
19188 <CENTER><SAMP>_DATE_</SAMP></CENTER>
19189 <P>
19190 is included in the text of the signature file, then when you reply to
19191 or forward a message, the token will be replaced with the actual date
19192 the message you are replying to or forwarding was sent.
19193 <P>
19194 If you use a role that has a signature file for a plain composition
19195 (that is, not a reply or forward) then there is no original message, so
19196 any tokens that depend on the message will be replaced with nothing.
19197 So if you want a signature file to be useful for new compositions it
19198 shouldn't include any of the tokens that depend on the message being
19199 replied to or forwarded.
19200 <P>
19201 The list of available tokens is
19202 <A HREF="h_index_tokens">here</A>.
19203 <P>
19204 Actually, for the adventurous, there is a way to conditionally include text based
19205 on whether or not a token would result in specific replacement text.
19206 For example, you could include some text based on whether or not
19207 the _NEWS_ token would result in any newsgroups if it was used.
19208 It's explained in detail
19209 <A HREF="h_reply_token_conditionals">here</A>.
19210 <P>
19211 In the very unlikely event that you want to include a literal token in
19212 a signature file, you must precede it with a backslash character.
19213 For example, to include the literal text _DATE_ you must actually use
19214 &#92;_DATE_.
19215 It is not possible to have a literal backslash followed by an expanded token.
19216 <P>
19217 A blank field here means that Alpine will use its normal rules for deciding
19218 which file (if any) to use for the signature file.
19219 <P>
19220 An alternate method for storing the signature is available in
19221 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
19222 <P>
19223 Look <A HREF="h_edit_nav_cmds">here</A>
19224 to see the available Editing and Navigation commands.
19225 <P>
19226 &lt;End of help on this topic&gt;
19227 </BODY>
19228 </HTML>
19229 ======= h_config_role_settempl =======
19230 <HTML>
19231 <HEAD>
19232 <TITLE>Set Template Explained</TITLE>
19233 </HEAD>
19234 <BODY>
19235 <H1>Set Template Explained</H1>
19236
19237 This describes part of the action to be taken if the Pattern for this
19238 role is a match.
19239 This field consists of a filename that will be used as the template
19240 file when using this role.
19241 The template file is a file that is included at the top of the message you
19242 are composing.
19243 <P>
19244 If the filename is followed by a vertical bar (|) then instead
19245 of reading the contents of the file the file is assumed to be a
19246 program that will produce the text to be used on its standard output.
19247 The program can't have any arguments and doesn't receive any input from Alpine,
19248 but the rest of the processing works as if the contents came from a file.
19249 <P>
19250 Instead of storing the data in a local file, the
19251 template may be stored remotely in an IMAP folder.
19252 In order to do this,
19253 you must use a remote name for the template.
19254 A remote template name might look like:
19255 <P>
19256 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
19257 <P>
19258
19259 The syntax used here is the same as the syntax used for a remote
19260 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
19261 Note that you may not access an existing template file remotely,
19262 you have to create a new <EM>folder</EM> that contains the template data.
19263 If the name you use here for the template is a remote name, then when
19264 you edit the file using the &quot;F&quot; command the data will
19265 be saved remotely in the folder.
19266 You aren't required to do anything special to create the folder, it
19267 gets created if you use a remote name.
19268 <P>
19269 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
19270 the name of the file) you have specified.
19271 If you type &quot;T&quot; you may use a browser to choose an existing filename.
19272 <P>
19273 Besides containing regular text, the template file may also
19274 contain (or a template file program may produce) tokens that are replaced with text
19275 that depends on the message you are replying to or forwarding.
19276 The tokens all look like _word_ (a word surrounded by underscores).
19277 For example, if the token
19278 <P>
19279 <CENTER><SAMP>_DATE_</SAMP></CENTER>
19280 <P>
19281 is included in the text of the template file, then when you reply to
19282 or forward a message, the token will be replaced with the actual date
19283 the message you are replying to or forwarding was sent.
19284 <P>
19285 If you use a role that has a template file for a plain composition
19286 (that is, not a reply or forward) then there is no original message, so
19287 any tokens that depend on the message will be replaced with nothing.
19288 So if you want a template file to be useful for new compositions it
19289 shouldn't include any of the tokens that depend on the message being
19290 replied to or forwarded.
19291 <P>
19292 The list of available tokens is
19293 <A HREF="h_index_tokens">here</A>.
19294 <P>
19295 Actually, for the adventurous, there is a way to conditionally include text based
19296 on whether or not a token would result in specific replacement text.
19297 For example, you could include some text based on whether or not
19298 the _NEWS_ token would result in any newsgroups if it was used.
19299 It's explained in detail
19300 <A HREF="h_reply_token_conditionals">here</A>.
19301 <P>
19302 In the very unlikely event that you want to include a literal token in
19303 a template file, you must precede it with a backslash character.
19304 For example, to include the literal text _DATE_ you must actually use
19305 &#92;_DATE_.
19306 It is not possible to have a literal backslash followed by an expanded token.
19307 <P>
19308 A blank template field means that Alpine will not use a template file when
19309 this role is being used.
19310 <P>
19311 Look <A HREF="h_edit_nav_cmds">here</A>
19312 to see the available Editing and Navigation commands.
19313 <P>
19314 &lt;End of help on this topic&gt;
19315 </BODY>
19316 </HTML>
19317 ======= h_config_filt_stat_imp =======
19318 <HTML>
19319 <HEAD>
19320 <TITLE>Set Important Status Explained</TITLE>
19321 </HEAD>
19322 <BODY>
19323 <H1>Set Important Status Explained</H1>
19324
19325 This describes part of the action to be taken if the Pattern for this
19326 filter is a match.
19327 If set to &quot;Don't change it&quot; then this does nothing.
19328 If set to &quot;Set this state&quot; then the Important flag is set
19329 for the matching message.
19330 If set to &quot;Clear this state&quot; then the Important flag is cleared
19331 for the matching message.
19332 The important flag usually causes an asterisk to show up in the MESSAGE
19333 INDEX.
19334 It may also be useful when selecting a set of messages
19335 with the Select command.
19336 <P>
19337 Look <A HREF="h_edit_nav_cmds">here</A>
19338 to see the available Editing and Navigation commands.
19339 <P>
19340 &lt;End of help on this topic&gt;
19341 </BODY>
19342 </HTML>
19343 ======= h_config_filt_stat_new =======
19344 <HTML>
19345 <HEAD>
19346 <TITLE>Set New Status Explained</TITLE>
19347 </HEAD>
19348 <BODY>
19349 <H1>Set New Status Explained</H1>
19350
19351 This describes part of the action to be taken if the Pattern for this
19352 filter is a match.
19353 If set to &quot;Don't change it&quot; then this does nothing.
19354 If set to &quot;Set this state&quot; then the
19355 matching message is marked New.
19356 If set to &quot;Clear this state&quot; then the
19357 matching message is marked Seen.
19358 <P>
19359 Look <A HREF="h_edit_nav_cmds">here</A>
19360 to see the available Editing and Navigation commands.
19361 <P>
19362 &lt;End of help on this topic&gt;
19363 </BODY>
19364 </HTML>
19365 ======= h_config_filt_stat_ans =======
19366 <HTML>
19367 <HEAD>
19368 <TITLE>Set Answered Status Explained</TITLE>
19369 </HEAD>
19370 <BODY>
19371 <H1>Set Answered Status Explained</H1>
19372
19373 This describes part of the action to be taken if the Pattern for this
19374 filter is a match.
19375 If set to &quot;Don't change it&quot; then this does nothing.
19376 If set to &quot;Set this state&quot; then the Answered flag is set
19377 for the matching message.
19378 If set to &quot;Clear this state&quot; then the Answered flag is cleared
19379 for the matching message.
19380 <P>
19381 Look <A HREF="h_edit_nav_cmds">here</A>
19382 to see the available Editing and Navigation commands.
19383 <P>
19384 &lt;End of help on this topic&gt;
19385 </BODY>
19386 </HTML>
19387 ======= h_config_filt_stat_del =======
19388 <HTML>
19389 <HEAD>
19390 <TITLE>Set Deleted Status Explained</TITLE>
19391 </HEAD>
19392 <BODY>
19393 <H1>Set Deleted Status Explained</H1>
19394
19395 This describes part of the action to be taken if the Pattern for this
19396 filter is a match.
19397 If set to &quot;Don't change it&quot; then this does nothing.
19398 If set to &quot;Set this state&quot; then the
19399 matching message is marked Deleted.
19400 If set to &quot;Clear this state&quot; then the
19401 matching message is marked UnDeleted.
19402 <P>
19403 You should not use this option unless you are prepared to have matching
19404 messages expunged from the folder permanently.
19405 For example, if you type the Expunge command, this filter is applied
19406 before the expunge, so matching messages will be marked Deleted and then
19407 will be permanently expunged from the folder.
19408 However, since the index isn't redrawn in between the time that the message
19409 is marked Deleted and the time that you are asked to expunge, the only
19410 indication that you are expunging the message comes in the number of messages
19411 being expunged.
19412 The same thing may happen when you close a folder.
19413 It is also possible that an expunge not initiated by you will
19414 delete matching messages.
19415 <P>
19416 Look <A HREF="h_edit_nav_cmds">here</A>
19417 to see the available Editing and Navigation commands.
19418 <P>
19419 &lt;End of help on this topic&gt;
19420 </BODY>
19421 </HTML>
19422 ======= h_config_role_scoreval =======
19423 <HTML>
19424 <HEAD>
19425 <TITLE>Score Value Explained</TITLE>
19426 </HEAD>
19427 <BODY>
19428 <H1>Score Value Explained</H1>
19429
19430 A message's score is the sum of the Score Values from all of the Scoring rules
19431 with Patterns that match the message.
19432 The value you give here is the Score Value associated with this rule.
19433 A Score Value is an integer between -100 and 100, with the default
19434 value of zero.
19435 <P>
19436 Alternatively, if the
19437 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
19438 field is defined
19439 (on the line right below the &quot;Score Value&quot; field)
19440 then the &quot;Score Value&quot; is ignored and
19441 the &quot;Score From Header&quot; field is used instead.
19442 <P>
19443 Look <A HREF="h_edit_nav_cmds">here</A>
19444 to see the available Editing and Navigation commands.
19445 <P>
19446 &lt;End of help on this topic&gt;
19447 </BODY>
19448 </HTML>
19449 ======= h_config_role_scorehdrtok =======
19450 <HTML>
19451 <HEAD>
19452 <TITLE>Score Value From Header Explained</TITLE>
19453 </HEAD>
19454 <BODY>
19455 <H1>Score Value From Header Explained</H1>
19456
19457 This option provides a way to use a number that appears in the headers of your
19458 messages as the message's score, or as a component of that score.
19459 If this field is defined then it is used instead of the &quot;Score Value&quot;.
19460 The idea behind this option is that there may be a score embedded in the
19461 headers of messages that has already been calculated outside of Alpine.
19462 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
19463 somewhere in that header there is a score.
19464 <P>
19465 The value for this option is the name of the header followed by parentheses
19466 with two arguments inside:
19467 <P>
19468 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
19469 <P>
19470 No space is allowed between the comma and the start of the field_separators.
19471 It would be interpreted as the first separator if it was there.
19472 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
19473 starts after that and goes to the second separator, and so on.
19474 It's easier to explain with examples.
19475 <P>
19476 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
19477 <P>
19478 In the above example the header that is used is the &quot;X-Spam&quot; header.
19479 The value of that header (the part after the colon and the space) is split
19480 into fields separated by spaces.
19481 <P>
19482 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
19483 <P>
19484 The second field is selected and converted to an integer. It only makes sense
19485 if Field2 really is an integer.
19486 <P>
19487 Here's an example of a SpamAssassin header.
19488 The exact look of the header will vary, but if your incoming mail
19489 contains headers that look like the following
19490 <P>
19491 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
19492 <P>
19493 you might want to use the hits value as a score.
19494 Since the score is an integer value you can't make use of the decimal part of
19495 the number, but
19496 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
19497 and &quot;.&quot; as your separators.
19498 <P>
19499 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
19500 <P>
19501 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
19502 hits.
19503 The second field is &quot;10&quot; so the score value would be 10.
19504 <P>
19505 Another example we've seen has headers that look like
19506 <P>
19507 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
19508 <P>
19509 Because there are two equals before the 7% the value
19510 <P>
19511 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
19512 <P>
19513 should capture the probability as the score.
19514 <P>
19515 The Score From Header scoring value actually works just like the
19516 regular Score Value in that the rest of the pattern has to match before
19517 it is used and the scores from all the different scoring rules that
19518 match for a particular message are added together.
19519 When using the Score From Header method it may (or may not) make sense to
19520 use only a single scoring rule with a pattern that matches every message.
19521 <P>
19522 Look <A HREF="h_edit_nav_cmds">here</A>
19523 to see the available Editing and Navigation commands.
19524 <P>
19525 &lt;End of help on this topic&gt;
19526 </BODY>
19527 </HTML>
19528 ======= h_config_role_replyuse =======
19529 <HTML>
19530 <HEAD>
19531 <TITLE>Reply Use Explained</TITLE>
19532 </HEAD>
19533 <BODY>
19534 <H1>Reply Use Explained</H1>
19535
19536 This option determines how this particular role will be used when Replying
19537 to a message.
19538 There are three possible values for this option.
19539 The value &quot;Never&quot;
19540 means that this role will not be a candidate for use when Replying.
19541 The role's Pattern will not be checked for a match, however the role will
19542 be available to be manually switched to if there is a confirmation prompt.
19543 <P>
19544
19545 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19546 mean that you do want to consider this role when Replying.
19547 For either of these settings, the role's Pattern will be compared with
19548 the message being replied to.
19549 If there is a match then this role will either be used without confirmation
19550 or will be the default when confirmation is asked for, depending on
19551 which of the two options is selected.
19552 If confirmation is requested, you will also have a chance to
19553 manually change the role to any one of your other roles.
19554 <P>
19555
19556 You won't be prompted for confirmation if none of your role Patterns
19557 match the message being replied to.
19558 This is independent of the value of the current option.
19559 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19560 feature may be used to change this behavior.
19561 <P>
19562 &lt;End of help on this topic&gt;
19563 </BODY>
19564 </HTML>
19565 ======= h_config_role_forwarduse =======
19566 <HTML>
19567 <HEAD>
19568 <TITLE>Forward Use Explained</TITLE>
19569 </HEAD>
19570 <BODY>
19571 <H1>Forward Use Explained</H1>
19572
19573 This option determines how this particular role will be used when Forwarding
19574 a message.
19575 There are three possible values for this option.
19576 The value &quot;Never&quot;
19577 means that this role will not be a candidate for use when Forwarding.
19578 The role's Pattern will not be checked for a match, however the role will
19579 be available to be manually switched to if there is a confirmation prompt.
19580 <P>
19581
19582 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19583 mean that you do want to consider this role when Forwarding.
19584 For either of these settings, the role's Pattern will be compared with
19585 the message being forwarded.
19586 If there is a match then this role will either be used without confirmation
19587 or will be the default when confirmation is asked for, depending on
19588 which of the two options is selected.
19589 If confirmation is requested, you will also have a chance to
19590 manually change the role to any one of your other roles.
19591 <P>
19592
19593 You won't be prompted for confirmation if none of your role Patterns
19594 match the message being forwarded.
19595 This is independent of the value of the current option.
19596 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19597 feature may be used to change this behavior.
19598 <P>
19599 &lt;End of help on this topic&gt;
19600 </BODY>
19601 </HTML>
19602 ======= h_config_role_composeuse =======
19603 <HTML>
19604 <HEAD>
19605 <TITLE>Compose Use Explained</TITLE>
19606 </HEAD>
19607 <BODY>
19608 <H1>Compose Use Explained</H1>
19609
19610 This option determines how this particular role will be used when Composing
19611 a new message using the &quot;Compose&quot; command.
19612 This does not affect what happens when using the &quot;Role&quot; command
19613 to compose a new message.
19614 The &quot;Role&quot; command allows you to select a role from all of the
19615 roles you have defined, regardless of what Uses you've assigned to those
19616 roles.
19617 <P>
19618
19619 There are three possible values for this option.
19620 The value &quot;Never&quot;
19621 means that this role will not be a candidate for use when Composing.
19622 The role's Current Folder Type will not be checked for a match, however the role
19623 will be available to be manually switched to if there is a confirmation prompt.
19624 <P>
19625
19626 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19627 mean that you do want to consider this role when Composing.
19628 For either of these settings,
19629 the role's Current Folder Type will be checked (since there is no message
19630 to compare with, the rest of the Pattern is considered a match).
19631 If there is a match then this role will either be used without confirmation
19632 or will be the default when confirmation is asked for, depending on
19633 which of the two options is selected.
19634 If confirmation is requested, you will also have a chance to
19635 manually change the role to any one of your other roles.
19636 <P>
19637
19638 When using the Compose command the role checking is a little different
19639 because there is no message being replied to or forwarded.
19640 Because of this the Current Folder Type is checked but the header pattern
19641 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
19642 A role is considered to be a match if it is a candidate for Compose Use and
19643 its Current Folder Type matches the currently open folder.
19644 This could be useful if you want to set a role based on the folder you
19645 are reading, or the type of folder you are reading.
19646 <P>
19647
19648 You won't be prompted for confirmation if none of your role Patterns
19649 are a match.
19650 This is independent of the value of the current option.
19651 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19652 feature may be used to change this behavior.
19653 <P>
19654 &lt;End of help on this topic&gt;
19655 </BODY>
19656 </HTML>
19657 ======= h_config_filter_folder =======
19658 <HTML>
19659 <HEAD>
19660 <TITLE>Filter Folder Explained</TITLE>
19661 </HEAD>
19662 <BODY>
19663 <H1>Filter Folder Explained</H1>
19664
19665 When the Filter Action is set to &quot;Move&quot;,
19666 the folder or folders specified here will be used to store messages matching
19667 the provided pattern.
19668
19669 <P>
19670 If you set the Filter Action to &quot;Move&quot; you must give a folder name
19671 here.
19672
19673 <P>
19674 If you wish,
19675 you may choose a folder from your folder collections by using the
19676 &quot;T&quot; command.
19677 <P>
19678 Besides regular text, the folder name may also contain
19679 tokens that are replaced with text representing the current date
19680 when you run Alpine.
19681 For example, if the folder name you use is
19682 <P>
19683 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
19684 <P>
19685 that is replaced with something like
19686 <P>
19687 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
19688 <P>
19689 Or,
19690 <P>
19691 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
19692 <P>
19693 becomes
19694 <P>
19695 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
19696 <P>
19697 The token names must be surrounded by underscores in order to be recognized
19698 as tokens.
19699 The tokens that may be used are those that are derived from the current date.
19700 They're listed near the bottom of the list of tokens give
19701 <A HREF="h_index_tokens">here</A>.
19702 <P>
19703 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19704 for more information on Patterns.
19705 <P>
19706 Look <A HREF="h_edit_nav_cmds">here</A>
19707 to see the available Editing and Navigation commands.
19708 <P>
19709 &lt;End of help on this topic&gt;
19710 </BODY>
19711 </HTML>
19712 ======= h_config_filter_kw_set =======
19713 <HTML>
19714 <HEAD>
19715 <TITLE>Set These Keywords Explained</TITLE>
19716 </HEAD>
19717 <BODY>
19718 <H1>Set These Keywords Explained</H1>
19719
19720 This describes part of the action to be taken if the Pattern for this
19721 filter is a match.
19722 Read a little about keywords in the help text for the
19723 <A HREF="h_common_flag">Flag</A> command.
19724 This option is a list of keywords that will be Set when there is a match.
19725 If you wish, you may choose keywords from the list of keywords you have
19726 defined with the &quot;T&quot; command.
19727 You may add new keywords by defining them in the
19728 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19729 If you have given a keyword a nickname when configuring it,
19730 that nickname may be used instead of the actual keyword.
19731
19732 <P>
19733 Look <A HREF="h_edit_nav_cmds">here</A>
19734 to see the available Editing and Navigation commands.
19735 <P>
19736 &lt;End of help on this topic&gt;
19737 </BODY>
19738 </HTML>
19739 ======= h_config_filter_kw_clr =======
19740 <HTML>
19741 <HEAD>
19742 <TITLE>Clear These Keywords Explained</TITLE>
19743 </HEAD>
19744 <BODY>
19745 <H1>Clear These Keywords Explained</H1>
19746
19747 This describes part of the action to be taken if the Pattern for this
19748 filter is a match.
19749 Read a little about keywords in the help text for the
19750 <A HREF="h_common_flag">Flag</A> command.
19751 This option is a list of keywords that will be Cleared when there is a match.
19752 If you wish, you may choose keywords from the list of keywords you have
19753 defined with the &quot;T&quot; command.
19754 You may add new keywords by defining them in the
19755 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19756 If you have given a keyword a nickname when configuring it,
19757 that nickname may be used instead of the actual keyword.
19758
19759 <P>
19760 Look <A HREF="h_edit_nav_cmds">here</A>
19761 to see the available Editing and Navigation commands.
19762 <P>
19763 &lt;End of help on this topic&gt;
19764 </BODY>
19765 </HTML>
19766 ======= h_index_tokens =======
19767 <HTML>
19768 <HEAD>
19769 <TITLE>Tokens for Index and Replying</TITLE>
19770 </HEAD>
19771 <BODY>
19772
19773 This set of special tokens may be used in the
19774 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
19775 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
19776 in signature files,
19777 in template files used in
19778 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
19779 that is the target of a Filter Rule.
19780 Some of them aren't available in all situations.
19781 <P>
19782 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
19783 option, but they must be surrounded by underscores for the
19784 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
19785 and in the target of Filter Rules.
19786 <P>
19787 <P>
19788
19789 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
19790
19791 <DL>
19792 <DT>SUBJECT</DT>
19793 <DD>
19794 This token represents the Subject the sender gave the message.
19795 Alternatives for use in the index screen are SHORTSUBJECT,
19796 SUBJKEY, SHORTSUBJKEY, SUBJKEYINIT, SHORTSUBJKEYINIT, SUBJECTTEXT,
19797 SUBJKEYTEXT, and SUBJKEYINITTEXT.
19798 You may color the subject text in the MESSAGE INDEX screen differently by using the
19799 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
19800 <A HREF="h_config_index_opening_color">Index Opening Color</A>
19801 options available from
19802 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19803 </DD>
19804
19805 <DT>FROM</DT>
19806 <DD>
19807 This token represents the personal name (or email address if the name
19808 is unavailable) of the person specified in the message's &quot;From:&quot;
19809 header field.
19810 You may color the from text in the MESSAGE INDEX screen differently by using the
19811 <A HREF="h_config_index_from_color">Index From Color</A>
19812 option available from
19813 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19814 </DD>
19815
19816 <DT>ADDRESS</DT>
19817 <DD>
19818 This is similar to the &quot;FROM&quot; token, only it is always the
19819 email address, never the personal name.
19820 For example, &quot;mailbox@domain&quot;.
19821 </DD>
19822
19823 <DT>MAILBOX</DT>
19824 <DD>
19825 This is the same as the &quot;ADDRESS&quot; except that the
19826 domain part of the address is left off.
19827 For example, &quot;mailbox&quot;.
19828 </DD>
19829
19830 <DT>SENDER</DT>
19831 <DD>
19832 This token represents the personal name (or email address) of the person
19833 listed in the message's &quot;Sender:&quot; header field.
19834 </DD>
19835
19836 <DT>TO</DT>
19837 <DD>
19838 This token represents the personal names (or email addresses if the names
19839 are unavailable) of the persons specified in the
19840 message's &quot;To:&quot; header field.
19841 </DD>
19842
19843 <DT>NEWSANDTO</DT>
19844 <DD>
19845 This token represents the newsgroups from the
19846 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19847 the personal names (or email addresses if the names
19848 are unavailable) of the persons specified in the
19849 message's &quot;To:&quot; header field.
19850 </DD>
19851
19852 <DT>TOANDNEWS</DT>
19853 <DD>
19854 Same as &quot;NEWSANDTO&quot; except in the opposite order.
19855 </DD>
19856
19857 <DT>NEWS</DT>
19858 <DD>
19859 This token represents the newsgroups from the
19860 message's &quot;Newsgroups:&quot; header field.
19861 </DD>
19862
19863 <DT>CC</DT>
19864 <DD>
19865 This token represents the personal names (or email addresses if the names
19866 are unavailable) of the persons specified in the
19867 message's &quot;Cc:&quot; header field.
19868 </DD>
19869
19870 <DT>RECIPS</DT>
19871 <DD>
19872 This token represents the personal names (or email addresses if the names
19873 are unavailable) of the persons specified in both the
19874 message's &quot;To:&quot; header field and
19875 the message's &quot;Cc:&quot; header field.
19876 </DD>
19877
19878 <DT>NEWSANDRECIPS</DT>
19879 <DD>
19880 This token represents the newsgroups from the
19881 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19882 the personal names (or email addresses if the names
19883 are unavailable) of the persons specified in the
19884 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
19885 </DD>
19886
19887 <DT>RECIPSANDNEWS</DT>
19888 <DD>
19889 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
19890 </DD>
19891
19892 <DT>INIT</DT>
19893 <DD>
19894 This token represents the initials from the personal name
19895 of the person specified in the message's &quot;From:&quot;
19896 header field.
19897 If there is no personal name, it is blank.
19898 </DD>
19899
19900 <DT>DATE</DT>
19901 <DD>
19902 This token represents the date on which the message was sent, according
19903 to the &quot;Date&quot; header field.
19904 It has the format MMM DD. For example, &quot;Oct 23&quot;.
19905 The feature
19906 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
19907 which adjusts for the timezone the message was sent from,
19908 may have an effect on the value of this token as well as the values of
19909 all of the other DATE or TIME tokens.
19910 Some of the DATE and TIME tokens are displayed in a locale-specific
19911 way unless the option
19912 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
19913 </DD>
19914
19915 <DT>SMARTDATE</DT>
19916 <DD>
19917 This token represents the date on which the message was sent, according
19918 to the &quot;Date&quot; header field.
19919 It is &quot;Today&quot; if the message was sent today,
19920 &quot;Yesterday&quot; for yesterday,
19921 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
19922 message is from last year and is more than six months old it includes the year, as well.
19923 See the SMARTDATE alternatives below, as well.
19924 </DD>
19925
19926 <DT>SMARTTIME</DT>
19927 <DD>
19928 This token represents the most relevant elements of the date on which
19929 the message was sent (according to the &quot;Date&quot; header field),
19930 in a compact form. If the message was sent today, only the time is used
19931 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
19932 the past week, the day of the week and the hour are used
19933 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
19934 given as date, month, and year (e.g. &quot;23Aug00&quot;,
19935 &quot;9Apr98&quot;).
19936 </DD>
19937
19938 <DT>SMARTTIME24</DT>
19939 <DD>
19940 This token has the structure &quot;day hour:minute&quot;
19941 (e.g. &quot;Sun 19:03&quot;) for messages dated less than a week
19942 from the current date, or &quot;month day&quot; (e.g.
19943 &quot;Nov 23&quot;) for messages dated less than 6 months
19944 ago, or &quot;day/month/year&quot; (e.g &quot;06/Jan/16&quot;)
19945 for messages dated more than 6 months ago. It uses 9 characters
19946 of the width of the screen, and it left aligned.
19947 </DD>
19948
19949 <DT>SMARTDATETIME</DT>
19950 <DD>
19951 This is a combination of SMARTDATE and SMARTTIME.
19952 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
19953 case it is SMARTTIME.
19954 See the SMARTDATETIME alternatives below, as well.
19955 </DD>
19956
19957 <DT>DATEISO</DT>
19958 <DD>
19959 This token represents the date on which the message was sent, according
19960 to the &quot;Date&quot; header field.
19961 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
19962 </DD>
19963
19964 <DT>SHORTDATEISO</DT>
19965 <DD>
19966 This token represents the date on which the message was sent, according
19967 to the &quot;Date&quot; header field.
19968 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
19969 </DD>
19970
19971 <DT>SHORTDATE1</DT>
19972 <DD>
19973 This token represents the date on which the message was sent, according
19974 to the &quot;Date&quot; header field.
19975 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
19976 </DD>
19977
19978 <DT>SHORTDATE2</DT>
19979 <DD>
19980 This token represents the date on which the message was sent, according
19981 to the &quot;Date&quot; header field.
19982 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
19983 </DD>
19984
19985 <DT>SHORTDATE3</DT>
19986 <DD>
19987 This token represents the date on which the message was sent, according
19988 to the &quot;Date&quot; header field.
19989 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
19990 </DD>
19991
19992 <DT>SHORTDATE4</DT>
19993 <DD>
19994 This token represents the date on which the message was sent, according
19995 to the &quot;Date&quot; header field.
19996 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
19997 </DD>
19998
19999 <DT>LONGDATE</DT>
20000 <DD>
20001 This token represents the date on which the message was sent, according
20002 to the &quot;Date&quot; header field.
20003 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
20004 </DD>
20005
20006 <DT>SMARTDATE alternatives</DT>
20007 <DD>
20008 There are several versions of SMARTDATE that are all the same except
20009 for the way they format dates far in the past.
20010 SMARTDATE formats the date using the information from your locale settings
20011 to format the date string. It may end up formatting dates so that they look
20012 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
20013 The feature
20014 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
20015 may have an effect on the values of these tokens.
20016 If you want more control you may use one of the following.
20017   <DL>
20018   <DT>SMARTDATE</DT> <DD>If the option
20019 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
20020 then this will be locale specific. Control this with the
20021 LC_TIME locale setting on a UNIX system. On Windows
20022 the Regional Options control panel may be used to set the Short date
20023 format. At the programming level, the strftime routine is what Alpine
20024 uses to print the date.
20025 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
20026 to SMARTDATES1.</DD>
20027   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
20028   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
20029   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
20030   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
20031   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
20032   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
20033   </DL>
20034 </DD>
20035
20036 <DT>SMARTDATETIME alternatives</DT>
20037 <DD>
20038 There are several versions of SMARTDATETIME that are all very similar.
20039 The ones that end in 24 use a 24-hour clock for Today's messages instead
20040 of a 12-hour clock.
20041 The other variation is
20042 for the way they format dates far in the past.
20043 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
20044 to format the date string. It may end up formatting dates so that they look
20045 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
20046 The feature
20047 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
20048 may have an effect on the values of these tokens.
20049 The possible choices are:
20050   <DL>
20051   <DT>SMARTDATETIME</DT> <DD>If the option
20052 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
20053 then this will be locale specific. Control this with the
20054 LC_TIME locale setting on a UNIX system. On Windows
20055 the Regional Options control panel may be used to set the Short date
20056 format. At the programming level, the strftime routine is what Alpine
20057 uses to print the date.
20058 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
20059 to SMARTDATETIMES1.</DD>
20060   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
20061   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
20062   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
20063   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
20064   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
20065   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
20066   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
20067   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
20068   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
20069   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
20070   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
20071   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
20072   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
20073   </DL>
20074 </DD>
20075
20076 <DT>DAYDATE</DT>
20077 <DD>
20078 This token represents the date on which the message was sent, according
20079 to the &quot;Date&quot; header field.
20080 It looks like &quot;Sat, 23 Oct 1998&quot;.
20081 This token is never converted in any locale-specific way.
20082 </DD>
20083
20084 <DT>PREFDATE</DT>
20085 <DD>
20086 This token represents the date on which the message was sent, according
20087 to the &quot;Date&quot; header field.
20088 It is your operating system's idea of the preferred date representation for the current locale.
20089 Internally it uses the %x version of the date from the strftime routine.
20090 </DD>
20091
20092 <DT>PREFTIME</DT>
20093 <DD>
20094 This token represents the time at which the message was sent, according
20095 to the &quot;Date&quot; header field.
20096 It is the preferred time representation for the current locale.
20097 Internally it uses the %X version of the time from the strftime routine.
20098 </DD>
20099
20100 <DT>PREFDATETIME</DT>
20101 <DD>
20102 This token represents the date and time at which the message was sent, according
20103 to the &quot;Date&quot; header field.
20104 It is the preferred date and time representation for the current locale.
20105 Internally it uses the %c version of the time from the strftime routine.
20106 </DD>
20107
20108 <DT>DAY</DT>
20109 <DD>
20110 This token represents the day of the month on which the message was sent,
20111 according to the &quot;Date&quot; header field.
20112 For example, &quot;23&quot; or &quot;9&quot;.
20113 </DD>
20114
20115 <DT>DAY2DIGIT</DT>
20116 <DD>
20117 This token represents the day of the month on which the message was sent,
20118 according to the &quot;Date&quot; header field.
20119 For example, &quot;23&quot; or &quot;09&quot;.
20120 It is always 2 digits.
20121 </DD>
20122
20123 <DT>DAYORDINAL</DT>
20124 <DD>
20125 This token represents the ordinal number that is the day of
20126 the month on which the message was sent,
20127 according to the &quot;Date&quot; header field.
20128 For example, &quot;23rd&quot; or &quot;9th&quot;.
20129 </DD>
20130
20131 <DT>DAYOFWEEK</DT>
20132 <DD>
20133 This token represents the day of the week on which the message was sent,
20134 according to the &quot;Date&quot; header field.
20135 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20136 </DD>
20137
20138 <DT>DAYOFWEEKABBREV</DT>
20139 <DD>
20140 This token represents the day of the week on which the message was sent,
20141 according to the &quot;Date&quot; header field.
20142 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20143 </DD>
20144
20145 <DT>MONTHABBREV</DT>
20146 <DD>
20147 This token represents the month the message was sent, according
20148 to the &quot;Date&quot; header field.
20149 For example, &quot;Oct&quot;.
20150 </DD>
20151
20152 <DT>MONTHLONG</DT>
20153 <DD>
20154 This token represents the month in which the message was sent, according
20155 to the &quot;Date&quot; header field.
20156 For example, &quot;October&quot;.
20157 </DD>
20158
20159 <DT>MONTH</DT>
20160 <DD>
20161 This token represents the month in which the message was sent, according
20162 to the &quot;Date&quot; header field.
20163 For example, &quot;10&quot; or &quot;9&quot;.
20164 </DD>
20165
20166 <DT>MONTH2DIGIT</DT>
20167 <DD>
20168 This token represents the month in which the message was sent, according
20169 to the &quot;Date&quot; header field.
20170 For example, &quot;10&quot; or &quot;09&quot;.
20171 It is always 2 digits.
20172 </DD>
20173
20174 <DT>YEAR</DT>
20175 <DD>
20176 This token represents the year the message was sent, according
20177 to the &quot;Date&quot; header field.
20178 For example, &quot;1998&quot; or &quot;2001&quot;.
20179 </DD>
20180
20181 <DT>YEAR2DIGIT</DT>
20182 <DD>
20183 This token represents the year the message was sent, according
20184 to the &quot;Date&quot; header field.
20185 For example, &quot;98&quot; or &quot;01&quot;.
20186 It is always 2 digits.
20187 </DD>
20188
20189 <DT>TIME24</DT>
20190 <DD>
20191 This token represents the time at which the message was sent, according
20192 to the &quot;Date&quot; header field.
20193 There is no adjustment made for different time zones, so you'll get
20194 the time the message was sent according to the time zone the sender
20195 was in.
20196 It has the format HH:MM. For example, &quot;17:28&quot;.
20197 </DD>
20198
20199 <DT>TIME12</DT>
20200 <DD>
20201 This token represents the time at which the message was sent, according
20202 to the &quot;Date&quot; header field.
20203 This time is for a 12 hour clock.
20204 It has the format HH:MMpm.
20205 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20206 </DD>
20207
20208 <DT>TIMEZONE</DT>
20209 <DD>
20210 This token represents the numeric timezone from
20211 the &quot;Date&quot; header field.
20212 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
20213 </DD>
20214
20215 </DL>
20216
20217 <P>
20218 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
20219
20220 <DL>
20221 <DT>MSGNO</DT>
20222 <DD>
20223 This token represents the message's current position in the folder that,
20224 of course, may change as the folder is sorted or new mail arrives.
20225 </DD>
20226
20227 <DT>STATUS</DT>
20228 <DD>
20229 This token represents a three character wide field displaying various
20230 aspects of the message's state.
20231 The first character is either blank,
20232 a '*' for message marked Important, or a '+' indicating a message
20233 addressed directly to you (as opposed to your having received it via a
20234 mailing list, for example).
20235 When the feature
20236 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
20237 is set, if the first character would have been
20238 blank then it will instead be a '-' if the message is cc'd to you.
20239 The second character is typically blank,
20240 though the arrow cursor may occupy it if either the
20241 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
20242 or the
20243 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
20244 is set (or you actually are on a slow link).
20245 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
20246 '<A HREF="h_flag_answered">A</A>' (Answered),
20247 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
20248 '<A HREF="h_flag_new">N</A>' (New), or blank.
20249 <P>
20250 If you are using a threaded view of the index and this message is at the
20251 top of a collapsed portion of a thread,
20252 then this token refers to all of the messages in the collapsed portion of
20253 the thread instead of just the top message.
20254 The first character will be a '*' if <EM>any</EM> of the messages in the thread
20255 are marked Important, else a '+' if any of the messages are addressed
20256 to you, else a '-' if any of the messages are cc'd to you.
20257 The third character will be a 'D' if <EM>all</EM> of the messages
20258 in the collapsed thread are marked deleted,
20259 an 'A' if <EM>all</EM> of the messages
20260 in the collapsed thread are marked answered,
20261 it will be an 'N' if any of
20262 the messages are undeleted and unseen, and it will be blank otherwise.
20263 </DD>
20264
20265 <DT>FULLSTATUS</DT>
20266 <DD>
20267 This token represents a less abbreviated alternative
20268 to the &quot;STATUS&quot; token.
20269 It is six characters wide.
20270 The first character is '+', '-', or blank, the
20271 second blank, the third either '*' or blank, the fourth
20272 '<A HREF="h_flag_new">N</A>' or blank,
20273 the fifth '<A HREF="h_flag_answered">A</A>'
20274 or blank, and the sixth character is
20275 either '<A HREF="h_flag_deleted">D</A>' or
20276 blank.
20277 <P>
20278 If you are using a threaded view of the index and this message is at the
20279 top of a collapsed portion of a thread,
20280 then this token refers to all of the messages in the collapsed portion of
20281 the thread instead of just the top message.
20282 The first character is '+', '-', or blank depending on whether <EM>any</EM>
20283 of the messages in the collapsed thread are addressed to you or cc'd to you.
20284 The third character will be '*' if any of the messages are marked
20285 Important.
20286 The fourth character will be 'N' if all of the messages in the thread
20287 are New, else 'n' if some of the messages in the thread are New, else blank.
20288 The fifth character will be 'A' or 'a' or blank, and the sixth character
20289 will be 'D' or 'd' or blank.
20290 </DD>
20291
20292 <DT>IMAPSTATUS</DT>
20293 <DD>
20294 This token represents an even less abbreviated alternative to the
20295 &quot;STATUS&quot; token.
20296 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
20297 an 'N' if the message is new to this folder since the last time
20298 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
20299 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
20300 new to the folder since it was last opened <EM>but</EM> has not been
20301 viewed, or a blank if the message has been in the folder since it was
20302 last opened and has been viewed.
20303 <P>
20304 If you are using a threaded view of the index and this message is at the
20305 top of a collapsed portion of a thread,
20306 then the fourth character will be
20307 'N' if all of the messages in the thread are unseen and recent;
20308 else 'n' if some of the messages in the thread are unseen and recent;
20309 else 'U' if all of the messages in the thread are unseen and not recent;
20310 else 'u' if some of the messages in the thread are unseen and not recent;
20311 else 'R' if all of the messages in the thread are seen and recent;
20312 else 'r' if some of the messages in the thread are seen and recent;
20313 else blank.
20314 </DD>
20315
20316 <DT>SHORTIMAPSTATUS</DT>
20317 <DD>
20318 This is the same as the last four of the six characters of IMAPSTATUS,
20319 so the '+' To Me information will be missing.
20320 </DD>
20321
20322 <DT>SIZE</DT>
20323 <DD>
20324 This token represents the total size, in bytes, of the message.
20325 If a &quot;K&quot; (Kilobyte)
20326 follows the number, the size is approximately 1,000
20327 times that many bytes (rounded to the nearest 1,000).
20328 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20329 1,000,000 times that many bytes.
20330 Commas are not used in this field.
20331 This field is seven characters wide, including the enclosing parentheses.
20332 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20333 The progression of sizes used looks like:
20334
20335 <P>
20336 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
20337 <P>
20338 </DD>
20339
20340 <DT>SIZECOMMA</DT>
20341 <DD>
20342 This token represents the total size, in bytes, of the message.
20343 If a &quot;K&quot; (Kilobyte)
20344 follows the number, the size is approximately 1,000
20345 times that many bytes (rounded to the nearest 1,000).
20346 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20347 1,000,000 times that many bytes.
20348 Commas are used if the number shown is 1,000 or greater.
20349 The SIZECOMMA field is one character wider than the SIZE field.
20350 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20351 The progression of sizes used looks like:
20352
20353 <P>
20354 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
20355 <P>
20356 </DD>
20357
20358 <DT>KSIZE</DT>
20359 <DD>
20360 This token represents the total size of the message, expressed in
20361 kilobytes or megabytes, as most appropriate.
20362 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
20363 The progression of sizes used looks like:
20364
20365 <P>
20366 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
20367 <P>
20368 </DD>
20369
20370 <DT>SIZENARROW</DT>
20371 <DD>
20372 This token represents the total size, in bytes, of the message.
20373 If a &quot;K&quot; (Kilobyte)
20374 follows the number, the size is approximately 1,000
20375 times that many bytes.
20376 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20377 1,000,000 times that many bytes.
20378 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
20379 1,000,000,000 times that many bytes.
20380 This field uses only five characters of screen width, including the enclosing
20381 parentheses.
20382 The progression of sizes used looks like:
20383
20384 <P>
20385 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
20386 <P>
20387 </DD>
20388
20389 <DT>DESCRIPSIZE</DT>
20390 <DD>
20391 This token is intended to represent a more useful description of the
20392 message than just its size, but it isn't very useful at this point.
20393 The plus sign in this view means there are attachments.
20394 Note that including this token in
20395 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
20396 display a little while Alpine collects the necessary information.
20397 </DD>
20398
20399 <DT>SHORTSUBJECT</DT>
20400 <DD> This token is the same as SUBJECT, but removes
20401 text between &quot;[&quot; and &quot;]&quot;. Typically text enclosed
20402 between these characters corresponds to mailing list names, and may be
20403 unnecessary or unwanted in some instances.
20404 </DD>
20405
20406 <DT>SUBJKEY</DT>
20407 <DD>
20408 This token is the same as the SUBJECT token unless keywords are set for
20409 the message.
20410 In that case, a list of keywords enclosed in braces will be prepended to
20411 the subject of the message.
20412 Only those keywords that you have defined in your
20413 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20414 in Setup/Config are considered in the list.
20415 In other words, keywords that have been set by some other means, perhaps
20416 by another email program, won't show up unless included in
20417 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20418 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
20419 prepended to the subject in the MESSAGE TEXT screen.
20420 If you have given a keyword a nickname
20421 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
20422 instead of the actual keyword.
20423 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20424 option may be used to modify this token slightly.
20425 It is also possible to color keywords in the index using the
20426 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20427 </DD>
20428
20429 <DT>SHORTSUBJKEY</DT>
20430 <DD> This token is the same as SUBJKEY, but it is based on
20431 SHORTSUBJECT, instead of in SUBJECT.
20432 </DD>
20433
20434 <DT>SUBJKEYINIT</DT>
20435 <DD>
20436 This token is the same as the SUBJKEY token except that instead of
20437 prepending a list of keywords to the subject, a list of first initials
20438 of keywords will be prepended instead.
20439 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
20440 set (or Work and Now are the Alpine nicknames of keywords that are set)
20441 then the SUBJKEY token would cause a result like
20442 <P>
20443 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
20444 <P>
20445 whereas the SUBJKEYINIT token would give
20446 <P>
20447 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
20448 <P>
20449 Only those keywords that you have defined in your
20450 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20451 in Setup/Config are considered in the list.
20452 In other words, keywords that have been set by some other means, perhaps
20453 by another email program, won't show up unless included in
20454 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20455 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20456 option may be used to modify this token slightly.
20457 It is also possible to color keywords in the index using the
20458 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20459 </DD>
20460
20461 <DT>SHORTSUBJKEYINIT</DT>
20462 <DD> This token is the same as SUBJKEYINIT, but it is based on
20463 SHORTSUBJECT, instead of in SUBJECT.
20464 </DD>
20465
20466 <DT>SUBJECTTEXT</DT>
20467 <DD>
20468 Same as SUBJECT but if there is room in the Subject field for more text,
20469 the opening part of the text of the message is displayed after the subject.
20470 The time needed to fetch the text may cause a performance problem
20471 which can, of course, be avoided by using the SUBJECT version of
20472 the Subject instead.
20473 You may color this opening text differently by using the
20474 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20475 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20476 You may adjust the characters that are displayed between the Subject and the
20477 opening text with the option
20478 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
20479 </DD>
20480
20481 <DT>SUBJKEYTEXT</DT>
20482 <DD>
20483 Same as SUBJKEY but with the opening message text.
20484 </DD>
20485
20486 <DT>OPENINGTEXT</DT>
20487 <DD>
20488 This is similar to SUBJECTTEXT.
20489 Instead of combining the Subject and the opening text in a single
20490 field in the index screen this token allows you to allocate a
20491 separate column just for the opening text of the message.
20492 The time needed to fetch this text may cause a performance problem.
20493 You may color this opening text differently by using the
20494 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20495 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20496 </DD>
20497
20498 <DT>OPENINGTEXTNQ</DT>
20499 <DD>
20500 This is very similar to OPENINGTEXT.
20501 The NQ stands for No Quotes.
20502 The only difference is that quoted text (lines beginning with &gt;) is deleted.
20503 For some messages this may be confusing.
20504 For example, a message might have a line preceding some quoted
20505 text that reads something like &quot;On May 8th person A said.&quot;
20506 That no longer makes sense after the quoted text is deleted and it
20507 will appear that person A said whatever the text after the quote
20508 is, even though that is really person B talking.
20509 </DD>
20510
20511 <DT>SUBJKEYINITTEXT</DT>
20512 <DD>
20513 Same as SUBJKEYINIT but with the opening message text.
20514 </DD>
20515
20516 <DT>KEY</DT>
20517 <DD>
20518 This is a space-delimited list of keywords that are set for the message.
20519 Only those keywords that you have defined in your
20520 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20521 in Setup/Config are considered in the list.
20522 In other words, keywords that have been set by some other means, perhaps
20523 by another email program, won't show up unless included in
20524 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20525 If you have given a keyword a nickname
20526 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
20527 instead of the actual keyword.
20528 It is also possible to color keywords in the index using the
20529 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20530 This token defaults to an arbitrary width of 5.
20531 You should set it to whatever width suits you using something
20532 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
20533 </DD>
20534
20535 <DT>KEYINIT</DT>
20536 <DD>
20537 This is a list of keyword initials that are set for the message.
20538 If you have given a keyword a nickname
20539 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
20540 is displayed instead of the initial of the actual keyword.
20541 It is also possible to color keyword initials in the index using the
20542 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20543 This token defaults to an arbitrary width of 2.
20544 You should set it to whatever width suits you using something
20545 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
20546 </DD>
20547
20548 <DT>PRIORITY</DT>
20549 <DD>
20550 The X-Priority header is a non-standard header that is used in a
20551 somewhat standard way by many mail programs.
20552 Alpine expects the value of this header to be a digit with a value
20553 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
20554 Since this priority is something that the sender sets it is only an indication
20555 of the priority that the sender attaches to the mail and it is therefore almost
20556 totally unreliable for use as a filtering criterion.
20557 This token will display the numeric value of the priority if it is between
20558 1 and 5.
20559 It will be suppressed (blank) if the value is 3, which is normal priority.
20560 This token may be colored with the
20561 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20562 </DD>
20563
20564 <DT>PRIORITYALPHA</DT>
20565 <DD>
20566 This is a more verbose interpretation of the X-Priority field.
20567 Once again nothing is displayed unless the value of the field
20568 is 1, 2, 4, or 5.
20569 The values displayed for those values are:
20570 <P>
20571 <TABLE>
20572 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
20573 <TR> <TD>2</TD> <TD>High</TD> </TR>
20574 <TR> <TD>4</TD> <TD>Low</TD> </TR>
20575 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
20576 </TABLE>
20577 <P>
20578 This token may be colored with the
20579 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20580 </DD>
20581
20582 <DT>PRIORITY!</DT>
20583 <DD>
20584 This is a one character, non-numeric version of the X-Priority field.
20585 If the value of the X-Priority header is 1 or 2 an exclamation
20586 point is displayed.
20587 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
20588 This token may be colored with the
20589 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20590 </DD>
20591
20592 <DT>ATT</DT>
20593 <DD>
20594 This is a one column wide field that represents the number of attachments
20595 a message has. It will be blank if there are no attachments, a single
20596 digit for one to nine attachments, or an asterisk for more than nine.
20597 Note that including this token in
20598 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
20599 display a little while Alpine collects the necessary information.
20600 </DD>
20601
20602 <DT>FROMORTO</DT>
20603 <DD>
20604 This token represents <EM>either</EM> the personal name (or email address) of
20605 the person listed in the message's &quot;From:&quot; header
20606 field, <EM>or</EM>, if that address is yours or one of your
20607 <A HREF="h_config_alt_addresses">alternate addresses</A>,
20608 the first person specified in the
20609 message's &quot;To:&quot; header field
20610 with the prefix &quot;To: &quot; prepended.
20611 If the from address is yours and there is also no &quot;To&quot; address,
20612 Alpine will use the address on the &quot;Cc&quot; line.
20613 If there is no address there, either, Alpine will look for a newsgroup name
20614 from the &quot;Newsgroups&quot; header field and put
20615 that after the &quot;To: &quot; prefix.
20616 </DD>
20617
20618 <DT>FROMORTONOTNEWS</DT>
20619 <DD>
20620 This is almost the same as <EM>FROMORTO</EM>.
20621 The difference is that newsgroups aren't considered.
20622 When a message is from you, doesn't have a To or Cc, and does have
20623 a Newsgroups header; this token will be your name instead of the name
20624 of the newsgroup (like it would be with FROMORTO).
20625 </DD>
20626
20627 <DT>TEXT</DT>
20628 <DD>
20629 This is a different sort of token.
20630 It allows you to display a label within each index line.
20631 It will be the same fixed text for each line.
20632 It is different from all the other tokens in that there is no space column
20633 displayed after this token.
20634 Instead, it is butted up against the following field.
20635 It also has a different syntax.
20636 The text to display is given following a colon after the
20637 word &quot;TEXT&quot;.
20638 For example,
20639 <P>
20640 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
20641 <P>
20642 would insert the literal text &quot;abc=&quot; (without the quotes)
20643 into the index display line.
20644 You must quote the text if it includes space characters, like
20645 <P>
20646 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
20647 <P>
20648 </DD>
20649
20650 <DT>HEADER</DT>
20651 <DD>
20652 This allows you to display the text from a particular header line in the
20653 message.
20654 The syntax for this token is substantially different from all the others
20655 in order that you might be able to display a portion of the text following
20656 a particular header.
20657 The header name you are interested in is given following a colon
20658 after the word &quot;HEADER&quot;.
20659 For example,
20660 <P>
20661 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
20662 <P>
20663 would display the text of the X-Spam header, if any.
20664 Like for other index tokens a width field may (and probably should)
20665 follow this.
20666 <P>
20667 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
20668 <P>
20669 displays the first ten characters of the X-Spam header.
20670 Unlike other index tokens, the syntax for HEADER is more flexible.
20671 An optional second argument comes after a comma inside the parentheses.
20672 It specifies the &quot;field&quot; number.
20673 By default, the field separator is a space character.
20674 No extra space characters are allowed in the argument list.
20675 <P>
20676 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
20677 <P>
20678 would display the second field, left-justified, in a 10 character
20679 wide field.
20680 The second field would consist of all the text after the first space
20681 up to the next space or the end of the header.
20682 The default field number is zero, which stands for the entire line.
20683 There is also an optional third argument that is a list of field
20684 separators. It defaults to a space character.
20685 The example
20686 <P>
20687 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
20688 <P>
20689 would cause the field separators to be any of colon, percent,
20690 or space (there is a space character between the percent and the
20691 right parenthesis).
20692 The first field runs from the start of the header value up to the first
20693 colon, percent, or space; the second goes from there to the next; and so on.
20694 In order to use a comma character as a field separator you must escape
20695 it by preceding it with a backslash (&#92;).
20696 The same is true of the backslash character itself.
20697 There is one further optional argument.
20698 It is an R or an L to specify right or left adjustment of the text
20699 within the field.
20700 The default is to left justify, however if you are displaying numbers
20701 you might prefer to right justify.
20702 <P>
20703 Here's an example of a SpamAssassin header.
20704 The exact look of the header will vary, but if your incoming mail
20705 contains headers that look like the following
20706 <P>
20707 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
20708 <P>
20709 you might want to display the hits value.
20710 The first field starts with the Y in Yes.
20711 To get what you're interested in you might use &quot;=&quot; and
20712 space as the field separators and display the third field, like
20713 <P>
20714 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
20715 <P>
20716 or maybe you would break at the dot instead
20717 <P>
20718 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
20719 <P>
20720 Another example we've seen has headers that look like
20721 <P>
20722 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
20723 <P>
20724 Because there are two equals and a comma before the 7% and a comma
20725 after it, the token
20726 <P>
20727 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
20728 <P>
20729 should display the probability (for example 7% or 83%) right justified
20730 in a 3-wide field.
20731 </DD>
20732
20733 <DT>ARROW</DT>
20734 <DD>
20735 This gives an alternative way to display the current message in the
20736 MESSAGE INDEX screen.
20737 Usually the current message is indicated by the line being shown in
20738 reverse video.
20739 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
20740 the current line will include an &quot;arrow&quot; that
20741 looks like
20742 <P>
20743 <CENTER><SAMP>-&gt;</SAMP></CENTER>
20744 <P>
20745 in the ARROW token's field.
20746 For all of the non-current messages, the ARROW field will be filled
20747 with blanks.
20748 If you use the fixed-field width feature the length of the &quot;arrow&quot;
20749 may be adjusted.
20750 The arrow will be drawn as width-1 dashes followed by a greater than sign.
20751 For example, if you use ARROW(3) you will get
20752 <P>
20753 <CENTER><SAMP>--&gt;</SAMP></CENTER>
20754 <P>
20755 and ARROW(1) will give you just
20756 <P>
20757 <CENTER><SAMP>&gt;</SAMP></CENTER>
20758 <P>
20759 It is also possible to set the color of the ARROW field.
20760 By default (and for non-current messages) the arrow is colored the same
20761 as the index line it is part of.
20762 You may set it to be another color with the
20763 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
20764 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20765 </DD>
20766
20767 <DT>SCORE</DT>
20768 <DD>
20769 This gives the
20770 <a href="h_rules_score">score</a>
20771 of each message.
20772 This will be six columns wide to accommodate the widest possible score.
20773 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
20774 to limit the width of the field to the widest score that
20775 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
20776 If you have not defined any score rules the scores will all be zero.
20777 If any of your score rules contain AllText or BodyText patterns
20778 then including SCORE in the <!--#echo var="VAR_index-format"-->
20779 may slow down the display of the MESSAGE INDEX screen.
20780 </DD>
20781 </DL>
20782
20783 <P>
20784 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
20785
20786 <DL>
20787 <DT>CURNEWS</DT>
20788 <DD>
20789 This token represents the current newsgroup if there is one.
20790 For example, &quot;comp.mail.pine&quot;.
20791 </DD>
20792
20793 <DT>MSGID</DT>
20794 <DD>
20795 This token represents the message ID of the message.
20796 This token does not work with Filter Rule folder names.
20797 </DD>
20798
20799 <DT>CURDATE</DT>
20800 <DD>
20801 This token represents the current date.
20802 It has the format MMM DD. For example, &quot;Oct 23&quot;.
20803 </DD>
20804
20805 <DT>CURDATEISO</DT>
20806 <DD>
20807 This token represents the current date.
20808 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
20809 </DD>
20810
20811 <DT>CURDATEISOS</DT>
20812 <DD>
20813 This token represents the current date.
20814 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
20815 </DD>
20816
20817 <DT>CURPREFDATE</DT>
20818 <DD>
20819 This token represents the current date.
20820 It is your operating system's idea of the preferred date representation for the current locale.
20821 Internally it uses the %x version of the date from the strftime routine.
20822 </DD>
20823
20824 <DT>CURPREFTIME</DT>
20825 <DD>
20826 This token represents the current time.
20827 It is the preferred time representation for the current locale.
20828 Internally it uses the %X version of the time from the strftime routine.
20829 </DD>
20830
20831 <DT>CURPREFDATETIME</DT>
20832 <DD>
20833 This token represents the current date and time.
20834 It is the preferred date and time representation for the current locale.
20835 Internally it uses the %c version of the time from the strftime routine.
20836 </DD>
20837
20838 <DT>CURTIME24</DT>
20839 <DD>
20840 This token represents the current time.
20841 It has the format HH:MM. For example, &quot;17:28&quot;.
20842 </DD>
20843
20844 <DT>CURTIME12</DT>
20845 <DD>
20846 This token represents the current time.
20847 This time is for a 12 hour clock.
20848 It has the format HH:MMpm.
20849 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20850 </DD>
20851
20852 <DT>CURDAY</DT>
20853 <DD>
20854 This token represents the current day of the month.
20855 For example, &quot;23&quot; or &quot;9&quot;.
20856 </DD>
20857
20858 <DT>CURDAY2DIGIT</DT>
20859 <DD>
20860 This token represents the current day of the month.
20861 For example, &quot;23&quot; or &quot;09&quot;.
20862 It is always 2 digits.
20863 </DD>
20864
20865 <DT>CURDAYOFWEEK</DT>
20866 <DD>
20867 This token represents the current day of the week.
20868 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20869 </DD>
20870
20871 <DT>CURDAYOFWEEKABBREV</DT>
20872 <DD>
20873 This token represents the current day of the week.
20874 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20875 </DD>
20876
20877 <DT>CURMONTH</DT>
20878 <DD>
20879 This token represents the current month.
20880 For example, &quot;10&quot; or &quot;9&quot;.
20881 </DD>
20882
20883 <DT>CURMONTH2DIGIT</DT>
20884 <DD>
20885 This token represents the current month.
20886 For example, &quot;10&quot; or &quot;09&quot;.
20887 It is always 2 digits.
20888 </DD>
20889
20890 <DT>CURMONTHLONG</DT>
20891 <DD>
20892 This token represents the current month.
20893 For example, &quot;October&quot;.
20894 </DD>
20895
20896 <DT>CURMONTHABBREV</DT>
20897 <DD>
20898 This token represents the current month.
20899 For example, &quot;Oct&quot;.
20900 </DD>
20901
20902 <DT>CURYEAR</DT>
20903 <DD>
20904 This token represents the current year.
20905 For example, &quot;1998&quot; or &quot;2001&quot;.
20906 </DD>
20907
20908 <DT>CURYEAR2DIGIT</DT>
20909 <DD>
20910 This token represents the current year.
20911 For example, &quot;98&quot; or &quot;01&quot;.
20912 It is always 2 digits.
20913 </DD>
20914
20915 <DT>LASTMONTH</DT>
20916 <DD>
20917 This token represents last month.
20918 For example, if this is November (the 11th month),
20919 it is equal to &quot;10&quot; or if this is October (the 10th month),
20920 it is &quot;9&quot;.
20921 It is possible that this and the other tokens beginning with LASTMONTH
20922 below could be useful when used with a Filtering Rule that
20923 has the &quot;Beginning of Month&quot; option set.
20924 </DD>
20925
20926 <DT>LASTMONTH2DIGIT</DT>
20927 <DD>
20928 This token represents last month.
20929 For example, if this is November (the 11th month),
20930 it is equal to &quot;10&quot; or if this is October (the 10th month),
20931 it is &quot;09&quot;.
20932 It is always 2 digits.
20933 </DD>
20934
20935 <DT>LASTMONTHLONG</DT>
20936 <DD>
20937 This token represents last month.
20938 For example, if this is November the value is &quot;October&quot;.
20939 </DD>
20940
20941 <DT>LASTMONTHABBREV</DT>
20942 <DD>
20943 This token represents last month.
20944 For example, if this is November the value is &quot;Oct&quot;.
20945 </DD>
20946
20947 <DT>LASTMONTHYEAR</DT>
20948 <DD>
20949 This token represents what the year was a month ago.
20950 For example, if this is October, 1998, it is &quot;1998&quot;.
20951 If this is January, 1998, it is &quot;1997&quot;.
20952 </DD>
20953
20954 <DT>LASTMONTHYEAR2DIGIT</DT>
20955 <DD>
20956 This token represents what the year was a month ago.
20957 For example, if this is October, 1998, it is &quot;98&quot;.
20958 If this is January, 1998, it is &quot;97&quot;.
20959 </DD>
20960
20961 <DT>LASTYEAR</DT>
20962 <DD>
20963 This token represents last year.
20964 For example, if this is 1998, it equals &quot;1997&quot;.
20965 It is possible that this
20966 could be useful when used with a Filtering Rule that
20967 has the &quot;Beginning of Year&quot; option set.
20968 </DD>
20969
20970 <DT>LASTYEAR2DIGIT</DT>
20971 <DD>
20972 This token represents last year.
20973 For example, if this is 1998, it equals &quot;97&quot;.
20974 It is always 2 digits.
20975 </DD>
20976
20977 <DT>ROLENICK</DT>
20978 <DD>
20979 This token represents the nickname of the
20980 role currently being used.  If no role is being used,
20981 then no text will be printed for this token.
20982 This token does not work with Filter Rule folder names.
20983 </DD>
20984 </DL>
20985
20986 <P>
20987 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
20988 See the help for the
20989 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
20990 to see why you might want to use this.
20991 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
20992 must be surrounded by underscores when used.
20993
20994 <DL>
20995 <DT>NEWLINE</DT>
20996 <DD>
20997 This is an end of line marker.
20998 </DD>
20999 </DL>
21000
21001 <P>
21002 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
21003
21004 <DL>
21005 <DT>CURSORPOS</DT>
21006 <DD>
21007 This token is different from the others.
21008 When it is replaced it is replaced with nothing, but it sets an Alpine
21009 internal variable that tells the composer to start with the cursor
21010 positioned at the position where this token was.
21011 If both the template file and the signature file contain
21012 a &quot;CURSORPOS&quot; token, then the position in the template file
21013 is used.
21014 If there is a template file and neither it nor the signature file contains
21015 a &quot;CURSORPOS&quot; token, then the cursor is positioned
21016 after the end of the contents of the
21017 template file when the composer starts up.
21018 </DD>
21019 </DL>
21020
21021 <P>
21022 &lt;End of help on this topic&gt;
21023 </BODY>
21024 </HTML>
21025 ======= h_reply_token_conditionals =======
21026 <HTML>
21027 <HEAD>
21028 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
21029 </HEAD>
21030 <BODY>
21031 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
21032
21033 Conditional text inclusion may be used with
21034 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
21035 in signature files, and in template files used in
21036 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
21037 It may <EM>not</EM> be used with the
21038 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
21039
21040 <P>
21041 There is a limited if-else capability for including text.
21042 The if-else condition is based
21043 on whether or not a given token would result in replacement text you
21044 specify.
21045 The syntax of this conditional inclusion is
21046 <P>
21047 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
21048 <P>
21049 The left parenthesis must follow the underscore immediately, with no
21050 intervening space.
21051 It means the token is expanded and the results of that expansion are
21052 compared against the &quot;match_this&quot; argument.
21053 If there is an exact match, then the &quot;if_matched&quot; text is used
21054 as the replacement text.
21055 Otherwise, the &quot;if_not_matched&quot; text is used.
21056 One of the most useful values for the &quot;match_this&quot; argument is
21057 the empty string, &quot;&quot;.
21058 In that case the expansion is compared against the empty string.
21059 <P>
21060 Here's an example to make it clearer.
21061 This text could be included in one of your template files:
21062 <P>
21063 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
21064 <P>
21065 If that is included in a template file that you are using while replying
21066 to a message (because you chose to use the role it was part of),
21067 and that message has a newsgroup header and a newsgroup in that header,
21068 then the text
21069 <P>
21070 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
21071 <P>
21072 will be included in the message you are about to compose.
21073 On the other hand, if the message you are replying to does not have
21074 a newsgroup, then the text
21075 <P>
21076 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
21077 <P>
21078 would be included instead.
21079 This would also work in signature files and in
21080 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
21081 If the &quot;match_this&quot;, &quot;if_matched&quot;,
21082 or &quot;if_not_matched&quot; arguments contain
21083 spaces, parentheses, or commas;
21084 they have to be quoted with double quotation marks (like in the example
21085 above).
21086 If you want to include a literal quote (&quot;) in the text you must escape the
21087 quote by preceding it with a backslash (&#92;) character.
21088 If you want to include a literal backslash character you must escape it
21089 by preceding it with another backslash.
21090 <P>
21091 The comma followed by &quot;if_not_matched&quot; is optional.
21092 If there is no &quot;if_not_matched&quot;
21093 present then no text is included if the not_matched case is true.
21094 Here's another example:
21095 <P>
21096 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
21097 <P>
21098 Here you can see that tokens may appear in the arguments.
21099 The same is true for tokens with the conditional parentheses.
21100 They may appear in arguments,
21101 though you do have to be careful to get the quoting and escaping of
21102 nested double quotes correct.
21103 If this was in the signature file being used and you were replying to a message
21104 sent to comp.mail.pine the resulting text would be:
21105 <P>
21106 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
21107 <P>
21108 If you were replying to a message that wasn't sent to any newsgroup the
21109 resulting text would be a single blank line.
21110 The reason you'd get a blank line is because the end of the line is
21111 outside of the conditional, so is always included.
21112 If you wanted to get rid of that blank line you could do so by moving
21113 the end of line inside the conditional.
21114 In other words, it's ok to have multi-line
21115 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
21116 template file.
21117 The text just continues until the next double quotation, even if it's not
21118 on the same line.
21119 <P>
21120 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
21121 <P>
21122 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
21123 <P>
21124 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
21125 while reading the newsgroup comp.mail.pine the resulting text would be:
21126 <P>
21127 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
21128 <P>
21129 If you were replying to a message while reading an email folder instead
21130 of a newsgroup the resulting leadin text would be
21131 <P>
21132 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
21133 <P>
21134 Here's one more (contrived) example illustrating a matching argument
21135 that is not the empty string.
21136 <P>
21137 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
21138 <P>
21139 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
21140 were replying to
21141 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
21142 would be
21143 <P>
21144 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
21145 <P>
21146 But if you were replying to a message sent on Oct. 27 (and that wasn't
21147 today) you would get
21148 <P>
21149 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
21150 <P>
21151
21152 &lt;End of help on this topic&gt;
21153 </BODY>
21154 </HTML>
21155 ======= h_composer_cntxt_nick =======
21156 <HTML>
21157 <HEAD>
21158 <TITLE>Collection Nickname Explained</TITLE>
21159 </HEAD>
21160 <BODY>
21161 <H1>Collection Edit Help -- Nickname Field</H1>
21162
21163 This field is provided so you can add a short nickname to use when
21164 referring to this collection within Alpine.  Spaces are allowed, and
21165 you don't need to use double-quotes.  However, the double-quote
21166 character is not allowed.
21167 <P>
21168 Look <A HREF="h_edit_nav_cmds">here</A>
21169 to see the available Editing and Navigation commands.
21170 <P>
21171 &lt;End of help on this topic&gt;
21172 </BODY>
21173 </HTML>
21174 ======= h_folder_server_syntax =======
21175 <HTML>
21176 <HEAD>
21177 <TITLE>Server Name Syntax</TITLE>
21178 </HEAD>
21179 <BODY>
21180 <H1>Server Name Syntax</H1>
21181
21182 This help describes the syntax that may be used for server names
21183 that may be associated with remote folders or SMTP servers.
21184
21185 <P>
21186 A server name is the hostname of the server.
21187 It's a good idea to use the host's fully-qualified network name.
21188
21189 <P>
21190 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
21191 <P>
21192
21193 However, IP addresses are allowed if surrounded
21194 with square-brackets.
21195
21196 <P>
21197 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
21198 <P>
21199
21200 An optional network port number may be supplied by appending
21201 a colon (:) followed by the port number
21202 to the server name.
21203 By default, the IMAP port number, 143, is used.
21204
21205 <P>
21206 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
21207 <P>
21208
21209 Besides server name and optional port number, various other optional
21210 parameters may be supplied that alter Alpine's interaction with the server.
21211 A parameter is supplied by appending a slash (/) character followed by
21212 the parameter's name and,
21213 depending on the particular parameter, the value assigned to that
21214 name, to the server name (and optional port number).
21215 Parameter names are <EM>not</EM> case sensitive.
21216 Currently supported parameters include:
21217
21218 <DL>
21219
21220 <DT>User</DT>
21221 <DD>This parameter requires an associated value, and is intended to
21222 provide the username identifier with which to establish the server
21223 connection.
21224 If your SMTP server offers SMTP AUTH authentication, adding this
21225 parameter to the
21226 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
21227 option will cause Alpine to attempt to authenticate to the server using the
21228 supplied username.
21229 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
21230 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
21231 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
21232 option (or to the server name for any folder collection using NNTP)
21233 will cause Alpine to attempt
21234 to authenticate to the server using the supplied username.
21235 An example might be:
21236
21237 <P>
21238 <CENTER><SAMP>/user=katie</SAMP></CENTER>
21239 <P>
21240
21241 </DD>
21242
21243 <DT>STARTTLS</DT>
21244 <DD>
21245 This is a unary parameter indicating communication with the server must
21246 take place over a TLS connection. If you use this parameter, Alpine will
21247 establish an insecure connection to the server, and later will attempts to
21248 use a secure encrypted connection. If the attempt to use TLS fails then
21249 this parameter will cause the connection to fail instead of falling back
21250 to an insecure connection.
21251 <P>
21252 Use this option when you are told to use STARTTLS. If you are told to use
21253 SSL or TLS on port 993, use the /ssl unary parameter instead, and not this
21254 parameter. Use this parameter when establishing a connection to a server
21255 on an insecure port (normally port 143 for IMAP) and then needing to
21256 establish a secure connection using STARTTLS.
21257
21258 <P><A href="h_security_considerations">Learn more</A> about security
21259 considerations when you use this option.
21260
21261 <P>
21262 <CENTER><SAMP>/starttls</SAMP></CENTER>
21263 <P>
21264
21265 </DD>
21266
21267 <DT>SSL</DT>
21268 <DD>
21269 This is a unary parameter indicating communication with the server should
21270 take place over a Secure Socket Layer connection.  The server must support
21271 this method, and be prepared to accept connections on the appropriate
21272 port (993 by default).
21273 Alpine must be linked with an SSL library for this option to be operational.
21274 Using this option will make Alpine try to connect to the server using the
21275 most secure encrypted SSL connection that both your version of Alpine and the
21276 server support.
21277
21278 <P>
21279 <CENTER><SAMP>/ssl</SAMP></CENTER>
21280 <P>
21281
21282 </DD>
21283
21284 <DT>TLS1</DT>
21285 <DD>
21286 This parameter indicates that the connection to the server will be made
21287 over the SSL port, but using the TLSv1 protocol, instead of the usual
21288 SSLv3 or SSLv2 protocols.
21289 Alpine must be linked with an SSL library for this option to be operational.
21290
21291 <P>
21292 <CENTER><SAMP>/tls1</SAMP></CENTER>
21293 <P>
21294 </DD>
21295
21296 <DT>TLS1_1</DT>
21297 <DD>
21298 This parameter indicates that the connection to the server will be made
21299 over the SSL port, but using the TLSv1.1 protocol.
21300 Alpine must be linked with an SSL library that supports this encryption
21301 protocol for this option to be operational.
21302
21303 <P>
21304 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
21305 <P>
21306 </DD>
21307
21308 <DT>TLS1_2</DT>
21309 <DD>
21310 This parameter indicates that the connection to the server will be made
21311 over the SSL port, but using the TLSv1.2 protocol.
21312 Alpine must be linked with an SSL library that supports this encryption
21313 protocol for this option to be operational.
21314
21315 <P>
21316 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
21317 <P>
21318 </DD>
21319
21320 <DT>TLS1_3</DT>
21321 <DD>
21322 This parameter indicates that the connection to the server will be made
21323 over the SSL port, but using the TLSv1.3 protocol.
21324 Alpine must be linked with an SSL library that supports this encryption
21325 protocol for this option to be operational.
21326
21327 <P>
21328 <CENTER><SAMP>/tls1_3</SAMP></CENTER>
21329 <P>
21330 </DD>
21331
21332 <DT>NoValidate-Cert</DT>
21333 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
21334 This is needed if the server uses self-signed certificates or if Alpine
21335 cannot validate the certificate for some other known reason. You should avoid
21336 using this option, and instead install the certificate of the server, so you
21337 are not a victim of a cracker-in-the-middle attack.
21338 <P>
21339 </DD>
21340
21341 <DT>Anonymous</DT>
21342 <DD>This is a unary parameter (that means it does not have a value)
21343 indicating that the connection be logged in as
21344 &quot;anonymous&quot; rather than a specific user.
21345 Not all servers offer anonymous
21346 access; those which do generally only offer read-only access to certain
21347 &quot;public&quot; folders.
21348
21349 <P>
21350 <CENTER><SAMP>/anonymous</SAMP></CENTER>
21351 <P>
21352
21353 </DD>
21354
21355 <DT>Secure</DT>
21356 <DD>This is a unary parameter indicating that the connection use the
21357 most secure authentication method mutually supported by Alpine and the
21358 server.
21359 Alpine is capable of authenticating connections to
21360 the server using several methods.
21361 By default, Alpine will attempt each
21362 method until either a connection is established or the
21363 list of methods is exhausted.
21364 This parameter causes Alpine to instead fail
21365 the connection if the first (generally most &quot;secure&quot;) method fails.
21366
21367 <P>
21368 <CENTER><SAMP>/secure</SAMP></CENTER>
21369 <P>
21370
21371 </DD>
21372
21373 <DT>Submit</DT>
21374 <DD>This is a unary parameter for use with the
21375 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
21376 It indicates that the connection should be made to the Submit server
21377 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
21378 (port 587) instead of the SMTP port (25).
21379 At the time this help was written the submit option was equivalent to
21380 specifying port 587. <A href="h_security_considerations">Learn more</A>
21381 about security considerations when you use this option.
21382
21383 <P>
21384 <CENTER><SAMP>/submit</SAMP></CENTER>
21385 <P>
21386 or
21387 <P>
21388 <CENTER><SAMP>host:587</SAMP></CENTER>
21389 <P>
21390
21391 </DD>
21392
21393 <DT>Debug</DT>
21394 <DD>This is a unary parameter indicating that the connection be established
21395 in a verbose mode.  Basically, it causes Alpine to log the communication with
21396 the server in Alpine's debug file.
21397 Normally, the pine -d command-line flag would be used instead.
21398 <P>
21399 </DD>
21400
21401 <DT>NoRsh</DT>
21402 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
21403 the UNIX remote shell program.
21404 Including &quot;NoRsh&quot; will cause connections to this server to skip
21405 the &quot;rsh&quot; attempt.
21406 This might be useful to avoid long timeouts caused by rsh firewalls, for
21407 example.
21408 <P>
21409 </DD>
21410
21411 <DT>Loser</DT>
21412 <DD>This option makes sense only for IMAP servers that do not perform
21413 a SEARCH command correctly. If your filtering rules
21414 fail to filter some messages, that should have been filtered, then this
21415 option will make Alpine download all data necessary data to perform that
21416 search. There is a performance penalty when using this option. Downloading
21417 the data to perform the search will take longer than requesting the IMAP
21418 server to perform the filtering, but the filtering will be done correctly.
21419 <P>
21420 </DD>
21421
21422
21423 <DT>Service</DT>
21424 <DD>This parameter requires an associated value.  The default value is
21425 &quot;IMAP&quot; which indicates communication with the server based
21426 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
21427 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
21428
21429 Other service values include:
21430  <DL>
21431  <DT>NNTP</DT>
21432  <DD>This value indicates communication with the server takes place via
21433 the Network News Transfer Protocol.  Use this to define a collection
21434 of newsgroups on a remote news server.  So
21435
21436 <P>
21437 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
21438 <P>
21439 or just
21440 <P>
21441 <CENTER><SAMP>/NNTP</SAMP></CENTER>
21442 <P>
21443
21444 is the way to specify NNTP access.
21445 <P>
21446  </DD>
21447
21448  <DT>POP3</DT>
21449  <DD>This value indicates communication with the server takes place via the
21450 Post Office Protocol 3 protocol.
21451
21452 <P>
21453 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
21454 <P>
21455 or just
21456 <P>
21457 <CENTER><SAMP>/POP3</SAMP></CENTER>
21458 <P>
21459
21460 Note that there are several important issues
21461 to consider when selecting this option:
21462 <OL>
21463  <LI> POP3 provides access to only your INBOX.  In other words,
21464 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
21465  <LI> Alpine's implementation of POP3 does not follow the traditional POP
21466 model and will leave your mail on the server. Refer to the
21467 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
21468  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
21469 </OL>
21470 </DD>
21471 </DL>
21472 </DL>
21473
21474 <P>
21475 Note that it is possible to include more than one parameter in a server
21476 specification by concatenating the parameters. For example:
21477
21478 <P>
21479 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
21480 <P>
21481
21482 <P>
21483 &lt;End of help on this topic&gt;
21484 </BODY>
21485 </HTML>
21486 ======= h_security_considerations =======
21487 <HTML>
21488 <HEAD>
21489 <TITLE>SSL, TLS, STARTTLS and More Security Considerations</TITLE>
21490 </HEAD>
21491 <BODY>
21492 <H1>SSL, TLS, STARTTLS and More Security Considerations</H1>
21493
21494 The purpose of this text is to educate users on how to best choose
21495 the type of security connection to a remote server using the SSL and TLS
21496 encryption protocols.
21497
21498 <P>
21499 In the past, and when Alpine originally started to support encrypted connections
21500 to remote servers, the /ssl modifier was needed, and it meant any of the SSLv2
21501 or SSLv3 protocols. Those encryption protocols are considered not fully secure
21502 anymore, and in fact, you might not be able to use them anymore.
21503
21504 <P> Today the /ssl modifier means to use the most secure encryption
21505 protocol between your version of Alpine and what the server supports. This
21506 might mean more modern protocols, such as TLS 1.0, TLS 1.1, etc. As of
21507 this writing, Alpine supports connection using TLS 1.3. These protocols
21508 are considered more secure today and they should be preferred over the old
21509 SSL protocols.
21510
21511 <P> A source of confusion for Alpine users might be the meaning of the
21512 modifier /tls with respect to the names of the encryption protocols, such
21513 as TLS 1.2. The meaning of /tls is to start an encrypted connection to a
21514 server after an insecure connection has been established, and we will
21515 discuss this later in this help text. The preferred way flag is to use
21516 /starttls, instead of /tls.
21517
21518 <P>The best way to start an encrypted connection to a server is to use the
21519 /ssl modifier. If your provider allows encrypted connections on port 993
21520 for IMAP, or port 995 for POP3, or in port 465 for SMTP, just define your
21521 server by adding the /ssl modifier and do not add the port to the server.
21522 Alpine knows that the secure connection will be done in the correct port,
21523 and will use the most secure encryption available between Alpine and the
21524 server. You only need to use the port number when it is different from the
21525 default port numbers for this type of connections, and those were given
21526 above.
21527
21528 <P>Most email service providers identify secure connections by saying
21529 &quot;SSL or TLS&quot;. In this case, use the /ssl modifier, and only use
21530 the port number in case it is different to the ones above.
21531
21532 <P>If your service provider says to use STARTTLS, then you need to use the
21533 /starttls modifier. If your service provider gives you the option to use SSL or
21534 TLS and to use STARTTLS choose the secure port and choose the /ssl
21535 modifier. This is because connections using the /starttls modifier can be
21536 attacked and your username and password can be stolen by a hacker. The next
21537 paragraph describes in short how to do this.
21538
21539 <P> When you use the /starttls modifier, Alpine connects insecurely to the
21540 remote server. Because the connection is insecure, it is possible that you
21541 connect to a different server, which connects you to the real server. This
21542 is called &quot;man-in-the-middle&quot; attack, and so your communication
21543 will pass through the hackers computer before it reaches the real target.
21544 An example of a possible man-in-the-middle is your internet service provider,
21545 or your employer in some instances.
21546 This means that the hacker can modify the replies from the correct server
21547 and give you the illusion of security before you are actually connected to
21548 the secure server. Therefore, you might disclose your username and
21549 password to the hacker before you establish a secure connection to the correct
21550 server.
21551
21552 <P> Therefore, if possible avoid using STARTTLS (for IMAP and POP) or SUBMIT
21553 for SMTP (in port 587), as these are subject to attack. If possible
21554 ask your provider for secure connections for SSL or TLS in the secure ports
21555 993 for IMAP, 995 for POP or 465 for SMTP.
21556
21557 <P> In the current state, even as of TLS 1.3, these protocols are considered
21558 secure but they do not protect your privacy. For example your internet
21559 service provider might track to which servers you are connecting securely.
21560 Encryption protocols are evolving to not only protect the security of your
21561 data, but also your privacy.
21562
21563 <P> Other types of errors can lead to insecure connections. An example is
21564 when the name of the server as provided by the user does not match the
21565 name of the server in the certificate.
21566 <A href="h_tls_validation_failure">Read more</A> about security errors
21567 of this type and learn how to protect yourself against this type of
21568 errors.
21569
21570 <P>
21571 &lt;End of help on this topic&gt;
21572 </BODY>
21573 </HTML>
21574 ======= h_composer_cntxt_server =======
21575 <HTML>
21576 <HEAD>
21577 <TITLE>Collection Server: Explained</TITLE>
21578 </HEAD>
21579 <BODY>
21580 <H1>Collection Edit Help -- Server Field</H1>
21581
21582 This collection's &quot;Server:&quot; definition indicates the
21583 hostname of the server providing access to the folders in this
21584 collection.
21585 The syntax of this server name is the same as for other server names used
21586 in remote folder names in
21587 Alpine and is described
21588 <A HREF="h_folder_server_syntax">here</A>.
21589
21590 <P>
21591 &lt;End of help on this topic&gt;
21592 </BODY>
21593 </HTML>
21594 ======= h_composer_cntxt_path =======
21595 <HTML>
21596 <HEAD>
21597 <TITLE>Collection Path: Explained</TITLE>
21598 </HEAD>
21599 <BODY>
21600 <H1>Collection Edit Help -- Path Field</H1>
21601
21602 The collection's &quot;Path:&quot; definition indicates the location
21603 of the folders in this collection.  If the path or any of its components
21604 do not exist, Alpine will prompt you for their creation when exiting the
21605 Add/Change screen.
21606
21607 <P>
21608 By default the path is interpreted as defining a section of your personal
21609 folder area.  This area and how you specify it are defined by the
21610 server, if one is specified in the collection, or, typically, the home
21611 directory if no server is defined.
21612
21613 <P>
21614 To define a collection outside the default &quot;area&quot;, prefix
21615 the path with the &quot;namespace&quot; to use when interpreting the
21616 given path.  If a namespace is specified, the Path begins with the
21617 sharp, &quot;#&quot;, character followed by the name of the namespace
21618 and then the namespace's path-element-delimiter.  Aside from the
21619 path's format, namespaces can also imply access rights, content
21620 policy, audience, location, and, occasionally, access methods.
21621
21622 <P>
21623 Each server exports its own set (possibly of size one) of
21624 namespaces.  Hence, it's likely communication with your server's
21625 administrator will be required for specific configurations.  Some of
21626 the more common namespaces, however, include:
21627
21628 <DL>
21629 <DT>#news.</DT>
21630 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
21631 names are hierarchically defined with each level delimited by a period.
21632 </DD>
21633 <DT>#public/</DT>
21634 <DD>This specifies a folder area that the server may export to the general
21635 public.
21636 </DD>
21637 <DT>#shared/</DT>
21638 <DD>This specifies a folder area that the folder may export to groups
21639 of users.
21640 </DD>
21641 <DT>#ftp/</DT>
21642 <DD>This specifies a folder area that is the same as that it may have
21643 exported via the &quot;File Transfer Protocol&quot;.
21644 </DD>
21645 <DT>#mh/</DT>
21646 <DD>This specifies the personal folder area associated with folders
21647 and directories that were created using the MH message handling system.
21648 </DD>
21649 </DL>
21650 <P>
21651
21652 In addition, the server may support access to other user's folders,
21653 provided you have suitable permissions.  Common methods use a prefix
21654 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
21655 indicate the root of the other user's folder area.
21656
21657 <P>
21658 No, nothing's simple.
21659
21660 <P>
21661 &lt;End of help on this topic&gt;
21662 </BODY>
21663 </HTML>
21664 ======= h_composer_cntxt_view =======
21665 <HTML>
21666 <HEAD>
21667 <TITLE>Collection View: Explained</TITLE>
21668 </HEAD>
21669 <BODY>
21670 <H1>Collection Edit Help -- View Field</H1>
21671
21672 The collection's &quot;View:&quot; definition provides a way to limit
21673 the displayed list of folders within a collection.  By default, only
21674 folders that contain the specified characters anywhere in their name
21675 are shown in the collection's folder list.
21676
21677 <P>
21678 Additionally, you can use a wildcard character to better control
21679 the list of folders selected for display.  The wildcard specifier is
21680 the star, &quot;*&quot;, character.
21681
21682 <P>
21683 So, for example, to define a collection of all folders ending with
21684 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
21685 quote characters!).  Or, similarly, to define a collection of folders
21686 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
21687 specify a view of &quot;a*z&quot;.
21688
21689 <P>
21690 &lt;End of help on this topic&gt;
21691 </BODY>
21692 </HTML>
21693 ======= h_composer_abook_add_server =======
21694 <HTML>
21695 <HEAD>
21696 <TITLE>Addressbook Server Name Field Explained</TITLE>
21697 </HEAD>
21698 <BODY>
21699 This field should be left blank if the address book is stored in a regular
21700 file on this system.  If it is a remote address book stored on an IMAP
21701 server then this is the name of that IMAP server.
21702 <P>
21703 Look <A HREF="h_edit_nav_cmds">here</A>
21704 to see the available Editing and Navigation commands.
21705 <P>
21706 &lt;End of help on this topic&gt;
21707 </BODY>
21708 </HTML>
21709 ======= h_composer_abook_add_folder =======
21710 <HTML>
21711 <HEAD>
21712 <TITLE>Addressbook Folder Name Field Explained</TITLE>
21713 </HEAD>
21714 <BODY>
21715 For a remote address book (one for which the Server Name is filled in)
21716 this is the name of a folder on the remote server. The address book data
21717 will be stored in this folder. This folder should be used only for
21718 storing this single address book, not for other address books or for
21719 other messages.
21720 <P>
21721 For a local address book (one for which the Server Name is not filled in)
21722 this is the name of a file in which the address book will be stored.
21723 The file is in the same directory as the Alpine configuration file if the
21724 configuration file is local.
21725 If the configuration file is remote, then this will be in the home directory
21726 for Unix Alpine and in the directory specified by the
21727 &quot;-aux local_directory&quot; command line argument.
21728 <P>
21729 Look <A HREF="h_edit_nav_cmds">here</A>
21730 to see the available Editing and Navigation commands.
21731 <P>
21732 &lt;End of help on this topic&gt;
21733 </BODY>
21734 </HTML>
21735 ======= h_composer_abook_add_nick =======
21736 <HTML>
21737 <HEAD>
21738 <TITLE>Addressbook NickName Field Explained</TITLE>
21739 </HEAD>
21740 <BODY>
21741 This is just an optional nickname for this address book. If present, it
21742 is used in some of the displays and error messages in the address book
21743 maintenance screens. It is for your convenience only and serves no
21744 other purpose.
21745 <P>
21746 Look <A HREF="h_edit_nav_cmds">here</A>
21747 to see the available Editing and Navigation commands.
21748 <P>
21749 &lt;End of help on this topic&gt;
21750 </BODY>
21751 </HTML>
21752 ======= h_composer_qserv_cn =======
21753 <HTML>
21754 <HEAD>
21755 <TITLE>Directory Query Form Explained</TITLE>
21756 </HEAD>
21757 <BODY>
21758
21759 Fill in as many of these fields as you wish to narrow down your
21760 search. All the fields you fill in must match in order for an entry
21761 to be returned. You may use the wildcard character &quot;*&quot; in
21762 any of the fields, it matches any zero or more characters at that
21763 point in the string. There are no implicit wildcards, so the match is
21764 exact unless you include wildcards.
21765 <P>
21766
21767 Note that if an attribute isn't present at all, then the match will fail.
21768 For example, if a server doesn't support the Locality attribute, then no
21769 matter what you put in the Locality field (other than leaving it empty)
21770 the search will fail.
21771 <P>
21772
21773 This field, the Common Name field, is typically a person's full name.
21774 <P>
21775
21776 <H1>EDITING and NAVIGATION COMMANDS</H1>
21777 <!--chtml if pinemode="function_key"-->
21778 <PRE>
21779 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
21780 ^B (Left Arrow)    Back character       | ^D       Delete current character
21781 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
21782 ^P (Up Arrow)      Previous line        |
21783 ^N (Down Arrow)    Next line            | F9       Cut marked text or
21784 ^A                 Beginning of line    |            delete current line
21785 ^E                 End of line          | F10      Undelete line(s)
21786 F7                 Previous page        |
21787 F8                 Next page            |-------------------------------------
21788 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
21789 ----------------------------------------|
21790 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
21791 F2   Cancel      |   F1    Get help     |
21792 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
21793 </PRE>
21794 <!--chtml else-->
21795 <PRE>
21796 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
21797 ^B (Left Arrow)    Back character       | ^D       Delete current character
21798 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
21799 ^P (Up Arrow)      Previous line        |
21800 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
21801 ^A                 Beginning of line    |            delete current line
21802 ^E                 End of line          | ^U       Undelete line(s)
21803 ^Y                 Previous page        |
21804 ^V                 Next page            |-------------------------------------
21805 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
21806 ----------------------------------------|
21807 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
21808 ^C   Cancel      |   ^G    Get help     |
21809 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
21810 </PRE>
21811 <!--chtml endif-->
21812 <P><UL>
21813 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21814 </UL><P>
21815 &lt;End of help on this topic&gt;
21816 </BODY>
21817 </HTML>
21818 ======= h_composer_qserv_sn =======
21819
21820 The Surname is usually the family name of a person.
21821
21822 <End of help on this topic>
21823 ======= h_composer_qserv_gn =======
21824
21825 This is the part of a person's name that isn't the surname or initials.
21826
21827 <End of help on this topic>
21828 ======= h_composer_qserv_mail =======
21829
21830 This is the email address of a person.
21831
21832 <End of help on this topic>
21833 ======= h_composer_qserv_org =======
21834
21835 This is the organization a person belongs to.
21836
21837 <End of help on this topic>
21838 ======= h_composer_qserv_unit =======
21839
21840 This is the organizational unit a person belongs to.
21841
21842 <End of help on this topic>
21843 ======= h_composer_qserv_country =======
21844
21845 This is the country a person belongs to.
21846
21847 <End of help on this topic>
21848 ======= h_composer_qserv_state =======
21849
21850 This is the state a person belongs to.
21851
21852 <End of help on this topic>
21853 ======= h_composer_qserv_locality =======
21854
21855 This is the locality a person belongs to.
21856
21857 <End of help on this topic>
21858 ======= h_composer_qserv_custom =======
21859
21860 This one is for advanced users only! If you put something in this field,
21861 then the rest of the fields are ignored.
21862
21863 This field may be set to the string representation of an LDAP search
21864 filter (see RFC1960). Here are some examples:
21865
21866 To search for an entry with a surname equal to "clinton" you could set
21867 the custom filter to:
21868
21869      (sn=clinton)
21870
21871 This is equivalent to putting "clinton" in the SurName field.
21872 To search for an entry that has a surname that begins with "clint" and
21873 has a givenname equal to "william" you could use:
21874
21875      (&(sn=clint*)(givenname=william))
21876
21877 This is equivalent to setting the SurName field to "clint*" and the
21878 GivenName field to "william".
21879 To search for an entry where either the common name OR the email address
21880 contains "abcde" you could use:
21881
21882      (|(cn=*abcde*)(mail=*abcde*))
21883
21884 That isn't equivalent to anything you can do by setting the other fields
21885 because of the OR.
21886
21887 <End of help on this topic>
21888 ======= h_composer_qserv_qq =======
21889
21890 This one is a little different from the rest of the categories.  It causes
21891 a search to be formed from the configured search filter that you filled
21892 in when you added the directory server to your configuration. It can also
21893 be combined with the other fields if you'd like.
21894
21895 <End of help on this topic>
21896 ======= h_address_format =======
21897 <HTML>
21898 <HEAD>
21899 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
21900 </HEAD>
21901 <BODY>
21902 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
21903
21904 A valid email address on the Internet has a username, an &quot;@&quot; sign,
21905 and then a domain, with no spaces.
21906 For example, jsmith@art.example.com might be the email address
21907 of a person
21908 with the username &quot;jsmith&quot; who has an account in the domain
21909 &quot;art.example.com&quot;.  The number of dot-separated segments on the
21910 right of the &quot;@&quot; sign can vary - a shorter example would be
21911 isabelle@elsewhere.edu (the shortest possible form: here, only the
21912 organization's domain is specified after the &quot;@&quot; sign); a longer
21913 example would be
21914  jsingh@shakti.edutech.example.com
21915 (here, the name of the host &quot;shakti&quot; in the domain
21916 edutech.example.com is also specified).
21917 <P>
21918 If you do not know the exact email address of someone you want to write
21919 to, ask them what it is using other means of communication than email; or
21920 use the tools for
21921 finding people's addresses that are available on the Internet.
21922 <P>
21923 If you are sending to someone on the same system as you are, you can leave
21924 the &quot;@&quot; sign and all the information to its right off of the
21925 address, and Alpine will fill it in automatically,
21926 unless the feature
21927 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
21928 <P>
21929
21930 When an email address you send a message to is not reachable -- either because
21931 it is simply an incorrect address, or because email can temporarily not be
21932 delivered to it due to a technical problem on the way to or at the recipient's
21933 end -- you will almost always get an error notification email message back.
21934 <P>
21935 If you encounter problems with, or have questions about, email delivery or
21936 email address syntax, contact your local network computing consultants.
21937 <P><UL>
21938 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21939 </UL>
21940 <P>
21941 &lt;End of help on this topic&gt;
21942 </BODY>
21943 </HTML>
21944 ======= h_flag_user_flag =======
21945 <HTML>
21946 <HEAD>
21947 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
21948 </HEAD>
21949 <BODY>
21950 <H1>STATUS FLAG: User Defined Keyword</h1>
21951
21952 This is a keyword that is defined for this folder.
21953 It was most likely defined by the owner of the folder.
21954 Alpine will not set or clear this flag on its own.
21955
21956 <P><UL>
21957 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21958 </UL><P>
21959 &lt;End of help on this topic&gt;
21960 </BODY>
21961 </HTML>
21962 ======= h_flag_important =======
21963 <html>
21964 <title>STATUS FLAG: Important</title>
21965 <body>
21966 <h1>STATUS FLAG: Important</h1>
21967
21968
21969 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
21970 MESSAGE&nbsp;INDEX
21971 screen, can only be set by the user, and is intended to be used in
21972 whatever fashion makes sense to you.  You are the only one that can set or
21973 clear it.
21974
21975 <P>
21976 &lt;End of help on this topic&gt;
21977 </BODY>
21978 </HTML>
21979 ======= h_flag_new =======
21980 <html>
21981 <title>STATUS FLAG: New</title>
21982 <body>
21983 <h1>STATUS FLAG: New</h1>
21984
21985
21986 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
21987 MESSAGE&nbsp;INDEX screen,
21988 is automatically set when messages are delivered to your Inbox (or other
21989 folder specified outside of Alpine).  Likewise, it is cleared automatically
21990 the first time you read the message it is associated with.
21991
21992 <P>
21993 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
21994 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
21995 you'd like to be reminded of it next time you read mail.  This can be done
21996 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
21997
21998
21999 <P>
22000 &lt;End of help on this topic&gt;
22001 </BODY>
22002 </HTML>
22003 ======= h_flag_answered =======
22004 <html>
22005 <title>STATUS FLAG: Answered</title>
22006 <body>
22007 <h1>STATUS FLAG: Answered</h1>
22008
22009 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
22010 MESSAGE&nbsp;INDEX
22011 screen, is automatically set when you reply to a message.  This flag is not
22012 automatically cleared.
22013
22014 <P>
22015 &lt;End of help on this topic&gt;
22016 </BODY>
22017 </HTML>
22018 ======= h_flag_forwarded =======
22019 <html>
22020 <title>STATUS FLAG: Forwarded</title>
22021 <body>
22022 <h1>STATUS FLAG: Forwarded</h1>
22023
22024 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
22025 MESSAGE&nbsp;INDEX
22026 screen, is automatically set when you forward a message.  This flag is not
22027 automatically cleared.
22028
22029 <P>
22030 &lt;End of help on this topic&gt;
22031 </BODY>
22032 </HTML>
22033 ======= h_flag_deleted =======
22034 <html>
22035 <title>STATUS FLAG: Deleted</title>
22036 <body>
22037 <h1>STATUS FLAG: Deleted</h1>
22038
22039 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
22040 MESSAGE&nbsp;INDEX
22041 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
22042 It is cleared
22043 when you use the &quot;U&nbsp;Undelete&quot; command.
22044
22045 <P>
22046 Messages marked with this flag will be permanently removed from
22047 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
22048 command, or
22049 when you indicate acceptance of their removal upon leaving the folder.
22050
22051 <P>
22052 Note, there can be other actions implicit in the
22053 &quot;D&nbsp;Delete&quot; command,
22054 such as advancing to the next message, that may be momentarily undesirable.
22055 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
22056 flag <A HREF="h_common_flag">explicitly</A>.
22057
22058 <P>
22059 &lt;End of help on this topic&gt;
22060 </BODY>
22061 </HTML>
22062 ====== h_config_incoming_timeo ======
22063 <HTML>
22064 <HEAD>
22065 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
22066 </HEAD>
22067 <BODY>
22068 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
22069
22070 This option has no effect unless the feature
22071 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22072 is set, which in turn has no effect unless
22073 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22074 is set.
22075 <P>
22076 Sets the time in seconds that Alpine will
22077 attempt to open a network connection used for monitoring for Unseen
22078 messages in Incoming Folders. The default is 5.
22079 If a connection has not completed within this many seconds Alpine will
22080 give up and consider it a failed connection.
22081 <P>
22082 <UL>
22083 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22084 </UL><P>
22085 &lt;End of help on this topic&gt;
22086 </BODY>
22087 </HTML>
22088 ====== h_config_incoming_interv ======
22089 <HTML>
22090 <HEAD>
22091 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
22092 </HEAD>
22093 <BODY>
22094 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
22095
22096 This option has no effect unless the feature
22097 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22098 is set, which in turn has no effect unless
22099 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22100 is set.
22101 <P>
22102 This option specifies, in seconds, how often Alpine will check
22103 for new mail and state changes in Incoming Folders when Incoming Folders
22104 Checking is turned on.
22105 The default is 3 minutes (180).
22106 This value applies only to folders that are local to the system that
22107 Alpine is running on or that are accessed using the IMAP protocol.
22108 The similar option
22109 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
22110 applies to all other monitored folders.
22111 <P>
22112 <UL>
22113 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22114 </UL><P>
22115 &lt;End of help on this topic&gt;
22116 </BODY>
22117 </HTML>
22118 ====== h_config_incoming_second_interv ======
22119 <HTML>
22120 <HEAD>
22121 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
22122 </HEAD>
22123 <BODY>
22124 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
22125
22126 This option has no effect unless the feature
22127 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22128 is set, which in turn has no effect unless
22129 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22130 is set.
22131 <P>
22132 This option together with the option
22133 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
22134 specifies, in seconds, how often Alpine will check
22135 for new mail and state changes in Incoming Folders when Incoming Folders
22136 Checking is turned on.
22137 The default for this option is 3 minutes (180).
22138 For folders that are local to this system or
22139 that are accessed using the IMAP protocol
22140 the value of the option
22141 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
22142 is used.
22143 For all other monitored folders, the value of this option is used.
22144 <P>
22145 The reason there are two separate options is because it is usually
22146 less expensive to check local and IMAP folders than it is to check
22147 other types, like POP or NNTP folders.
22148 You may want to set this secondary value to a higher number than
22149 the primary check interval.
22150 <P>
22151 <UL>
22152 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22153 </UL><P>
22154 &lt;End of help on this topic&gt;
22155 </BODY>
22156 </HTML>
22157 ====== h_config_incoming_list ======
22158 <HTML>
22159 <HEAD>
22160 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
22161 </HEAD>
22162 <BODY>
22163 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
22164
22165 This option has no effect unless the feature
22166 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
22167 is set, which in turn has no effect unless
22168 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
22169 is set.
22170 <P>
22171 When monitoring the Incoming Message Folders for Unseen messages Alpine will
22172 normally monitor all Incoming Folders.
22173 You may use this option to restrict the list of monitored folders to a
22174 subset of all Incoming Folders.
22175 <P>
22176 <UL>
22177 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22178 </UL><P>
22179 &lt;End of help on this topic&gt;
22180 </BODY>
22181 </HTML>
22182 ====== h_config_pers_name ======
22183 <HTML>
22184 <HEAD>
22185 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
22186 </HEAD>
22187 <BODY>
22188 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
22189
22190 This value is used to determine the full name part of the "From" address
22191 on messages you send.
22192 <!--chtml if pinemode="os_windows"-->
22193  PC-Alpine requires that this be set in order to properly construct the "From" address.
22194 <!--chtml else-->
22195  If unset, Unix Alpine will obtain your full name from
22196  the system password file. PC-Alpine, on the other hand, requires that this be set.
22197 <!--chtml endif-->
22198 <P>
22199 If you want to change the value of what gets included in the From header
22200 in messages you send (other than just the Personal Name)
22201 look <A HREF="h_config_change_your_from">here</A> for a description.
22202 <P><UL>
22203 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22204 </UL><P>
22205 &lt;End of help on this topic&gt;
22206 </BODY>
22207 </HTML>
22208 ====== h_config_pruned_folders ======
22209 <html>
22210 <header>
22211 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
22212 </header>
22213 <body>
22214 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
22215
22216 This variable allows you to define a list of one or more folders that
22217 Alpine will offer to prune for you in the same way it automatically offers
22218 to prune your "sent-mail" folder each month.
22219 Each folder in this list must be a folder in your default folder collection
22220 (the first folder collection if you have more than one), and it is just
22221 the relative name of the folder in the collection, not the fully-qualified name.
22222 It is similar to sent-mail.
22223 Instead of something like
22224 <P>
22225 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
22226 <P>
22227 the correct value to use would be
22228 <P>
22229 <CENTER><SAMP>folder</SAMP></CENTER>
22230 <P>
22231 There is an assumption here that your first collection is the folders in
22232 <P>
22233 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
22234 <P>
22235
22236 Once a month, for each folder listed, Alpine will offer to move
22237 the contents of the folder to a new folder of the same name but with
22238 the previous month's date appended.  Alpine will then look for any such
22239 date-appended folder names created for a previous month, and offer each
22240 one it finds for deletion.
22241 <P>
22242
22243 If you decline the first offer, no mail is moved and no new folder is
22244 created.
22245 <P>
22246
22247 The new folders will be created
22248 in your default folder collection.
22249 <P>
22250
22251 <UL>
22252 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22253 </UL><P>
22254 &lt;End of help on this topic&gt;
22255 </body>
22256 </html>
22257 ====== h_config_upload_cmd ======
22258 <HTML>
22259 <HEAD>
22260 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
22261 </HEAD>
22262 <BODY>
22263 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
22264
22265 This option affects the behavior of the Composer's &quot;Read File&quot;
22266 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
22267 commands.  It specifies
22268 a Unix program name, and any necessary command line arguments, that Alpine can
22269 use to transfer files from your personal computer into messages that you are
22270 composing.<P>
22271
22272 <B>Note:</B> this facility is intended for use with serial line transfer
22273 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22274 to work with TCP/IP file transfer programs such as ftp.<P>
22275
22276 If a program is specified, the commands listed above are modified to offer a
22277 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
22278 specified here must match the transfer program or protocol available on the
22279 personal computer.<P>
22280
22281 Alpine expects to exchange uploaded data via a file on your Unix system.  When
22282 the specified upload program finishes, Alpine expects the uploaded data to be
22283 contained in this file.<P>
22284
22285 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
22286 generates a
22287 temporary file name that it will pass to the specified Unix program.  Alpine
22288 will read the resulting uploaded text from this file and then delete it when
22289 the upload command is finished.<P>
22290
22291 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
22292 prompt
22293 you for the name of the file that is to contain the uploaded information that
22294 it is to attach.  Alpine will attach this file to the composition, but will
22295 <B>not</B> delete this file after the upload command is finished.<P>
22296
22297 The special token &quot;_FILE_&quot; may be included among the Unix program's
22298 command
22299 line arguments.  Alpine will replace this symbol with the name of the file
22300 being used to exchange the uploaded information.  This token allows you to
22301 position the file name where it is required in the Unix program's command
22302 line arguments.<P>
22303
22304 If the &quot;_FILE_&quot; token is not present in the specified command, the
22305 temporary file's name is automatically appended to the specified Unix
22306 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22307 <B>last</B> command line argument.
22308 <P><UL>
22309 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22310 </UL><P>
22311 &lt;End of help on this topic&gt;
22312 </BODY>
22313 </HTML>
22314 ====== h_config_upload_prefix ======
22315 <HTML>
22316 <HEAD>
22317 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
22318 </HEAD>
22319 <BODY>
22320 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
22321
22322 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
22323 It defines text to be written to the terminal emulator (via standard output)
22324 immediately prior to starting upload command.  This is useful for
22325 integrated serial line file transfer agents that permit command passing
22326 (e.g., Kermit's APC method).<P>
22327
22328 The special token &quot;_FILE_&quot; may be included in the string specification.
22329 That symbol will be replaced with the (Alpine-created) name of the temporary
22330 file in which Alpine will expect to find the uploaded file.
22331 <P><UL>
22332 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22333 </UL><P>
22334 &lt;End of help on this topic&gt;
22335 </BODY>
22336 </HTML>
22337 ====== h_config_download_cmd ======
22338 <HTML>
22339 <HEAD>
22340 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
22341 </HEAD>
22342 <BODY>
22343 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
22344
22345 This option affects the behavior of the Export command.  It specifies a Unix
22346 program name, and any necessary command line arguments, that Alpine can use to
22347 transfer the exported message to your personal computer's disk.<P>
22348 Note: this facility is intended for use with serial line transfer
22349 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22350 to work with TCP/IP file transfer programs such as ftp.<P>
22351 If a program is specified, the Export command is modified to offer a
22352 subcommand (^V) to activate the transfer (in lieu of saving it to
22353  the machine where Alpine is running).  Obviously, the Unix program
22354 specified here must match the transfer program or protocol available on the
22355 personal computer.<P>
22356
22357 When this subcommand is selected and before Alpine invokes the specified Unix
22358 program, Alpine will create a temporary file containing the text of the
22359 exported message.  Alpine uses this file to pass the exported message text to
22360 the specified Unix program.<P>
22361
22362 The special token &quot;_FILE_&quot; may be included among the Unix program's command
22363 line arguments.  Alpine will replace this symbol with the temporary file's name
22364 before executing the Unix program.  This token allows you to position the
22365 file name where it is required in the Unix program's command line arguments.
22366 <P>
22367 If the &quot;_FILE_&quot; token is not present in the specified command, the
22368 temporary file's name is automatically appended to the specified Unix
22369 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22370 <B>last</B> command line argument.
22371 <P><UL>
22372 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22373 </UL><P>
22374 &lt;End of help on this topic&gt;
22375 </BODY>
22376 </HTML>
22377 ====== h_config_download_prefix ======
22378 <HTML>
22379 <HEAD>
22380 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
22381 </HEAD>
22382 <BODY>
22383 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
22384
22385 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
22386 It defines text to be written to the terminal emulator (via standard output)
22387 immediately prior to starting the download command.  This is useful for
22388 integrated serial line file transfer agents that permit command passing
22389 (e.g., Kermit's APC method).
22390 <P>
22391 The special token &quot;_FILE_&quot; may be included in the string
22392 specification.
22393 That symbol will be replaced with the (Alpine-created) name of the temporary
22394 file into which Alpine will place the message to be downloaded.
22395 <P><UL>
22396 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22397 </UL><P>
22398 &lt;End of help on this topic&gt;
22399 </BODY>
22400 </HTML>
22401 ====== h_config_mailcap_path ======
22402 <HTML>
22403 <HEAD>
22404 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
22405 </HEAD>
22406 <BODY>
22407 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
22408 This variable is used to replace Alpine's default mailcap file search path.
22409 It takes one or more file names (full paths must be specified) in which to
22410 look for mail capability data.  The default search path can be found in this
22411 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
22412 If there is more than one file name listed, list members should be delimited
22413 by
22414 <!--chtml if pinemode="os_windows"-->
22415 a semi-colon (;) under Windows; for example:<PRE>
22416         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
22417 </PRE>
22418 <!--chtml else-->
22419 a colon (:) under UNIX; for example:<PRE>
22420         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
22421 </PRE>
22422 <!--chtml endif-->
22423 <P><UL>
22424 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22425 </UL>
22426 <P>
22427 &lt;End of help on this topic&gt;
22428 </BODY>
22429 </HTML>
22430 ====== h_config_mimetype_path ======
22431 <HTML>
22432 <HEAD>
22433 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
22434 </HEAD>
22435 <BODY>
22436 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
22437
22438 This variable is used to replace Alpine's default mime.types file search path.
22439 It takes one or more file names (full paths must be specified) in which to
22440 look for file-name-extension to MIME type mapping data.  The default search
22441 path can be found in this
22442 <A HREF="h_news_config">Alpine Configuration</A> help.
22443
22444 <P>
22445
22446 If there is more than one file name listed, list members should be delimited
22447 by a colon (:) under UNIX and a semi-colon (;) under Windows.
22448 <P>
22449 &lt;End of help on this topic&gt;
22450 </BODY></HTML>
22451 ====== h_config_system_certs_path ======
22452 <HTML>
22453 <HEAD>
22454 <TITLE>OPTION: <!--#echo var="VAR_system-certs-path"--></TITLE>
22455 </HEAD>
22456 <BODY>
22457 <H1>OPTION: <!--#echo var="VAR_system-certs-path"--></H1>
22458
22459 When Alpine is built to support secure connections to remote servers, a directory
22460 must be reserved in the system to store certificates that will be used to validate
22461 remote servers. This is normally configured at the time that Alpine is built, but
22462 there might be circumstances under which a user might want to use a different
22463 directory. For example, the directory might not be accessible, or has not been
22464 updated and contains old certificates that have expired.
22465
22466 <P>
22467 This variable can be used to list
22468 the directory where such certificates can be found. Alpine will use the first
22469 directory in this list that exists in your system and can be accessed. This
22470 allows for users to be able to use the same pinerc file in different systems.
22471
22472 <P>
22473 Example of values for this option might be:
22474
22475 <PRE>
22476 System CACerts Dir = /etc/ssl/certs
22477                      /usr/local/ssl/certs
22478                      C:\\libressl\\ssl\\certs
22479 <PRE>
22480
22481 <P>
22482 In unix systems, the default location of the certificates for openssl can
22483 be obtained by first executing the command
22484
22485 <PRE>openssl version -d</PRE>
22486
22487 and adding &quot;/certs&quot; to that value. In Windows the default location
22488 for the certificates is C:\\libressl\\ssl\\certs. This value was set by
22489 LibreSSL developers, and this option can be used to override this default.
22490
22491 <P>
22492 &lt;End of help on this topic&gt;
22493 </BODY></HTML>
22494 ====== h_config_system_certs_file ======
22495 <HTML>
22496 <HEAD>
22497 <TITLE>OPTION: <!--#echo var="VAR_system-certs-file"--></TITLE>
22498 </HEAD>
22499 <BODY>
22500 <H1>OPTION: <!--#echo var="VAR_system-certs-file"--></H1>
22501
22502 This option sets the location of the container file that holds
22503 certificate authority (CA) certificates.
22504 Alpine will use the first
22505 container in this list that exists in your system and can be accessed. This
22506 allows for users to be able to use the same pinerc file in different systems.
22507
22508 <P>
22509 Example of values for this option might be:
22510
22511 <PRE>
22512 System Certs Path = /etc/ssl/certs/cert.pem
22513                     /usr/local/ssl/ca-root-nss.crt
22514                     C:\\libressl\\ssl\\certs\\cert.pem
22515 <PRE>
22516
22517 <P>
22518 In unix systems, the default location of the certificates for openssl can
22519 be obtained by first executing the command
22520
22521 <PRE>openssl version -d</PRE>
22522
22523 and adding &quot;/certs&quot; to that value. In Windows the default location
22524 for the certificates is C:\\libressl\\ssl\\certs\\cert.pem. This value was set
22525 by LibreSSL developers, and this option can be used to override this default.
22526
22527 <P>
22528 &lt;End of help on this topic&gt;
22529 </BODY></HTML>
22530 ====== h_config_set_att_ansi ======
22531 <HTML><HEAD>
22532 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
22533 </HEAD>
22534 <BODY>
22535 <H1>OPTION: Set printer to attached ansi printer</H1>
22536
22537 Type "S" to set your printer to "attached-to-ansi".<BR>
22538 It is OK to include "attached-to-ansi" in your personal list below.
22539 <P>
22540 &lt;End of help on this topic&gt;
22541 </BODY></HTML>
22542 ====== h_config_set_att_ansi2 ======
22543 <HTML><HEAD>
22544 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
22545 </HEAD>
22546 <BODY>
22547 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
22548
22549 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
22550 It is OK to include "attached-to-ansi-no-formfeed" in your personal
22551 list below.
22552
22553 <P>
22554
22555 This is the same as the "attached-to-ansi" option except that a
22556 formfeed character will not be appended to the end of the print job.
22557 If your printer already ejects the paper by itself at the end of the
22558 job, you may prefer the "no-formfeed" form of this printer so that you
22559 don't get an extra blank page between print jobs.
22560 <P>
22561
22562 &lt;End of help on this topic&gt;
22563 </BODY></HTML>
22564 ====== h_config_set_att_wyse ======
22565 <HTML><HEAD>
22566 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
22567 </HEAD>
22568 <BODY>
22569 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
22570
22571 Type "S" to set your printer to "attached-to-wyse".<BR>
22572 It is OK to include "attached-to-wyse" in your personal list below.
22573 <P>
22574 This is very similar to "attached-to-ansi".
22575 The only difference is in the control characters sent to turn the printer
22576 on and off.
22577 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
22578 to turn on the printer and ESC LEFT_BRACKET 4 i
22579 to turn it off.
22580 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
22581 &lt;End of help on this topic&gt;
22582 </BODY></HTML>
22583 ====== h_config_set_att_wyse2 ======
22584 <HTML><HEAD>
22585 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
22586 </HEAD>
22587 <BODY>
22588 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
22589
22590 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
22591 It is OK to include "attached-to-wyse-no-formfeed" in your personal
22592 list below.
22593
22594 <P>
22595
22596 This is the same as the "attached-to-wyse" option except that a
22597 formfeed character will not be appended to the end of the print job.
22598 If your printer already ejects the paper by itself at the end of the
22599 job, you may prefer the "no-formfeed" form of this printer so that you
22600 don't get an extra blank page between print jobs.
22601 <P>
22602
22603 &lt;End of help on this topic&gt;
22604 </BODY></HTML>
22605 ====== h_config_set_stand_print ======
22606 <HTML>
22607 <HEAD>
22608 <TITLE>OPTION: Set default printer</TITLE>
22609 </HEAD>
22610 <H1>OPTION: Set default printer</H1>
22611 <BODY>
22612 Move to the printer you want and type "S" to set it to be your
22613 default printer.  This list is not modifiable by you and has been
22614 set up by the system administrators.  If there is more than one printer
22615 listed in the Command List, you will be able to cycle through that
22616 whole list at the time you print, starting with your default.
22617 It is OK to include entries from this Standard list in your personal
22618 list below.
22619 <P>
22620 &lt;End of help on this topic&gt;
22621 </BODY>
22622 </HTML>
22623 ====== h_config_set_custom_print ======
22624 <HTML>
22625 <HEAD>
22626 <TITLE>OPTION: Set default printer</TITLE>
22627 </HEAD>
22628 <H1>OPTION: Set default printer</H1>
22629 <BODY>
22630 You may add as many print commands as you want to your personal list.
22631 Specify one of them as your default printer by moving to the printer
22632 you want and typing "S".  If there is more than one printer listed
22633 in the Command List, you will be able to cycle through that list at
22634 the time you print, starting with your default.  It is OK to include
22635 entries from the Standard list above or to include the command
22636 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
22637 "attached-to-wyse-no-formfeed" as one of the entries here.
22638 <P>
22639 &lt;End of help on this topic&gt;
22640 </BODY>
22641 </HTML>
22642 ====== h_config_user_id =====
22643 <HTML>
22644 <HEAD>
22645 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
22646 </HEAD>
22647 <BODY>
22648 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
22649
22650 This value is used as part of the "From" address on messages you send.
22651 It is also the default login name for remote IMAP server access.  Set this
22652 to the username part you want to appear on outgoing email.
22653 <P>
22654 If you want to change the value of what gets included in the From header
22655 in messages you send (other than just the User ID)
22656 look <A HREF="h_config_change_your_from">here</A> for a description.
22657
22658 <P><UL>
22659 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22660 </UL><P>
22661 &lt;End of help on this topic&gt;
22662 </BODY>
22663 </HTML>
22664 ====== h_config_user_dom =====
22665 <HTML>
22666 <HEAD>
22667 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
22668 </HEAD>
22669 <BODY>
22670 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
22671
22672 This value specifies the domain part (right-hand side) of your return
22673 address on outgoing email and is also used as the default domain for email
22674 composed to a local user.
22675 <!--chtml if pinemode="os_windows"-->
22676  This value is required for PC-Alpine. If you are unsure as to what this should be,
22677  contact your local help desk, system administrator, or Internet Service Provider.
22678 <!--chtml else-->
22679  If unset, Unix Alpine will obtain the domain from
22680  the system.  Often this value will be set for your whole site by the
22681  system administrator.<P>
22682 <!--chtml endif-->
22683 If you set this, see also the <A HREF="h_config_quell_local_lookup">
22684 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
22685 <P>
22686 If you want to change the value of what gets included in the From header
22687 in messages you send (other than just the User Domain)
22688 look <A HREF="h_config_change_your_from">here</A> for a description.
22689 <P><UL>
22690 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22691 </UL><P>
22692 &lt;End of help on this topic&gt;
22693 </BODY>
22694 </HTML>
22695 ====== h_config_smtp_server =====
22696 <HTML>
22697 <HEAD>
22698 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
22699 </HEAD>
22700 <BODY>
22701 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
22702 This value specifies the name of one or more SMTP
22703 (Simple Mail Transfer Protocol) servers for sending mail.
22704 <!--chtml if pinemode="os_windows"-->
22705 You must have an SMTP server for use with PC-Alpine.
22706 SMTP servers are
22707 normally set up by a system administrator for use by all members of a given
22708 campus or department.
22709 Contact your local help desk to ask what SMTP
22710 servers you should use.
22711 <!--chtml else-->
22712 Unix Alpine users may not need to set an SMTP server.
22713 Alpine will attempt to execute the program (usually sendmail) that is used
22714 to insert mail into the mail system.
22715 If this works for you, you may leave this option blank.
22716 If there is an SMTP server running on the Unix host you may be able to
22717 improve sending performance slightly by setting the SMTP server option
22718 to &quot;localhost&quot; or to the actual name of the Unix host.
22719 <P>
22720 If the Unix host doesn't work the way Alpine was expecting you will need to
22721 set the value of this option.
22722 SMTP servers are
22723 normally set up by a system administrator for use by all members of a given
22724 campus or department.
22725 Contact your local help desk to ask what SMTP
22726 servers you should use.
22727 <!--chtml endif-->
22728 <P>
22729 Your SMTP server may offer SMTP AUTH authentication.
22730 It may even require it.
22731 If your SMTP server offers SMTP AUTH authentication you may specify a
22732 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
22733 This parameter requires an associated value,
22734 the username identifier with which to establish the server
22735 connection.
22736 An example might be:
22737
22738 <P>
22739 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
22740 <P>
22741
22742 If AUTH authentication is offered by the server, this will cause Alpine to
22743 attempt to use it.
22744 If AUTH authentication is not offered by the server, this will cause Alpine
22745 to fail sending with an error similar to:
22746
22747 <P>
22748 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
22749 <P>
22750
22751 Another type of authentication that is used by some ISPs is called
22752 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
22753 which means that you have to authenticate
22754 yourself to the POP or IMAP server by opening a mailbox before you
22755 can send mail.
22756 To do this, you usually only have to open your INBOX.
22757
22758 <P>
22759 You may tell Alpine to use the
22760 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
22761 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
22762 parameter
22763 in this option.
22764 At this time &quot;/submit&quot; is simply equivalent to specifying
22765 port 587, though it may imply more than that at some point in the future.
22766 Some ISPs are blocking port 25 in order to reduce the amount of spam
22767 being sent to their users.
22768 You may find that the submit option allows you to get around such a block.
22769
22770 <P>
22771 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
22772 <P>
22773
22774 To specify any non-standard port number on the SMTP server you may follow
22775 the hostname with a colon followed by the portnumber.
22776
22777 <P>
22778 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
22779 <P>
22780
22781 Normally, when a connection is made to the Smtp-Server Alpine will attempt
22782 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
22783 If that fails then a non-encrypted connection will be attempted instead.
22784 You may specify that a TLS connection is required if you wish.
22785 If you append &quot;/starttls&quot; to the name then the connection will fail
22786 instead of falling back to a non-secure connection.
22787
22788 <P>
22789 <CENTER><SAMP>smtpserver.example.com/starttls</SAMP></CENTER>
22790 <P>
22791
22792
22793 For more details about server name possibilities see
22794 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
22795 <P>
22796
22797 <UL>
22798 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22799 </UL>
22800 <P>
22801 &lt;End of help on this topic&gt;
22802 </BODY>
22803 </HTML>
22804 ====== h_config_nntp_server =====
22805 <HTML>
22806 <HEAD>
22807 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
22808 <BODY>
22809 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
22810
22811 This value specifies the name of one or more NNTP
22812 (Network News Transfer Protocol)
22813 servers for reading and posting USENET news.
22814 NNTP servers are normally
22815 set up by a system administrator for use by all members of a given campus
22816 or department.
22817 Contact your local help desk to ask what NNTP servers you should use.
22818 <!--chtml if pinemode="os_windows"--><!--chtml else-->
22819 Often Unix Alpine users will find that this variable has been
22820 set for the whole system (and they don't have to worry about it).
22821 <!--chtml endif-->
22822 When you define an NNTP server here, Alpine implicitly defines a news
22823 collection for you, assuming that server as the news server and assuming
22824 that you will use the NNTP protocol and a local newsrc configuration file
22825 for reading news.
22826 For more about reading news with Alpine, see
22827 <A HREF="h_reading_news">how to use Alpine to read news</A>.
22828 <P>
22829 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
22830 or &quot;AUTHINFO USER&quot; authentication.
22831 It may even require it.
22832 If your NNTP server does offer such authentication you may specify a user name
22833 parameter to cause Alpine to attempt to authenticate.
22834 The same is true for the server name in a folder collection that uses NNTP.
22835 This parameter requires an associated value,
22836 the username identifier with which to establish the server connection.
22837 An example might be:
22838
22839 <P>
22840 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
22841 <P>
22842
22843 If authentication is offered by the server, this will cause Alpine to
22844 attempt to use it.
22845 If authentication is not offered by the server, this will cause Alpine
22846 to fail with an error similar to:
22847
22848 <P>
22849 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
22850 <P>
22851 For more details about the server name possibilities see
22852 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
22853 <P><UL>
22854 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22855 </UL><P>
22856 &lt;End of help on this topic&gt;
22857 </BODY>
22858 </HTML>
22859 ====== h_config_inbox_path =====
22860 <HTML>
22861 <HEAD>
22862 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
22863 </HEAD>
22864 <BODY>
22865 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
22866
22867 This value overrides the default value of your INBOX name/path/location.
22868 <!--chtml if pinemode="os_windows"-->
22869 PC-Alpine users must specify an inbox path and it must be a folder on an
22870 IMAP server.
22871 <!--chtml else-->
22872 Unix and VMS Alpine users will often find that this variable
22873 has been pre-configured by your system administrator.
22874 <!--chtml endif-->
22875 You may be able to specify an alternate INBOX that is either a local folder
22876 or a folder on an IMAP server.
22877 <P>
22878 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
22879 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
22880 mail server.
22881 <P>
22882 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22883 details on the syntax of folder definitions.
22884 <P>
22885 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
22886 mail is disappearing.
22887 <P><UL>
22888 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22889 </UL><P>
22890 &lt;End of help on this topic&gt;
22891 </BODY>
22892 </HTML>
22893 ====== h_config_change_your_from =====
22894 <HTML>
22895 <HEAD>
22896 <TITLE>How to Change your From Address</TITLE>
22897 </HEAD>
22898 <BODY>
22899 <H1>How to Change your From Address</H1>
22900
22901 If the From address that Alpine includes in mail that you send is not correct,
22902 you may want to configure a different default value for the From address.
22903 You may follow these directions to change the default:
22904
22905 <P>
22906 <UL>
22907   <LI> Go to the Main Alpine Menu
22908   <LI> From there type the Setup Command
22909   <LI> From there type the Config Command
22910 </UL>
22911
22912 <P>
22913 You've probably already seen this SETUP CONFIGURATION screen.
22914 If not, there are many options you may want to set here.
22915 To set the value of the From header you may use the
22916 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
22917 Find it by scrolling down a few pages or use the WhereIs command to
22918 search for &quot;customized&quot;.
22919 You may want to read the help text associated with the option.
22920 <P>
22921 To add a custom From header, type the Add command and enter the
22922 full header line, including the leading &quot;From:&nbsp;&quot;.
22923 For example:
22924 <P>
22925 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22926 <P>
22927 Now exit the Setup command and try sending mail to yourself to see
22928 what the From line looks like.
22929 <P>
22930 When you are in the composer you may edit the custom From line by typing
22931 Ctrl-R while your cursor is in the headers of the message and then moving
22932 to the From line and editing.
22933 If you want to leave the default value the same but add the possibility
22934 of being able to edit the header when you compose, add just the header
22935 name without a value.
22936 For example:
22937 <P>
22938 <CENTER><SAMP>From:</SAMP></CENTER>
22939 <P>
22940 If you change your From address you may also find it useful to add the
22941 changed From address to the
22942 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22943 configuration option.
22944 <P>
22945 <UL>
22946 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22947 </UL><P>
22948 &lt;End of help on this topic&gt;
22949 </BODY>
22950 </HTML>
22951 ====== h_config_default_fcc =====
22952 <HTML>
22953 <HEAD>
22954 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
22955 </HEAD>
22956 <BODY>
22957 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
22958
22959 This value specifies where a copy of outgoing mail should be saved.  If
22960 this is not a path name, it will be in the default collection for saves.
22961 Any valid folder specification, local or IMAP, is allowed.  This default
22962 folder carbon copy only applies when the
22963 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
22964 is set to use the default folder.
22965 <!--chtml if pinemode="os_windows"-->
22966 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
22967 <!--chtml else-->
22968 Unix Alpine default
22969 is normally &quot;sent-mail&quot; in the default folder collection.
22970 <!--chtml endif-->
22971 <P>
22972 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
22973 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
22974 IMAP server (remember that in order to later access this remote folder through Alpine, it
22975 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22976 for more information). An example:<p>
22977 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
22978 <P>
22979 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
22980 <P>
22981 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22982 details on the syntax of folder definitions.
22983 <P>
22984 <UL>
22985 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22986 </UL><P>
22987 &lt;End of help on this topic&gt;
22988 </BODY>
22989 </HTML>
22990 ====== h_config_def_save_folder =====
22991 <HTML>
22992 <HEAD>
22993 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
22994 </HEAD>
22995 <BODY>
22996 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
22997
22998 This option determines the default folder name for save-message operations
22999 (&quot;saves&quot;).
23000 <P>
23001 If this is not a path name, it will be in the default collection for saves.
23002 Any valid folder specification, local or IMAP, is allowed.  This default
23003 folder only applies when the
23004 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
23005 doesn't override it.
23006 <!--chtml if pinemode="os_windows"-->
23007 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
23008 <!--chtml else-->
23009 Unix Alpine default
23010 is normally &quot;saved-messages&quot; in the default folder collection.
23011 <!--chtml endif-->
23012 If you access your email through an IMAP server, especially if you often switch between Unix
23013 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
23014 IMAP server (remember that in order to later access this remote folder through Alpine, it
23015 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
23016 for more information). An example:<p>
23017 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
23018 <P>
23019 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23020 details on the syntax of folder definitions.
23021 <P>
23022 <UL>
23023 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23024 </UL><P>
23025 &lt;End of help on this topic&gt;
23026 </BODY>
23027 </HTML>
23028 ====== h_config_postponed_folder =====
23029 <HTML>
23030 <HEAD>
23031 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
23032 </HEAD>
23033 <BODY>
23034 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
23035
23036 This value overrides the default name for the folder where postponed
23037 messages are saved.  If this is not a path name, it will be in the default
23038 collection for message Saves.  Any valid folder specification, local or
23039 remote, is allowed.
23040 PC-Alpine default
23041 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
23042 The Unix Alpine default is normally &quot;postponed-msgs&quot;
23043 in the default collection.
23044 <P>
23045 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
23046 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
23047 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
23048 in all Alpine copies you use.
23049 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
23050 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
23051 for more information). An
23052 example:<p>
23053 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
23054 <P>
23055 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23056 details on the syntax of folder definitions.
23057 <P>
23058 <UL>
23059 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23060 </UL><P>
23061 &lt;End of help on this topic&gt;
23062 </BODY>
23063 </HTML>
23064 ====== h_config_read_message_folder =====
23065 <HTML>
23066 <HEAD>
23067 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
23068 </HEAD>
23069 <BODY>
23070 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
23071
23072 By virtue of specifying a folder name here, Alpine will be configured to
23073 save all messages that you have read during a session into the designated
23074 &quot;read messages&quot; folder.  This allows you to more easily distinguish
23075 between your really new email (in your INBOX) and those that you have
23076 already read.  Depending on how you define the
23077 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
23078 setting, you may or may not be asked when you quit
23079 Alpine if you want read messages to be moved to this folder.  In either
23080 case, moving the messages means they will be deleted from your INBOX.
23081 <P>
23082 If this is not a path name, it will be in the default collection for
23083 saves.  Any valid folder specification, local or remote (via IMAP), is
23084 allowed.  There is no default for the name of the read message folder.
23085 <P>
23086 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23087 details on the syntax of folder definitions.
23088 <P>
23089 <UL>
23090 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23091 </UL><P>
23092 &lt;End of help on this topic&gt;
23093 </BODY>
23094 </HTML>
23095 ====== h_config_form_folder =====
23096 <HTML>
23097 <HEAD>
23098 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
23099 </HEAD>
23100 <BODY>
23101 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
23102
23103 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
23104 contain messages that you have composed and that are intended to be
23105 sent in their original form repeatedly.
23106
23107 <P>
23108 Setting this variable will alter Alpine's usual behavior when you
23109 execute the Compose command.  Normally, Alpine offers a chance to
23110 continue a postponed or interrupted message should one or the other
23111 exist.  When this variable is set to a folder name that exists, Alpine
23112 will also offer the chance to select a message from the folder to
23113 insert into the composer (much like when continuing a postponed message).
23114 The difference, however, is that Alpine will not automatically delete
23115 the selected message from the Form Letter Folder.
23116 <P>
23117 Setting this variable will also affect Alpine's behavior when you
23118 Postpone a message from the composer.  Normally, Alpine simply stashes
23119 the message away in your
23120 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
23121 Regardless of the specified folder's existence, Alpine will ask which
23122 folder you intend the message to be stored in.  Choose the
23123 &quot;F&quot; option to store the message in your Form Letter Folder.
23124 This is the most common way to add a message to the folder.
23125
23126 <P>
23127 Another method of adding messages to the folder is via the Alpine
23128 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
23129 you expect to send in the same form again, you can enter the Form
23130 Letter Folder's name in this field.  Alpine, as usual, will copy the
23131 message as it's sent.  Note, when you later select this message from
23132 your Form Letter Folder, it will have the same recipients as the original
23133 message.
23134
23135 <P>
23136 To delete a message from the Form Letter Folder, you can either select
23137 the folder from a suitable FOLDER LIST screen, or use the Delete
23138 command in the MESSAGE INDEX offered when selecting from the folder as
23139 part of the Compose command.  You can delete a Form Letter Folder just
23140 as any other folder from a suitable FOLDER LIST screen.
23141
23142 <P>
23143 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
23144 facility can be used
23145 to replace the Form Letter Folder.
23146
23147 <P>
23148 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23149 details on the syntax of folder definitions.
23150
23151 <P>
23152 <UL>
23153 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23154 </UL><P>
23155 &lt;End of help on this topic&gt;
23156 </BODY>
23157 </HTML>
23158 ====== h_config_archived_folders =====
23159 <HTML>
23160 <HEAD>
23161 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
23162 </HEAD>
23163 <BODY>
23164 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
23165
23166 This is like
23167 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
23168 only more general.  You may archive
23169 any of the folders in your incoming collection.  This is a list of folder
23170 pairs, with the first separated from the second in the pair by a space.
23171 The first folder in a pair is the folder you want to archive, and the
23172 second folder is the folder that read messages from the first should be
23173 moved to.  Depending on how you define the
23174 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
23175 setting, you may or may not be asked when you
23176 leave the first folder if you want read messages to be moved to the
23177 second folder.  In either case, moving the messages means they will be
23178 deleted from the first folder.
23179 <P>
23180 The name of the first folder in each pair can be either the technical
23181 specification of the folder (like what appears in your configuration file)
23182 or (much easier) the nickname that you gave the folder when you made it
23183 an incoming folder.
23184 <p>
23185 For example:<p>
23186 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
23187 <p>or, using nicknames:<p>
23188 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
23189 <P>
23190 If these are not path names, they will be in the default collection for
23191 saves. Any valid folder specification, local or remote (via IMAP), is
23192 allowed. There is no default.
23193 <P>
23194 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
23195 details on the syntax of folder definitions.
23196 <P>
23197 <UL>
23198 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23199 </UL><P>
23200 &lt;End of help on this topic&gt;
23201 </BODY>
23202 </HTML>
23203 ====== h_config_newsrc_path ======
23204 <HTML>
23205 <HEAD>
23206 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
23207 </HEAD>
23208 <BODY>
23209 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
23210
23211 This option overrides the default name Alpine uses for your "newsrc" news
23212 status and subscription file.  If set, Alpine will take this value as the
23213 full pathname for the desired newsrc file.<P>
23214
23215 If this option is <B>not</B> set,
23216 <!--chtml if pinemode="os_windows"-->
23217 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
23218 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
23219 directory as your pinerc file for NEWSRC.
23220 <!--chtml else-->
23221 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
23222 your account's home directory).
23223 <!--chtml endif-->
23224 <P><UL>
23225 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23226 </UL>
23227 <P>
23228 &lt;End of help on this topic&gt;
23229 </BODY>
23230 </HTML>
23231 ====== h_config_literal_sig =====
23232 <HTML>
23233 <HEAD>
23234 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
23235 </HEAD>
23236 <BODY>
23237 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
23238
23239 With this option your actual signature, as opposed to
23240 the name of a file containing your signature,
23241 is stored in the Alpine configuration file.
23242 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
23243 <P>
23244
23245 This is simply a different way to store the signature.
23246 The signature is stored inside your Alpine configuration file instead of in
23247 a separate file.
23248 Tokens work the same way they do with the
23249 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
23250 help.
23251 <P>
23252
23253 The Setup/Signature command on Alpine's MAIN MENU will edit
23254 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
23255 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
23256 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
23257 instead.
23258 <P>
23259
23260 The two character sequence &#92;n (backslash followed by
23261 the character n) will be used to signify a line-break in your signature.
23262 You don't have to enter the &#92;n, but it will be visible in the
23263 SETUP CONFIGURATION window after you are done editing the signature.
23264
23265 <P>
23266 <UL>
23267 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23268 </UL><P>
23269 &lt;End of help on this topic&gt;
23270 </BODY>
23271 </HTML>
23272 ====== h_config_signature_file =====
23273 <HTML>
23274 <HEAD>
23275 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
23276 </HEAD>
23277 <BODY>
23278 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
23279
23280 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
23281 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
23282 You can tell that that is the case because the value of the
23283 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
23284 <P>
23285 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
23286 <P>
23287 You may either use all Literal Signatures (signatures stored in your
23288 configuration file) throughout Alpine, or all signature files.
23289 You can't mix the two.
23290 <P>
23291 This is the name of a file that will be automatically inserted into
23292 outgoing messages.
23293 It typically contains information such as your
23294 name, email address and organizational affiliation.
23295 Alpine adds the
23296 signature into the message as soon as you enter the composer so you
23297 can choose to remove it or edit it on a message by message basis.
23298 Signature file placement in message replies is controlled by the
23299 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
23300 setting in the feature list.
23301 <P>
23302
23303 The default file name is
23304 <!--chtml if pinemode="os_windows"-->
23305 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
23306 PINERC file is a local file.
23307 If your PINERC file is remote, then it will be in the directory specified
23308 by the &quot;-aux local_directory&quot; command line option.
23309 <!--chtml else-->
23310 &quot;.signature&quot;.
23311 <!--chtml endif-->
23312 <P>
23313
23314 To create or edit your signature file choose Setup from the MAIN MENU
23315 and then select S for Signature (Main/Setup/Signature).  This puts you
23316 into the Signature Editor where you can enter a <EM>few</EM> lines of
23317 text containing your identity and affiliation.
23318
23319 <P>
23320 If the filename is followed by a vertical bar (|) then instead
23321 of reading the contents of the file the file is assumed to be a
23322 program that will produce the text to be used on its standard output.
23323 The program can't have any arguments and doesn't receive any input from Alpine,
23324 but the rest of the processing works as if the contents came from a file.
23325
23326 <P>
23327 Instead of storing the data in a local file, the
23328 signature data may be stored remotely in an IMAP folder.
23329 In order to do this,
23330 you must use a remote name for the file.
23331 A remote <!--#echo var="VAR_signature-file"--> name might look like:
23332 <P>
23333 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
23334 <P>
23335
23336 The syntax used here is the same as the syntax used for remote configuration
23337 files from the command line.
23338 Note that you may not access an existing signature file remotely,
23339 you have to create a new <EM>folder</EM> that contains the signature data.
23340 If the name you use here for the signature file is a remote name, then when
23341 you edit the file from the Setup/Signature command the data will be stored
23342 remotely in the folder.
23343 You aren't required to do anything special to create the folder, it
23344 gets created automatically if you use a remote name.
23345
23346 <P>
23347 Besides regular text, the signature file may also contain
23348 (or a signature program may produce) tokens that
23349 are replaced with text that usually depends on the message you are replying
23350 to or forwarding.
23351 For example, if the signature file contains the token
23352 <P>
23353 <CENTER><SAMP>_DATE_</SAMP></CENTER>
23354 <P>
23355 anywhere in the text, then that token is replaced by the date
23356 the message you are replying to or forwarding was sent.
23357 If it contains
23358 <P>
23359 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
23360 <P>
23361 that is replaced with the current date.
23362 The first is an example of a token that depends on the message you
23363 are replying to (or forwarding) and the second is an example which
23364 doesn't depend on anything other than the current date.
23365 You have to be a little careful with this facility since tokens that
23366 depend on the message you are replying to or forwarding will be replaced
23367 by nothing in the case where you are composing a new message from scratch.
23368 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
23369 in this respect.
23370 It allows you to use different signature files in different cases.
23371 <P>
23372
23373 The list of tokens available for use in the signature file is
23374 <A HREF="h_index_tokens">here</A>.
23375 <P>
23376
23377 Instead of, or along with the use of &quot;roles&quot; to give you
23378 different signature files in different situations, there is also
23379 a way to conditionally include text based
23380 on whether or not a token would result in specific replacement text.
23381 For example, you could include some text based on whether or not
23382 the _NEWS_ token would result in any newsgroups if it was used.
23383 This is explained in detail
23384 <A HREF="h_reply_token_conditionals">here</A>.
23385 This isn't for the faint of heart.
23386 <P>
23387 In the very unlikely event that you want to include a literal token
23388 in the signature you must precede it with a backslash character.
23389 For example,
23390 <P>
23391 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
23392 <P>
23393 would produce something like
23394 <P>
23395 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
23396 <P>
23397 It is not possible to have a literal backslash followed by an expanded token.
23398 <P>
23399 An alternate method for storing the signature data is available by using the
23400 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
23401 This variable will be used by default.
23402 <P>
23403 <UL>
23404 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23405 </UL><P>
23406 &lt;End of help on this topic&gt;
23407 </BODY>
23408 </HTML>
23409 ====== h_config_init_cmd_list =====
23410 <HTML>
23411 <HEAD>
23412 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
23413 </HEAD>
23414 <BODY>
23415 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
23416
23417 The initial keystroke--or command--list option lets you start Alpine at
23418 any place you like.
23419 Whatever keystrokes you specify here will be executed
23420 by Alpine upon startup as a macro.
23421 The words SPACE, TAB, DOWN, UP, LEFT, and
23422 RIGHT indicate the pressing of those keys.
23423 CR indicates the pressing of the RETURN key.
23424 F1 through F12 represent the function keys, and ^ followed
23425 by a character indicates that key pressed along with the control key (in
23426 other words, ^P means Ctrl-P).
23427 As a shortcut notation, an element of the list may be several characters
23428 surrounded by double-quotes (").
23429 That will be expanded into the individual keystrokes
23430 (excluding the double-quote characters).
23431 For example, the quoted-string
23432
23433 <P><CENTER>"ABC"</CENTER>
23434
23435 <P>
23436 is interpreted the same as the three separate list members
23437
23438 <P><CENTER>A and B and C</CENTER>
23439
23440 <P>
23441 which is also the same as
23442
23443 <P><CENTER>A,B,C</CENTER>
23444
23445 <P>
23446 An example: To view message 1 on startup,
23447 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
23448
23449 <P><CENTER>I,J,1,CR,V</CENTER>
23450
23451 <P>
23452 An equivalent version of this is
23453
23454 <P><CENTER>"IJ1",CR,V</CENTER>
23455
23456 <P>
23457 Restrictions: You cannot pre-type into the composer with the initial
23458 keystroke list, and you cannot mix function key commands with letter
23459 commands.
23460
23461 <P><UL>
23462 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23463 </UL>
23464 <P>
23465 &lt;End of help on this topic&gt;
23466 </BODY>
23467 </HTML>
23468 ====== h_config_comp_hdrs =====
23469 <html>
23470 <header>
23471 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
23472 </header>
23473 <body>
23474 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
23475
23476 You can control which headers you want visible when composing outgoing
23477 email using this option.
23478 You can specify any of the regular set, any
23479 <A HREF="h_compose_richhdr">Rich Header</A>,
23480 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
23481 that you have already defined.
23482 If you use this setting at all, you must specify all the
23483 headers you want to see, you can't just add to the regular header set.
23484 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
23485
23486 Note that the "Newsgroups:" header will be abbreviated in the Composer
23487 display, but should be spelled out in full here.<p>
23488 <UL>
23489 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23490 </UL><P>
23491 &lt;End of help on this topic&gt;
23492 </body>
23493 </html>
23494 ====== h_config_custom_hdrs =====
23495 <HTML>
23496 <HEAD>
23497 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
23498 </HEAD>
23499 <BODY>
23500 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
23501
23502 You may add your own custom headers to outgoing messages.
23503 Each header you specify here must include the header tag
23504 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
23505 and may optionally include a value for that header.
23506 If you want to see these custom headers each time you compose a message,
23507 you must add them to your
23508 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
23509 otherwise they become part
23510 of the rich header set that you only see when you press the
23511 <A HREF="h_compose_richhdr">Rich Header</A>
23512 <!--chtml if pinemode="function_key"-->(F5)
23513 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
23514 (If you are looking for a way to change which headers are <EM>displayed</EM>
23515 when you view a message, take a look at the
23516 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
23517 option instead.)
23518 Here's an example that shows how you might set your From address
23519 <P>
23520 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
23521 <P>
23522 and another showing how you might set a Reply-To address
23523 <P>
23524 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
23525 <P>
23526 You may also set non-standard header values here.
23527 For example, you could add
23528 <P>
23529 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
23530 <P>
23531 or even
23532 <P>
23533 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
23534 <P>
23535 If you include a value after the colon then that header will be included
23536 in your outgoing messages unless you delete it before sending.
23537 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
23538 it will not be included in outgoing messages unless you edit a value
23539 in manually.
23540 For example, if
23541 <P>
23542 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
23543 <P>
23544 is in the list, then the Reply-To header will be available for editing
23545 but won't be included unless a value is added while in the composer.
23546 <P>
23547 It's actually a little more complicated than that.
23548 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
23549 defaults.
23550 If the message you are about to compose already has a value for a header,
23551 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
23552 For example, if you are Replying to a message the Subject field
23553 will already be filled in.
23554 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
23555 custom subject will <EM>NOT</EM> be used.
23556 The subject derived from the subject of the message you are Replying
23557 to will be used instead.
23558 <P>
23559 It is also possible to make header setting even more complicated and more
23560 automatic by using
23561 <A HREF="h_rules_roles">Roles</A>,
23562 but if all you want to do is set a default value for a header, you don't
23563 need to think about Roles.
23564 <P>
23565 If you change your From address you may also find it useful to add the
23566 changed From address to the
23567 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
23568 configuration option.
23569 <P>
23570 Limitation: Because commas are used to separate the list of
23571 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
23572 header contain a comma.
23573 Nor is there currently an &quot;escape&quot; mechanism provided
23574 to make this work.
23575 <P><UL>
23576 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23577 </UL>
23578 <P>
23579 &lt;End of help on this topic&gt;
23580 </BODY>
23581 </HTML>
23582 ====== h_config_viewer_headers =====
23583 <HTML>
23584 <HEAD>
23585 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
23586 </HEAD>
23587 <BODY>
23588 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
23589
23590 You may change the default list of headers that are viewed by listing
23591 the headers you want to view here.  If the headers in your
23592 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
23593 will be shown.  The order of the headers you list will be honored.  If
23594 the special value &quot;all-except&quot; is included as the first
23595 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
23596 message except those in the list will be shown.  The values are all
23597 case insensitive.
23598
23599 <P>
23600 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
23601 then the original default headers are ignored.  So, if you just wanted
23602 to add the header Organization to the list, you would have to list
23603 Organization plus all of the other headers originally in the default
23604 list.  If you just included Organization and nothing else, then you
23605 would see only the Organization header, nothing else.
23606
23607 <P>
23608 The default list of headers includes:
23609 <UL>
23610   <LI>From
23611   <LI>Resent-From
23612   <LI>To
23613   <LI>Resent-To
23614   <LI>Cc
23615   <LI>Resent-cc
23616   <LI>Bcc
23617   <LI>Newsgroups
23618   <LI>Followup-To
23619   <LI>Date
23620   <LI>Resent-Date
23621   <LI>Subject
23622   <LI>Resent-Subject
23623   <LI>Reply-To
23624 </UL>
23625
23626 <P>
23627 If you are looking for a way to control which headers are included in
23628 outgoing mail and are visible or not in the composer, take a look at the
23629 options
23630 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
23631 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
23632 this option.
23633 <P>
23634 <UL>
23635 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23636 </UL><P>
23637 &lt;End of help on this topic&gt;
23638 </BODY>
23639 </HTML>
23640 ====== h_config_viewer_margin_left =====
23641 <HTML>
23642 <HEAD>
23643 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
23644 </HEAD>
23645 <BODY>
23646 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
23647
23648 This variable controls the left-hand vertical margin's width in
23649 Alpine's Message Viewing screen.
23650 Its value is the number of space characters preceding each displayed line.
23651 For consistency with
23652 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
23653 you may specify the column number to start in
23654 (column numbering begins with number 1)
23655 instead of the width of the margin by appending a lower case letter
23656 &quot;c&quot; to the number.
23657 For example, a value of &quot;2c&quot; means to start the text in column two,
23658 which is entirely equivalent to a value of &quot;1&quot;, which means to
23659 leave a margin of 1 space.
23660 <P>
23661 The default is a left margin of 0 (zero).
23662 Misconfigurations (for example, negative values or values with starting
23663 left columns greater than the ending right column)
23664 are silently ignored.
23665 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
23666 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
23667 instead.
23668
23669 <P>
23670 &lt;End of help on this topic&gt;
23671 </BODY>
23672 </HTML>
23673 ====== h_config_viewer_margin_right =====
23674 <HTML>
23675 <HEAD>
23676 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
23677 </HEAD>
23678 <BODY>
23679 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
23680
23681 This variable controls the right-hand vertical margin's width in
23682 Alpine's Message Viewing screen.
23683 Its value is the number of space characters following each displayed line.
23684 You may specify the column number to end the text in
23685 (column numbering begins with number 1)
23686 instead of the width of the margin by appending a lower case letter
23687 &quot;c&quot; to the number.
23688 For example, a value of &quot;76c&quot; means to end the text in column 76.
23689 If the screen is 80 characters wide, this is equivalent to a value
23690 of &quot;4&quot;, which means to leave a margin of 4 spaces.
23691 However, if you use different size screens at different times, then these
23692 two values are not equivalent.
23693 <P>
23694 The default right margin is 4.
23695 Misconfigurations (for example, negative values or values with starting
23696 left columns greater than the ending right column)
23697 are silently ignored.
23698 If the number of columns for text between the
23699 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
23700 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
23701 instead.
23702
23703 <P>
23704 &lt;End of help on this topic&gt;
23705 </BODY>
23706 </HTML>
23707 ====== h_config_quote_suppression =====
23708 <HTML>
23709 <HEAD>
23710 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
23711 </HEAD>
23712 <BODY>
23713 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
23714
23715 This option should be used with care.
23716 It will cause some of the quoted text to be eliminated from the
23717 display when viewing a message in the MESSAGE TEXT screen.
23718 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
23719 value &quot;5&quot;,
23720 this will cause quoted text that is longer than five lines to be truncated.
23721 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
23722 Quoted text of more than six lines will have the first five lines displayed
23723 followed by a line that looks something like
23724 <P>
23725 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
23726 <P>
23727 As a special case, if exactly one line of quoted text would be hidden, the
23728 entire quote will be shown instead.
23729 So for the above example, quoted text that is exactly six lines long will
23730 will be shown in its entirety.
23731 (In other words, instead of hiding a single line and adding a line
23732 that announces that one line was hidden, the line is just shown.)
23733 <P>
23734 If the sender of a message has carefully chosen the quotes that he or she
23735 includes, hiding those quotes may change the meaning of the message.
23736 For that reason, Alpine requires that when you want to set the value of this
23737 variable to something less than four lines, you actually have to set it
23738 to the negative of that number.
23739 So if you want to set this option to &quot;3&quot;, you actually have to
23740 set it to &quot;-3&quot;.
23741 The only purpose of this is to get you to think about whether or not you
23742 really want to do this!
23743 If you want to delete all quoted text you set the value of this option
23744 to the special value &quot;-10&quot;.
23745 <P>
23746 The legal values for this option are
23747 <P>
23748 <TABLE>
23749 <TR>
23750   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
23751   <TD> Default, don't hide anything </TD>
23752 </TR>
23753 <TR>
23754   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
23755   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
23756 </TR>
23757 <TR>
23758   <TD> &nbsp;4,5,6,...&nbsp; </TD>
23759   <TD> Suppress if more than that many lines </TD>
23760 </TR>
23761 <TR>
23762   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
23763   <TD> Suppress all quoted lines </TD>
23764 </TR>
23765 </TABLE>
23766 <P>
23767 If you set this option to a non-default value you may sometimes wish to
23768 view the quoted text that is not shown.
23769 When this is the case, the
23770 <A HREF="h_common_hdrmode">HdrMode Command</A>
23771 may be used to show the hidden text.
23772 Typing the &quot;H&quot; command once will show the hidden text.
23773 Typing a second &quot;H&quot; will also turn on Full Header mode.
23774 The presence or absence of the HdrMode command is determined by the
23775 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
23776 Feature-List option in your Alpine configuration, so you will want to
23777 be sure that is turned on if you use quote suppression.
23778 <P>
23779 For the purposes of this option, a quote is a line that begins with the
23780 character &quot;&gt;&quot;.
23781 <P>
23782 Quotes are only suppressed when displaying a message on the screen.
23783 The entire quote will be left intact when printing or forwarding or something
23784 similar.
23785 <P>
23786 &lt;End of help on this topic&gt;
23787 </BODY>
23788 </HTML>
23789 ====== h_config_saved_msg_name_rule =====
23790 <HTML>
23791 <HEAD>
23792 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
23793 </HEAD>
23794 <BODY>
23795 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
23796
23797 This option determines the default folder name when saving
23798 a message.
23799
23800 <P>
23801 The default option is &quot;default-folder&quot;, which is the folder
23802 called &quot;saved-messages&quot; in Unix Alpine and
23803 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
23804 the Alpine option called
23805 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
23806
23807 <P>
23808 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
23809 get the chosen option's value for the message being saved (or for the
23810 first message being saved if using an aggregrate save).
23811 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
23812 value of who the message came from (i.e. the from address).
23813 Alpine then attempts to save the message to a folder matching that value.
23814 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
23815 &quot;by-sender&quot;.
23816 The opposite is also true.
23817 If &quot;by-recipient&quot; is chosen and the message was posted to a
23818 newsgroup, Alpine will use the newsgroup name.
23819 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
23820 &quot;by-from&quot;.
23821
23822 <P>
23823 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
23824 to use the personal name part of the address instead of the mailbox part.
23825 If any of the &quot;by-nick&quot; options are chosen, the
23826 address is looked up in your address book and if found, the
23827 nickname for that entry is used.
23828 Only simple address book entries are checked, not distribution lists.
23829 Similarly, if any of the
23830 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
23831 address book entry is used.
23832 If by-realname, or the by-nick or by-fcc lookups result in no value,
23833 then if the chosen option ends with the &quot;then-from&quot;,
23834 &quot;then-sender&quot;, &quot;then-replyto&quot;,
23835 or &quot;then-recip&quot; suffix, Alpine
23836 reverts to the same behavior as &quot;by-from&quot;,
23837 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
23838 depending on which option was specified.
23839 If the chosen option doesn't end with one of
23840 the &quot;then-&quot; suffixes, then Alpine reverts to the default
23841 folder when no match is found in the address book.
23842
23843 <P>
23844 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
23845 to save to the folder that you saved to the last time you saved a
23846 message.  The first time you save a message in an Alpine session, Alpine
23847 attempts to save the message to the default folder.
23848
23849 <P>
23850 Here is an example to make some of the options clearer.
23851 If the message is From
23852 <P>
23853 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
23854 <P>
23855 and this rule is set to &quot;by-from&quot;, then the default folder offered
23856 in the save dialog would be &quot;flint&quot;.
23857 <P>
23858 If this rule is set to &quot;by-realname-of-from&quot; then the default would
23859 be &quot;Fred Flintstone&quot;.
23860 <P>
23861 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
23862 for the address &quot;flint@bedrock.org&quot; in your address book.
23863 If an entry is found and it has a nickname associated with it, that nickname
23864 will be offered as the default folder.
23865 If not, the default saved message folder will be offered as the default.
23866 <P>
23867 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
23868 for the address &quot;flint@bedrock.org&quot; in your address book.
23869 If an entry is found and it has an Fcc associated with it, that Fcc
23870 will be offered as the default folder.
23871 If not, the default saved message folder will be offered as the default.
23872 <P>
23873 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
23874 for the address &quot;flint@bedrock.org&quot; in your address book.
23875 If an entry is found and it has a nickname associated with it, that nickname
23876 will be offered as the default folder.
23877 If it is not found (or has no nickname) then the default offered will be
23878 the same as it would be for the &quot;by-from&quot; rule.
23879 That is, it would be &quot;flint&quot;
23880 <P>
23881 <UL>
23882 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23883 </UL><P>
23884 &lt;End of help on this topic&gt;
23885 </BODY>
23886 </HTML>
23887 ====== h_config_fcc_rule =====
23888 <HTML>
23889 <HEAD>
23890 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
23891 </HEAD>
23892 <BODY>
23893 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
23894
23895 This option determines the default name for folder carbon copy. Choose
23896 one:
23897
23898 <DL>
23899 <DT>default-fcc</DT>
23900 <DD>This is the normal default, the value of which is set in the
23901 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
23902 configuration.
23903 </DD>
23904
23905 <DT>last-fcc-used</DT>
23906 <DD> Causes Alpine to use the folder that was last
23907 used in the fcc field
23908 </DD>
23909
23910 <DT>by-nickname</DT>
23911 <DD>Means that Alpine will use the nickname
23912 from your address book that matches the first address in the To line.
23913 If there is no match, it will use the value of the
23914 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
23915 </DD>
23916
23917 <DT>by-recipient</DT>
23918 <DD>Means Alpine will form a folder name
23919 based on the left hand side of the first address in the To line.
23920 </DD>
23921
23922 <DT>by-nick-then-recip</DT>
23923 <DD>Means that it will use the
23924 matching nickname from your address book if there is one, otherwise it
23925 will extract the recipient name from the address and use that (like
23926 by-recipient).
23927 </DD>
23928
23929 <DT>current-folder</DT>
23930 <DD>Causes a copy to be written to
23931 the currently open folder, unless that is the INBOX.  In the case
23932 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
23933 used instead.
23934 </DD>
23935 </DL>
23936
23937 <P>
23938 Note: Whatever the fcc specified by the rule here, it will be
23939 over-ridden by any fcc entries you have in your address book.
23940
23941 <P>
23942 <UL>
23943 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23944 </UL><P>
23945 &lt;End of help on this topic&gt;
23946 </BODY>
23947 </HTML>
23948 ====== h_config_sort_key =====
23949 <HTML>
23950 <HEAD>
23951 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
23952 </HEAD>
23953 <BODY>
23954 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
23955
23956 This option determines the order in which messages will be displayed in
23957 the MESSAGE INDEX screen.  Choose from:
23958 <P>
23959 <UL>
23960  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23961  <LI> <A HREF="h_index_sort_date">Date</A>
23962  <LI> <A HREF="h_index_sort_subj">Subject</A>
23963  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23964  <LI> <A HREF="h_index_sort_thread">Thread</A>
23965  <LI> <A HREF="h_index_sort_from">From</A>
23966  <LI> <A HREF="h_index_sort_size">Size</A>
23967  <LI> <A HREF="h_index_sort_score">Score</A>
23968  <LI> <A HREF="h_index_sort_to">To</A>
23969  <LI> <A HREF="h_index_sort_cc">Cc</A>
23970 </UL>
23971
23972 <P>
23973 Each type of sort may also be reversed.
23974 Normal default is by &quot;Arrival&quot;.
23975
23976 <P>
23977 A possible point of confusion arises when you change the configuration
23978 of the <!--#echo var="VAR_sort-key"-->.
23979 The folder will normally be re-sorted when you go back to viewing the
23980 index.
23981 However, if you have manually sorted the folder with the
23982 Sort
23983 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23984 command, then it will not be re-sorted until the next time it is opened.
23985
23986 <P>
23987 <UL>
23988 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23989 </UL><P>
23990 &lt;End of help on this topic&gt;
23991 </BODY>
23992 </HTML>
23993 ====== h_config_other_startup =====
23994 <HTML>
23995 <HEAD>
23996 <TITLE>OPTION: Set Startup Rule</TITLE>
23997 </HEAD>
23998 <BODY>
23999 <H1>OPTION: Set Startup Rule</H1>
24000
24001 This option determines which message will be the <EM>current message</EM> when
24002 the folder is first opened.
24003 It works the same way that the option
24004 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
24005 works, so look there for help.
24006 It may be used for any folder, not just incoming folders.
24007
24008 <P>
24009 <UL>
24010 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24011 </UL><P>
24012 &lt;End of help on this topic&gt;
24013 </BODY>
24014 </HTML>
24015 ====== h_config_perfolder_sort =====
24016 <HTML>
24017 <HEAD>
24018 <TITLE>Set Sort Order</TITLE>
24019 </HEAD>
24020 <BODY>
24021 <H1>Set Sort Order</H1>
24022
24023 This option determines the order in which messages will be displayed in
24024 the MESSAGE INDEX screen when the Current Folder Type set in the
24025 Pattern is a match. Choose from:
24026 <P>
24027 <UL>
24028  <LI> <A HREF="h_index_sort_default">Default</A>
24029  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
24030  <LI> <A HREF="h_index_sort_date">Date</A>
24031  <LI> <A HREF="h_index_sort_subj">Subject</A>
24032  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
24033  <LI> <A HREF="h_index_sort_thread">Thread</A>
24034  <LI> <A HREF="h_index_sort_from">From</A>
24035  <LI> <A HREF="h_index_sort_size">Size</A>
24036  <LI> <A HREF="h_index_sort_score">Score</A>
24037  <LI> <A HREF="h_index_sort_to">To</A>
24038  <LI> <A HREF="h_index_sort_cc">Cc</A>
24039 </UL>
24040
24041 <P>
24042 Each type of sort may also be reversed.
24043 Normal default is by &quot;Arrival&quot;.
24044
24045 <P>
24046 A possible point of confusion arises when you change the configuration
24047 of the Sort Order for the currently open folder.
24048 The folder will normally be re-sorted when you go back to viewing the
24049 index.
24050 However, if you have manually sorted the folder with the
24051 Sort
24052 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
24053 command, then it will not be re-sorted until the next time it is opened.
24054
24055 <P>
24056 <UL>
24057 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24058 </UL><P>
24059 &lt;End of help on this topic&gt;
24060 </BODY>
24061 </HTML>
24062 ====== h_config_fld_sort_rule =====
24063 <HTML>
24064 <HEAD>
24065 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
24066 </HEAD>
24067 <BODY>
24068 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
24069
24070 This option controls the order in which folder list entries will be
24071 presented in the FOLDER LIST screen.  Choose one of the following:
24072
24073 <DL>
24074 <DT>Alphabetical</DT>
24075 <DD>sort by alphabetical name independent of type
24076 </DD>
24077
24078 <DT>Alpha-with-dirs-last</DT>
24079 <DD>sort by alphabetical name grouping directory entries
24080 to the end of the list
24081 </DD>
24082
24083 <DT>Alpha-with-dirs-first</DT>
24084 <DD>sort by alphabetical name grouping directory entries
24085 to the start of the list
24086 </DD>
24087 </DL>
24088
24089 The normal default is &quot;Alphabetical&quot;.
24090
24091 <P>
24092 <UL>
24093 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24094 </UL><P>
24095 &lt;End of help on this topic&gt;
24096 </BODY>
24097 </HTML>
24098 ====== h_config_ab_sort_rule =====
24099 <HTML>
24100 <HEAD>
24101 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
24102 </HEAD>
24103 <BODY>
24104 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
24105
24106 This option controls the order in which address book entries will be
24107 presented.  Choose one of the following:
24108
24109 <DL>
24110 <DT>fullname</DT>
24111 <DD>use fullname field, lists mixed in
24112 </DD>
24113
24114 <DT>fullname-with-lists-last</DT>
24115 <DD>use fullname field, but put lists at end
24116 </DD>
24117
24118 <DT>nickname</DT>
24119 <DD>use nickname field, lists mixed in
24120 </DD>
24121
24122 <DT>nickname-with-lists-last</DT>
24123 <DD>use nickname field, but put lists at end
24124 </DD>
24125
24126 <DT>dont-sort</DT>
24127 <DD>don't change order of file
24128 </DD>
24129 </DL>
24130
24131 <P>
24132 The normal default is &quot;fullname-with-lists-last&quot;.
24133 If you use an address book from more than one computer and those
24134 computers sort the address book differently then the sort order
24135 will be the order where the last change to the address book was
24136 made.
24137 There are two reasons the sorting might be different on different
24138 systems.
24139 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
24140 places.
24141 Second, the collation rules on the two computers may be different.
24142 For example, one system might ignore special characters while the other
24143 doesn't or one may sort upper and lower case letters together while
24144 the other doesn't.
24145 In any case, the order you see is the order on the system where the
24146 last change was made, for example by an address book edit or a
24147 Take Address command.
24148
24149 <P>
24150 <UL>
24151 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24152 </UL><P>
24153 &lt;End of help on this topic&gt;
24154 </BODY>
24155 </HTML>
24156 ====== h_config_post_char_set =====
24157 <HTML>
24158 <HEAD>
24159 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
24160 </HEAD>
24161 <BODY>
24162 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
24163
24164 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
24165 when sending messages.
24166
24167 <P>
24168
24169 When sending a message the text typed in the composer is
24170 labeled with the character set specified by this option.
24171 If the composed text is not fully representable in the
24172 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
24173 instead;
24174
24175 <P>
24176 Attachments are labeled with your
24177 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
24178
24179 <P>
24180 Generally, there should be little need to set this option.
24181 If left unset, the
24182 default behavior is to label composed text as specifically as
24183 possible.  That is, if the composed text has no non-ASCII characters,
24184 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
24185 only ISO-8859-15 characters, it is labeled as such.  Alpine will
24186 attempt to automatically detect a number of character sets including ISO-8859-15,
24187 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
24188 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
24189 If the message contains a mix of character sets,
24190 it is labeled as &quot;UTF-8.&quot;
24191
24192 <P>
24193
24194 This setting is provided to allow you to force a particular character set that
24195 Alpine does not automatically detect. For example, if a message is representable
24196 in more than one character set then Alpine may choose a different default
24197 than you want.
24198 Lastly, by setting this option explicitly to
24199 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
24200 &quot;UTF-8&quot; instead of something more specific.
24201
24202 <P>
24203 In the Setup/Config screen you may choose from a list of all the
24204 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24205
24206 <P>
24207 The options
24208 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
24209 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
24210 are closely related.
24211 Setting the feature
24212 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24213 should cause this option to be ignored.
24214
24215 <P>
24216 <UL>
24217 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24218 </UL><P>
24219 &lt;End of help on this topic&gt;
24220 </BODY>
24221 </HTML>
24222 ====== h_config_unk_char_set =====
24223 <HTML>
24224 <HEAD>
24225 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
24226 </HEAD>
24227 <BODY>
24228 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
24229
24230 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
24231 when reading or replying to messages.
24232
24233 <P>
24234
24235 A text message should either be made up of all US-ASCII characters
24236 or it should contain a charset label which tells the software which
24237 character set encoding to use to interpret the message.
24238 Sometimes a malformed message may be unlabeled but contain non-ascii text.
24239 This message is outside of the standards so any attempt to read it could fail.
24240 When Alpine attempts to read such a message it will try to interpret the
24241 text in the character set you specify here.
24242 For example, if you have correspondents who send you unlabeled messages that
24243 are usually made up of characters from the WINDOWS-1251 character set, setting
24244 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
24245 allow you to read those messages.
24246 Of course, if the unlabeled message is actually in some other character set,
24247 then you may see garbage on your screen.
24248 <P>
24249 Instead of just unlabeled text, this option also affects text which is labeled
24250 with the charsets &quot;X-Unknown&quot;, &quot;MISSING_PARAMETER_VALUE&quot;
24251 or &quot;US-ASCII&quot;.
24252
24253 <P>
24254 In the Setup/Config screen you may choose from a list of all the
24255 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24256
24257 <P>
24258 <UL>
24259 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24260 </UL><P>
24261 &lt;End of help on this topic&gt;
24262 </BODY>
24263 </HTML>
24264 ====== h_config_char_set =====
24265 <HTML>
24266 <HEAD>
24267 <TITLE>OPTION: Display Character Set</TITLE>
24268 </HEAD>
24269 <BODY>
24270 <H1>OPTION: Display Character Set</H1>
24271
24272 The Display Character Set configuration option is used when viewing messages.
24273 <P>
24274 Alpine uses Unicode characters internally and
24275 it is a goal for Alpine to handle email in many different languages.
24276 Alpine will properly display only left-to-right character sets
24277 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
24278 font is in use, in the sense that
24279 characters are assumed to take up zero, one, or two character cell
24280 widths from left to right on the screen. This is true even in PC-Alpine.
24281 <P>
24282
24283 Alpine recognizes some local character sets that are right-to-left
24284 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
24285 (Arabic) and properly converts texts in these character sets to/from
24286 Unicode; however, there are known display bugs with these character
24287 sets.
24288 <P>
24289
24290 There are three possible configuration character settings and some
24291 environment variable settings that can affect how Alpine
24292 handles international characters.
24293 The first two of these are only available in UNIX Alpine.
24294 The three configuration options are
24295 Display Character Set,
24296 Keyboard Character Set, and
24297 <!--#echo var="VAR_posting-character-set"-->.
24298 The Keyboard Character Set defaults to being the same value
24299 as the Display Character Set, and that is usually correct, because
24300 the keyboard almost always produces characters in the same character set
24301 as the display displays.
24302 The Display Character Set is the character set that Alpine
24303 will attempt to use when sending characters to the display.
24304 <P>
24305
24306 By default, the Display Character Set variable is not set and UNIX Alpine
24307 will attempt to get this information from the environment.
24308 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
24309 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
24310 An explicit configuration setting for Display Character Set will,
24311 of course, override any default setting.
24312 <P>
24313 For PC-Alpine the Display Character Set
24314 and the Keyboard Character Set
24315 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
24316 <P>
24317
24318 It is probably best to use UNIX Alpine in a terminal emulator
24319 capable of displaying UTF-8 characters, since that will allow you to
24320 view just about any received text that is correctly formatted (note,
24321 however, the above comments about known index display bugs with certain
24322 character sets). You'll need to have an emulator that uses a UTF-8 font
24323 and you'll need to set up your environment to use a UTF-8 charmap. For
24324 example, on a Linux system you might include
24325 <P>
24326 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
24327 <P>
24328
24329 or something similar in your UNIX startup files.
24330 You'd also have to select a UTF-8 font in your terminal emulator.
24331 <P>
24332
24333 The types of values that the character set variables may be set to are
24334 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
24335 The <CODE>ISO-2022</CODE> character sets are not supported for input or
24336 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
24337 for use only as a <!--#echo var="VAR_posting-character-set"-->.
24338 In the Setup/Config screen you may choose from a list of all the
24339 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24340 Here is a list of many of the possible character sets:
24341
24342 <P>
24343 <TABLE>
24344 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
24345 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
24346 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
24347 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
24348 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
24349 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
24350 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
24351 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
24352 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
24353 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
24354 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
24355 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
24356 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
24357 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
24358 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
24359 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
24360 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
24361 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
24362 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
24363 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukrainian</TD> </TR>
24364 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
24365 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
24366 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
24367 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24368 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24369 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24370 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24371 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24372 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
24373 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
24374 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
24375 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
24376 </TABLE>
24377 <P>
24378
24379 When reading incoming email, Alpine understands many different
24380 character sets and is able to convert the incoming mail into Unicode.
24381 The Unicode will be converted to the Display Character Set
24382 for display on your terminal.
24383 Characters typed at the keyboard will be converted from the
24384 Keyboard Character Set to Unicode for Alpine's internal
24385 use.
24386 You may find that you can read some malformed messages that do not
24387 contain a character set label by setting the option
24388 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
24389 <P>
24390
24391 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
24392 The default behavior obtained by leaving this variable unset is usually
24393 what is wanted. In that default case, Alpine will attempt
24394 to label the message with the most specific character set from the
24395 rather arbitrary set
24396 <P>
24397 US-ASCII, ISO-8859-15,
24398 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
24399 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
24400 <P>
24401
24402 For example, if the message is made up of only US-ASCII characters, it
24403 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
24404 that will be the label. If that doesn't work the same is tried for the
24405 remaining members of the list.
24406
24407 <P>
24408 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
24409 explicit value instead.
24410 For example, if you usually send messages in Greek, setting this
24411 option to ISO-8859-7 will result in messages being labeled as
24412 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
24413 are only Greek characters, or UTF-8 if there are some characters
24414 that aren't representable in ISO-8859-7.
24415 Another possibility is to set this option explicitly to UTF-8.
24416 In that case
24417 Alpine labels only ascii messages as US-ASCII and all other
24418 messages as UTF-8.
24419 <P>
24420
24421 The options
24422 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
24423 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
24424 are closely related to this option.
24425 Setting the feature
24426 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24427 should cause this option to be ignored.
24428
24429 <P>
24430 When displaying a message, Alpine compares this setting to the character
24431 set specified in the message.  If not all of the
24432 characters in the message can be displayed using the Display Character Set
24433 then Alpine places an editorial
24434 comment in the displayed text (enclosed in square-brackets) indicating
24435 that some characters may not be displayed correctly.
24436 This comment may be eliminated by turning on the option
24437 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
24438
24439 <P>
24440 <UL>
24441 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24442 </UL><P>
24443 &lt;End of help on this topic&gt;
24444 </BODY>
24445 </HTML>
24446 ====== h_config_key_char_set =====
24447 <HTML>
24448 <HEAD>
24449 <TITLE>OPTION: Keyboard Character Set</TITLE>
24450 </HEAD>
24451 <BODY>
24452 <H1>OPTION: Keyboard Character Set</H1>
24453
24454 UNIX Alpine only.
24455 <P>
24456 The Keyboard Character Set identifies the character set of the characters
24457 coming from your keyboard.
24458 It defaults to having the same value as your
24459 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
24460 which in turn defaults to a value obtained from your environment.
24461 It is unlikely that you will need to use this option, because the keyboard
24462 almost always produces the same kind of characters as the display displays.
24463
24464 <P>
24465 This character set is also used when accessing files in your local
24466 file system.
24467 The names of the files are assumed to be in the same character set as
24468 what the keyboard produces, as well as the contents of the files.
24469
24470 <P>
24471 In the Setup/Config screen you may choose from a list of all the
24472 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24473
24474 <P>
24475 The options
24476 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
24477 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
24478 are closely related.
24479 Setting the feature
24480 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24481 should cause this option to be ignored.
24482
24483 <P>
24484 <UL>
24485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24486 </UL><P>
24487 &lt;End of help on this topic&gt;
24488 </BODY>
24489 </HTML>
24490 ====== h_config_editor =====
24491 <HTML>
24492 <HEAD>
24493 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
24494 </HEAD>
24495 <BODY>
24496 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
24497
24498 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
24499 normally an alternative to Alpine's internal composer (Pico).  You could use
24500 this setting to specify an alternate editor to use occasionally or if you
24501 have a favorite editor and want to use it all the time (see the
24502 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
24503 If you specify multiple editors for this option, ^_ will invoke the first one
24504 of those specified that exists and is executable.  When specifying a program
24505 for use here, make sure that the format of the text it saves -- which, when
24506 you exit it, will become the message body in Alpine -- is appropriate
24507 for the body of an email message; avoid proprietary formats that may result in
24508 a message body that the recipient of your message will be unable to decipher.
24509 <P>
24510 <!--chtml if pinemode="os_windows"-->
24511 <!--chtml else-->
24512 If you are in doubt about what editors are available on your system, or which
24513 of them may be appropriate for specification here, ask your local computing
24514 support staff.
24515 <!--chtml endif-->
24516 <P>
24517 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
24518 unset, outgoing text will be set as flowed.  In most cases this will be fine,
24519 but if the editor has a &quot;flowed text&quot; mode, it would be best to
24520 use that.
24521
24522 <P><UL>
24523 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24524 </UL>
24525 <P>
24526 &lt;End of help on this topic&gt;
24527 </BODY>
24528 </HTML>
24529 ====== h_config_speller =====
24530 <HTML>
24531 <HEAD>
24532 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
24533 </HEAD>
24534 <BODY>
24535 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
24536
24537 UNIX Alpine only.
24538 <P>
24539 For PC-Alpine, you must install the aspell library code that you
24540 may get from
24541 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
24542 <P>
24543 This option affects the behavior of the ^T (spell check) command in the
24544 Composer.  It specifies the program invoked by ^T in the Composer.
24545 By default, Alpine uses
24546 <P>
24547 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
24548 <P>
24549 if it knows where to find &quot;aspell&quot;.
24550 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
24551 then the command used is
24552 <P>
24553 <CENTER><SAMP>ispell -l</SAMP></CENTER>
24554 <P>
24555 Otherwise, the ancient &quot;spell&quot; command is used.
24556 <P>
24557 If you specify a value for this command (with full pathname) then that is what
24558 will be used instead of any of the defaults.
24559 When invoking this
24560 spell-checking program, Alpine appends a tempfile name (where the message is
24561 passed) to the command line. Alpine expects the speller to correct the
24562 spelling in that file. When you exit from that program Alpine will read the
24563 tempfile back into the composer.
24564 <P>
24565 Don't set this speller option to the standard Unix spell command.
24566 That won't work because spell works in a different way.
24567
24568 <P>
24569 <UL>
24570 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24571 </UL><P>
24572 &lt;End of help on this topic&gt;
24573 </BODY>
24574 </HTML>
24575 ====== h_config_aspell_dictionary =====
24576 <HTML>
24577 <HEAD>
24578 <TITLE>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></TITLE>
24579 </HEAD>
24580 <BODY>
24581 <H1>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></H1>
24582
24583 PC Alpine only.
24584 <P>
24585 This option specifies a list of dictionaries you will use with
24586 aspell. A sample entry is &quot;en_US&quot; for american english, or
24587 &quot;en_GB&quot; for british english.
24588
24589 <P>
24590 <UL>
24591 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24592 </UL><P>
24593 &lt;End of help on this topic&gt;
24594 </BODY>
24595 </HTML>
24596 ====== h_config_display_filters =====
24597 <HTML>
24598 <HEAD>
24599 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
24600 </HEAD>
24601 <BODY>
24602 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
24603
24604 This option defines a list of text-filtering commands (programs or
24605 scripts) that may be used to filter text portions of received messages
24606 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
24607 display screen, exporting to a text file).
24608 For security reasons, the full path name of the
24609 filter command must be specified.
24610
24611 <P>
24612 The command is executed and the message is piped into its standard input.
24613 The standard output of the command is read back by Alpine.  The
24614 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
24615
24616 <P>
24617 The filter's use is based on the configured &quot;trigger&quot; string.  The
24618 format of a filter definition is:
24619
24620 <P>
24621 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
24622
24623 <P>
24624 You can specify as many filters as you wish, separating them with a comma.
24625 Each filter can have only one trigger and command.  Thus, two trigger
24626 strings that invoke the same command require separate filter
24627 specifications.
24628
24629 <P>
24630 The &quot;trigger&quot; is simply text that, if found in the message,
24631 will invoke the associated command.  If the trigger contains any space
24632 characters, it must be placed within quotes.  Likewise, should you
24633 wish a filter to be invoked unconditionally, define the trigger as the
24634 null string, &quot;&quot; (two consecutive double-quote characters).  If the
24635 trigger string is found anywhere in the text of the message the filter
24636 is invoked.  Placing the trigger text within the tokens defined below
24637 changes where within the text the trigger must be before considering
24638 it a match.
24639
24640 <P>
24641 Trigger Modifying Tokens:
24642 <DL>
24643 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
24644 <DD>This token tells Alpine to invoke the supplied command
24645 if the text is in a character set matching <VAR>string</VAR>
24646 (e.g., ISO-8859-2 or ISO-2022-JP).
24647 </DD>
24648
24649
24650 <DT>_LEADING(<VAR>string</VAR>)_</DT>
24651 <DD>This token tells Alpine to invoke the supplied command
24652 if the enclosed <VAR>string</VAR> is found to be the first
24653 non-whitespace text.
24654 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
24655 the space character.
24656 </DD>
24657
24658 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
24659 <DD>This token tells Alpine to invoke the supplied command
24660 if the enclosed <VAR>string</VAR> is found at the beginning
24661 of any line in the text.
24662 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
24663 the space character.
24664 </DD>
24665 </DL>
24666
24667 <P>
24668 The &quot;command&quot; and &quot;arguments&quot; portion is simply
24669 the command line to be invoked if the trigger string is found.  Below
24670 are tokens that Alpine will recognize and replace with special values
24671 when the command is actually invoked.
24672
24673 <P>
24674 Command Modifying Tokens:
24675
24676 <DL>
24677 <DT>_TMPFILE_</DT>
24678 <DD>When the command is executed, this token is
24679 replaced with the path and name of the temporary
24680 file containing the text to be filtered.  Alpine
24681 expects the filter to replace this data with the
24682 filter's result.
24683
24684 <P>
24685 NOTE: Use of this token implies that the text to
24686 be filtered is not piped into standard input of the
24687 executed command and its standard output is ignored.
24688 Alpine restores the tty modes before invoking the
24689 filter in case the filter interacts with the user
24690 via its own standard input and output.
24691 </DD>
24692
24693 <DT>_RESULTFILE_</DT>
24694 <DD>When the command is executed, this token is
24695 replaced with the path and name of a temporary
24696 file intended to contain a status message from the
24697 filter.  Alpine displays this in the message status
24698 field.
24699 </DD>
24700
24701 <DT>_DATAFILE_</DT>
24702 <DD>When the command is executed, this token is
24703 replaced with the path and name of a temporary
24704 file that Alpine creates once per session and deletes
24705 upon exit.  The file is intended to be used by the
24706 filter to store state information between instances
24707 of the filter.
24708 </DD>
24709
24710 <DT>_PREPENDKEY_</DT>
24711 <DD>When the command is executed, this token indicates that a random
24712 number will be passed down the input stream before the message text.
24713 This number could be used as a session key.  It is sent in this way to
24714 improve security.  The number is unique to the current Alpine session
24715 and is only generated once per session.
24716 </DD>
24717
24718 <DT>_SILENT_</DT>
24719 <DD>When the filter is executed, this token tells Alpine not to repaint
24720 the screen while the command is being executed. This can be used with
24721 filters that do not interact with the user, and therefore repainting
24722 the screen is not necessary.
24723 </DD>
24724 </DL>
24725
24726 <P>
24727 The feature
24728 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
24729 <P>
24730 Performance caveat/considerations:
24731 <BR>
24732 Testing for the trigger and invoking the filter doesn't come for free.
24733 There is overhead associated with searching for the trigger string, testing
24734 for the filter's existence and actually piping the text through the filter.
24735 The impact can be reduced if the Trigger Modifying Tokens above are
24736 employed.
24737 <P>
24738 &lt;End of help on this topic&gt;
24739 </BODY>
24740 </HTML>
24741 ====== h_config_sending_filter =====
24742 <HTML>
24743 <HEAD>
24744 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
24745 </HEAD>
24746 <BODY>
24747 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
24748
24749 This option defines a list of text-filtering commands (programs and
24750 scripts) that may be selectively invoked to process a message just before
24751 it is sent.  If set, the Composer's ^X (Send) command will allow you to
24752 select which filter (or none) to apply to the message before it is sent.
24753 For security reasons, the full path of the filter program must be
24754 specified.
24755
24756 <P>
24757 Command Modifying Tokens:
24758
24759 <DL>
24760 <DT>_RECIPIENTS_</DT>
24761 <DD>When the command is executed, this token is replaced
24762 with the space delimited list of recipients of the
24763 message being sent.
24764 </DD>
24765
24766 <DT>_TMPFILE_</DT>
24767 <DD>
24768 When the command is executed, this token is
24769 replaced with the path and name of the temporary
24770 file containing the text to be filtered.  Alpine
24771 expects the filter to replace this data with the
24772 filter's result.
24773
24774 <P>
24775 NOTE: Use of this token implies that the text to
24776 be filtered is not piped into standard input of the
24777 executed command and its standard output is ignored.
24778 Alpine restores the tty modes before invoking the
24779 filter in case the filter interacts with the user
24780 via its own standard input and output.
24781 </DD>
24782
24783 <DT>_RESULTFILE_</DT>
24784 <DD>When the command is executed, this token is
24785 replaced with the path and name of a temporary
24786 file intended to contain a status message from the
24787 filter.  Alpine displays this in the message status
24788 field.
24789 </DD>
24790
24791 <DT>_DATAFILE_</DT>
24792 <DD>When the command is executed, this token is replaced
24793 in the command line with the path and name of a
24794 temporary file that Alpine creates once per session
24795 and deletes upon exit.  The file is intended to be
24796 used by the filter to store state information between
24797 instances of the filter.
24798 </DD>
24799
24800 <DT>_PREPENDKEY_</DT>
24801 <DD>When the command is executed, this token indicates
24802 that a random number will be passed down the input
24803 stream before the message text.  This number could
24804 be used as a session key.  It is sent in this way
24805 to improve security.  The number is unique to the
24806 current Alpine session and is only generated once per
24807 session.
24808 </DD>
24809
24810 <DT>_INCLUDEALLHDRS_</DT>
24811 <DD>When the command is executed, this token indicates
24812 that the headers of the message will be passed down the input stream
24813 before the message text.
24814 </DD>
24815
24816 <DT>_MIMETYPE_</DT>
24817 <DD>When the command is executed, this token is replaced in the
24818 command name with a temporary file name used to accept any new MIME
24819 Content-Type information necessitated by the output of the filter.
24820 Upon the filter's exit, if the file contains new MIME type
24821 information, Alpine verifies its format and replaces the outgoing
24822 message's MIME type information with that contained in the file. This
24823 is basically a cheap way of sending something other than Text/Plain.
24824 </DD>
24825 </DL>
24826
24827 <P>
24828 NOTE: Only the body text, which is visible in the Composer, is piped
24829 through this filter.  Attachments are not sent to the filter.
24830 <P>
24831 Sending filters are not used if the feature
24832 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
24833 <P>
24834 <UL>
24835 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24836 </UL><P>
24837 &lt;End of help on this topic&gt;
24838 </BODY>
24839 </HTML>
24840 ====== h_config_keywords =====
24841 <HTML>
24842 <HEAD>
24843 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
24844 </HEAD>
24845 <BODY>
24846 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
24847
24848 You may define your own set of keywords and optionally set them on a
24849 message by message basis.
24850 These are similar to the &quot;Important&quot; flag which the user
24851 may set using the Flag command.
24852 The difference is that the Important flag is always present for each folder.
24853 User-defined keywords are chosen by the user.
24854 You may set up the list of possible keywords here, or you may add keywords
24855 from the Flag Details screen that you
24856 can get to after typing the
24857 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
24858 command.
24859 After the keywords have been defined,
24860 then you use the <A HREF="h_common_flag">Flag command</A>
24861 to set or clear the keywords in each message.
24862 The behavior of the flag command may be modified by using the
24863 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
24864 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
24865
24866 <P>
24867 Keywords may be used when Selecting messages (Select Keyword).
24868 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
24869 Filter Rules may be used to set keywords automatically.
24870 Keywords may be displayed as part of the Subject of a message by using
24871 the SUBJKEY or SUBJKEYINIT tokens in the
24872 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
24873 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
24874 option may be used to modify the display of keywords using
24875 SUBJKEY and SUBJKEYINIT slightly.
24876 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
24877 screen by using the KEY or KEYINIT tokens.
24878 It is also possible to color keywords in the index using the
24879 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
24880 Keywords are not supported by all mail servers.
24881
24882 <P>
24883 You may give keywords nicknames if you wish.
24884 If the keyword definition you type in contains a SPACE character, then the
24885 actual value of the keyword is everything after the last SPACE and the
24886 nickname for that keyword is everything before the last SPACE.
24887 For example, suppose you are trying to interoperate with another email program
24888 that uses a particular keyword with an unpleasant name.
24889 Maybe it uses a keyword called
24890 <P>
24891 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
24892 <P>
24893 but for you that keyword means that the message is work-related.
24894 You could define a keyword to have the value
24895 <P>
24896 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
24897 <P>
24898 and then you would use the name &quot;Work&quot; when dealing with
24899 that keyword in Alpine.
24900 If you defined it as
24901 <P>
24902 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
24903 <P>
24904 the nickname would be everything before the last SPACE, that is the nickname
24905 would be &quot;My Work&quot;.
24906 <P>
24907 Some commonly used keywords begin with dollar signs.
24908 This presents a slight complication, because the dollar sign is normally used
24909 to signify
24910 <A HREF="h_news_config">environment variable expansion</A>
24911 in the Alpine configuration.
24912 In order to specify a keyword that begins with a dollar sign you must
24913 precede the dollar sign with a second dollar sign to escape its special
24914 meaning.
24915 For example, if you want to include the keyword
24916 <P>
24917 <CENTER><SAMP>$Label1</SAMP></CENTER>
24918 <P>
24919 as one of your possible keywords, you must enter the text
24920 <P>
24921 <CENTER><SAMP>$$Label1</SAMP></CENTER>
24922 <P>
24923
24924 instead.
24925 <P>
24926 There are a couple limitations.
24927 First, not all servers support keywords.
24928 Second, some servers (including the IMAP server included with Alpine)
24929 have a per folder limit on the number of keywords that may be defined.
24930 This count commonly includes every keyword you have ever used in the
24931 folder, even if it is no longer being used.
24932 In other words, you can add keywords but you cannot remove them easily.
24933 If you have changed keywords over the life of a folder and find that
24934 you have reached such a limit, one possible solution might be to copy
24935 all of the messages to a newly created folder (using Alpine) and then
24936 delete the original and rename the new folder.
24937 The reason this might work is that only the keywords currently set in
24938 any of the messages will be used in the new folder, hopefully putting you
24939 under the limit.
24940
24941 <P>
24942 <UL>
24943 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24944 </UL><P>
24945 &lt;End of help on this topic&gt;
24946 </BODY>
24947 </HTML>
24948 ====== h_config_alt_addresses =====
24949 <HTML>
24950 <HEAD>
24951 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
24952 </HEAD>
24953 <BODY>
24954 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
24955
24956 This option provides a place for you to list alternate email addresses
24957 you may have.
24958 Each address in the list should be the actual email address part of an
24959 address, without the full name field or the angle brackets.
24960 For example:
24961
24962 <P>
24963 <CENTER><SAMP>user@example.com</SAMP></CENTER>
24964 <P>
24965
24966 The matching is case-insensitive, so this would match any of
24967 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
24968 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
24969
24970 <P>
24971 If set, the option affects the behavior of the Reply
24972 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
24973 a message has been addressed specifically to you.
24974
24975 <P>
24976 In the default INDEX display
24977 the personal name (or email address) of
24978 the person listed in the message's &quot;From:&quot; header
24979 field is usually displayed except when that address is yours or one of your
24980 alternate addresses.
24981 In that case you will usually see the name of
24982 the first person specified in the
24983 message's &quot;To:&quot; header field
24984 with the prefix &quot;To: &quot; prepended.
24985
24986 <P>
24987 With respect to Reply, the reply-to-all option will exclude addresses
24988 listed here.
24989
24990 <P>
24991 The feature
24992 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
24993 is somewhat related to this option.
24994
24995 <P>
24996 In addition to a list of actual addresses,
24997 you may use regular expressions (as used with egrep with the ignore case flag)
24998 to describe the addresses you want to match.
24999 Alpine will somewhat arbitrarily interpret your entry as a regular
25000 expression if it contains any of the characters
25001 *, |, +, ?, {, [, ^, $, or &#92;.
25002 Otherwise, it will be treated literally.
25003 The feature
25004 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
25005 may be used to turn off regular expression processing regardless of whether or not
25006 special characters appear in the entry.
25007
25008 <P>
25009 A description of how regular expressions work is beyond the
25010 scope of this help text, but some examples follow.
25011
25012 <P>
25013 The entry
25014
25015 <P>
25016 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
25017 <P>
25018
25019 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
25020 address with a domain name of <SAMP>example.com</SAMP> (such as
25021 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
25022 one of your alternate addresses.
25023 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
25024 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
25025 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
25026 Complicating things further, the dollar sign
25027 is special in the Alpine configuration (it signifies environment variable expansion)
25028 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
25029 Quotes around the whole expression will not escape the dollar sign successfully.
25030 So this example should look like
25031
25032 <P>
25033 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
25034 <P>
25035
25036 <P>
25037 The entry
25038
25039 <P>
25040 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
25041 <P>
25042
25043 would match
25044 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
25045 as <SAMP>fred@example.com</SAMP>.
25046
25047 <P>
25048 You could match all addresses that look like
25049 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
25050 entry
25051
25052 <P>
25053 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
25054 <P>
25055
25056 Notice that you have to escape the plus sign with a backslash because plus
25057 is a special character in regular expressions.
25058 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
25059 the expression
25060
25061 <P>
25062 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
25063 <P>
25064
25065 would do it, but it would be easier to just add fred@example.com as a
25066 separate entry.
25067
25068 <P>
25069 One more example, a match of all first-level subdomains, is given by
25070
25071 <P>
25072 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
25073 <P>
25074
25075 <P>
25076 Because the regular expression matching is based on an old library
25077 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
25078 but they should be close.
25079
25080 <P>
25081 <UL>
25082 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25083 </UL><P>
25084 &lt;End of help on this topic&gt;
25085 </BODY>
25086 </HTML>
25087 ====== h_config_abook_formats =====
25088 <HTML>
25089 <HEAD>
25090 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
25091 </HEAD>
25092 <BODY>
25093 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
25094
25095 This option specifies the format that address books are displayed in.
25096 Normally, address books are displayed with the nicknames in the first
25097 column, the fullnames in the second column, and addresses in the third
25098 column.  The system figures out reasonable defaults for the widths of
25099 the columns.  An address book may be given a different format by
25100 listing special tokens in the order you want them to display.  The
25101 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
25102 So, for example, to get the default behavior you could list
25103
25104 <P>
25105 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
25106
25107 <P>
25108 (You can also use the token DEFAULT to get the default behavior for
25109 an address book format.)
25110
25111 <P>
25112 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
25113 is a list, so if you have more than one address book you may have a
25114 separate format for each by putting its format at the corresponding
25115 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
25116
25117 <P>
25118
25119 Listed first are the personal address books, then the global address
25120 books.  So, if you have two personal address books and one global
25121 address book, you may have up to three formats in the
25122 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
25123 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
25124 are address books, the last element is used repeatedly.
25125
25126 <P>
25127
25128 Each of the tokens may also be optionally followed by parentheses with
25129 either a number or a percentage inside the parentheses.  For example,
25130 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
25131 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
25132 of the available space (the screen width minus the space for
25133 inter-column spaces) to the fullnames column, while plain
25134 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
25135 reasonable number of columns.
25136
25137 <P>
25138 There are always 2 spaces between every column, so if you use
25139 fixed column widths (like 13) you should remember to take that into
25140 account.
25141
25142 <P>
25143 <UL>
25144 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25145 </UL><P>
25146 &lt;End of help on this topic&gt;
25147 </BODY>
25148 </HTML>
25149 ====== h_config_set_index_format =====
25150 <HTML>
25151 <HEAD>
25152 <TITLE>Set Index Format</TITLE>
25153 </HEAD>
25154 <BODY>
25155 <H1>Set Index Format</H1>
25156
25157 This option is used to customize the content of lines in the
25158 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
25159 This action works exactly like the regular
25160 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
25161 except that you can have a folder-specific value for it if you specify it here.
25162 Consult the help for
25163 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
25164 for more information.
25165
25166 <P>
25167 <UL>
25168 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25169 </UL><P>
25170 &lt;End of help on this topic&gt;
25171 </BODY>
25172 </HTML>
25173 ====== h_config_index_format =====
25174 <HTML>
25175 <HEAD>
25176 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
25177 </HEAD>
25178 <BODY>
25179 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
25180
25181 This option is used to customize the content of lines in the
25182 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
25183 to convey some amount of immediately relevant information about each
25184 message in the current folder.
25185 <P>
25186
25187 Alpine provides a pre-defined set of informational fields with
25188 reasonable column widths automatically computed.  You can, however,
25189 replace this default set by listing special tokens in the order you
25190 want them displayed.
25191 <P>
25192
25193 The list of available tokens is
25194 <A HREF="h_index_tokens">here</A>.
25195 <P>
25196
25197 Spaces are used to separate listed tokens.  Additionally, you can
25198 specify how much of the screen's width the token's associated data
25199 should occupy on the index line by appending to the token a pair of
25200 parentheses enclosing either a number or percentage.  For example,
25201 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
25202 column, and &quot;SUBJECT(20%)&quot; means to
25203 allocate 20% of the available space
25204 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
25205 attempt to figure out a reasonable amount of space.
25206 <P>
25207
25208 There is always one space between every pair of columns, so if you use fixed
25209 column widths (like 13) you should remember to take that into account.
25210 Several of the fields are virtually fixed-width, so it doesn't make
25211 much sense to specify the width for them.  The fields STATUS,
25212 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
25213 and DESCRIPSIZE all fall into that category.
25214 You <EM>may</EM> specify widths for those if you wish, but
25215 you're probably better off letting the system pick those widths.  <P>
25216
25217 <P>
25218 The default is equivalent to:
25219
25220 <P>
25221 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
25222
25223 <P>
25224 This means that the four fields without percentages will be allocated
25225 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
25226 the from and subject fields.  If one of those two fields is specified
25227 as a percentage and the other is left for the system to choose, then
25228 the percentage is taken as an absolute percentage of the screen, not
25229 of the space remaining after allocating the first four columns.  It
25230 doesn't usually make sense to do it that way.  If you leave off all
25231 the widths, then the subject and from fields (if both are present) are
25232 allocated space in a 2 to 1 ratio, which is almost exactly the same as
25233 the default.
25234
25235 <P>
25236 What you are most likely to do with this configuration option is to
25237 specify which fields appear at all, which order they appear in, and the
25238 percentage of screen that is used for the from and subject fields if you
25239 don't like the 2 to 1 default.
25240
25241 <P>
25242 If you want to retain the default format that Pine 4.64 had, use
25243
25244 <P>
25245 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
25246 <P>
25247 <EM>and</EM> set the feature
25248 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
25249 <UL>
25250 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25251 </UL><P>
25252 &lt;End of help on this topic&gt;
25253 </BODY>
25254 </HTML>
25255 ====== h_config_reply_intro =====
25256 <HTML>
25257 <HEAD>
25258 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
25259 </HEAD>
25260 <BODY>
25261 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
25262
25263 This option is used to customize the content of the introduction line
25264 that is included when replying to a message and including the original
25265 message in the reply.
25266 The normal default (what you will get if you delete this variable) looks
25267 something like:
25268 <P>
25269 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
25270 <P>
25271 where the day of the week is only included if it is available in the
25272 original message.
25273 You can replace this default with text of your own.
25274 The text may contain tokens that are replaced with text
25275 that depends on the message you are replying to.
25276 For example, the default is equivalent to:
25277 <P>
25278 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25279 <P>
25280
25281 Since this variable includes regular text mixed with special tokens
25282 the tokens have to be surrounded by underscore characters.
25283 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
25284 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
25285 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
25286 <P>
25287 The list of available tokens is
25288 <A HREF="h_index_tokens">here</A>.
25289
25290 <P>
25291 By default, the text is all on a single line and is followed by a blank line.
25292 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
25293 than 80 characters when replying to a particular message, it is shortened.
25294 However, if you use the token
25295 <P>
25296 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
25297 <P>
25298
25299 anywhere in the value, no end of line or blank line is appended, and no
25300 shortening is done.
25301 The _NEWLINE_ token may be used to get rid of the blank line following
25302 the text, to add more blank lines, or to form a multi-line
25303 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25304 To clarify how _NEWLINE_ works recall that the default value is:
25305 <P>
25306 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25307 <P>
25308
25309 That is equivalent to
25310 <P>
25311 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
25312 <P>
25313
25314 In the former case, two newlines are added automatically because
25315 no _NEWLINE_ token appears in the value of the option (for backwards
25316 compatibility). In the latter case, the newlines are explicit.
25317 If you want to remove the blank line that follows the
25318 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
25319 _NEWLINE_ token like
25320 <P>
25321 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
25322 <P>
25323
25324 Because of the backwards compatibility problem, it is not possible to
25325 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
25326 and that will cause the automatic adding of two newlines!
25327 If you want, you may embed newlines in the middle of the text, as well,
25328 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25329
25330 <P>
25331 By default, no attempt is made to localize the date.
25332 If you prefer a localized form you may find that one of the tokens
25333 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
25334 If you want more control one of the many other date tokens, such as _DATEISO_,
25335 might be better.
25336
25337 <P>
25338 For the adventurous, there is a way to conditionally include text based
25339 on whether or not a token would result in specific replacement text.
25340 For example, you could include some text based on whether or not
25341 the _NEWS_ token would result in any newsgroups if it was used.
25342 It's explained in detail
25343 <A HREF="h_reply_token_conditionals">here</A>.
25344
25345 <P>
25346 In the very unlikely event that you want to include a literal token
25347 in the introduction line you must precede it with a backslash character.
25348 For example,
25349 <P>
25350 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
25351 <P>
25352 would produce something like
25353 <P>
25354 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
25355 <P>
25356 It is not possible to have a literal backslash followed by an expanded token.
25357 <P>
25358 <UL>
25359 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25360 </UL><P>
25361 &lt;End of help on this topic&gt;
25362 </BODY>
25363 </HTML>
25364 ====== h_config_remote_abook_history =====
25365 <HTML>
25366 <HEAD>
25367 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
25368 </HEAD>
25369 <BODY>
25370 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
25371
25372 Sets how many extra copies of
25373 remote address book
25374 data will be kept in each remote address book folder.
25375 The default is three.
25376 These extra copies are simply old versions of the data. Each time a change
25377 is made a new copy of the address book data is appended to the folder. Old
25378 copies are trimmed, if possible, when Alpine exits.
25379 An old copy can be put back into use by
25380 deleting and expunging newer versions of the data from the folder.
25381 Don't delete the first message from the folder. It is a special header
25382 message for the remote address book and it must be there.
25383 This is to prevent regular folders from being used as remote address book
25384 folders and having their data destroyed.
25385 <P>
25386 This option is also used to determine how many extra copies of remote
25387 Alpine configuration files are kept.
25388 <P>
25389 <UL>
25390 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25391 </UL><P>
25392 &lt;End of help on this topic&gt;
25393 </BODY>
25394 </HTML>
25395 ====== h_config_remote_abook_validity =====
25396 <HTML>
25397 <HEAD>
25398 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
25399 </HEAD>
25400 <BODY>
25401 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
25402
25403 Sets the minimum number of minutes that a
25404 remote address book will be considered up to date.
25405 Whenever an entry contained in a remote address book is used,
25406 if more than this many minutes have
25407 passed since the last check the remote server will be queried to see if the
25408 address book has changed.
25409 If it has changed, the local copy is updated.
25410 The default value is five minutes.
25411 The special value of -1 means never check.
25412 The special value of zero means only check when the address book is first
25413 opened.
25414 <P>
25415 No matter what the value, the validity check is always done when the
25416 address book is about to be changed by the user.
25417 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
25418 while in the address book maintenance screen for the remote address book.
25419 <P>
25420 <UL>
25421 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25422 </UL><P>
25423 &lt;End of help on this topic&gt;
25424 </BODY>
25425 </HTML>
25426 ====== h_config_user_input_timeo =====
25427 <HTML>
25428 <HEAD>
25429 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
25430 </HEAD>
25431 <BODY>
25432 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
25433
25434 If this is set to an integer greater than zero, then this is the number
25435 of <EM>hours</EM> to wait for user input before Alpine times out.
25436 If Alpine is
25437 in the midst of composing a message or is waiting for user response to
25438 a question, then it will not timeout.
25439 However, if Alpine is sitting idle waiting for
25440 the user to tell it what to do next and the user does not give any
25441 input for this many hours, Alpine will exit.
25442 No expunging or moving of read
25443 messages will take place.
25444 It will exit similarly to the way it would exit
25445 if it received a hangup signal.
25446 This may be useful for cleaning up unused Alpine sessions that have been
25447 forgotten by their owners.
25448 The Alpine developers envision system administrators
25449 setting this to a value of several hours (24?) so that it won't surprise
25450 a user who didn't want to be disconnected.
25451 <P>
25452 <UL>
25453 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25454 </UL><P>
25455 &lt;End of help on this topic&gt;
25456 </BODY>
25457 </HTML>
25458 ====== h_config_ssh_open_timeo =====
25459 <HTML>
25460 <HEAD>
25461 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
25462 </HEAD>
25463 <BODY>
25464 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
25465
25466 Sets the time in seconds that Alpine will
25467 attempt to open a UNIX secure shell connection.
25468 The default is 15, the minimum non-zero value is 5,
25469 and the maximum is unlimited. If this is set to zero ssh connections
25470 will be completely disabled.
25471 <P>
25472 <UL>
25473 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25474 </UL><P>
25475 &lt;End of help on this topic&gt;
25476 </BODY>
25477 </HTML>
25478 ====== h_config_rsh_open_timeo =====
25479 <HTML>
25480 <HEAD>
25481 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
25482 </HEAD>
25483 <BODY>
25484 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
25485
25486 Sets the time in seconds that Alpine will
25487 attempt to open a UNIX remote shell connection.
25488 The default is 15, the minimum non-zero value is 5,
25489 and the maximum is unlimited. If this is set to zero rsh connections
25490 will be completely disabled.
25491 This might be useful if rsh connections will never work in your environment
25492 but are causing delays due to firewalls or some other reason.
25493 <P>
25494 <UL>
25495 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25496 </UL><P>
25497 &lt;End of help on this topic&gt;
25498 </BODY>
25499 </HTML>
25500 ====== h_config_tcp_open_timeo =====
25501 <HTML>
25502 <HEAD>
25503 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
25504 </HEAD>
25505 <BODY>
25506 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
25507
25508 Sets the time in seconds that Alpine will
25509 attempt to open a network connection. The default is 30, the minimum is 5,
25510 and the maximum is system defined (typically 75). If a connection has not
25511 completed within this many seconds Alpine will give up and consider it a
25512 failed connection.
25513 <P>
25514 <UL>
25515 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25516 </UL><P>
25517 &lt;End of help on this topic&gt;
25518 </BODY>
25519 </HTML>
25520 ====== h_config_tcp_readwarn_timeo =====
25521 <HTML>
25522 <HEAD>
25523 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
25524 </HEAD>
25525 <BODY>
25526 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
25527
25528 Sets the time in seconds that Alpine will
25529 wait for a network read before warning you that things are moving slowly
25530 and possibly giving you the option to break the connection.
25531 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
25532 1000 seconds.
25533 <P>
25534 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
25535 <P>
25536 <UL>
25537 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25538 </UL><P>
25539 &lt;End of help on this topic&gt;
25540 </BODY>
25541 </HTML>
25542 ====== h_config_tcp_writewarn_timeo =====
25543 <HTML>
25544 <HEAD>
25545 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
25546 </HEAD>
25547 <BODY>
25548 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
25549
25550 Sets the time in seconds that Alpine will
25551 wait for a network write before warning you that things are moving slowly
25552 and possibly giving you the option to break the connection.
25553 The default is 0 which means it is unset. If set to a non-zero value, the
25554 minimum is 5 and the maximum is 1000.
25555 <P>
25556 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
25557 <P>
25558 <UL>
25559 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25560 </UL><P>
25561 &lt;End of help on this topic&gt;
25562 </BODY>
25563 </HTML>
25564 ====== h_config_tcp_query_timeo =====
25565 <HTML>
25566 <HEAD>
25567 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
25568 </HEAD>
25569 <BODY>
25570 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
25571
25572 When Alpine times out a network read or write it will normally just display
25573 a message saying &quot;Still waiting&quot;.
25574 However, if enough time has elapsed since it started waiting it will offer
25575 to let you break the connection.
25576 That amount of time is set by this option, which defaults to 60 seconds,
25577 has a minimum of 5 seconds, and a maximum of 1000 seconds.
25578 <P>
25579 <UL>
25580 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25581 </UL><P>
25582 &lt;End of help on this topic&gt;
25583 </BODY>
25584 </HTML>
25585 ====== h_config_quit_query_timeo =====
25586 <HTML>
25587 <HEAD>
25588 <TITLE>OPTION: <!--#echo var="VAR_close-connection-timeout"--></TITLE>
25589 </HEAD>
25590 <BODY>
25591 <H1>OPTION: <!--#echo var="VAR_close-connection-timeout"--></H1>
25592
25593 The original purpose of this option was to close a connection after this
25594 much time has elapsed without response from the server. The problem this
25595 generates is that a server might not reply on time due to a slow operation
25596 (for example, sorting a large folder, or filtering messages, etc.) In those
25597 situations it is desirable to wait for the server, even when this takes
25598 a long time.
25599
25600 <P>
25601 In order to have a good compromise so that a user can distinguish between
25602 when a connection is closed, therefore
25603 we do not need to wait for it, and the operation that the user is waiting
25604 for takes a long time, this option only applies to the
25605 &quot;NOOP&quot; IMAP command. So, if a NOOP command has been issued,
25606 and the connection does not return after the number of seconds configured
25607 here, which must be at least the amount configured in the option
25608 <a href="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></a>,
25609 then Alpine will close the connection.
25610
25611 <P>
25612 Closing connections that have connectivity problems is a good idea. In an ideal
25613 world, one would like all connections to be fast and reliable, so the amount
25614 of time and effort put into parsing a folder to report its state when it is
25615 opened is not wasted, so keeping connections alive is good, but the problem
25616 with this is that waiting for a user to reply to a &quot;keep connection
25617 alive?&quot; question can take a long time, and that might affect other
25618 connections that could be closed because Alpine is not pinging them while it
25619 is waiting for a reply from a user for a different connection. Therefore
25620 setting this value helps to keep other connections alive, in case
25621 you have several incoming folders in other servers.
25622
25623 <P>
25624 The default value for this option is 0, which means that no connections will
25625 be closed automatically, so if you want connections to be closed automatically
25626 you must set this option to a positive number bigger or equal than the
25627 value of the option <!--#echo var="VAR_tcp-query-timeout"-->.
25628 <P>
25629 <UL>
25630 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25631 </UL><P>
25632 &lt;End of help on this topic&gt;
25633 </BODY>
25634 </HTML>
25635 ====== h_config_incoming_folders =====
25636 <HTML>
25637 <HEAD>
25638 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
25639 </HEAD>
25640 <BODY>
25641 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
25642
25643 This is a list of one or more folders other than <EM>INBOX</EM> that
25644 may receive new messages.
25645 It is related to the
25646 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
25647 feature.
25648 This variable is normally manipulated with the Add, Delete, and Rename
25649 commands in the FOLDER LIST for the Incoming Message Folders collection.
25650 <P>
25651 <UL>
25652 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25653 </UL><P>
25654 &lt;End of help on this topic&gt;
25655 </BODY>
25656 </HTML>
25657 ====== h_config_folder_spec =====
25658 <HTML>
25659 <HEAD>
25660 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
25661 </HEAD>
25662 <BODY>
25663 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
25664
25665 This is a list of one or more collections where saved mail is stored.
25666 The first collection in this list is the default
25667 collection for <EM>Save</EM>s,
25668 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
25669 <P>
25670 This variable is normally manipulated using the Setup/collectionList screen.
25671 <P>
25672 <UL>
25673 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25674 </UL><P>
25675 &lt;End of help on this topic&gt;
25676 </BODY>
25677 </HTML>
25678 ====== h_config_news_spec =====
25679 <HTML>
25680 <HEAD>
25681 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
25682 </HEAD>
25683 <BODY>
25684 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
25685
25686 This is a list of collections where news folders are located.
25687 <P>
25688 This variable is normally manipulated using the Setup/collectionList screen.
25689 <P>
25690 <UL>
25691 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25692 </UL><P>
25693 &lt;End of help on this topic&gt;
25694 </BODY>
25695 </HTML>
25696 ====== h_config_address_book =====
25697 <HTML>
25698 <HEAD>
25699 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
25700 </HEAD>
25701 <BODY>
25702 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
25703
25704 A list of personal address books.
25705 Each entry in the list is an
25706 optional nickname followed by a pathname or file name relative to the home
25707 directory.
25708 The nickname is separated from the rest of the line with whitespace.
25709 Instead of a local pathname or file name, a remote folder name can be given.
25710 This causes the address book to
25711 be a Remote address book.
25712 <P>
25713 Use the Setup/AddressBook screen to modify this variable.
25714 <P>
25715 <UL>
25716 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25717 </UL><P>
25718 &lt;End of help on this topic&gt;
25719 </BODY>
25720 </HTML>
25721 ====== h_config_glob_addrbook =====
25722 <HTML>
25723 <HEAD>
25724 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
25725 </HEAD>
25726 <BODY>
25727 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
25728
25729 A list of shared address books.  Each entry in the list is an
25730 optional nickname followed by a pathname or file name relative to the home
25731 directory.
25732 A SPACE character separates the nickname from the rest of the line.
25733 Instead of a local pathname or file name, a remote folder name can be given.
25734 This causes the address book to
25735 be a Remote address book.
25736 Global address books are
25737 defined to be ReadOnly.
25738 <P>
25739 Use the Setup/AddressBook screen to modify this variable.
25740 <P>
25741 <UL>
25742 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25743 </UL><P>
25744 &lt;End of help on this topic&gt;
25745 </BODY>
25746 </HTML>
25747 ====== h_config_last_vers =====
25748 <HTML>
25749 <HEAD>
25750 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
25751 </HEAD>
25752 <BODY>
25753 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
25754
25755 This is set automatically by Alpine.
25756 It is used to keep track of the last version of Alpine that
25757 was run by the user.
25758 Whenever the version number increases, a new version message is printed out.
25759 This may not be set in the system-wide configuration files.
25760 <P>
25761 <UL>
25762 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25763 </UL><P>
25764 &lt;End of help on this topic&gt;
25765 </BODY>
25766 </HTML>
25767 ====== h_config_printer =====
25768 <HTML>
25769 <HEAD>
25770 <TITLE>OPTION: Printer</TITLE>
25771 </HEAD>
25772 <BODY>
25773 <H1>OPTION: Printer</H1>
25774
25775 Your default printer selection.
25776 <P>
25777 Use the Setup/Printer screen to modify this variable.
25778 <P>
25779 <UL>
25780 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25781 </UL><P>
25782 &lt;End of help on this topic&gt;
25783 </BODY>
25784 </HTML>
25785 ====== h_config_print_cat =====
25786 <HTML>
25787 <HEAD>
25788 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
25789 </HEAD>
25790 <BODY>
25791 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
25792
25793 This is an internal Alpine variable.
25794 It will be equal to 1, 2, or 3 depending on whether the default printer is
25795 attached, standard, or a personal print command.
25796 <P>
25797 Use the Setup/Printer screen to modify this variable.
25798 <P>
25799 <UL>
25800 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25801 </UL><P>
25802 &lt;End of help on this topic&gt;
25803 </BODY>
25804 </HTML>
25805 ====== h_config_print_command =====
25806 <HTML>
25807 <HEAD>
25808 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
25809 </HEAD>
25810 <BODY>
25811 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
25812
25813 List of personal print commands.
25814 <P>
25815 Use the Setup/Printer screen to modify this variable.
25816 <P>
25817 <UL>
25818 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25819 </UL><P>
25820 &lt;End of help on this topic&gt;
25821 </BODY>
25822 </HTML>
25823 ====== h_config_pat_old =====
25824 <HTML>
25825 <HEAD>
25826 <TITLE>OPTION: Patterns</TITLE>
25827 </HEAD>
25828 <BODY>
25829 <H1>OPTION: Patterns</H1>
25830
25831 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
25832 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
25833 and Patterns-Other.
25834 Patterns-Scores and Patterns-Filters have been replaced since then by
25835 Patterns-Scores2 and Patterns-Filters2.
25836 <P>
25837 Use the Setup/Rules screens to modify these variable.
25838 <P>
25839 <UL>
25840 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25841 </UL><P>
25842 &lt;End of help on this topic&gt;
25843 </BODY>
25844 </HTML>
25845 ====== h_config_pat_roles =====
25846 <HTML>
25847 <HEAD>
25848 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
25849 </HEAD>
25850 <BODY>
25851 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
25852
25853 List of rules used for roles.
25854 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
25855 other options.
25856 <P>
25857 Use the Setup/Rules/Roles screen to modify this variable.
25858 <P>
25859 <UL>
25860 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25861 </UL><P>
25862 &lt;End of help on this topic&gt;
25863 </BODY>
25864 </HTML>
25865 ====== h_config_pat_filts =====
25866 <HTML>
25867 <HEAD>
25868 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
25869 </HEAD>
25870 <BODY>
25871 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
25872
25873 List of rules used for filters.
25874 <P>
25875 Use the Setup/Rules/Filters screen to modify this variable.
25876 <P>
25877 <UL>
25878 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25879 </UL><P>
25880 &lt;End of help on this topic&gt;
25881 </BODY>
25882 </HTML>
25883 ====== h_config_pat_scores =====
25884 <HTML>
25885 <HEAD>
25886 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
25887 </HEAD>
25888 <BODY>
25889 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
25890
25891 List of rules used for scoring.
25892 <P>
25893 Use the Setup/Rules/SetScores screen to modify this variable.
25894 <P>
25895 <UL>
25896 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25897 </UL><P>
25898 &lt;End of help on this topic&gt;
25899 </BODY>
25900 </HTML>
25901 ====== h_config_pat_other =====
25902 <HTML>
25903 <HEAD>
25904 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
25905 </HEAD>
25906 <BODY>
25907 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
25908
25909 List of rules used for miscellaneous configuration.
25910 <P>
25911 Use the Setup/Rules/Other screen to modify this variable.
25912 <P>
25913 <UL>
25914 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25915 </UL><P>
25916 &lt;End of help on this topic&gt;
25917 </BODY>
25918 </HTML>
25919 ====== h_config_pat_incols =====
25920 <HTML>
25921 <HEAD>
25922 <TITLE>OPTION: patterns-indexcolors</TITLE>
25923 </HEAD>
25924 <BODY>
25925 <H1>OPTION: patterns-indexcolors</H1>
25926
25927 List of rules used for coloring lines in the index.
25928 <P>
25929 Use the Setup/Rules/Indexcolor screen to modify this variable.
25930 <P>
25931 <UL>
25932 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25933 </UL><P>
25934 &lt;End of help on this topic&gt;
25935 </BODY>
25936 </HTML>
25937 ====== h_config_pat_srch =====
25938 <HTML>
25939 <HEAD>
25940 <TITLE>OPTION: patterns-search</TITLE>
25941 </HEAD>
25942 <BODY>
25943 <H1>OPTION: patterns-search</H1>
25944
25945 List of rules used only for searching with the Select command in the MESSAGE INDEX.
25946 <P>
25947 Use the Setup/Rules/searCh screen to modify this variable.
25948 <P>
25949 <UL>
25950 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25951 </UL><P>
25952 &lt;End of help on this topic&gt;
25953 </BODY>
25954 </HTML>
25955 ====== h_config_font_name =====
25956 <HTML>
25957 <HEAD>
25958 <TITLE>OPTION: Font Name</TITLE>
25959 </HEAD>
25960 <BODY>
25961 <H1>OPTION: Font Name</H1>
25962
25963 PC-Alpine only.
25964 <P>
25965 Name of normal font.
25966 <P>
25967 Use the pulldown Config menu to modify this variable.
25968 <P>
25969 <UL>
25970 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25971 </UL><P>
25972 &lt;End of help on this topic&gt;
25973 </BODY>
25974 </HTML>
25975 ====== h_config_font_size =====
25976 <HTML>
25977 <HEAD>
25978 <TITLE>OPTION: Font Size</TITLE>
25979 </HEAD>
25980 <BODY>
25981 <H1>OPTION: Font Size</H1>
25982
25983 PC-Alpine only.
25984 <P>
25985 Size of normal font.
25986 <P>
25987 Use the pulldown Config menu to modify this variable.
25988 <P>
25989 <UL>
25990 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25991 </UL><P>
25992 &lt;End of help on this topic&gt;
25993 </BODY>
25994 </HTML>
25995 ====== h_config_font_style =====
25996 <HTML>
25997 <HEAD>
25998 <TITLE>OPTION: Font Style</TITLE>
25999 </HEAD>
26000 <BODY>
26001 <H1>OPTION: Font Style</H1>
26002
26003 PC-Alpine only.
26004 <P>
26005 Style of normal font.
26006 <P>
26007 Use the pulldown Config menu to modify this variable.
26008 <P>
26009 <UL>
26010 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26011 </UL><P>
26012 &lt;End of help on this topic&gt;
26013 </BODY>
26014 </HTML>
26015 ====== h_config_font_char_set =====
26016 <HTML>
26017 <HEAD>
26018 <TITLE>OPTION: Font Character Set</TITLE>
26019 </HEAD>
26020 <BODY>
26021 <H1>OPTION: Font Character Set</H1>
26022
26023 PC-Alpine only.
26024 <P>
26025 Character set of normal font.
26026 <P>
26027 Use the pulldown Config menu to modify this variable.
26028 <P>
26029 <UL>
26030 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26031 </UL><P>
26032 &lt;End of help on this topic&gt;
26033 </BODY>
26034 </HTML>
26035 ====== h_config_print_font_name =====
26036 <HTML>
26037 <HEAD>
26038 <TITLE>OPTION: Print-Font-Name</TITLE>
26039 </HEAD>
26040 <BODY>
26041 <H1>OPTION: Print-Font-Name</H1>
26042
26043 PC-Alpine only.
26044 <P>
26045 Name of printer font.
26046 <P>
26047 Use the pulldown Config menu to modify this variable.
26048 <P>
26049 <UL>
26050 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26051 </UL><P>
26052 &lt;End of help on this topic&gt;
26053 </BODY>
26054 </HTML>
26055 ====== h_config_print_font_size =====
26056 <HTML>
26057 <HEAD>
26058 <TITLE>OPTION: Print-Font-Size</TITLE>
26059 </HEAD>
26060 <BODY>
26061 <H1>OPTION: Print-Font-Size</H1>
26062
26063 PC-Alpine only.
26064 <P>
26065 Size of printer font.
26066 <P>
26067 Use the pulldown Config menu to modify this variable.
26068 <P>
26069 <UL>
26070 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26071 </UL><P>
26072 &lt;End of help on this topic&gt;
26073 </BODY>
26074 </HTML>
26075 ====== h_config_print_font_style =====
26076 <HTML>
26077 <HEAD>
26078 <TITLE>OPTION: Print-Font-Style</TITLE>
26079 </HEAD>
26080 <BODY>
26081 <H1>OPTION: Print-Font-Style</H1>
26082
26083 PC-Alpine only.
26084 <P>
26085 Style of printer font.
26086 <P>
26087 Use the pulldown Config menu to modify this variable.
26088 <P>
26089 <UL>
26090 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26091 </UL><P>
26092 &lt;End of help on this topic&gt;
26093 </BODY>
26094 </HTML>
26095 ====== h_config_print_font_char_set =====
26096 <HTML>
26097 <HEAD>
26098 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
26099 </HEAD>
26100 <BODY>
26101 <H1>OPTION: Print-Font-Char-Set</H1>
26102
26103 PC-Alpine only.
26104 <P>
26105 Character set of printer font.
26106 <P>
26107 Use the pulldown Config menu to modify this variable.
26108 <P>
26109 <UL>
26110 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26111 </UL><P>
26112 &lt;End of help on this topic&gt;
26113 </BODY>
26114 </HTML>
26115 ====== h_config_window_position =====
26116 <HTML>
26117 <HEAD>
26118 <TITLE>OPTION: Window-Position</TITLE>
26119 </HEAD>
26120 <BODY>
26121 <H1>OPTION: Window-Position</H1>
26122
26123 PC-Alpine only.
26124 <P>
26125 Position on the screen of the Alpine window.
26126 <P>
26127 Alpine normally maintains this variable itself, and it is set automatically.
26128 This variable is provided to those who wish to use the same window position
26129 across different machines from the same configuration.
26130 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
26131 must also be set for this setting to be used.
26132 <P>
26133 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
26134 C is the number of columns, R is the number of rows, and X and Y specify the
26135 top left corner of the window.
26136 <P>
26137 <UL>
26138 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26139 </UL><P>
26140 &lt;End of help on this topic&gt;
26141 </BODY>
26142 </HTML>
26143 ====== h_config_cursor_style =====
26144 <HTML>
26145 <HEAD>
26146 <TITLE>OPTION: Cursor Style</TITLE>
26147 </HEAD>
26148 <BODY>
26149 <H1>OPTION: Cursor Style</H1>
26150
26151 PC-Alpine only.
26152 <P>
26153 Cursor style.
26154 <P>
26155 Use the pulldown Config menu to modify this variable.
26156 <P>
26157 <UL>
26158 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26159 </UL><P>
26160 &lt;End of help on this topic&gt;
26161 </BODY>
26162 </HTML>
26163 ====== h_config_ldap_servers =====
26164 <HTML>
26165 <HEAD>
26166 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
26167 </HEAD>
26168 <BODY>
26169 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
26170
26171 List of LDAP servers and associated data.
26172 <P>
26173 Use the Setup/Directory screen to modify this variable.
26174 <P>
26175 <UL>
26176 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26177 </UL><P>
26178 &lt;End of help on this topic&gt;
26179 </BODY>
26180 </HTML>
26181 ====== h_config_sendmail_path =====
26182 <HTML>
26183 <HEAD>
26184 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
26185 </HEAD>
26186 <BODY>
26187 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
26188
26189 This names the path to an
26190 alternative program, and any necessary arguments, to be used in posting
26191 mail messages. See the Technical notes for more information.
26192 <P>
26193 <UL>
26194 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26195 </UL><P>
26196 &lt;End of help on this topic&gt;
26197 </BODY>
26198 </HTML>
26199 ====== h_config_oper_dir =====
26200 <HTML>
26201 <HEAD>
26202 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
26203 </HEAD>
26204 <BODY>
26205 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
26206
26207 This names the root of the
26208 tree to which you are restricted when reading and writing folders and
26209 files. It is usually used in the system-wide,
26210 <EM>fixed</EM> configuration file.
26211 <P>
26212 <UL>
26213 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26214 </UL><P>
26215 &lt;End of help on this topic&gt;
26216 </BODY>
26217 </HTML>
26218 ====== h_config_rshpath =====
26219 <HTML>
26220 <HEAD>
26221 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
26222 </HEAD>
26223 <BODY>
26224 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
26225
26226 Sets the name of the command used to open a UNIX remote shell
26227 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
26228 <P>
26229 <UL>
26230 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26231 </UL><P>
26232 &lt;End of help on this topic&gt;
26233 </BODY>
26234 </HTML>
26235 ====== h_config_rshcmd =====
26236 <HTML>
26237 <HEAD>
26238 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
26239 </HEAD>
26240 <BODY>
26241 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
26242
26243 Sets the format of the command used to
26244 open a UNIX remote shell connection. The default is
26245 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26246 provided command. The first is for the command's pathname, the second is
26247 for the host to connect to, the third is for the user to connect as, and
26248 the fourth is for the connection method (typically <CODE>imap</CODE>).
26249 <P>
26250 <UL>
26251 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26252 </UL><P>
26253 &lt;End of help on this topic&gt;
26254 </BODY>
26255 </HTML>
26256 ====== h_config_sshpath =====
26257 <HTML>
26258 <HEAD>
26259 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
26260 </HEAD>
26261 <BODY>
26262 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
26263
26264 Sets the name of the command used to open a UNIX secure shell
26265 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
26266 <P>
26267 <UL>
26268 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26269 </UL><P>
26270 &lt;End of help on this topic&gt;
26271 </BODY>
26272 </HTML>
26273 ====== h_config_sshcmd =====
26274 <HTML>
26275 <HEAD>
26276 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
26277 </HEAD>
26278 <BODY>
26279 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
26280
26281 Sets the format of the command used to
26282 open a UNIX secure shell connection. The default is
26283 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26284 provided command. The first is for the command's pathname, the second is
26285 for the host to connect to, the third is for the user to connect as, and
26286 the fourth is for the connection method (typically <CODE>imap</CODE>).
26287 <P>
26288 <UL>
26289 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26290 </UL><P>
26291 &lt;End of help on this topic&gt;
26292 </BODY>
26293 </HTML>
26294 ====== h_config_new_ver_quell =====
26295 <HTML>
26296 <HEAD>
26297 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
26298 </HEAD>
26299 <BODY>
26300 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
26301
26302 When a new version of Alpine is run for the first time it offers a
26303 special explanatory screen to the user upon startup.  This option
26304 helps control when and if that special screen appears for users that
26305 have previously run Alpine.  It takes as its value an Alpine version
26306 number.  Alpine versions less than the specified value will suppress this
26307 special screen while versions equal to or greater than that specified
26308 will behave normally.
26309 <P>
26310 <UL>
26311 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26312 </UL><P>
26313 &lt;End of help on this topic&gt;
26314 </BODY>
26315 </HTML>
26316 ====== h_config_disable_drivers =====
26317 <HTML>
26318 <HEAD>
26319 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
26320 </HEAD>
26321 <BODY>
26322 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
26323
26324 This variable is a list of mail drivers that will be disabled.
26325 The candidates for disabling are listed below.
26326 There may be more in the future if you compile Alpine with
26327 a newer version of the c-client library.
26328 <P>
26329
26330 <UL>
26331 <LI> mbox
26332 <LI> mbx
26333 <LI> mh
26334 <LI> mmdf
26335 <LI> mtx
26336 <LI> mx
26337 <LI> news
26338 <LI> phile
26339 <LI> tenex
26340 <LI> unix
26341 </UL>
26342 <P>
26343
26344 The <EM>mbox</EM> driver enables the following behavior: if there is a
26345 file called <CODE>mbox</CODE>
26346 in your home directory, and if that file is either empty or in Unix mailbox
26347 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
26348 will automatically transfer mail from the system mail spool directory into the
26349 <CODE>mbox</CODE> file and
26350 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
26351 this will not happen.
26352 <P>
26353
26354 It is not recommended to disable the driver that supports the system default
26355 mailbox format. On most non-SCO systems, that driver is the
26356 <EM>unix</EM> driver.
26357 On most SCO systems, it is the <EM>mmdf</EM> driver.
26358 The system default driver may be
26359 configured to something else on your system; check with your system manager
26360 for additional information.
26361 <P>
26362
26363 It is most likely not very useful for you to disable any of the drivers other
26364 than possibly <EM>mbox</EM>.
26365 You could disable some of the others if you know for
26366 certain that you don't need them but the performance gain in doing so
26367 is very modest.
26368 <P>
26369 <UL>
26370 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26371 </UL><P>
26372 &lt;End of help on this topic&gt;
26373 </BODY>
26374 </HTML>
26375 ====== h_config_disable_auths =====
26376 <HTML>
26377 <HEAD>
26378 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
26379 </HEAD>
26380 <BODY>
26381 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
26382
26383 This variable is a list of SASL (Simple Authentication and Security
26384 Layer) authenticators that will be disabled.
26385 SASL is a mechanism for
26386 authenticating to IMAP, POP3, SMTP, and other network servers.
26387 <P>
26388
26389 Alpine matches its list of supported authenticators with the server to
26390 determine the most secure authenticator that is supported by both.
26391 If no matching authenticators are found, Alpine will revert to plaintext
26392 login (or, in the case of SMTP, will be unable to authenticate at all).
26393 <P>
26394 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
26395 <P>
26396
26397 Normally, you will not disable any authenticators.
26398 There are two exceptions:
26399 <P>
26400 <OL>
26401 <LI> You use a broken server that advertises an authenticator,
26402 but does not actually implement it.
26403 <LI> You have a Kerberos-capable version of Alpine and the server is
26404 also Kerberos-capable, but you can not obtain Kerberos
26405 credentials on the server machine, thus you desire to disable
26406 GSSAPI (which in turn disables Alpine's Kerberos support).
26407 </OL>
26408 <P>
26409 It is never necessary to disable authenticators, since Alpine will try
26410 other authenticators before giving up.
26411 However, disabling the relevant authenticator avoids annoying error messages.
26412 <P>
26413 <UL>
26414 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26415 </UL><P>
26416 &lt;End of help on this topic&gt;
26417 </BODY>
26418 </HTML>
26419 ====== h_config_encryption_range =====
26420 <HTML>
26421 <HEAD>
26422 <TITLE>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></TITLE>
26423 </HEAD>
26424 <BODY>
26425 <H1>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></H1>
26426
26427 This option sets a range of encryption protocols that can be attempted when
26428 Alpine will try to establish a secure connection using the SSL or TLS
26429 protocols.
26430
26431 <P>
26432 Before a secure connection to an external server is established, Alpine and the
26433 server will attempt to negotiate a secure connection. This part is known as the
26434 &quot;ClientHello&quot;. At that time Alpine will announce the version of
26435 encryption that it would like to establish. The server can reject that, and announce
26436 a different version of encryption. Once both the server and Alpine have found
26437 a version of encryption that they both agree on, they will both use it to start
26438 a secure connection.
26439
26440 <P>
26441 The use of the /ssl parameter in the definition of the server will make Alpine
26442 attempt the highest encryption protocol that it can use, in agreement with the
26443 server. However, using this option, you will set limits to the versions of
26444 the protocols that are used. This would, for example, allow you to disable the use
26445 of ssl3, in favor of more modern protocols.
26446
26447 <P>
26448 For purposes of this option, the protocols are sorted
26449 as follows
26450
26451 <P>
26452 <CENTER>
26453 no_min < ssl3 < tls1 < tls1_1 < tls1_2 < tls1_3 < no_max
26454 </CENTER>
26455
26456 <P>
26457 For example, if you want to disable ssl3, all you have to do is to set the minimum
26458 version to tls1, or any higher protocol.
26459
26460 <P>The name of the parameters used to configure this option is the same as the
26461 parameters that are added to the definition of a server to make it a secure
26462 connection, and they are listed above for your reference.
26463
26464 <P>
26465 The special values &quot;no_min&quot; and &quot;no_max&quot; do not set values
26466 for the minimum and maximum protocol versions, and Alpine will use the maximum
26467 and minimum values of encryption protocols built into your SSL library.
26468
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_abook_metafile =====
26477 <HTML>
26478 <HEAD>
26479 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
26480 </HEAD>
26481 <BODY>
26482 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
26483
26484 This is usually set by Alpine and is the name of a file
26485 that contains data about
26486 remote address books and remote configuration files.
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_composer_wrap_column =====
26495 <HTML>
26496 <HEAD>
26497 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
26498 </HEAD>
26499 <BODY>
26500 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
26501
26502
26503 This option specifies an aspect of Alpine's Composer.  This gives the
26504 maximum width that auto-wrapped lines will have.  It's also the maximum
26505 width of lines justified using the <A HREF="h_compose_justify">^J
26506 Justify</A> command.  The normal default
26507 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
26508 in order to
26509 prevent very long lines from being sent in outgoing mail.  When the mail
26510 is actually sent, trailing spaces will be stripped off of each line.
26511
26512 <P>
26513 <UL>
26514 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26515 </UL><P>
26516 &lt;End of help on this topic&gt;
26517 </BODY>
26518 </HTML>
26519 ====== h_config_deadlets =====
26520 <HTML>
26521 <HEAD>
26522 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
26523 </HEAD>
26524 <BODY>
26525 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
26526
26527
26528 This option affects Alpine's behavior when you cancel a message being
26529 composed.  Alpine's usual behavior is to write the canceled message to
26530 a file named
26531 <!--chtml if pinemode="os_windows"-->
26532 &quot;DEADLETR&quot;,
26533 <!--chtml else-->
26534 &quot;dead.letter&quot; in your home directory,
26535 <!--chtml endif-->
26536 overwriting any previous message.
26537 <P>
26538 If you set this option to a value higher than one, then that many copies
26539 of dead letter files will be saved.
26540 For example, if you set this option to &quot;3&quot; then you may have
26541 files named
26542 <!--chtml if pinemode="os_windows"-->
26543 &quot;DEADLETR&quot;,
26544 &quot;DEADLETR2&quot;, and
26545 &quot;DEADLETR3&quot;.
26546 <!--chtml else-->
26547 &quot;dead.letter&quot;,
26548 &quot;dead.letter2&quot;, and
26549 &quot;dead.letter3&quot; in your home directory.
26550 <!--chtml endif-->
26551 In this example, the most recently cancelled message will be in
26552 <!--chtml if pinemode="os_windows"-->
26553 &quot;DEADLETR&quot;,
26554 <!--chtml else-->
26555 &quot;dead.letter&quot;,
26556 <!--chtml endif-->
26557 and the third most recently cancelled message will be in
26558 <!--chtml if pinemode="os_windows"-->
26559 &quot;DEADLETR3&quot;.
26560 <!--chtml else-->
26561 &quot;dead.letter3&quot;.
26562 <!--chtml endif-->
26563 The fourth most recently cancelled message will no longer be saved.
26564
26565 <P>
26566 If you set this option to zero, then NO record of canceled messages is
26567 maintained.
26568 <P>
26569 If the feature
26570 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
26571 is set, that overrides whatever you set for this option.
26572 If this option had existed at the time, then the Quell feature would not
26573 have been added, but it is still there for backwards compatibility.
26574 So, in order for this option to have the desired effect, make sure the
26575 Quell feature is turned off.
26576
26577 <P>
26578 <UL>
26579 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26580 </UL><P>
26581 &lt;End of help on this topic&gt;
26582 </BODY>
26583 </HTML>
26584 ====== h_config_maxremstream =====
26585 <HTML>
26586 <HEAD>
26587 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
26588 </HEAD>
26589 <BODY>
26590 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
26591
26592 This option affects low-level behavior of Alpine.
26593 The default value for this option is <EM>3</EM>.
26594 If your INBOX is accessed using the IMAP protocol
26595 from an IMAP server, that connection is kept open throughout the
26596 duration of your Alpine session, independent of the value of this option.
26597 The same is true of any
26598 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
26599 you have defined.
26600 This option controls Alpine's behavior when connecting to remote IMAP folders
26601 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
26602 It specifies the maximum number of remote IMAP connections (other than
26603 those mentioned above) that Alpine will use for accessing the rest of your
26604 folders.
26605 If you set this option to zero, you will turn off most remote connection
26606 re-use.
26607 It's difficult to understand exactly what this option does, and it is usually
26608 fine to leave it set to its default value.
26609 It is probably more likely that you will be interested in setting the
26610 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
26611 instead of changing the value of this option.
26612 A slightly longer explanation of what is going on with this option
26613 is given in the next paragraphs.
26614
26615 <P>
26616 There are some time costs involved in opening and closing remote IMAP
26617 folders, the main costs being the time you have to wait for the connection
26618 to the server and the time for the folder to open.
26619 Opening a folder may involve not only the time the server takes to do its
26620 processing but time that Alpine uses to do filtering.
26621 These times can vary widely.
26622 They depend on how loaded the server is, how large
26623 the folder being opened is, and how you set up filtering, among other things.
26624 Once Alpine has opened a connection to a particular folder, it will attempt
26625 to keep that connection open in case you use it again.
26626 In order to do this,
26627 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
26628 this option) IMAP connections you have allotted for this purpose.
26629 <P>
26630 For example, suppose the value of this option is set to &quot;2&quot;.
26631 If your INBOX is accessed on a remote server using the IMAP protocol, that
26632 doesn't count as one of the remote connections but it is always kept open.
26633 If you then open another IMAP folder, that would be your first
26634 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
26635 If you open a third folder the second will be left open, in case you
26636 return to it.
26637 You won't be able to tell it has been left open.
26638 It will appear to be closed when you leave the folder but the connection
26639 will remain in the background.
26640 Now suppose you go back to the second folder (the first folder after the
26641 INBOX).
26642 A connection to that folder is still open so you won't have to wait
26643 for the startup time to open it.
26644 Meanwhile, the connection to the third folder will be left behind.
26645 Now, if you open a fourth folder, you will bump into the
26646 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
26647 than INBOX and you have the option set to &quot;2&quot;.
26648 The connection that is being used for
26649 the third folder will be re-used for this new fourth folder.
26650 If you go back to the third folder after this, it is no longer already
26651 connected when you get there.
26652 You'll still save some time since Alpine will re-use the connection to the
26653 fourth folder and you have already logged in on that connection,
26654 but the folder will have to be re-opened from scratch.
26655 <P>
26656 If a folder is large and the startup cost is dominated by the time it takes
26657 to open that folder or to run filters on it, then it will pay to make the
26658 value of this option large enough to keep it open.
26659 On the other hand, if you only revisit a handful of folders or if
26660 the folders are small, then it might
26661 make more sense to keep this number small so that the reconnect
26662 time (the time to start up a new connection and authenticate)
26663 is eliminated instead.
26664 <P>
26665 You may also need to consider the impact on the server.
26666 On the surface, a larger number here may cause a larger impact on the
26667 server, since you will have more connections open to the server.
26668 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
26669 associated with reopening a folder, but the <EM>server</EM> will be
26670 avoiding those costs as well.
26671 <P>
26672 When twenty five minutes pass without any active use of an IMAP connection
26673 being saved for possible re-use, that connection will be shut down,
26674
26675 <P>
26676 <UL>
26677 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26678 </UL><P>
26679 &lt;End of help on this topic&gt;
26680 </BODY>
26681 </HTML>
26682 ====== h_config_permlocked =====
26683 <HTML>
26684 <HEAD>
26685 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
26686 </HEAD>
26687 <BODY>
26688 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
26689
26690 This option affects low-level behavior of Alpine.
26691 There is no default value for this option.
26692 It is related to the options
26693 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
26694 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
26695 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
26696
26697 <P>
26698 Note: changes made to this list take effect the next time you open a
26699 folder in the list.
26700
26701 <P>
26702 This is a list of folders that will be permanently kept open once they
26703 are first opened.
26704 The names in this list may be either the nickname of an Incoming folder
26705 or the full technical specification of a folder.
26706 The folders in this list need not be remote IMAP folders, they could usefully
26707 be local folders, as well.
26708 If a folder in the list is a newsgroup or is not accessed either locally
26709 or via IMAP, then the entry will be ignored.
26710 For example, folders accessed via NNTP or POP3 will not be kept open, since
26711 the way that new mail is found with those protocols involves closing and
26712 reopening the connection.
26713 <P>
26714 Once a Stay Open folder has been opened, new-mail checking will continue
26715 to happen on that folder for the rest of the Alpine session.
26716 Your INBOX is always implicitly included in this Stay-Open list and doesn't
26717 need to be added explicitly.
26718 <P>
26719 Another difference that you may notice between a Stay Open folder and a
26720 non-Stay Open folder is which message is selected as the current message
26721 when you enter the folder index.
26722 Normally, the starting position for an incoming folder (which most Stay Open
26723 folders will likely be) is controlled by the
26724 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
26725 However, if a folder is a Stay Open folder, when you re-enter the folder
26726 after the first time the current message will be the same as it was when
26727 you left the folder.
26728 An exception is made if you use the TAB command to get to the folder.
26729 In that case, the message number will be incremented by one from what it
26730 was when you left the folder.
26731 <P>
26732 The above special behavior is thought to be useful.
26733 However, it is special and different from what you might at first expect.
26734 The feature
26735 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
26736 may be used to turn off this special treatment.
26737 <P>
26738 If the message that was current when you left the folder no longer exists,
26739 then the regular startup rule will be used instead.
26740
26741 <P>
26742 <UL>
26743 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26744 </UL><P>
26745 &lt;End of help on this topic&gt;
26746 </BODY>
26747 </HTML>
26748 ====== h_config_viewer_overlap =====
26749 <html>
26750 <header>
26751 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
26752 </header>
26753 <body>
26754 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
26755
26756 This option specifies an aspect of Alpine's Message Viewing screen.  When
26757 the space bar is used to page forward in a message, the number of lines
26758 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
26759 bottom of the screen.  That is, if this was set to two lines, then the
26760 bottom two lines of the screen would be repeated on the top of the next
26761 screen.  The normal default value is "2".<p>
26762 <UL>
26763 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26764 </UL><P>
26765 &lt;End of help on this topic&gt;
26766 </body>
26767 </html>
26768 ====== h_config_scroll_margin =====
26769 <HTML>
26770 <HEAD>
26771 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
26772 </HEAD>
26773 <BODY>
26774 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
26775
26776 This option controls when Alpine's line-by-line scrolling occurs.
26777 Typically, when a selected item is at the top or bottom screen edge
26778 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
26779 displayed items are scrolled down or up by a single line.
26780
26781 <P>
26782 This option allows you to tell Alpine the number of lines from the top and
26783 bottom screen edge that line-by-line paging should occur.  For example,
26784 setting this value to one (1) will cause Alpine to scroll the display
26785 vertically when you move to select an item on the display's top or
26786 bottom edge.
26787
26788 <P>
26789 By default, this variable is zero, indicating that scrolling happens
26790 when you move up or down to select an item immediately off the display's
26791 top or bottom edge.
26792
26793 <P>
26794 <UL>
26795 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26796 </UL><P>
26797 &lt;End of help on this topic&gt;
26798 </BODY>
26799 </HTML>
26800 ====== h_config_wordseps =====
26801 <HTML>
26802 <HEAD>
26803 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
26804 </HEAD>
26805 <BODY>
26806 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
26807
26808 This option affects how a &quot;word&quot; is defined in the composer.
26809 The definition of a word is used when using the Forward Word and Backward
26810 Word commands in the composer, as well as when using the spell checker.
26811 Whitespace is always considered a word separator.
26812 Punctuation (like question marks, periods, commas, and so on) is always
26813 a word separator if it comes at the end of a word.
26814 By default, a punctuation character that is in the middle of a word does
26815 not break up that word as long as the character before and the character
26816 after it are both alphanumeric.
26817 If you add a character to this option it will be considered a
26818 word separator even when it occurs in the middle of an alphanumeric word.
26819 For example, if you want to skip through each part of an address instead
26820 of skipping the whole address at once you might want to include &quot;@&quot;
26821 and &quot;.&quot; in this list.
26822 If you want the word-skipper to stop on each part of a UNIX filename you
26823 could add &quot;/&quot; to the list.
26824 The equal sign and dash are other possibilities you might find helpful.
26825 <P>
26826 <UL>
26827 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26828 </UL><P>
26829 &lt;End of help on this topic&gt;
26830 </BODY>
26831 </HTML>
26832 ====== h_config_reply_indent_string =====
26833 <HTML>
26834 <HEAD>
26835 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
26836 </HEAD>
26837 <BODY>
26838 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
26839
26840 This option specifies an aspect of Alpine's Reply command.
26841 When a message is replied to and the text of the message is included, the
26842 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
26843 to each line indicating it is quoted text.
26844 (In case you haven't seen this before, &quot;string&quot; is a technical term
26845 that means chunk of text.)
26846
26847 <P>
26848 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
26849 in 1999 and its wide-spread adoption since then, you will usually be better off if you
26850 use one of the standard values,
26851 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
26852
26853 <P>
26854 This option specifies a different value for that string.
26855 If you wish to use a string that begins or ends with a space,
26856 enclose the string in double quotes.
26857
26858 <P>
26859 Besides simple text, the prepended string can be based
26860 on the message being replied to.
26861 The following tokens are substituted for the message's corresponding value:
26862
26863 <DL>
26864 <DT>_FROM_</DT>
26865 <DD>This token gets replaced with the message sender's &quot;username&quot;.
26866 If the name is longer than six characters, only the first six characters are
26867 used.
26868 </DD>
26869
26870 <DT>_NICK_</DT>
26871 <DD>This token gets replaced with the nickname of the message sender's
26872 address as found in your addressbook.
26873 If no addressbook entry is found,
26874 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
26875 If the nickname is longer than six characters, only the first six characters are
26876 used.
26877 </DD>
26878
26879 <DT>_INIT_</DT>
26880 <DD>This token gets replaced with the initials of the sender of the message.
26881 </DD>
26882
26883 </DL>
26884
26885 NOTE: When the
26886 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
26887 feature is enabled, you are given the opportunity to edit the string, whether
26888 it is the default or one automatically generated using the above tokens.
26889 <P>
26890 If you change your <!--#echo var="VAR_reply-indent-string"-->
26891 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
26892 quoted text will not be flowed
26893 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
26894 when you reply.
26895 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
26896 set to the default value.
26897 <P>
26898 <UL>
26899 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26900 </UL><P>
26901 &lt;End of help on this topic&gt;
26902 </BODY>
26903 </HTML>
26904 ====== h_config_quote_replace_string =====
26905 <HTML>
26906 <HEAD>
26907 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
26908 </HEAD>
26909 <BODY>
26910 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
26911
26912 This option specifies what string to use as a quote when <b>viewing</b> a
26913 message.  The standard way of quoting messages when replying is the string
26914 &quot;&gt;&nbsp;&quot; (quote space).
26915 With this variable set, viewing a message will
26916 replace occurrences of
26917 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
26918 This setting works best when
26919 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
26920 or the equivalent setting in your correspondents' mail programs
26921 is set to the default
26922 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
26923 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
26924 <P>
26925 By default, this setting will only work on messages that are flowed, which is
26926 the default way of sending messages for many mail clients including
26927 Alpine.  Enable the feature
26928 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
26929 to also have quote-replacement performed on non-flowed messages.
26930 <P>
26931
26932 Setting this option will replace  &quot;&gt;&quot; and
26933 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
26934 spaces. To preserve those spaces enclose the full string in double quotes.
26935 <P>
26936 No padding to separate the text of the message from the quote string is
26937 added. This means that if you do not add trailing spaces to the value of
26938 this variable, text will be displayed right next to the quote string,
26939 which may be undesirable. This can be avoided by adding a new string
26940 separated by a space from your selection of quote string replacement. This
26941 last string will be used for padding. For example, setting this variable to
26942 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
26943 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
26944 a space from the last quote string to make it more readable.
26945 <P>
26946 One possible setting for this variable could be
26947 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
26948 would have the effect of indenting each level of quoting four spaces and
26949 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
26950 more discernible by setting colors for quoted text.
26951 <P>
26952 Replying to or forwarding the viewed message will preserve the original
26953 formatting of the message, so quote-replacement will not be performed on
26954 messages that are being composed.
26955 <P>
26956 <UL>
26957 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26958 </UL><P>
26959 &lt;End of help on this topic&gt;
26960 </BODY>
26961 </HTML>
26962 ====== h_config_empty_hdr_msg =====
26963 <HTML>
26964 <HEAD>
26965 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
26966 </HEAD>
26967 <BODY>
26968 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
26969
26970 When sending, if both the To and Cc fields are empty and you
26971 are sending the message to a Bcc,
26972 Alpine will put a special address in the To line.  The default value is:
26973
26974 <P>
26975 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
26976
26977 <P>
26978 The reason for this is to avoid embarrassment caused by some Internet
26979 mail transfer software that interprets a &quot;missing&quot;
26980 <SAMP>To:</SAMP> header as an error and replaces it with an
26981 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
26982 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
26983 Bcc.  You may change the part of this message that comes before the
26984 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
26985 variable to something else.
26986
26987 <P>
26988 The normal default is &quot;undisclosed-recipients&quot;.
26989
26990 <P>
26991 <UL>
26992 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26993 </UL><P>
26994 &lt;End of help on this topic&gt;
26995 </BODY>
26996 </HTML>
26997 ====== h_config_status_msg_delay =====
26998 <HTML>
26999 <HEAD>
27000 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
27001 </HEAD>
27002 <BODY>
27003 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
27004
27005 This option has evolved over time, causing the possible values to be
27006 counter-intuitive.
27007 Read carefully before you set this option.
27008 First we explain what the option does, then there is a longer discussion
27009 following that.
27010 <P>
27011 If this is set to zero, the default value, it has <EM>no</EM> effect.
27012 Positive and negative values serve two similar, but different purposes.
27013 <P>
27014 If it is set to a positive number, it causes the cursor to move to the
27015 status line whenever a status message is printed and pause there for this
27016 many seconds.
27017 It will probably only be useful if the
27018 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
27019 also turned on.
27020 Setting this option to a positive number can only be used to
27021 <EM>increase</EM> the status message delay.
27022 This may be useful for Braille displays, or other non-traditional displays.
27023 <P>
27024 If it is set to a negative number the interpretation is a bit complicated.
27025 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
27026 allow you to read important status messages.
27027 Of course, this may cause you to miss some important messages.
27028 If you see a message flash by but miss what it says you can use the
27029 Journal command from the MAIN MENU to read it.
27030 If you set this option to a negative value, the delay will be
27031 no more than one second less than the absolute value
27032 of the value you set.
27033 So if you set it to -1, the delay will be no more than zero seconds, no
27034 delay at all.
27035 If you set it to -2, the delay will be no more than 1 second.
27036 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
27037 If the delay that Alpine would have used by default is less than this delay,
27038 then the smaller delay set by Alpine will be used.
27039 Setting this option to a negative value can only reduce the amount of
27040 delay, never increase it.
27041 <P>
27042 Here is a more detailed explanation.
27043 Status messages are the messages that show up spontaneously in the
27044 status message line, usually the third line from the bottom of the screen.
27045 By default, Alpine assigns each status message it produces a minimum
27046 display time.
27047 Some status messages have a minimum display time of zero.
27048 You can see an example of such a message by paging up in this help text
27049 until you reach the top of the screen.
27050 If you try to page past the top you will see the message
27051 <P>
27052 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
27053 <P>
27054 in the status line.
27055 If there is another more important use of the status message line this message
27056 might be replaced quickly, or it even might not be shown at all.
27057 However, if there is no reason to get rid of the message, it might stay
27058 there for several seconds while you read the help.
27059 An example where it is replaced immediately happens when you page up in
27060 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
27061 command right after paging up.
27062 The message will disappear immediately without causing a delay (unless you
27063 have set this option to a positive value) to allow you to type input for
27064 the &quot;WhereIs&quot; command.
27065 Since it isn't a very important message, Alpine has set its minimum display
27066 time to zero seconds.
27067 <P>
27068 Other messages have minimum display times of three or more seconds.
27069 These are usually error messages that Alpine thinks you ought to see.
27070 For example, it might be a message about a failed Save or a failed folder open.
27071 It is often the case that this minimum display time won't delay you in
27072 any way because the status message line is not needed for another reason.
27073 However, there are times when Alpine has to delay what it is doing in
27074 order to display a status message for the minimum display time.
27075 This happens when a message is being displayed and Alpine wants to ask
27076 for input from the keyboard.
27077 For example, when you Save a message you use the status message line.
27078 You get a prompt there asking for the name of the folder to save to.
27079 If there is a status message being displayed that has not
27080 yet displayed for its minimum
27081 time Alpine will display that status message surrounded with the characters
27082 &gt; and &lt; to show you that it is delaying.
27083 That might happen, for example, if you tried to save to a folder that
27084 caused an error, then followed that immediately with another Save command.
27085 You might find yourself waiting for a status message like
27086 <P>
27087 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
27088 <P>
27089 to finish displaying for three seconds.
27090 If that is something you find happening to you frequently, you may use
27091 negative values of this option to decrease or eliminate that delay, at
27092 the risk of missing the message.
27093 <P>
27094 <UL>
27095 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27096 </UL><P>
27097 &lt;End of help on this topic&gt;
27098 </BODY>
27099 </HTML>
27100 ====== h_config_active_msg_interval =====
27101 <HTML>
27102 <HEAD>
27103 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
27104 </HEAD>
27105 <BODY>
27106 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
27107
27108 When Alpine is delayed for some reason it usually shows that
27109 something is happening with a small animated display in the status
27110 message line near the bottom of the screen.
27111 This option sets how frequently the characters (for example, a spinning bar)
27112 in the active status message lines are updated.
27113 At most, it can be set to be updated 20 times per second.
27114
27115 <P>
27116 Setting this value to zero will prevent display of the animations
27117 altogether.
27118
27119 <P>
27120 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
27121 can be used to remove the randomness from this animated display.
27122
27123 <P>
27124 <UL>
27125 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27126 </UL><P>
27127 &lt;End of help on this topic&gt;
27128 </BODY>
27129 </HTML>
27130 ====== h_config_mailchecknoncurr =====
27131 <HTML>
27132 <HEADER>
27133 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
27134 </HEADER>
27135 <BODY>
27136 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
27137
27138 This option is closely related to the
27139 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27140 option, as well as the
27141 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
27142 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
27143 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
27144 new-mail checking is disabled and this option will have no effect.
27145 <P>
27146 Normally this option is set to zero, which means that the value used will be
27147 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
27148 If you set this option to a value different from zero
27149 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
27150 then that is the check interval that will be used
27151 for folders that are not the currently open folder or the INBOX.
27152 You may not even have any folders that are noncurrent and not the INBOX.
27153 If you do, it is likely that they are due to
27154 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
27155 you have configured.
27156 This option also affects the rate of mail checking done on cached
27157 connections to folders you previously had open but are no longer actively
27158 using.
27159 You aren't expected to understand that last sentence, but if you are interested
27160 take a look at
27161 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
27162 and the related options.
27163 <P>
27164 <UL>
27165 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27166 </UL><P>
27167 &lt;End of help on this topic&gt;
27168 </BODY>
27169 </HTML>
27170 ====== h_config_fifopath =====
27171 <HTML>
27172 <HEADER>
27173 <TITLE>OPTION: NewMail FIFO Path</TITLE>
27174 </HEADER>
27175 <BODY>
27176 <H1>OPTION: NewMail FIFO Path</H1>
27177
27178 This option is only available in UNIX Alpine.
27179 However, there is a very similar feature built in to PC-Alpine.
27180 In PC-Alpine's Config menu at the top of the screen
27181 is an option called &quot;New Mail Window&quot;.
27182 <P>
27183 You may have Alpine create a FIFO special file (also called a named pipe) where
27184 it will send a one-line message each time a new message is received in
27185 the current folder, the INBOX, or any open
27186 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
27187 To protect against two different Alpines both writing to the same FIFO, Alpine
27188 will only create the FIFO and write to it if it doesn't already exist.
27189 <P>
27190 A possible way to use this option would be to have a separate window
27191 on your screen running the command
27192 <P>
27193 <CENTER><SAMP>cat filename</SAMP></CENTER>
27194 <P>
27195 where &quot;filename&quot; is the name of the file given for this option.
27196 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
27197 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
27198 You may be tempted to use &quot;tail -f filename&quot; to view the new
27199 mail log.
27200 However, the common implementations of the tail command will not do what you
27201 are hoping.
27202 <P>
27203 The width of the messages produced for the FIFO may be altered with the
27204 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
27205 <P>
27206 On some systems, fifos may only be created in a local filesystem.
27207 In other words, they may not be in NFS filesystems.
27208 This requirement is not universal.
27209 If the system you are using supports it, it should work.
27210 (It is often the case that your home directory is in an NFS filesystem.
27211 If that is the case, you might try using a file in the &quot;/tmp&quot;
27212 filesystem, which is usually a local filesystem.)
27213 Even when it is possible to use an NFS-mounted filesystem as a place to name
27214 the fifo (for example, your home directory), it will still be the case that
27215 the reader (probably the &quot;cat&quot; command) and the
27216 writer (Alpine) of the fifo must be running on the same system.
27217 <P>
27218 <UL>
27219 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27220 </UL><P>
27221 &lt;End of help on this topic&gt;
27222 </BODY>
27223 </HTML>
27224 ====== h_config_newmailwidth =====
27225 <HTML>
27226 <HEADER>
27227 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
27228 </HEADER>
27229 <BODY>
27230 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
27231
27232 For UNIX Alpine, this option is only useful if you have turned on the
27233 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
27234 That option causes new mail messages to be sent to a fifo file.
27235 Those messages will be 80 characters wide by default.
27236 You can change the width of those messages by changing this option.
27237 For example, if you are reading those messages in another window you might
27238 want to set this width to the width of that other window.
27239 <P>
27240 If you are using PC-Alpine, it has an option in the Config menu to turn
27241 on the &quot;New Mail Window&quot;.
27242 This present option also controls the width of that window.
27243 <P>
27244 <UL>
27245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27246 </UL><P>
27247 &lt;End of help on this topic&gt;
27248 </BODY>
27249 </HTML>
27250 ====== h_config_mailcheck =====
27251 <HTML>
27252 <HEADER>
27253 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
27254 </HEADER>
27255 <BODY>
27256 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
27257
27258 This option specifies, in seconds,
27259 how often Alpine will check for new mail.
27260 If set to zero, new-mail checking is disabled.
27261 (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
27262 current message is the last message of the folder.)
27263 There is a minimum value for this option, normally 15 seconds.
27264 The default value is normally 150 seconds.
27265 The higher you set this option, the easier it is on the server.
27266 <P>
27267 There are some situations where automatic new-mail checking does not work.
27268 See the discussion about new-mail checking in
27269 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
27270 <P>
27271 The new-mail checking will not happen exactly at the frequency that you specify.
27272 For example, Alpine may elect to defer a non-INBOX mail check if you
27273 are busy typing.
27274 Or, it may check more frequently than you have specified if that is
27275 thought to be necessary to keep the server from closing the connection
27276 to the folder due to inactivity.
27277 If Alpine checks for new mail as a side effect of another command, it will reset
27278 the timer, so that new-mail checking may seem to happen irregularly instead of
27279 every X seconds like clockwork.
27280 <P>
27281 If you are anxious to know about new mail as soon as possible, set the check
27282 interval low, and you'll know about the new mail by approximately
27283 that amount of time after it arrives.
27284 If you aren't so worried about knowing right away, set this option to a
27285 higher value.
27286 That will save the server some processing time and may save you some of
27287 the time you spend waiting for new-mail checks to happen if you are
27288 dealing with a slow server or slow network connection.
27289 <P>
27290 If you suspect that new-mail checking is causing slow downs for you,
27291 you may want to look into the options
27292 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
27293 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
27294 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
27295 which refine when mail checking is done.
27296 <P>
27297 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
27298 there is a minimum time
27299 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
27300 between new-mail checks.
27301 Because of this minimum you may notice that new mail does not
27302 appear promptly when you expect it.
27303 The reason for this is to protect the server from over-zealous opening and
27304 closing of the Mail Drop folder, since that is a costly operation.
27305 <P>
27306 <UL>
27307 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27308 </UL><P>
27309 &lt;End of help on this topic&gt;
27310 </BODY>
27311 </HTML>
27312 ====== h_config_quell_checks_comp =====
27313 <HTML>
27314 <HEAD>
27315 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
27316 </HEAD>
27317 <BODY>
27318 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
27319
27320 This option is closely related to the
27321 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27322 option, the
27323 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27324 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
27325 <P>
27326 If this option is set, then the normal new-mail checking that happens
27327 while you are composing will not happen for folders other than your
27328 INBOX (which depends on the setting
27329 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
27330 <P>
27331 You might want to set this option if you are experiencing delays while
27332 composing that you think might be related to the speed of the new-mail
27333 checks.
27334 <P>
27335 Even with this option turned on, an occasional new-mail check may be done
27336 in order to keep the server from killing the connection to the folder.
27337 For example, IMAP servers may remove a connection to a folder if there
27338 has been no activity on the connection for 30 minutes or more.
27339 Instead of letting that happen, Alpine will check for new mail before the
27340 30 minutes is up even though you have turned on this feature to quell
27341 those checks.
27342 <P>
27343 Besides new-mail checks, checkpoint operations on the folders
27344 will also be quelled when you set this option.
27345 The purpose of checkpointing is to write the changes to a folder out to
27346 disk periodically in order to avoid losing those changes when system or
27347 software problems occur.
27348 New-mail checking and checkpointing while you are not composing are not
27349 affected by this option.
27350
27351 <P>
27352 &lt;End of help on this topic&gt;
27353 </BODY>
27354 </HTML>
27355 ====== h_config_quell_checks_comp_inbox =====
27356 <HTML>
27357 <HEAD>
27358 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
27359 </HEAD>
27360 <BODY>
27361 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
27362
27363 This option is closely related to the
27364 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27365 option, the
27366 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27367 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
27368 <P>
27369 If this option is set, then the normal new-mail checking that happens
27370 while you are composing will not happen for your INBOX.
27371 Checking of other folders is controlled in a similar way with the
27372 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
27373 <P>
27374 You might want to set this option if you are experiencing delays while
27375 composing that you think might be related to the speed of the new-mail
27376 checks.
27377 <P>
27378 Even with this option turned on, an occasional new-mail check may be done
27379 in order to keep the server from killing the connection to the folder.
27380 For example, IMAP servers may remove a connection to a folder if there
27381 has been no activity on the connection for 30 minutes or more.
27382 Instead of letting that happen, Alpine will check for new mail before the
27383 30 minutes is up even though you have turned on this feature to quell
27384 those checks.
27385 <P>
27386 Besides new-mail checks, checkpoint operations on the INBOX
27387 will also be quelled when you set this option.
27388 The purpose of checkpointing is to write the changes to a folder out to
27389 disk periodically in order to avoid losing those changes when system or
27390 software problems occur.
27391 New-mail checking and checkpointing while you are not composing are not
27392 affected by this option.
27393 <P>
27394 &lt;End of help on this topic&gt;
27395 </BODY>
27396 </HTML>
27397 ====== h_config_maildropcheck =====
27398 <HTML>
27399 <HEADER>
27400 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
27401 </HEADER>
27402 <BODY>
27403 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
27404
27405 New-mail checking for a
27406 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
27407 mail checking for a regular folder.
27408 One of the differences is that the connection to the Mail Drop is not
27409 kept open and so the cost of checking
27410 (delay for you and additional load for the server) may be significant.
27411 Because of this additional cost we set a minimum time that
27412 must pass between checks.
27413 This minimum only applies to the automatic checking done by Alpine.
27414 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
27415 at the end of a folder index, then the check is done right away.
27416 <P>
27417 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
27418 new-mail checks.
27419 You may want to set this minimum high in order to avoid experiencing some
27420 of the delays associated with the checks.
27421 Note that the time between checks is still controlled by the regular
27422 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
27423 When Alpine is about to do an automatic check for new mail (because
27424 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
27425 new-mail check
27426 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
27427 the Mail Drop is checked for new mail as well.
27428 Therefore, it is only useful to set this option to a value that is higher
27429 than the <!--#echo var="VAR_mail-check-interval"-->.
27430 <P>
27431 If this option is set to zero, automatic Mail Drop new-mail
27432 checking is disabled.
27433 There is a minimum value, normally 60 seconds.
27434 The default value is normally 60 seconds as well.
27435 This applies to the INBOX and to the currently open folder if that is
27436 different from the INBOX.
27437
27438 <P>
27439 <UL>
27440 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27441 </UL><P>
27442 &lt;End of help on this topic&gt;
27443 </BODY>
27444 </HTML>
27445 ====== h_config_nntprange =====
27446 <HTML>
27447 <HEADER>
27448 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
27449 </HEADER>
27450 <BODY>
27451 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
27452
27453 This option applies only to newsgroups accessed using the NNTP protocol.
27454 It does not, for example,
27455 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
27456
27457 <P>
27458 When you open a connection to a News server using the NNTP protocol, you
27459 normally have access to all of the articles in each newsgroup.
27460 If a server keeps a large backlog of messages it may speed performance
27461 some to restrict attention to only the newer messages in a group.
27462 This option allows you to set how many article numbers should be checked
27463 when opening a newsgroup.
27464 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
27465 of messages you ever want to see.
27466 For example, if you only ever wanted to look at the last 500 messages in each
27467 newsgroup you could set this option to 500.
27468 In actuality, it isn't quite that.
27469 Instead, for performance reasons, it specifies the range of article
27470 numbers to be checked, beginning
27471 with the highest numbered article and going backwards from there.
27472 If there are messages that have been canceled or deleted
27473 their article numbers are still counted as part of the range.
27474 <P>
27475 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
27476 numbers
27477 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
27478 <P>
27479 to be considered when reading a newsgroup.
27480 The number of messages that show up in your index will be less than or equal
27481 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
27482
27483 <P>
27484 The purpose of this option is simply to speed up access when reading news.
27485 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
27486 numbers, and can avoid downloading any information about the ignored articles.
27487 There is a cost you pay for this speedup.
27488 That cost is that there is no way for you to see those ignored articles.
27489 The articles that come before the range you specify are invisible to you and
27490 to Alpine, as if they did not exist at all.
27491 There is no way to see those messages using, for example, an unexclude command
27492 or something similar.
27493 The only way to see those articles is to set this option high enough (or
27494 set it to zero) and then to reopen the newsgroup.
27495
27496 <P>
27497 If this option is set to 0 (which is also the default),
27498 then the range is unlimited.
27499 This option applies globally to all NNTP servers and to all newsgroups
27500 on those servers.
27501 There is no way to set different values for different newsgroups or servers.
27502
27503 <P>
27504 <UL>
27505 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27506 </UL><P>
27507 &lt;End of help on this topic&gt;
27508 </BODY>
27509 </HTML>
27510 ====== h_config_news_active =====
27511 <html>
27512 <header>
27513 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
27514 </header>
27515 <body>
27516 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
27517
27518 This option tells Alpine where to look for the "active file" for newsgroups
27519 when accessing news locally, rather than via NNTP.  The default path is
27520 usually "/usr/lib/news/active".<p>
27521 <UL>
27522 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27523 </UL><P>
27524 &lt;End of help on this topic&gt;
27525 </body>
27526 </html>
27527 ====== h_config_news_spool =====
27528 <html>
27529 <header>
27530 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
27531 </header>
27532 <body>
27533 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
27534
27535 This option tells Alpine where to look for the "news spool" for newsgroups
27536 when accessing news locally, rather than via NNTP.  The default path is
27537 usually "/var/spool/news".<p>
27538 <UL>
27539 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27540 </UL><P>
27541 &lt;End of help on this topic&gt;
27542 </body>
27543 </html>
27544 ====== h_config_image_viewer =====
27545 <html>
27546 <header>
27547 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
27548 </header>
27549 <body>
27550 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
27551 <body>
27552 This option specifies the program Alpine should call to view MIME
27553 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
27554 no longer needed, but remains for backward compatibility.  The more
27555 general method for associating external printing and viewing programs with
27556 specific MIME data types is to use the system's (or your personal)
27557 "mailcap" configuration file.<p>
27558 <UL>
27559 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27560 </UL><P>
27561 &lt;End of help on this topic&gt;
27562 </body>
27563 </html>
27564 ====== h_config_domain_name =====
27565 <HTML>
27566 <HEAD>
27567 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
27568 </HEAD>
27569 <BODY>
27570 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
27571
27572 This option is used only if the
27573 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
27574 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
27575 strips the hostname from your return (&quot;From&quot;) address and when
27576 completing unqualified addresses that you enter into the composer.
27577 <P>
27578 If you set this, see also the <A HREF="h_config_quell_local_lookup">
27579 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
27580
27581
27582 <!--chtml if pinemode="os_windows"-->
27583 <P>This option is not applicable to PC-Alpine.
27584 <!--chtml else-->
27585 <P>
27586 <!--chtml endif-->
27587 <UL>
27588 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27589 </UL>
27590 <P>
27591 &lt;End of help on this topic&gt;
27592 </BODY>
27593 </HTML>
27594 ====== h_config_prune_date =====
27595 <HTML>
27596 <HEAD>
27597 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
27598 </HEAD>
27599 <BODY>
27600 <H1>OPTION: Last-Time-Prune Question</H1>
27601
27602 This value records the last time you were asked about deleting old
27603 sent-mail.
27604 It is set automatically by Alpine at the beginning of each month.
27605 In the past, if you wished to suppress the monthly sent-mail
27606 pruning feature, you could set this to a date in the future.
27607 This value is relative to the year 1900, so
27608 to set this, for example, to October 2005, use 105.10.
27609 <P>
27610 You can still do that if you wish, or you can use the
27611 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
27612 a little more convenient to use.
27613 <P>
27614 <UL>
27615 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27616 </UL><P>
27617 &lt;End of help on this topic&gt;
27618 </BODY>
27619 </HTML>
27620 ====== h_config_goto_default =====
27621 <HTML>
27622 <HEAD>
27623 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
27624 </HEAD>
27625 <BODY>
27626 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
27627
27628 This value affects Alpine's behavior when you use the Goto command.
27629 Alpine's usual behavior has two parts.  If your current folder is
27630 &quot;Inbox&quot;, Alpine will offer the last open folder as the
27631 default.  If the current folder is other than &quot;Inbox&quot;,
27632 &quot;Inbox&quot; is offered as the default.
27633
27634 <P>
27635 The available options include:
27636
27637 <DL>
27638
27639  <DT>folder-in-first-collection</DT>
27640
27641  <DD> Alpine will offer the most recently visited folder in the default
27642 collection found in the &quot;Collection List&quot; screen as the default.
27643 </DD>
27644
27645  <DT> inbox-or-folder-in-first-collection</DT>
27646
27647  <DD> If the current folder is &quot;Inbox&quot;,
27648 Alpine will offer the most recently visited folder in the
27649 default collection found in the &quot;Collection List&quot; screen.
27650 If the current folder is other than &quot;Inbox&quot;,
27651 &quot;Inbox&quot; is offered as the default.
27652 </DD>
27653
27654  <DT> inbox-or-folder-in-recent-collection</DT>
27655
27656  <DD> This is Alpine's default behavior.
27657 If the current folder is &quot;Inbox&quot;,
27658 Alpine will offer the last open
27659 folder as the default.
27660 If the current folder is other than &quot;Inbox&quot;,
27661 &quot;Inbox&quot; is offered as the default.
27662 </DD>
27663
27664  <DT> first-collection-with-inbox-default</DT>
27665
27666  <DD> Instead of offering the most recently visited folder in the default
27667 collection, the default collection is offered but with &quot;Inbox&quot; as
27668 the default folder.
27669 If you type in a folder name it will be in the default collection.
27670 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
27671 </DD>
27672
27673  <DT> most-recent-folder</DT>
27674
27675  <DD> The last accepted value simply causes the most recently opened
27676 folder to be offered as the default regardless of the currently opened
27677 folder.
27678 </DD>
27679 </DL>
27680
27681 <P>
27682 NOTE: The default while a newsgroup is open remains the same; the last
27683 open newsgroup.
27684
27685 <P>
27686 <UL>
27687 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27688 </UL><P>
27689 &lt;End of help on this topic&gt;
27690 </BODY>
27691 </HTML>
27692 ====== h_config_thread_lastreply_char =====
27693 <HTML>
27694 <HEAD>
27695 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
27696 </HEAD>
27697 <BODY>
27698 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
27699
27700 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
27701 INDEX display when using a
27702 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
27703 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
27704 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
27705 The value of this option is a single character.
27706 This character is used instead of the vertical line character when there are
27707 no more replies directly to the parent of the current message.
27708 It can be used to &quot;round-off&quot; the bottom of the vertical line
27709 by setting it to a character such as a backslash (&#92;) or
27710 a backquote (&#96;).
27711 The default value of this option is the backslash character (&#92;).
27712 This option may not be set to the Empty Value.
27713 In that case, the default will be used instead.
27714
27715 <P>
27716 <UL>
27717 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27718 </UL><P>
27719 &lt;End of help on this topic&gt;
27720 </BODY>
27721 </HTML>
27722 ====== h_config_thread_indicator_char =====
27723 <HTML>
27724 <HEAD>
27725 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
27726 </HEAD>
27727 <BODY>
27728 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
27729
27730 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
27731 INDEX display when using a
27732 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
27733 than &quot;none&quot; and sorting by Threads or OrderedSubject.
27734 The value of this option is a single character.
27735 This character is used to indicate that part of a thread (a conversation) is
27736 hidden beneath a message.
27737 The message could be expanded
27738 if desired with the &quot;/&quot; Collapse/Expand command.
27739 By default, the value of this option is the greater than sign (&gt;).
27740 <P>
27741 If this option is set to the Empty Value, then the column (and the following
27742 blank column) will be deleted from the display.
27743
27744 <P>
27745 This option is closely related to the
27746 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
27747 Another similar option that affects the thread display is the
27748 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
27749
27750 <P>
27751 <UL>
27752 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27753 </UL><P>
27754 &lt;End of help on this topic&gt;
27755 </BODY>
27756 </HTML>
27757 ====== h_config_thread_exp_char =====
27758 <HTML>
27759 <HEAD>
27760 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
27761 </HEAD>
27762 <BODY>
27763 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
27764
27765 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
27766 INDEX display when using a
27767 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
27768 than &quot;none&quot;.
27769 The value of this option is a single character.
27770 This character is used to indicate that part of a thread has been expanded
27771 and could be collapsed if desired with
27772 the &quot;/&quot; Collapse/Expand command.
27773 By default, the value of this option is a dot (.).
27774 <P>
27775 If this option is set to the Empty Value, then the column (and the following
27776 blank column) will be deleted from the display.
27777
27778 <P>
27779 This option is closely related to the
27780 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
27781 Another similar option that affects the thread display is the
27782 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
27783
27784 <P>
27785 <UL>
27786 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27787 </UL><P>
27788 &lt;End of help on this topic&gt;
27789 </BODY>
27790 </HTML>
27791 ====== h_config_thread_index_style =====
27792 <HTML>
27793 <HEAD>
27794 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
27795 </HEAD>
27796 <BODY>
27797 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
27798
27799 When a folder is sorted by Threads or OrderedSubject,
27800 this option will affect the INDEX displays.
27801 <P>
27802
27803 The possible values for this option are:
27804
27805 <DL>
27806 <DT>regular-index-with-expanded-threads</DT>
27807 <DD>This is the default display.
27808 If the configuration option
27809 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
27810 is set to something other than &quot;none&quot;, then this setting
27811 will cause Alpine to start off with a MESSAGE INDEX with all of
27812 the threads expanded.
27813 That is, each message will have a line in the MESSAGE INDEX display.
27814 The Collapse/Expand command (/) may be used to manually collapse or
27815 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
27816 <P>
27817 This setting affects the display when the folder is first threaded.
27818 The collapsed state may also be re-initialized by re-sorting the folder manually
27819 using the SortIndex command ($).
27820 After re-sorting the threads will once again all be expanded, even if you
27821 have previously collapsed some of them.
27822 <P>
27823 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
27824 the display will be the regular default Alpine MESSAGE INDEX, but sorted
27825 in a different order.
27826 </DD>
27827
27828 <DT>regular-index-with-collapsed-threads</DT>
27829 <DD>If the configuration option
27830 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
27831 is set to something other than &quot;none&quot;, then this setting
27832 will cause Alpine to start out with all of the threads collapsed instead of
27833 starting out with all of the threads expanded.
27834 The Collapse/Expand command (/) may be used to manually collapse or
27835 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
27836 <P>
27837 This setting affects the display when the folder is first threaded.
27838 The collapsed state may also be re-initialized by re-sorting the folder manually
27839 using the SortIndex command ($).
27840 After re-sorting the threads will once again all be collapsed, even if you
27841 have previously expanded some of them.
27842 </DD>
27843
27844 <DT>separate-index-screen-always</DT>
27845 <DD>With this setting and the next, you will see an index of threads
27846 instead of an
27847 index of messages, provided you have sorted by Threads or OrderedSubject.
27848 <P>
27849 The THREAD INDEX contains a '*' in the first column if any message in the thread
27850 is marked Important.
27851 If not, it contains a '+' if any message in the thread is to you.
27852 The second column is blank. The third column contains a 'D' if all of the
27853 messages in the thread are deleted.
27854 Otherwise, it contains an 'N' if any of the messages in the thread are New.
27855 <P>
27856 When you view a particular thread from the THREAD INDEX you will be
27857 in the MESSAGE INDEX display
27858 but the index will only contain messages from the thread you are viewing.
27859 </DD>
27860
27861 <DT>separate-index-screen-except-for-single-messages</DT>
27862 <DD>This is very similar to the option above.
27863 When you are in the THREAD INDEX, one of the available commands
27864 is &quot;ViewThd&quot;.
27865 With the setting &quot;separate-index-screen-always&quot; (the option above)
27866 when you view a particular thread you will be in the
27867 MESSAGE INDEX display and the index will only contain messages from
27868 the thread you are viewing.
27869 If the thread you are viewing consists of a single message, the MESSAGE INDEX
27870 will be an index with only one message in it.
27871 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
27872 setting instead, then that index that contains a single message
27873 will be skipped and you will go directly from the THREAD INDEX into the
27874 MESSAGE TEXT screen.
27875 </DD>
27876
27877 </DL>
27878
27879 <P>
27880 <UL>
27881 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27882 </UL><P>
27883 &lt;End of help on this topic&gt;
27884 </BODY>
27885 </HTML>
27886 ====== h_config_thread_disp_style =====
27887 <HTML>
27888 <HEAD>
27889 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
27890 </HEAD>
27891 <BODY>
27892 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
27893
27894 When a folder is sorted by Threads or OrderedSubject,
27895 this option will affect the MESSAGE INDEX display.
27896 By default, Alpine will display the MESSAGE INDEX in the
27897 &quot;show-thread-structure&quot; style if a folder is sorted
27898 by Threads or OrderedSubject.
27899 <P>
27900
27901 The possible values for this option are:
27902
27903 <DL>
27904 <DT>none</DT>
27905 <DD>Regular index display.
27906 The same index line as would be displayed without threading is used.
27907 The only difference will be in the order of the messages.
27908 </DD>
27909
27910 <DT>show-thread-structure</DT>
27911 <DD>Threaded Subjects will be indented and vertical bars and horizontal
27912 lines will be added to make it easier to see the relationships among
27913 the messages in a thread (a conversation).
27914 </DD>
27915
27916 <DT>mutt-like</DT>
27917 <DD>This is the same as the option above except that the Subject
27918 is suppressed (is blank) if it matches the previous Subject in the thread.
27919 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
27920 Here is an example of what a mutt-like index might look like.
27921 In this example, the first column represents the message number, the
27922 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
27923 is set to &quot;regular-index-with-expanded-threads&quot;, and the
27924 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
27925 is set to a backslash:
27926 <PRE>
27927 &nbsp;&nbsp;&nbsp;1    Some topic
27928 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
27929 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
27930 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
27931 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
27932 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
27933 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
27934 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
27935 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
27936 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
27937 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
27938 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
27939 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
27940 &nbsp;&nbsp;&nbsp;14    Next topic
27941 </PRE>
27942 </DD>
27943
27944 <DT>indent-subject-1</DT>
27945 <DD>Threaded Subjects will be indented one space per level of the conversation.
27946 The bars and lines that show up in the show-thread-structure display will
27947 not be there with this style.
27948 </DD>
27949
27950 <DT>indent-subject-2</DT>
27951 <DD>Same as above but indent two spaces per level instead of one space.
27952 </DD>
27953
27954 <DT>indent-from-1</DT>
27955 <DD>Similar to indent-subject-1, except that instead of indenting the
27956 Subject field one space the From field of a thread will be indented one
27957 space per level of the conversation.
27958 </DD>
27959
27960 <DT>indent-from-2</DT>
27961 <DD>Same as above but indent two spaces per level instead of one space.
27962 </DD>
27963
27964 <DT>show-structure-in-from</DT>
27965 <DD>The structure of the thread is illustrated with indenting, vertical bars,
27966 and horizontal lines just like with the show-thread-structure option, but
27967 the From field is used to show the relationships instead of the Subject field.
27968 </DD>
27969
27970 </DL>
27971
27972 <P>
27973 <UL>
27974 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27975 </UL><P>
27976 &lt;End of help on this topic&gt;
27977 </BODY>
27978 </HTML>
27979 ====== h_config_pruning_rule =====
27980 <HTML>
27981 <HEAD>
27982 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
27983 </HEAD>
27984 <BODY>
27985 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
27986
27987 By default, Alpine will ask at the beginning of each month whether or not
27988 you want to rename your sent-mail folder to a name like sent-mail-month-year.
27989 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
27990 change the format of the folder to sent-mail-yyyy-mm.)
27991 It will also ask whether you would like to delete old sent-mail folders.
27992 If you have defined
27993 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
27994 or
27995 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
27996 Alpine will also ask about pruning those folders.
27997 <P>
27998
27999 With this option you may provide an automatic answer to these questions.
28000 The default value is to ask you what you'd like to do.
28001 <P>
28002
28003 The six possible values for this option are:
28004
28005 <DL>
28006 <DT>ask about rename, ask about deleting</DT>
28007 <DD>This is the default.
28008 Alpine will ask whether you want to rename the folders and whether you
28009 want to delete each of the old folders.
28010 </DD>
28011
28012 <DT>ask about rename, don't delete</DT>
28013 <DD>Alpine will ask whether you want to rename the folders, but won't
28014 ask about or delete old folders.
28015 </DD>
28016
28017 <DT>always rename, ask about deleting</DT>
28018 <DD>This means you want to always answer yes and have Alpine automatically
28019 rename the folder if possible.
28020 You will also be asked about deleting old folders.
28021 </DD>
28022
28023 <DT>always rename, don't delete</DT>
28024 <DD>This means you want to always answer yes and have Alpine automatically
28025 rename the folder if possible.
28026 There will be no deleting of old folders.
28027 </DD>
28028
28029 <DT>don't rename, ask about deleting</DT>
28030 <DD>This means you want to always answer no.
28031 Alpine will not rename the folder.
28032 You will be asked about deleting old folders.
28033 </DD>
28034
28035 <DT>don't rename, don't delete</DT>
28036 <DD>This means you want to always answer no.
28037 Alpine will not rename the folder.
28038 There will be no deleting of old folders, either.
28039 </DD>
28040 </DL>
28041
28042 <P>
28043 <UL>
28044 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28045 </UL><P>
28046 &lt;End of help on this topic&gt;
28047 </BODY>
28048 </HTML>
28049 ====== h_config_reopen_rule =====
28050 <HTML>
28051 <HEAD>
28052 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
28053 </HEAD>
28054 <BODY>
28055 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
28056
28057 Alpine normally checks for new mail in the currently open folder
28058 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
28059
28060 <P>
28061 There are some situations where automatic new-mail checking does not work.
28062 For example, if a mail folder is opened using the POP protocol or a newsgroup
28063 is being read using the NNTP protocol, then new-mail checking is disabled.
28064
28065 <P>
28066 It may be possible to check for new mail in these cases by reopening the
28067 folder.
28068 Alpine does not do this for you automatically, but you may do the commands
28069 manually to cause this to happen.
28070 You reopen by going back to the folder list screen from the message
28071 index screen with the &quot;&lt;&quot; command,
28072 and then going back into the message index screen with
28073 the &quot;&gt;&quot; command.
28074 (Actually, any method you would normally use to open a folder will work the
28075 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
28076 For example, the GoTo Folder command will work, or you may use L to go to the
28077 Folder List screen and Carriage Return to reopen the folder.)
28078
28079 <P>
28080 There are some cases where Alpine knows that reopening the folder should
28081 be useful as a way to discover new mail.
28082 At the time of this writing, connections made using the POP protocol,
28083 news reading using the NNTP protocol, local news reading, and local
28084 ReadOnly folders that are in the traditional UNIX or the MMDF format all
28085 fall into this category.
28086 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
28087 has no way of knowing, so it might also just be an exercise in futility.
28088 All remote, ReadOnly folders other than those listed just above fall into this
28089 category.
28090 The setting of this option together with the type of folder
28091 controls how Alpine will react to the apparent attempt to reopen a folder.
28092
28093 <P>
28094 If you don't reopen, then you will just be back in
28095 the message index with no change.
28096 You left the index and came back, but the folder remained &quot;open&quot;
28097 the whole time.
28098 However, if you do reopen the folder, the folder is closed and then reopened.
28099 In this case, the current state of the open folder is lost.
28100 The New status, Important and Answered flags,
28101 selected state, Zoom state, collapsed or expanded state of threads,
28102 current message number,
28103 and any other temporary state is all lost when the reopen happens.
28104 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
28105
28106 <P>
28107 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
28108 several places.
28109 That really implies the case where Alpine knows it is a good way to discover
28110 new mail, which is more than just POP and NNTP, but POP and NNTP are
28111 the cases of most interest.
28112 This option probably has more possible values than it deserves. They are:
28113
28114 <DL>
28115 <DT>Always reopen</DT>
28116 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
28117 whenever you type a command that implies a reopen, regardless of the
28118 access method.
28119 In other words, it is assumed you would always answer Yes if asked
28120 about reopening.
28121 </DD>
28122
28123 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
28124 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
28125 will ask you whether to reopen other remote folders,
28126 with a default answer of Yes.
28127 </DD>
28128
28129 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
28130 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
28131 will ask you whether to reopen other remote folders,
28132 with a default answer of No.
28133 </DD>
28134
28135 <DT>Yes for POP/NNTP, No for other remote</DT>
28136 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
28137 will assume a No answer for all other remote folders.
28138 </DD>
28139
28140 <DT>Always ask [Yes]</DT>
28141 <DD>Alpine will not differentiate based on access method.
28142 It will always ask for all remote folders, with a default answer of Yes.
28143 </DD>
28144
28145 <DT>Always ask [No]</DT>
28146 <DD>Alpine will not differentiate based on access method.
28147 It will always ask for all remote folders, with a default answer of No.
28148 </DD>
28149
28150 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
28151 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
28152 of Yes.
28153 It will never attempt to reopen other remote folders.
28154 </DD>
28155
28156 <DT>Ask about POP/NNTP [No], No for other remote</DT>
28157 <DD>This is the default.
28158 Alpine will ask if the access method is POP or NNTP, with a default answer
28159 of No.
28160 It will never attempt to reopen other remote folders.
28161 </DD>
28162
28163 <DT>Never reopen</DT>
28164 <DD>Alpine will never attempt to reopen already open folders.
28165 </DD>
28166 </DL>
28167
28168 <P>
28169 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
28170 any of the other situations where it is likely that reopening is a good way
28171 to discover new mail.
28172
28173 <P>
28174 There is an alternative that may be of useful in some situations.
28175 Instead of manually checking for new mail you can set up a
28176 <A HREF="h_maildrop">Mail Drop</A>
28177 and automatically check for new mail.
28178
28179 <P>
28180 <UL>
28181 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28182 </UL><P>
28183 &lt;End of help on this topic&gt;
28184 </BODY>
28185 </HTML>
28186 ====== h_config_inc_startup =====
28187 <HTML>
28188 <HEAD>
28189 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
28190 </HEAD>
28191 <BODY>
28192 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
28193
28194 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
28195 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
28196 It determines which message will be the <EM>current message</EM> when
28197 the folder is first opened.
28198 The default value is &quot;first-unseen&quot;.
28199
28200 <P>
28201 The seven possible values for this option are:
28202
28203 <DL>
28204 <DT>first-unseen</DT>
28205 <DD>The current message is set to the first
28206 unseen message that has not been marked deleted, or the last message if
28207 all of the messages have been seen previously.
28208 Messages which have not been seen or which have been seen but re-marked
28209 as New are considered unseen messages.
28210 See the note at the bottom of this help about newsgroups.
28211 </DD>
28212
28213 <DT>first-recent</DT>
28214 <DD>Similar to the default, but rather than starting on the first
28215 unseen message Alpine starts on the first <EM>recent</EM> message.
28216 A message is recent if it arrived since the last time the folder was
28217 open.  This value causes the current message to be set to the first
28218 recent message if there is one, otherwise to the last
28219 message in the folder.
28220 </DD>
28221
28222 <DT>first-important</DT>
28223 <DD>This will result in the current message being set to the first
28224 message marked Important (but not Deleted).
28225 If no messages are marked Important, then it will be the last message.
28226 Messages are marked Important by <EM>you</EM>, not by the sender, using
28227 the
28228 <A HREF="h_common_flag">Flag command</A>.
28229 Or they may be marked Important by an Alpine
28230 <A HREF="h_mainhelp_filtering">Filter</A>
28231 that you have set up.
28232 </DD>
28233
28234 <DT>first-important-or-unseen</DT>
28235 <DD>This selects the first of the first unseen and the first important
28236 messages.
28237 </DD>
28238
28239 <DT>first-important-or-recent</DT>
28240 <DD>This selects the first of the first recent and the first important
28241 messages.
28242 </DD>
28243
28244 <DT>first</DT>
28245 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
28246 If all messages are deleted you start on the last message.
28247 </DD>
28248
28249 <DT>last</DT>
28250 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
28251 If all messages are deleted you start on the last message.
28252 </DD>
28253 </DL>
28254
28255 <P>
28256 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
28257 &quot;first-recent&quot; are the same and are affected by whether or not the
28258 feature
28259 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
28260 is turned on.
28261 Also, there is no permanent storage in news for an Important flag.
28262 This means that no messages will be marked Important when a newsgroup is
28263 first opened.
28264
28265 <P>
28266 <UL>
28267 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28268 </UL><P>
28269 &lt;End of help on this topic&gt;
28270 </BODY>
28271 </HTML>
28272 ====== h_config_browser =====
28273 <HTML>
28274 <HEAD>
28275 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
28276 </HEAD>
28277 <BODY>
28278 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
28279 <!--chtml if pinemode="os_windows"-->
28280 PC-Alpine users do not need to enter anything here, unless:<UL>
28281 <LI> they want to override, for use with Alpine, the application defined
28282 in the Windows operating system for handling URLs; or
28283 <LI> they are (planning on) using the same configuration file with
28284 Unix Alpine.
28285 </UL>
28286 <P>
28287 Note that if using a viewer that has a space in its path, you should
28288 use the DOS name for that directory or file. Example:
28289 <PRE>
28290 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
28291 </PRE>
28292 <HR><P>
28293 <!--chtml endif-->
28294 This option affects Alpine's handling of URLs that are found in
28295 messages you read.  Normally, only URLs Alpine can handle directly
28296 are automatically offered for selection in the &quot;Message
28297 Text&quot; screen.  When one or more applications
28298 capable of deciphering URLs on their command line are added here, Alpine
28299 will choose the first available to display URLs it cannot handle directly.
28300 A viewer's availability is based on its being specified with a <B>full
28301 directory path</B> and the evaluation of any optionally supplied
28302 parameters described below.
28303
28304 <P>
28305 Additionally, to support various connection methods and applications, each
28306 entry in this list can optionally begin with one or more of
28307 the following special tokens.  The allowed tokens include:
28308
28309 <P>
28310 <DL>
28311 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
28312 <DD>
28313 The <VAR>test-string</VAR> is a shell command that Alpine will run to
28314 evaluate a viewer's availability.  The command specified by the test
28315 string is run and if its resulting exit status is non-zero, Alpine will
28316 not consider the associated viewer for use.
28317 </DD>
28318
28319 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
28320 <DD>
28321 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
28322 URL schemes that are to be used with the associated viewer.  This is
28323 the way to configure Alpine to recognize URLs other than the built-in set.
28324 <P>
28325 It can also be used to override Alpine's built-in handlers.
28326 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
28327 and Alpine would use (provided it passed all other criteria) the associated
28328 viewer when it encountered a URL of the form &quot;news:comp.mail.pine&quot;.
28329
28330 </DD>
28331 </DL>
28332
28333 <P>
28334 By default, Alpine will simply append a space character followed by the
28335 selected URL prior to launching the command in your specified SHELL.  You can
28336 optionally specify where in the command the selected URL should appear
28337 by using the &quot;_URL_&quot; token.  All occurrences found in the command
28338 will be replaced with the selected URL before the command is handed
28339 to the shell.  If such replacement occurs, the default appending of the
28340 selected URL does not take place.
28341
28342 <P>
28343 NOTE: If the viewer you specify has any command-line arguments,
28344 including the &quot;_URL_&quot; token, you will need to add a
28345 double-quote character before the command path and after the last
28346 argument (see the &quot;lynx&quot; example below).
28347
28348 <P>
28349 So, here are some example entries:
28350 <PRE>
28351 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/local/bin/netscape
28352               &quot;/usr/local/bin/lynx _URL_&quot;
28353               C:&#92;BIN&#92;NETSCAPE.BAT
28354 </PRE>
28355 <P>
28356 This example shows that for the first viewer in the list to be used
28357 the environment variable &quot;DISPLAY&quot; must be defined.  If it
28358 is, then the path and file &quot;/usr/local/bin/netscape&quot; must exist.
28359 If neither condition is met,
28360 then the path and file &quot;/usr/local/bin/lynx&quot; must exist.
28361 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
28362 If the path to &quot;lynx&quot; is invalid,
28363 then the final path and file C:&#92;BIN&#92;NETSCAPE.BAT must exist.
28364 Note that the last
28365 entry is a DOS/Windows path.  This is one way to support Alpine running
28366 on more than one architecture with the same configuration file.<P>
28367 <P>
28368 <!--chtml if pinemode="os_windows"-->
28369 <!--chtml else-->
28370 Note that depending on the type of browser used and the method of
28371 its invocation (such as whether it will open in a separate window) from
28372 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
28373 the MESSAGE TEXT screen, and you will have to quit the browser to return to
28374 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
28375 In other words, launching the browser from Alpine may make Alpine
28376 &quot;disappear&quot; (although it is still &quot;running&quot;)
28377 until you close the browser again.<P>
28378 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
28379 environment: for advanced users and  systems administrators</A>
28380 </UL>
28381 <!--chtml endif-->
28382 <P>If you are unsure what browsers are available on your system or how to
28383 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
28384 local computing support staff.
28385 <P><UL>
28386 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28387 </UL>
28388 <P>
28389 &lt;End of help on this topic&gt;
28390 </BODY>
28391 </HTML>
28392 ====== h_config_history =====
28393 <HTML>
28394 <HEAD>
28395 <TITLE>OPTION: <!--#echo var="VAR_default-directories"--></TITLE>
28396 </HEAD>
28397 <BODY>
28398 <H1>OPTION: <!--#echo var="VAR_default-directories"--></H1>
28399 <P>
28400 This option allows you to input a list of directories that Alpine will offer
28401 for you to use when you are saving or exporting attachments. This is useful
28402 when navigating to specific directories becomes too tedious, or when you
28403 need to do this on a daily basis, and want Alpine to remember this on a
28404 permanent basis.
28405 <P>
28406 The list of directories saved here can be accessed using the ^Y and ^V commands
28407 in the save prompt for attachments, or the export command.
28408
28409 <P><UL>
28410 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28411 </UL>
28412 <P>
28413 &lt;End of help on this topic&gt;
28414 </BODY>
28415 </HTML>
28416 ====== h_config_browser_xterm =====
28417 <HTML>
28418 <HEAD>
28419 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
28420 </HEAD>
28421 <BODY>
28422 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
28423 environment: for advanced users and  systems administrators</H1>
28424 If you are using Alpine with an X-terminal (emulator) and want to define an
28425 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
28426 you may want to do so in a manner that causes any <B>already</B>
28427 invoked viewer application to be used for viewing URLs you select from Alpine
28428 messages, and a <B>new</B> URL-viewer process to be
28429 started <B>only</B> if the same application has <B>not already</B>
28430 been launched -- for one reason, to avoid file-locking contentions among
28431 multiple invocations of the same URL-viewer application.
28432 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
28433 option does not do this.)  A method of doing that would be:<OL>
28434 <LI> use
28435 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
28436 check (using commands appropriate for your Unix shell
28437 in place of <VAR>test-string</VAR>) for the presence of a
28438 lockfile created by the URL-viewer application -- which implies that the
28439 application is already running, though this is not foolproof.
28440 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
28441 application with its appropriate command line option(s) to
28442 show the URL selected from the Alpine message in an already open window of
28443 that application, or perhaps in a new window of that application.
28444
28445 <LI> In the
28446 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
28447 application without those command line options, but this time using the
28448 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
28449 is defined.
28450 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
28451 windows environment (for instance, using VT-100 terminal emulation), you
28452 may wish to specify a non-X windows URL-viewer application such as Lynx
28453 as the last entry.
28454 </OL><BR>
28455 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
28456 the command shell, the URL-viewer application(s), and possibly the specific
28457 version of the latter, you are using.
28458 <P>
28459 Relevant command
28460 line options for the Netscape browser for showing URLs (selected from Alpine)
28461 when Netscape is already running are discussed in the document
28462 &quot;Remote Control of UNIX Netscape&quot;
28463 found at the URL (as of 12 Aug. 1998):
28464 <P>
28465
28466 <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
28467
28468 <P>(If the URL-viewer application is
28469 <B>not</B> running on the same host as Alpine, but being launched from an
28470 applications server, you may not be able to use the command line options for
28471 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
28472 <P>
28473 <!--chtml if this-method="shown-to-work"-->
28474 An example using the Korn shell and the Netscape browser (first entry wrapped
28475 because of its length, but should all appear on one line):
28476 <P>
28477 url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ &quot;/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &amp;&quot;<BR>
28478
28479 _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_ &quot;/usr/local/bin/netscape &amp;&quot;<BR>
28480               &quot;/usr/local/bin/lynx '_URL_'&quot;
28481 <P>
28482 <!--chtml endif-->
28483 <P>
28484 <UL>
28485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28486 </UL><P>
28487 &lt;End of help on this topic&gt;
28488 </BODY>
28489 </HTML>
28490 ====== h_config_enable_full_hdr =====
28491 <HTML>
28492 <HEAD>
28493 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
28494 </HEAD>
28495 <BODY>
28496 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
28497
28498 This feature enables the &quot;H Full Headers&quot; command which toggles between
28499 the display of all headers in the message and the normal edited view of
28500 headers.  The Full Header command also controls which headers are included
28501 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
28502 Full Header mode will respect the
28503 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
28504 feature setting.)
28505 <P>
28506 If Full Header mode is turned on and you Forward a message, you will
28507 be asked if you'd like to forward the message as an attachment, as opposed
28508 to including the text of the message in the body of your new message.
28509 <P>
28510 If you have also turned on the
28511 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
28512 option then the Full Headers command actually rotates through three states
28513 instead of just two.
28514 The first is the normal view with long quotes suppressed.
28515 The second is the normal view but with the long quotes included.
28516 The last enables the display of all headers in the message.
28517 When using Export, Pipe, Print, Forward, or Reply the quotes are
28518 never suppressed, so the first two states are identical.
28519 <P>
28520 Normally, the Header Mode will reset
28521 to the default behavior when moving to a new message.
28522 The mode can be made to persist from message to message by setting the feature
28523 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
28524 <P>
28525 <UL>
28526 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28527 </UL><P>
28528 &lt;End of help on this topic&gt;
28529 </BODY>
28530 </HTML>
28531 ====== h_config_enable_full_hdr_and_text =====
28532 <HTML>
28533 <HEAD>
28534 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
28535 </HEAD>
28536 <BODY>
28537 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
28538
28539 This feature affects how the &quot;H Full Headers&quot; command displays
28540 message text.  If set, the raw message text will be displayed.  This
28541 especially affects MIME formatted email, where the entire MIME format
28542 will be displayed.  This feature similarly affects how messages are
28543 included for the Export, Pipe, Print, Forward, and Reply functions.
28544 <P>
28545 When viewing a raw message that has attachments with this feature set,
28546 you will not be able to view attachments without first leaving full
28547 headers mode.  This is because MIME parsing is not done on the raw message.
28548 <P>
28549 <UL>
28550 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28551 </UL><P>
28552 &lt;End of help on this topic&gt;
28553 </BODY>
28554 </HTML>
28555 ====== h_config_enable_pipe =====
28556 <HTML>
28557 <HEAD>
28558 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
28559 </HEAD>
28560 <BODY>
28561 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
28562
28563 This feature enables the "| Pipe" command that sends the current message
28564 to the specified command for external processing.
28565 <P>
28566
28567 A short description of how the pipe command works is given
28568 <A HREF="h_pipe_command">here</A>.
28569
28570 <P>
28571 <UL>
28572 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28573 </UL><P>
28574 &lt;End of help on this topic&gt;
28575 </BODY>
28576 </HTML>
28577 ====== h_config_quell_full_hdr_reset =====
28578 <HTML>
28579 <HEAD>
28580 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
28581 </HEAD>
28582 <BODY>
28583 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
28584
28585 The <A HREF="h_common_hdrmode">HdrMode Command</A>
28586 normally resets to the default state when switching to a new message.
28587 For example, if you've used the &quot;H&quot; command to turn on Full
28588 Headers for a message you are viewing, and then you type the Next command
28589 to look at the next message, the full headers will no longer be shown.
28590 Setting this feature disables that reset.
28591 Instead, the Header Mode remains the same from message to message.
28592
28593 <P>
28594 The presence or absence of the HdrMode command is determined by the
28595 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
28596 Feature-List option.
28597 <P>
28598 <UL>
28599 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28600 </UL><P>
28601 &lt;End of help on this topic&gt;
28602 </BODY>
28603 </HTML>
28604 ====== h_config_enable_tab_complete =====
28605 <HTML>
28606 <HEAD>
28607 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
28608 </HEAD>
28609 <BODY>
28610 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
28611
28612 This feature enables the TAB key when at a prompt for a filename. In this
28613 case, TAB will cause the partial name already entered to be automatically
28614 completed, provided the partial name is unambiguous.
28615 This feature is on by default.
28616 <P>
28617 Similarly, this feature also enables TAB completion of address book
28618 nicknames when at a prompt for a nickname,
28619 or when typing in an address field in the composer.
28620 <P>
28621 &lt;End of help on this topic&gt;
28622 </BODY>
28623 </HTML>
28624 ====== h_config_quit_wo_confirm =====
28625 <HTML>
28626 <HEAD>
28627 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
28628 </HEAD>
28629 <BODY>
28630 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
28631
28632 This feature controls whether or not Alpine will ask for confirmation when a
28633 Quit command is received.
28634 <P>
28635 &lt;End of help on this topic&gt;
28636 </BODY>
28637 </HTML>
28638 ====== h_config_quote_replace_noflow =====
28639 <HTML>
28640 <HEAD>
28641 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
28642 </HEAD>
28643 <BODY>
28644 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
28645
28646 This feature, which is only active when
28647 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
28648 also set,
28649 enables quote-replacement on non-flowed messages.  It is off
28650 by default because a non-flowed message is more dependent on its format,
28651 and thus quote-replacement may cause less-than-pleasing results.
28652 Setting this feature will cause quote-replacement similar to that of flowed
28653 messages, but with the added possibility of long lines being wrapped
28654 into new lines if the Quote-Replacement-String is longer than the string
28655 it is replacing, which is &quot;&gt;&nbsp;&quot;.
28656 <P>
28657 &lt;End of help on this topic&gt;
28658 </BODY>
28659 </HTML>
28660 ====== h_config_enable_jump =====
28661 <HTML>
28662 <HEAD>
28663 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
28664 </HEAD>
28665 <BODY>
28666 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
28667
28668 When this feature is set you may enter a number (followed by RETURN)
28669 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
28670 screens.  In other words, it obviates the need for typing the "J" for the
28671 Jump command.
28672 <P>
28673 &lt;End of help on this topic&gt;
28674 </BODY>
28675 </HTML>
28676 ====== h_config_enable_alt_ed =====
28677 <HTML>
28678 <HEAD>
28679 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
28680 </HEAD>
28681 <BODY>
28682 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
28683
28684 If this feature is set (the default), and the
28685 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
28686 <B>is not</B> set, entering
28687 the ^_ (Ctrl-underscore) key while composing a message will prompt you
28688 for the name of the editor you would like to use.
28689 <P>
28690 If the environment variable $EDITOR is set, its value will be offered as
28691 a default.
28692 <P>
28693 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
28694 <B>is</B> set, the ^_ key will activate the specified
28695 editor without prompting, in which case it is not necessary to
28696 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
28697 <P>
28698 <UL>
28699 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28700 </UL><P>
28701 &lt;End of help on this topic&gt;
28702 </BODY>
28703 </HTML>
28704 ====== h_config_alt_ed_now =====
28705 <HTML>
28706 <HEAD>
28707 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
28708 </HEAD>
28709 <BODY>
28710 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
28711
28712 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
28713 variable are both set, Alpine will
28714 automatically activate the specified editor when the cursor is moved from
28715 the header of the message being composed into the message text.  For
28716 replies, the alternate editor will be activated immediately.  If this
28717 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
28718 automatically ask for the name of an alternate editor when the cursor
28719 is moved out of the header being composed, or if a reply is being done.
28720
28721 <P><UL>
28722 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28723 </UL>
28724 <P>
28725 &lt;End of help on this topic&gt;
28726 </BODY>
28727 </HTML>
28728 ====== h_config_enable_bounce =====
28729 <HTML>
28730 <HEAD>
28731 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
28732 </HEAD>
28733 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
28734 <BODY>
28735
28736 Setting this feature enables the "B Bounce" command, which will prompt
28737 for an address and *remail* the message to the new recipient.  This command
28738 is used to re-direct messages that you have received in error, or need to
28739 be redirected for some other reason (e.g. list moderation).  The final
28740 recipient will see a header indicating that you have Resent the msg, but
28741 the message's From: header will show the original author of the message,
28742 and replies to it will go back to that author, and not to you.
28743 <P>
28744 &lt;End of help on this topic&gt;
28745 </BODY>
28746 </HTML>
28747 ====== h_config_enable_agg_ops =====
28748 <HTML>
28749 <HEAD>
28750 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
28751 </HEAD>
28752 <BODY>
28753 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
28754
28755 When this feature is set you may use the commands and subcommands that relate to
28756 performing operations on more than one message at a time.  We call these
28757 &quot;aggregate operations&quot;.  In particular, the
28758 <!--chtml if pinemode="function_key"-->&quot;F5
28759 <!--chtml else-->&quot;;
28760 <!--chtml endif--> Select&quot;,
28761
28762 <!--chtml if pinemode="function_key"-->
28763 &quot;F6
28764 <!--chtml else-->
28765 &quot;A
28766 <!--chtml endif-->
28767 Apply&quot;, and
28768 <!--chtml if pinemode="function_key"-->
28769 &quot;F4
28770 <!--chtml else-->
28771 &quot;Z
28772 <!--chtml endif-->
28773 Zoom&quot; commands are enabled by this feature.  Select is used to
28774 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
28775 then be used to apply any message command to all of the selected/tagged
28776 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
28777 view between just those Selected and all messages in the folder.
28778 <P>
28779 This feature also enables the
28780 <!--chtml if pinemode="function_key"-->
28781 &quot;F7&quot;
28782 <!--chtml else-->
28783 &quot;^X&quot;
28784 <!--chtml endif-->
28785
28786 subcommand in the MESSAGE INDEX
28787 WhereIs command that causes all messages matching the WhereIs argument to
28788 become selected; and the Select, Select Current, and ZoomMode commands in the
28789 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
28790 <P>
28791 Some related help topics are
28792 <UL>
28793 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
28794 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
28795 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
28796 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
28797 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
28798 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
28799 </UL>
28800 <P>
28801 <UL>
28802 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28803 </UL><P>
28804 &lt;End of help on this topic&gt;
28805 </BODY>
28806 </HTML>
28807
28808 ====== h_config_enable_flag =====
28809 <HTML>
28810 <HEAD>
28811 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
28812 </HEAD>
28813 <BODY>
28814 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
28815
28816 Setting this feature enables the
28817 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
28818 command that allows you to
28819 manipulate the status flags associated with a message.  By default, Flag
28820 will set the "Important" flag, which results in an asterisk being
28821 displayed in column one of the MESSAGE INDEX for such messages.
28822 <P>
28823 &lt;End of help on this topic&gt;
28824 </BODY>
28825 </HTML>
28826 ====== h_config_flag_screen_default =====
28827 <HTML>
28828 <HEAD>
28829 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
28830 </HEAD>
28831 <BODY>
28832 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
28833
28834 The feature modifies the behavior of the
28835 <a href="h_common_flag">Flag</a>
28836 command (provided it too is
28837 <A HREF="h_config_enable_flag">enabled</A>).
28838 By default, when the "* Flag" command is selected,
28839 Alpine offers a prompt to set one of several flags and also offers the
28840 option of entering the detailed flag manipulation screen via the "^T"
28841 key. Enabling this feature causes Alpine to immediately enter the detailed
28842 flag screen rather than first offer the simple prompt.
28843 The
28844 <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.
28845 <P>
28846 &lt;End of help on this topic&gt;
28847 </BODY>
28848 </HTML>
28849 ====== h_config_flag_screen_kw_shortcut =====
28850 <HTML>
28851 <HEAD>
28852 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
28853 </HEAD>
28854 <BODY>
28855 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
28856
28857 This feature modifies the behavior of the
28858 <a href="h_common_flag">Flag</a> command
28859 and the <A HREF="h_index_cmd_select">Select</A> command.
28860 This feature is set by default.
28861 When this feature is not set, when the "* Flag" command is selected,
28862 Alpine offers a prompt to set one of several flags and also offers the
28863 option of entering the detailed flag manipulation screen via the "^T"
28864 key.
28865 If you have
28866 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
28867 defined, then enabling this feature adds a shortcut way to set or unset
28868 keywords.
28869 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
28870 a keyword if you've given it a nickname) and that will set the keyword.
28871 <P>
28872 An example is easier to understand than the explanation.
28873 The flag command can always be used to set the system flags.
28874 For example, to set the Answered flag you would type
28875 <P>
28876 <CENTER><SAMP>* A</SAMP></CENTER>
28877 <P>
28878 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
28879 option in the Config screen.
28880 By default, to set a keyword like &quot;Work&quot; you would usually
28881 have to go to the Flag Details screen using
28882 the &quot;^T To Flag Details&quot; command.
28883 Instead, if you have enabled this feature, you may type
28884 <P>
28885 <CENTER><SAMP>* W</SAMP></CENTER>
28886 <P>
28887 to set the Work flag, or
28888 <P>
28889 <CENTER><SAMP>* ! W</SAMP></CENTER>
28890 <P>
28891 to unset it.
28892 Just like for the other flag setting commands, the case of the letter does
28893 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
28894 keyword.
28895 <P>
28896 Notice that you can only use this trick for one keyword that begins
28897 with &quot;W&quot;.
28898 If you happen to have a &quot;Work&quot; keyword and another keyword that is
28899 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
28900 your list of keywords.
28901 Also, there are five letters that are reserved for system
28902 flags and the NOT command.
28903 If you type &quot;* A&quot; it will always set the Answered flag, not
28904 your &quot;Aardvark&quot; keyword.
28905 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
28906 the Flag Details screen.
28907 <P>
28908 Because enabling the
28909 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
28910 option causes Alpine to skip directly to the Flag Details screen when the
28911 Flag command is used,
28912 setting it will cause this feature to have no effect at all.
28913 <P>
28914 Similarly, when Selecting by Keyword, setting this option will allow you
28915 to use Keyword initials instead of full keywords.
28916 <P>
28917 &lt;End of help on this topic&gt;
28918 </BODY>
28919 </HTML>
28920 ====== h_config_can_suspend =====
28921 <HTML>
28922 <HEAD>
28923 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
28924 </HEAD>
28925 <BODY>
28926 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
28927
28928 Setting this feature will allow you to type ^Z (Control Z) to
28929 <!--chtml if pinemode="os_windows"-->
28930 minimize Alpine into its icon, bringing into focus whatever
28931 application is running behind the PC-Alpine window.
28932 <!--chtml else-->
28933 temporarily suspend Alpine.
28934
28935 <P>
28936 This does not exit Alpine, but puts it in the background to watch
28937 for new mail and such.  Normally, you type a command, such
28938 as &quot;fg&quot; at your system prompt to return to your Alpine session.
28939
28940 <P>
28941 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
28942 adjusts whether Alpine is placed into the background of the shell its
28943 running in or starts a news shell.
28944 <!--chtml endif-->
28945
28946 <P>
28947 <UL>
28948 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28949 </UL><P>
28950 &lt;End of help on this topic&gt;
28951 </BODY>
28952 </HTML>
28953 ====== h_config_take_lastfirst ======
28954 <HTML>
28955 <HEAD>
28956 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
28957 </HEAD>
28958 <BODY>
28959 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
28960
28961 Normally, when TakeAddr is used to copy an address from a message into
28962 an address book entry, Alpine will attempt to rewrite the full name of the
28963 address in the form
28964 <P>
28965
28966 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
28967
28968 instead of<P>
28969
28970 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
28971
28972 <P>
28973 It does this because many people find it useful to sort by Last name
28974 instead of First name.  If this feature is set, then the TakeAddr command
28975 will not attempt to reverse the name in this manner.
28976 <P>
28977 &lt;End of help on this topic&gt;
28978 </BODY></HTML>
28979 ====== h_config_disable_regex ======
28980 <HTML>
28981 <HEAD>
28982 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
28983 </HEAD>
28984 <BODY>
28985 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
28986
28987 Normally, the
28988 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
28989 option is interpreted as a regular expression.
28990 One type of address that might cause trouble is an address that
28991 contains a plus sign.
28992 If you want to have an address with a plus as one of your
28993 <!--#echo var="VAR_alt-addresses"-->
28994 and you don't want to use regular expressions, then setting this
28995 feature will cause Alpine to treat the addresses you list literally instead.
28996 <P>
28997 &lt;End of help on this topic&gt;
28998 </BODY></HTML>
28999 ====== h_config_take_fullname ======
29000 <HTML>
29001 <HEAD>
29002 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
29003 </HEAD>
29004 <BODY>
29005 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
29006
29007 Normally, when TakeAddr is used to copy an address or addresses
29008 from a message into an address book entry, Alpine will try to preserve
29009 the full name associated with each address in the list of addresses.
29010 The reason for this is so that if the entry is a list or later becomes a
29011 list, then information about the individual addresses in the list
29012 is preserved.
29013 If you would rather just have the simple addresses in the list of addresses,
29014 set this feature. For example, with the default setting you might
29015 see something like this in the ADDRESS BOOK editor after you type TakeAddr
29016 <P>
29017 <PRE>
29018  Nickname  : nick
29019  Fullname  : Bedrock Elders
29020  Fcc       :
29021  Comment   :
29022  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
29023              Barney Rubble &lt;rubble@bedrock.org&gt;
29024 </PRE>
29025 <P>
29026 but with this feature set it would look like
29027 <P>
29028 <PRE>
29029  Nickname  : nick
29030  Fullname  : Bedrock Elders
29031  Fcc       :
29032  Comment   :
29033  Addresses : flint@bedrock.org,
29034              rubble@bedrock.org
29035 </PRE>
29036 <P>
29037 instead. Note the difference in the Addresses field.
29038 <P>
29039 &lt;End of help on this topic&gt;
29040 </BODY></HTML>
29041 ====== h_config_print_from ======
29042 <HTML>
29043 <HEAD>
29044 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
29045 </HEAD>
29046 <BODY>
29047 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
29048
29049 If this feature is set, then the Berkeley-mail style From line is included
29050 at the start of each message that is printed.  This line looks something
29051 like the following, with the address replaced by the address from the
29052 From line of the message being printed:
29053 <P>
29054 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
29055 14:11:06 1998
29056 <P>
29057 &lt;End of help on this topic&gt;
29058 </BODY>
29059 </HTML>
29060 ====== h_config_expanded_distlists ======
29061 <HTML>
29062 <HEAD>
29063 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
29064 </HEAD>
29065 <BODY>
29066 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
29067 If this feature is set, then distribution lists in the address book
29068 screen will always be expanded automatically.
29069 <P>
29070 &lt;End of help on this topic&gt;
29071 </BODY>
29072 </HTML>
29073 ====== h_config_compose_news_wo_conf ======
29074 <HTML>
29075 <HEAD>
29076 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
29077 </HEAD>
29078 <BODY>
29079 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
29080 This feature controls one aspect of Alpine's Composer.  If you enter the
29081 composer while reading a newsgroup, you will normally be prompted to
29082 determine whether you intend the new message to be posted to the current
29083 newsgroup or not.  If this feature is set, Alpine will not prompt you
29084 in this situation, and will assume that you do indeed wish to post
29085 to the newsgroup you are reading.
29086 <P>
29087 &lt;End of help on this topic&gt;
29088 </BODY>
29089 </HTML>
29090 ====== h_config_compose_rejects_unqual ======
29091 <HTML>
29092 <HEAD>
29093 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
29094 </HEAD>
29095 <BODY>
29096 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
29097
29098 This feature controls one aspect of the message composer; in particular,
29099 what happens when an unqualified name is entered into an address header.
29100 If set, unqualified names entered as addresses will be treated as errors
29101 unless they match an addressbook nickname.  Alpine will not attempt to turn
29102 them into complete addresses by adding your local domain.<P>
29103
29104 A complete (fully qualified) address is one containing a username followed
29105 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
29106 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
29107 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
29108
29109 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
29110
29111 <P>
29112
29113 When you enter a fully qualified address, Alpine does not interpret or
29114 modify it, but simply passes it on to the mail-transport-agent (MTA) for
29115 your system.  Alpine conforms to the Internet standards governing message
29116 headers and will not send an unqualifed name to the MTA.  Therefore, when
29117 you enter an unqualified name, Alpine will normally attempt to turn it into
29118 a fully qualified address, first by checking to see if you have entered a
29119 matching nickname in your addressbook, or failing that, by simply adding
29120 your own domain to the name entered.  So if your address is
29121 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
29122 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
29123 that into &quot;fred@example.com&quot;.<P>
29124
29125 There are situations where it is not desirable for Alpine to interpret such
29126 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
29127 turned out to be a typo (intended to be an addressbook nickname), but
29128 there actually was a &quot;fred&quot; in your local domain, the message might
29129 be mis-delivered without your realizing it.  In order to reduce the likelihood
29130 of such accidents, setting this feature will cause Alpine to treat such
29131 addresses as errors, and require that you explicitly enter the full local
29132 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
29133 matches an address book nickname.<P>
29134
29135 Consider this a safety feature against mis-directed mail.
29136 <P>
29137 <UL>
29138 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29139 </UL><P>
29140 &lt;End of help on this topic&gt;
29141 </BODY>
29142 </HTML>
29143 ====== h_config_quell_local_lookup ======
29144 <HTML>
29145 <HEAD>
29146 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
29147 </HEAD>
29148 <BODY>
29149 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
29150
29151 This feature controls an aspect of Alpine's Composer, and if needed, will
29152 usually be set by your system manager in Alpine's system-wide configuration
29153 file. Specifically, if this feature is set, Alpine will not attempt to look
29154 in the system password file to find a Full Name for the entered address.
29155 <P>
29156 Normally, names you enter into address fields (e.g. To: or Cc:) are
29157 checked against your address book(s) to see if they match an address book
29158 nickname.  Failing that, (in Unix Alpine) the name is then checked against
29159 the Unix password file.  If the entered name matches a username in the
29160 system password file, Alpine extracts the corresponding Full Name information
29161 for that individual, and adds that to the address being entered.
29162 <P>
29163 However, password file matching can have surprising (incorrect) results if
29164 other users of the system do not receive mail at the domain you are using.
29165 That is, if either the
29166 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
29167 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
29168 option
29169 is set such that the administrative domain of other users on the system
29170 isn't accurately reflected, Alpine should be told that a passwd file match
29171 is coincidental, and Full Name info will be incorrect.  For example, a
29172 personal name from the password file could get falsely paired with the
29173 entered name as it is turned into an address in the configured domain.
29174 <P>
29175 If you are seeing this behavior, enabling this feature will prevent Unix
29176 Alpine from looking up names in the password file to find the Full Name
29177 for incomplete addresses you enter.<P>
29178 <UL>
29179 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29180 </UL>
29181 <P>
29182 &lt;End of help on this topic&gt;
29183 </BODY>
29184 </HTML>
29185 ====== h_config_tab_checks_recent ======
29186 <HTML>
29187 <HEAD>
29188 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
29189 </HEAD>
29190 <BODY>
29191 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
29192
29193 In a FOLDER LIST screen, the TAB key usually just changes which
29194 folder is highlighted.
29195 If this feature is set, then the TAB key will cause the number of
29196 recent messages and the total number of messages in the highlighted folder
29197 to be displayed instead.
29198
29199 <P>
29200 &lt;End of help on this topic&gt;
29201 </BODY>
29202 </HTML>
29203 ====== h_config_maildrops_preserve_state ======
29204 <HTML>
29205 <HEAD>
29206 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
29207 </HEAD>
29208 <BODY>
29209 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
29210
29211 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
29212 Normally, when mail is moved from a Mail Drop folder to a destination
29213 folder, it is delivered as new mail.
29214 Any Seen/New, Answered, Important/Flagged state that has changed will be
29215 ignored.
29216 All of the mail will be considered unSeen, unAnswered, and unImportant after
29217 it is moved.
29218 <P>
29219 If this feature is set, then the state changes that have been made
29220 to the messages in the Mail Drop folder will be preserved.
29221 <P>
29222 In any case, messages that are already marked Deleted when the
29223 mail is to be moved from the Mail Drop will be ignored.
29224 <P>
29225 &lt;End of help on this topic&gt;
29226 </BODY>
29227 </HTML>
29228 ====== h_config_preopen_stayopens ======
29229 <HTML>
29230 <HEAD>
29231 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
29232 </HEAD>
29233 <BODY>
29234 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
29235
29236 This feature is related to the option
29237 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29238 Normally, Stay Open folders are only opened on demand, when the user
29239 asks to open them.
29240 From then on they are kept open for the duration of the session.
29241 However, if this feature is set, then the Stay Open folders will all be
29242 opened at startup, at the same time that the INBOX is opened.
29243
29244 <P>
29245 &lt;End of help on this topic&gt;
29246 </BODY>
29247 </HTML>
29248 ====== h_config_expunge_inbox ======
29249 <HTML>
29250 <HEAD>
29251 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
29252 </HEAD>
29253 <BODY>
29254 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
29255
29256 The INBOX is normally treated differently from regular folders in several
29257 ways.
29258 One of the differences is that the normal &quot;close&quot; sequence of
29259 events is deferred until Alpine is exited, instead of happening when you
29260 leave the INBOX to view another folder.
29261 The &quot;close&quot; sequence normally includes the Expunging
29262 of deleted messages
29263 (either automatically or after a prompt, controlled by the features
29264 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29265 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29266 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29267 handling of the
29268 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
29269
29270 <P>
29271 If this feature is set the &quot;close&quot; sequence handling will take
29272 place every time you leave the INBOX.
29273 The INBOX will still be kept open, but the offer to Expunge and the archiving
29274 to the <!--#echo var="VAR_read-message-folder"-->
29275 will take place each time you leave the INBOX instead of only once at the
29276 end of the session.
29277
29278 <P>
29279 &lt;End of help on this topic&gt;
29280 </BODY>
29281 </HTML>
29282 ====== h_config_expunge_stayopens ======
29283 <HTML>
29284 <HEAD>
29285 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
29286 </HEAD>
29287 <BODY>
29288 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
29289
29290 This feature is related to the option
29291 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29292 Stay Open folders are treated differently from regular folders in several
29293 ways.
29294 One of the differences is that the normal &quot;close&quot; sequence of
29295 events is deferred until Alpine is exited, instead of happening when you
29296 leave the folder to view another folder.
29297 The &quot;close&quot; sequence normally includes the Expunging
29298 of deleted messages
29299 (either automatically or after a prompt, controlled by the features
29300 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29301 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29302 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29303 handling of
29304 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
29305
29306 <P>
29307 If this feature is set the &quot;close&quot; sequence handling will take
29308 place when you leave the Stay Open folder.
29309 The folder will still be kept open, but the offer to Expunge and the archiving
29310 will take place each time you leave the folder instead of only once at the
29311 end of the session.
29312 This feature does not affect the INBOX, which will still only be processed
29313 when you exit Alpine.
29314 However, there is a similar feature that affects only the INBOX called
29315 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
29316
29317 <P>
29318 &lt;End of help on this topic&gt;
29319 </BODY>
29320 </HTML>
29321 ====== h_config_preserve_start_stop ======
29322 <HTML>
29323 <HEAD>
29324 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
29325 </HEAD>
29326 <BODY>
29327 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
29328
29329 This feature controls how special control key characters, typically
29330 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
29331 are known as the "stop" and "start" characters and are sometimes used in
29332 communications paths to control data flow between devices that operate at
29333 different speeds.
29334
29335 <P>
29336
29337 By default, Alpine turns the system's handling of these special characters
29338 off except during printing.  However, if you see Alpine reporting input errors
29339 such as:
29340 <P>
29341 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
29342 <P>
29343 and, at the same time, see your display become garbled, then it is likely
29344 that setting this option will solve the problem.  Be aware, though, that
29345 enabling this feature will also cause Alpine to ostensibly "hang"
29346 whenever the Ctrl-S key combination is entered as the system is now
29347 interpreting such input as a "stop output" command.  To "start
29348 output"  again, simply type Ctrl-Q.
29349 <P>
29350 &lt;End of help on this topic&gt;
29351 </BODY>
29352 </HTML>
29353 ====== h_config_enable_incoming ======
29354 <HTML>
29355 <HEAD>
29356 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
29357 </HEAD>
29358 <BODY>
29359 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
29360
29361 Alpine's Incoming Message Folders collection
29362 provides a convenient way to access multiple incoming folders.
29363 It is also useful if you have accounts on multiple computers.
29364 <P>
29365
29366 If set, this feature defines a pseudo-folder collection called
29367 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
29368 in this collection will be your INBOX, which will no longer show up in
29369 your Default folder collection.
29370 <P>
29371
29372 You may add more folders to the Incoming Message Folders collection by
29373 using the
29374 <!--chtml if pinemode="function_key"-->
29375 &quot;F10
29376 <!--chtml else-->
29377 &quot;A
29378 <!--chtml endif-->
29379 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
29380 the host the folder is stored on (which defaults to the same host used
29381 for your INBOX), a nickname, and the actual folder name.  Once a set
29382 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
29383 or MESSAGE TEXT screens) may be used to scan the folders for those
29384 with Recent messages.  If you add more folders to
29385 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
29386 no effect.
29387 <P>
29388 NOTE: Normally the software that actually delivers mail (the stuff that happens
29389 before Alpine is involved) is in a better position to do delivery filtering
29390 than is Alpine itself.
29391 If possible, you may want to look at programs such as
29392 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
29393 filtering programs.
29394 If you'd prefer to have Alpine do the filtering for you, you may set that
29395 up.
29396 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
29397 <P>
29398 <UL>
29399 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29400 </UL><P>
29401 &lt;End of help on this topic&gt;
29402 </BODY>
29403 </HTML>
29404 ====== h_config_enable_incoming_checking ======
29405 <HTML>
29406 <HEAD>
29407 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
29408 </HEAD>
29409 <BODY>
29410 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
29411
29412 This feature is only operational if you have enabled the optional
29413 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
29414 If you do have Incoming Message Folders and you also set this feature,
29415 then the number of Unseen messages in each folder will be displayed
29416 in the FOLDER LIST screen for the Incoming Message Folders.
29417 The number of Unseen messages in a folder will be displayed in parentheses
29418 to the right of the name of each folder.
29419 If there are no Unseen messages in a folder then only the name
29420 is displayed, not a set of parentheses with zero inside them.
29421 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
29422 the Incoming Message Folders to cause an immediate update.
29423 <P>
29424 If a check for Unseen messages fails for a particular folder then Alpine
29425 will no longer attempt to check that folder for the duration of the
29426 session and this will be indicated by a question mark inside the
29427 parentheses.
29428 <P>
29429 The features
29430 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
29431 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
29432 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
29433 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
29434 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
29435 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
29436 all affect how this feature behaves.
29437 <P>
29438 <UL>
29439 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29440 </UL><P>
29441 &lt;End of help on this topic&gt;
29442 </BODY>
29443 </HTML>
29444 ====== h_config_incoming_checking_total ======
29445 <HTML>
29446 <HEAD>
29447 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
29448 </HEAD>
29449 <BODY>
29450 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
29451
29452 This option has no effect unless the feature
29453 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
29454 is set, which in turn has no effect unless
29455 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29456 is set.
29457 <P>
29458 When incoming folder checking is turned on the default is to display
29459 the number of unseen messages in each folder.
29460 More precisely, it is the number of undeleted unseen messages.
29461 Using this option you may also display the total number of messages
29462 in each folder.
29463 Instead of a single number representing the number of unseen messages
29464 you will get two numbers separated by a slash character.
29465 The first is the number of unseen messages and the second is the
29466 total number of messages.
29467 <P>
29468 You may also use the recent message count instead of the unseen message
29469 count by turning on the feature
29470 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
29471 <P>
29472 <UL>
29473 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29474 </UL><P>
29475 &lt;End of help on this topic&gt;
29476 </BODY>
29477 </HTML>
29478 ====== h_config_incoming_checking_recent ======
29479 <HTML>
29480 <HEAD>
29481 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
29482 </HEAD>
29483 <BODY>
29484 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
29485
29486 This option has no effect unless the feature
29487 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
29488 is set, which in turn has no effect unless
29489 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29490 is set.
29491 <P>
29492 When incoming folder checking is turned on the default is to display
29493 the number of unseen messages in each folder.
29494 More precisely, it is the number of undeleted unseen messages.
29495 Using this option you may display the number of recent messages instead
29496 of the number of unseen messages.
29497 A message is only counted as recent if this is the first session to
29498 see it, so the recent count might be less than the unseen count.
29499 The difference between the two would be accounted for by the unseen messages
29500 in the folder which were there previously but have not been looked at yet.
29501 <P>
29502 If you simultaneously run more than one email client at a time
29503 (for example, you run more than one Alpine in parallel) then turning
29504 this feature on can cause some confusion.
29505 The confusion stems from the fact that each message is only considered to be
29506 recent in one session.
29507 That means that the counts of new messages may be different in the two
29508 Alpines running side by side, because each incoming message will only be
29509 counted as recent in one of the two sessions.
29510 <P>
29511 You may also display the total number of messages
29512 in each folder by using the
29513 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
29514 option.
29515 <P>
29516 <UL>
29517 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29518 </UL><P>
29519 &lt;End of help on this topic&gt;
29520 </BODY>
29521 </HTML>
29522 ====== h_config_attach_in_reply ======
29523 <HTML>
29524 <HEAD>
29525 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
29526 </HEAD>
29527 <BODY>
29528 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
29529
29530 This feature controls an aspect of Alpine's Reply command. If set, any MIME
29531 attachments that were part of the original message will automatically be
29532 included in the Reply.
29533 <P>
29534 &lt;End of help on this topic&gt;
29535 </BODY>
29536 </HTML>
29537 ====== h_config_include_header =====
29538 <HTML>
29539 <HEAD>
29540 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
29541 </HEAD>
29542 <BODY>
29543 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
29544
29545 This feature controls an aspect of Alpine's Reply command. If set, and the
29546 original message is being included in the reply, then headers from that
29547 message will also be part of the reply.
29548 <P>
29549 &lt;End of help on this topic&gt;
29550 </HEAD>
29551 </HTML>
29552 ====== h_config_sig_at_bottom =====
29553 <HTML>
29554 <HEAD>
29555 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
29556 </HEAD>
29557 <BODY>
29558 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
29559
29560 This feature controls an aspect of Alpine's Reply command.  If this feature
29561 is set, and the original message is being included in the reply, then the
29562 contents of your signature file (if any) will be inserted after the included
29563 message.
29564 <P>
29565 This feature does not affect the results of a Forward command.
29566 <P>
29567 &lt;End of help on this topic&gt;
29568 </BODY>
29569 </HTML>
29570 ====== h_config_sigdashes =====
29571 <HTML>
29572 <HEAD>
29573 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
29574 </HEAD>
29575 <BODY>
29576 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
29577
29578 This feature enables support for the common USENET news convention
29579 of preceding a message signature with the special line consisting of
29580 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
29581
29582 <P>
29583 When enabled and a
29584 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
29585 Alpine will insert the special line before including the file's text (unless
29586 the special line already exists somewhere in the file's text).
29587
29588 <P>
29589 In addition, when you Reply or Followup to a message containing one of
29590 these special lines and choose to include its text, Alpine will observe
29591 the convention of not including text beyond the special line in your
29592 reply.
29593 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
29594 mode is enabled and turned on, then Alpine <EM>will</EM>
29595 include the text beyond the special line regardless of the setting of
29596 this feature.
29597
29598 <P>
29599 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
29600 for a related feature.
29601
29602 <P>
29603 <UL>
29604 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29605 </UL><P>
29606 &lt;End of help on this topic&gt;
29607 </BODY>
29608 </HTML>
29609 ====== h_config_new_thread_blank_subject =====
29610 <HTML>
29611 <HEAD>
29612 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
29613 </HEAD>
29614 <BODY>
29615 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
29616
29617 When this feature is enabled (the default) Alpine will create a new thread
29618 every time that the subject line becomes empty at any time during composition.
29619
29620 <P>
29621 This behavior is particularly useful in case you are replying to a message.
29622 Replying to a message causes the message to be in the same thread than the
29623 original message that is being replied to. However, many authors want to create
29624 a new message (in a different thread) while replying to a message, and they do
29625 this by changing the full subject, by first deleting the original subject and
29626 typing the new subject of the current message.
29627
29628 <P>
29629 Enabling this feature causes that any time that the subject is deleted, the
29630 message being composed will be considered the first message of a new thread.
29631
29632 <P>
29633 <UL>
29634 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29635 </UL><P>
29636 &lt;End of help on this topic&gt;
29637 </BODY>
29638 </HTML>
29639 ====== h_config_strip_sigdashes =====
29640 <HTML>
29641 <HEAD>
29642 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
29643 </HEAD>
29644 <BODY>
29645 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
29646
29647 This feature doesn't do anything if the feature
29648 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
29649 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
29650 then turning on this feature enables support for the convention
29651 of not including text beyond the sigdashes line when Replying or Following
29652 up to a message and including the text of that message.
29653 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
29654 mode is enabled and turned on, then Alpine <EM>will</EM>
29655 include the text beyond the special line regardless of the setting of
29656 this feature.
29657 <P>
29658 In other words, this is a way to turn on the signature stripping behavior
29659 without also turning on the dashes-adding behavior.
29660 <P>
29661 <UL>
29662 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29663 </UL><P>
29664 &lt;End of help on this topic&gt;
29665 </BODY>
29666 </HTML>
29667 ====== h_config_forward_as_attachment =====
29668 <HTML>
29669 <HEAD>
29670 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
29671 </HEAD>
29672 <BODY>
29673 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
29674
29675 This feature affects the way forwarded message text is handled.  When set, rather than
29676 include the text of the forwarded message below any additional text you provide in the
29677 composer, the forwarded message is attached in its entirety to the message you send.
29678 <P>
29679 This is useful in that it keeps the text you provide in the composer distinct from the
29680 text of the forwarded message.  Similarly, it allows the recipient to
29681 conveniently operate on the forwarded message.  For example, they might reply directly to
29682 the sender of the forwarded message, or process it as part of a spam report.
29683 <UL>
29684 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29685 </UL><P>
29686 &lt;End of help on this topic&gt;
29687 </BODY>
29688 </HTML>
29689 ====== h_config_preserve_field =====
29690 <HTML>
29691 <HEAD>
29692 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
29693 </HEAD>
29694 <BODY>
29695 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
29696
29697 This feature affects Alpine's behavior when one replies to a message.
29698 When you receive a message, some or all of the recipients of the message
29699 have been added to the To: and Cc: fields. If you reply to such message,
29700 and this feature is disabled, then the original sender of the message is
29701 added to the To: field, and all other recipients are added to the Cc:
29702 field, while your address is added to the From: field.
29703
29704 <P>
29705 However, if this feature is enabled, then Alpine will preserve the
29706 original fields as sent in the original message, so the Cc: and To:
29707 fields will be preserved. The sender's address will be added to the To:
29708 field, while your address is added to the From: field.
29709
29710 <P>
29711 The behavior of this feature is that replies to all messages will behave
29712 in the way described above. If you only intend this to happen on a per
29713 message basis, then keep this feature disabled, and when replying to a
29714 message you will see a new option in the menu for the &quot;Reply to all
29715 recipients?&quot; question. In this case, pressing &quot;p&quot; will
29716 make Alpine toggle its question so you can preserve the To: and Cc:
29717 fields for that message only.
29718
29719 <UL>
29720 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29721 </UL><P>
29722 &lt;End of help on this topic&gt;
29723 </BODY>
29724 </HTML>
29725 ====== h_config_sub_lists =====
29726 <HTML>
29727 <HEAD>
29728 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
29729 </HEAD>
29730 <BODY>
29731 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
29732
29733 This feature affects the subcommands available when Saving,
29734 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
29735 available. This command allows you to type in a substring of the folder
29736 you are looking for and when you type ^X it will display all folders
29737 that contain that substring in their names.
29738 This feature is set by default.
29739
29740 <P>
29741 &lt;End of help on this topic&gt;
29742 </BODY>
29743 </HTML>
29744 ====== h_config_scramble_message_id =====
29745 <HTML>
29746 <HEAD>
29747 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
29748 </HEAD>
29749 <BODY>
29750 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
29751
29752 Normally the Message-ID header that Alpine generates when sending a message
29753 contains the name of the computer from which the message is being sent.
29754 Some believe that this hostname could be used by spammers or could
29755 be used by others for nefarious purposes.
29756 If this feature is set, that name will be transformed with a simple
29757 Rot13 transformation.
29758 The result will still have the correct syntax for a Message-ID but the
29759 part of the MessageID that is often a domain name will not be an actual
29760 domain name because the letters will be scrambled.
29761 <P>
29762 In addition, other information such as the name program, version, and
29763 a code for operating system used to build Alpine, will be encoded using
29764 the Rot13 transformation, except for the version number which will be
29765 encoded using a Rot5 transformation.
29766 <P>
29767 It is possible (but unlikely?) that some spam detection
29768 software will use that as a reason to reject the mail as spam.
29769 It has also been reported that some spam detection software uses the
29770 fact that there are no dots after the &quot;@&quot; as a reason to reject
29771 messages.
29772 If your PC-Alpine Message-ID is using a name without a dot that is because
29773 that is what Windows thinks is your &quot;Full computer name&quot;.
29774 The method used to set this varies from one type of Windows to another but
29775 check under Settings -> Control Panel -> System and
29776 look for Network Identification or Computer Name or something similar.
29777 How to set it is beyond the scope of Alpine.
29778
29779 <P>
29780 &lt;End of help on this topic&gt;
29781 </BODY>
29782 </HTML>
29783 ====== h_downgrade_multipart_to_text =====
29784 <HTML>
29785 <HEAD>
29786 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
29787 </HEAD>
29788 <BODY>
29789 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
29790
29791 <P>
29792 This feature affects Alpine's behavior when sending mail.  Internet
29793 standards require Alpine to translate all non-ASCII characters in
29794 messages that it sends using MIME encoding.  This encoding can be
29795 ostensibly broken for recipients if any agent between Alpine and the
29796 recipient, such as an email list expander, appends text to the
29797 message, such as list information or advertising.  When sending such
29798 messages Alpine attempts to protect such encoding by placing extra
29799 MIME boundaries around the message text.
29800 <P>
29801 These extra boundaries are invisible to recipients that
29802 use MIME-aware email programs (the vast majority).  However, if
29803 you correspond with users of email programs that are not MIME-aware,
29804 or do not handle the extra boundaries gracefully, you can
29805 use this feature to prevent Alpine from including the extra
29806 MIME information.  Of course, it will increase the likelihood
29807 that non-ASCII text you send may appear corrupt to the recipient.
29808 <P>
29809 &lt;End of help on this topic&gt;
29810 </BODY>
29811 </HTML>
29812 ====== h_config_show_sort =====
29813 <HTML>
29814 <HEAD>
29815 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
29816 </HEAD>
29817 <BODY>
29818 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
29819
29820 If this feature is set and there is sufficient space on the screen,
29821 a short indication of the current sort order will be
29822 added in the titlebar (the top line on the screen), before the name
29823 of the folder.
29824 For example, with the default Arrival sort in effect,
29825 the display would have the characters
29826
29827 <P><CENTER>[A]</CENTER><P>
29828
29829 added between the title of the screen and the folder name.
29830 The letters are the same as the letters you may type to manually
29831 sort a folder with the SortIndex command ($).
29832 The letters in the table below are the ones that may show
29833 up in the titlebar line.
29834 <P>
29835 <TABLE>
29836 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
29837 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
29838 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
29839 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
29840 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
29841 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
29842 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
29843 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
29844 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
29845 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
29846 </TABLE>
29847 <P>
29848 If the sort order is Reversed, the letter above will be preceded by the letter
29849 &quot;R&quot;, for example
29850
29851 <P><CENTER>[RS]</CENTER><P>
29852
29853 means that a Reverse Subject sort is in effect.
29854 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
29855 left out, and just an &quot;R&quot; is shown.
29856
29857 <P><CENTER>[R]</CENTER>
29858
29859 <P>
29860 &lt;End of help on this topic&gt;
29861 </BODY>
29862 </HTML>
29863 ====== h_config_disable_reset_disp =====
29864 <HTML>
29865 <HEAD>
29866 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
29867 </HEAD>
29868 <BODY>
29869 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
29870
29871 UNIX Alpine only.
29872 <P>
29873 This feature affects Alpine's behavior when using
29874 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
29875 Normally, before the display filter is run, the terminal mode is reset
29876 to what it was before you started Alpine.
29877 This may be necessary if the filter requires the use of the terminal.
29878 For example, it may need to interact with you.
29879 If you set this feature, then the terminal mode will not be reset.
29880 One thing that turning on this feature should fix is the coloring of
29881 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
29882 breaks because the terminal reset resets the color state of the terminal.
29883
29884 <P>
29885 &lt;End of help on this topic&gt;
29886 </BODY>
29887 </HTML>
29888 ====== h_config_disable_sender =====
29889 <HTML>
29890 <HEAD>
29891 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
29892 </HEAD>
29893 <BODY>
29894 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
29895
29896 This feature affects Alpine's generation of the &quot;Sender:&quot; or
29897 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
29898 header fields.
29899 By default, Alpine will generate such a header in situations where the
29900 username or domain are not the same as
29901 the &quot;From:&quot; header on the message.
29902 With this feature set,
29903 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
29904 This may be desirable on a system that is virtually hosting many domains,
29905 and the sysadmin has other methods available for tracking a message to
29906 its originator.
29907 <P>
29908 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
29909
29910 <P>
29911 &lt;End of help on this topic&gt;
29912 </BODY>
29913 </HTML>
29914 ====== h_config_use_sender_not_x =====
29915 <HTML>
29916 <HEAD>
29917 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
29918 </HEAD>
29919 <BODY>
29920 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
29921
29922 Normally Alpine adds a header line
29923 labeled &quot;X-X-Sender&quot;, if the sender is
29924 different from the From: line.
29925 The standard specifies that this header
29926 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
29927 Setting this feature causes
29928 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
29929 <P>
29930 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
29931
29932 <P>
29933 &lt;End of help on this topic&gt;
29934 </BODY>
29935 </HTML>
29936 ====== h_config_use_fk =====
29937 <HTML>
29938 <HEAD>
29939 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
29940 </HEAD>
29941 <BODY>
29942 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
29943
29944 This feature specifies that Alpine will respond to function keys instead of
29945 the normal single-letter commands. In this mode, the key menus at the
29946 bottom of each screen will show function key designations instead of the
29947 normal mnemonic key.
29948
29949 <P>
29950 &lt;End of help on this topic&gt;
29951 </BODY>
29952 </HTML>
29953 ====== h_config_cancel_confirm =====
29954 <HTML>
29955 <HEAD>
29956 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
29957 </HEAD>
29958 <BODY>
29959 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
29960
29961 This feature affects what happens when you type ^C to cancel a composition.
29962 By default, if you attempt to cancel a composition by typing ^C, you will be
29963 asked to confirm the cancellation by typing a &quot;C&quot;
29964 for <EM>C</EM>onfirm.
29965 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
29966 risky because the &quot;^C Y&quot; needed to cancel a message
29967 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
29968 <P>
29969 If this feature is set the confirmation asked for
29970 will be a &quot;<EM>Y</EM>es&quot;
29971 instead of a &quot;<EM>C</EM>onfirm&quot; response.
29972
29973 <P>
29974 &lt;End of help on this topic&gt;
29975 </BODY>
29976 </HTML>
29977 ====== h_config_compose_maps_del =====
29978 <HTML>
29979 <HEAD>
29980 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
29981 </HEAD>
29982 <BODY>
29983 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
29984
29985 This feature affects the behavior of the DELETE key.
29986 If set, Delete will be equivalent to ^D, and delete
29987 the current character.  Normally Alpine defines the Delete key
29988 to be equivalent to ^H, which deletes the <EM>previous</EM>
29989 character.
29990
29991 <P>
29992 &lt;End of help on this topic&gt;
29993 </BODY>
29994 </HTML>
29995 ====== h_config_compose_bg_post =====
29996 <HTML>
29997 <HEAD>
29998 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
29999 </HEAD>
30000 <BODY>
30001 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
30002
30003 This feature affects the behavior of Alpine's mail sending.  If set, this
30004 feature enables a subcommand in the composer's "Send?" confirmation
30005 prompt.  The subcommand allows you to tell Alpine to handle the actual
30006 posting in the background.  While this feature usually allows posting
30007 to appear to happen very fast, it has no affect on the actual delivery
30008 time it takes a message to arrive at its destination.
30009
30010 <P>
30011 Please Note:
30012 <OL>
30013  <LI>This feature will have no effect if the feature
30014        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
30015        is set.
30016  <LI>This feature isn't supported on all systems.  All DOS and Windows,
30017        as well as several Unix ports, do not recognize this feature.
30018  <LI>Error handling is significantly different when this feature is
30019         enabled.  Any message posting failure results in the message
30020         being appended to your &quot;Interrupted&quot; mail folder.  When you
30021         type the <A HREF="h_common_compose">C</A>ompose command,
30022         Alpine will notice this folder and
30023         offer to extract any messages contained.  Upon continuing a
30024         failed message, Alpine will display the nature of the failure
30025         in the status message line.
30026  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
30027         for message data to
30028         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
30029         if you typically run close to any sort of disk-space limits or quotas.
30030 </OL>
30031 <P>
30032 &lt;End of help on this topic&gt;
30033 </BODY>
30034 </HTML>
30035 ====== h_config_compose_dsn =====
30036 <HTML>
30037 <HEAD>
30038 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
30039 </HEAD>
30040 <BODY>
30041 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
30042
30043 This feature affects the behavior of Alpine's mail sending.  If set, this
30044 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
30045 prompt.  The subcommand allows you to tell Alpine to request the type of
30046 Delivery Status Notification (DSN) that you would like.  Most users will
30047 be happy with the default, and need not enable this feature.
30048 <P>
30049 If the feature
30050 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
30051 then this feature has no effect and the type of DSN is not selectable.
30052
30053 <P>
30054 Turning on this feature and then turning on the DSNOpts from the send
30055 prompt reveals four on-off toggles at the bottom of the screen.
30056 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
30057 that no notification be returned to you, even if there is a delivery
30058 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
30059 server that you are willing (or not) to receive delay notifications, which
30060 happen when there is an unusual delay at some mail server (in that mail
30061 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
30062 Success requests that you be sent a DSN message when the message is
30063 successfully delivered to the recipients mailbox.  Setting NoErrRets will
30064 automatically turn off Delay and Success notification, and will flip the
30065 toggles to show that.  Similarly, turning on Delay and/or Success will
30066 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
30067 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
30068 the full message be returned in any failed DSN.  RetHdrs requests that
30069 only the headers be returned in any failed DSN.  Notice that this command
30070 applies only to failed delivery status reports.  For delay or success
30071 reports, the full message is never returned, only the headers are returned.
30072
30073 <P>
30074 If you don't enable the DSN feature or if you don't turn it on for a
30075 particular message, the default is that you will be notified about failures,
30076 you might be notified about delays, and you won't be notified about
30077 successes.  You will usually receive the full message back when there is
30078 a failure.
30079
30080 <P>
30081 If you turn on the DSNOpts the default is to return as much information as
30082 possible to you.  That is, by default, the Success and Delay options are
30083 turned on and the full message will be returned on failure.
30084
30085 <P>
30086 The sending prompt will display the current DSN request (if any) in a
30087 shorthand form.  It will be:
30088
30089 <P><CENTER>[Never]</CENTER>
30090
30091 <P>
30092 if you have requested NoErrRets.  Otherwise, it will look something like:
30093
30094 <P><CENTER>[FDS-Hdrs]</CENTER>
30095
30096 <P>
30097 The &quot;F&quot; will always be there, indicating that you will be notified
30098 of failures.  (Alpine doesn't provide a way to request no failure notification
30099 and at the same time request either success or delay notification.  The only
30100 way to request no failure notifications is to request no notifications at
30101 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
30102 requested Delay and/or Success notification.  If one of those is missing,
30103 that means you are requesting no notification of the corresponding type.
30104 After the dash it will say either Hdrs or Full.  Hdrs means to return only
30105 the headers and Full means to return the full message (applies to
30106 failure notifications only).
30107
30108 <P>
30109 NOTE: This feature relies on your system's mail transport agent or
30110 configured
30111 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
30112 having the negotiation mechanism introduced in
30113 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
30114 &quot;Delivery Status Notification&quot; (DSN).  If the mail transport agent you
30115 are using doesn't support DSN, a short warning will be shown to you on
30116 the message line at the bottom of the screen after you send your message,
30117 but your message will have been sent anyway.
30118
30119 <P>
30120 Note that DSNs don't provide a mechanism to request read receipts.  That
30121 is, if you request notification on success you are notified when the
30122 message is delivered to the mailbox, not when the message is read.
30123
30124 <P>
30125 ESMTP allows for graceful migration to upgraded mail transfer agents, but
30126 it is possible that this feature might cause problems for some servers.
30127
30128 <P>
30129 &lt;End of help on this topic&gt;
30130 </BODY>
30131 </HTML>
30132 ====== h_config_auto_zoom =====
30133 <HTML>
30134 <HEAD>
30135 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
30136 </HEAD>
30137 <BODY>
30138 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
30139
30140 This feature affects the behavior of the Select command.
30141 If set, the select command will automatically perform a zoom
30142 after the select is complete.
30143 This feature is set by default.
30144 <P>
30145 Some related help topics are
30146 <UL>
30147 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30148 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30149 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30150 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
30151 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
30152 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30153 </UL>
30154
30155 <P>
30156 &lt;End of help on this topic&gt;
30157 </BODY>
30158 </HTML>
30159 ====== h_config_auto_unzoom =====
30160 <HTML>
30161 <HEAD>
30162 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
30163 </HEAD>
30164 <BODY>
30165 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
30166
30167 This feature affects the behavior of the Apply command.  If set, and if
30168 you are currently looking at a Zoomed Index view of selected messages,
30169 the Apply command will do the operation you specify, but then will
30170 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
30171 the normal Index view after the Apply.
30172 This feature is set by default.
30173
30174 <P>
30175 Some related help topics are
30176 <UL>
30177 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30178 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30179 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30180 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
30181 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
30182 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30183 </UL>
30184 <P>
30185 &lt;End of help on this topic&gt;
30186 </BODY>
30187 </HTML>
30188 ====== h_config_auto_unselect =====
30189 <HTML>
30190 <HEAD>
30191 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
30192 </HEAD>
30193 <BODY>
30194 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
30195
30196 This feature affects the behavior of the Apply command.  If set,
30197 the Apply command will do the operation you specify, but then will
30198 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
30199 the normal Index view after the Apply.
30200
30201 <P>
30202 Some related help topics are
30203 <UL>
30204 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30205 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30206 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30207 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
30208 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
30209 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
30210 </UL>
30211 <P>
30212 &lt;End of help on this topic&gt;
30213 </BODY>
30214 </HTML>
30215 ====== h_config_fast_recent =====
30216 <HTML>
30217 <HEAD>
30218 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
30219 </HEAD>
30220 <BODY>
30221 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
30222
30223 This feature controls the behavior of the TAB key when traversing folders
30224 in the optional
30225 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
30226 collection or in optional <!--#echo var="VAR_news-collections"-->.
30227
30228 <P>
30229 When the TAB
30230 (<A HREF="h_common_nextnew">NextNew</A>)
30231 key is pressed, the default behavior is to
30232 explicitly examine the status of the folder for the number of recent
30233 messages (messages delivered since the last time it was viewed).
30234 Depending on the size and number of messages in the folder, this test
30235 can be time consuming.
30236
30237 <P>
30238 Enabling this feature will cause Alpine to only test for the existence of
30239 any recent messages rather than to obtain the count.  This is much faster
30240 in many cases.  The downside is that you're not given the number of recent
30241 messages when prompted to view the next folder.
30242 If the feature
30243 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
30244 is turned on, then the present feature will have no effect.
30245
30246 <P>
30247 <UL>
30248 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30249 </UL><P>
30250 &lt;End of help on this topic&gt;
30251 </BODY>
30252 </HTML>
30253 ====== h_config_arrow_nav =====
30254 <HTML>
30255 <HEAD>
30256 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
30257 </HEAD>
30258 <BODY>
30259 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
30260
30261 This feature controls the behavior of the left and right arrow keys.
30262 If set, the left and right arrow keys will operate like the usual
30263 navigation keys &lt; and &gt;.
30264 This feature is set by default.
30265
30266 <P>
30267 If you set this feature, and do not like the changed behavior of the up/down
30268 arrow
30269 keys when navigating through the FOLDER LIST screen --
30270 <B>first</B> from column to column, if more than one folder is
30271 displayed per row,
30272 and <B>then</B> from row to row -- you may either also wish to set the feature
30273 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
30274 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
30275 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
30276 folders in each column.
30277 <P>
30278 <UL>
30279 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30280 </UL><P>
30281 &lt;End of help on this topic&gt;
30282 </BODY>
30283 </HTML>
30284 ====== h_config_relaxed_arrow_nav =====
30285 <HTML>
30286 <HEAD>
30287 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
30288 </HEAD>
30289 <BODY>
30290 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
30291
30292 This feature controls the behavior of the left, right, up and down
30293 arrow keys in the FOLDER LIST screen when the &quot;<A
30294 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
30295 set.
30296 This feature is set by default.
30297
30298 <P>
30299
30300 When this feature is set, the left and right
30301 arrow keys in the FOLDER LIST screen
30302 move the highlight bar to the left or right, and the up and
30303 down arrows move it up or down.
30304
30305 <P>
30306 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
30307 feature is not set;
30308 the left and right arrow keys in the Folder List screen strictly
30309 track the commands bound to the '&lt;' and '&gt;' keys, and the up
30310 and down arrow keys move the highlight bar to the previous and next
30311 folder or directory name.
30312
30313 <P>
30314 <UL>
30315 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30316 </UL><P>
30317 &lt;End of help on this topic&gt;
30318 </BODY>
30319 </HTML>
30320 ====== h_config_alt_compose_menu =====
30321 <HTML>
30322 <HEAD>
30323 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
30324 </HEAD>
30325 <BODY>
30326 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
30327
30328 This feature controls the menu that is displayed when Compose is selected.
30329 If set, a list of options will be presented, with each option representing
30330 the type of composition that could be used. This feature is most useful for
30331 users who want to avoid being prompted with each option separately, or who
30332 want to avoid the checking of remote postponed or form letter folders.
30333 The possible types of composition are:
30334
30335 <P>
30336 New, for starting a new composition. Note that if New is selected and roles
30337 are set, roles are checked for matches and applied according to the setting
30338 of the matching role.
30339
30340 <P>
30341 Interrupted, for continuing an interrupted composition. This option is only
30342 offered if an interrupted message folder is detected.
30343
30344 <P>
30345 Postponed, for continuing postponed compositions. This option is offered
30346 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
30347 the postponed folder actually exists. This option is especially handy
30348 for avoiding having to check for the existence of a remote postponed folder.
30349
30350 <P>
30351 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
30352 is set in the config, and is not checked for existence for reasons similar
30353 to those explained by the postponed option.
30354
30355 <P>
30356 setRole, for selecting a role to apply to a composition.
30357
30358 <P>
30359 &lt;End of help on this topic&gt;
30360 </BODY>
30361 </HTML>
30362 ====== h_config_alt_role_menu =====
30363 <HTML>
30364 <HEAD>
30365 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
30366 </HEAD>
30367 <BODY>
30368 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
30369
30370 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
30371 a role and compose a new message using that role.
30372 When this feature is set, the role command will first ask whether you want to
30373 Compose a new message, Forward the current message, Reply to the
30374 current message, or Bounce the current message.
30375 If you are not in the MESSAGE INDEX and are not viewing a message,
30376 then there is no current message and the question will be skipped.
30377 After you have chosen to Compose, Forward, Reply, or Bounce you will
30378 then choose the role to be used.
30379 <P>
30380 When Bouncing the &quot;Set From&quot; address is used for the
30381 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
30382 provided that the option
30383 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
30384 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
30385 set.
30386 Other actions of the role are ignored when Bouncing.
30387
30388 <P>
30389 &lt;End of help on this topic&gt;
30390 </BODY>
30391 </HTML>
30392 ====== h_config_always_spell_check =====
30393 <HTML>
30394 <HEAD>
30395 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
30396 </HEAD>
30397 <BODY>
30398 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
30399 <P>
30400 When this feature is set, every composed message will be spell-checked before
30401 being sent.
30402 <P>
30403 &lt;End of help on this topic&gt;
30404 </BODY>
30405 </HTML>
30406 ====== h_config_quell_asterisks =====
30407 <HTML>
30408 <HEAD>
30409 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
30410 </HEAD>
30411 <BODY>
30412 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
30413 <P>
30414 When you are running Alpine you will sometimes be asked for a password
30415 in a prompt on the third line from the bottom of the screen.
30416 Normally each password character you type will cause an asterisk to echo
30417 on the screen. That gives you some feedback to know that your typing is
30418 being recognized.
30419 There is a very slight security risk in doing it this way because someone
30420 watching over your shoulder might be able to see how many characters there
30421 are in your password.
30422 If you'd like to suppress the echoing of the asterisks set this feature.
30423 <P>
30424 &lt;End of help on this topic&gt;
30425 </BODY>
30426 </HTML>
30427 ====== h_config_quell_flowed_text =====
30428 <HTML>
30429 <HEAD>
30430 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
30431 </HEAD>
30432 <BODY>
30433 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
30434 <P>
30435 Alpine generates flowed text where possible.
30436 The method for generating flowed text is defined by
30437 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
30438 the benefit of doing so is
30439 to send message text that can properly be viewed both on normal width displays
30440 and on displays with smaller or larger than normal screen widths.
30441 With flowed text, a space at the end of a line tells the receiving mail
30442 client that the following line belongs to the same paragraph.
30443 Quoted text will also be affected, with only the innermost
30444 level of &quot;&gt;&quot; quoting being followed by a space.
30445 However, if you have changed the
30446 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
30447 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
30448 quoted text will not be flowed.
30449 For this reason, we recommend that you leave your
30450 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
30451 <P>
30452 This feature turns off the generation of flowed text, as it might be
30453 desired to more tightly control how a message is displayed on the receiving end.
30454 <P>
30455 If this feature is <EM>not</EM> set, you can control on a message by message
30456 basis whether or not flowed text is generated.
30457 You do this by typing ^V at the Send confirmation prompt that you get
30458 after typing ^X to send a message.
30459 ^V is a toggle that turns flowing off and back on if typed again.
30460 If for some reason flowing cannot be done on a particular message, then the
30461 ^V command will not be available.
30462 This would be the case, for example, if this feature was set, or if your
30463 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
30464 If the feature
30465 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
30466 then the opportunity to control on a message by message basis
30467 whether or not flowed text is generated is lost.
30468 <P>
30469 When this feature is not set and you have typed ^V to turn off flowing,
30470 the Send confirmation prompt will change to look like
30471 <P>
30472 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
30473 <P>
30474 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
30475 also turn off the sending of flowed text messages, but it differs in that
30476 it also trims all trailing white space from a message before sending it.
30477 <P>
30478 If alternate editors are used extensively, be aware that a message will still
30479 be sent flowed if this feature is unset.  In most cases this will be fine,
30480 but if the editor has a &quot;flowed text&quot; mode, it would be best to
30481 use that.
30482 <P>
30483 &lt;End of help on this topic&gt;
30484 </BODY>
30485 </HTML>
30486 ====== h_config_strip_ws_before_send =====
30487 <HTML>
30488 <HEAD>
30489 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
30490 </HEAD>
30491 <BODY>
30492 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
30493 <P>
30494 By default, trailing whitespace is not stripped from
30495 a message before sending.  Trailing whitespace should have no effect on an
30496 email message, and in flowed text can aid in delimiting paragraphs.
30497 However, the old behavior of stripping trailing whitespace was in place
30498 to better deal with older clients that couldn't handle certain types of
30499 text encodings.  This feature restores the old behavior
30500 <P>
30501 Trailing whitespace is of aid to flowed-text-formatted messages, which are
30502 generated by default but can be turned off via the
30503 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
30504 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
30505 of flowed text.
30506 <P>
30507 &lt;End of help on this topic&gt;
30508 </BODY>
30509 </HTML>
30510 ====== h_config_alt_reply_menu =====
30511 <HTML>
30512 <HEAD>
30513 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></TITLE>
30514 </HEAD>
30515 <BODY>
30516 <H1>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></H1>
30517
30518 Note that if this option is enabled, then the option
30519 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
30520 is ignored. See below to understand why.
30521 <P>
30522 When you reply to a message, a series of questions are asked that
30523 determines how your reply will be handled by Alpine. This feature only
30524 affects the result of the first question you are asked, and its purpose is
30525 to set values that could override defaults set in Alpine's main
30526 configuration screen. As a result, this menu allows you to configure even
30527 more features than you would be able to do without this option. For
30528 example, this menu always allows you to override or select a <A
30529 HREF="h_rules_roles">Role</A> if you have defined one, or allows you to
30530 override your indent string, regardless of if you have enabled
30531 <A HREF="h_config_prefix_editing"><!--#echo var="FEAT_enable-reply-indent-string-editing"--></A>.
30532 The full list of options can be found below.
30533 <P>
30534 Here is an example of how this option works. After you press Reply,
30535 if you see &quot;A Inc Attach&quot; in the menu, it means that
30536 if you press &quot;A&quot;, then Alpine will include the attachments
30537 of the original message, and the default is not to include them.
30538 Conversely, if you see &quot;A No Attach&quot;
30539 then by pressing &quot;A&quot; Alpine will not include
30540 attachments in your reply, and the default is that Alpine will
30541 include them in your reply. The value that you see when you
30542 start your reply is controlled by the option
30543 <A HREF="h_config_attach_in_reply">
30544 <!--#echo var="FEAT_include-attachments-in-reply"-->
30545 </A>. If the feature is enabled, then Alpine will display
30546 &quot;A No Attach&quot; to override the default behavior. You can
30547 toggle between the two values of this option by pressing &quot;A&quot;.
30548 Remember that the value that you see in the menu is the action that will
30549 be done when you press the associated command.
30550 <P>
30551 Below are your options:
30552 <OL>
30553 <LI><B>A</B>: This determines if Alpine will include or not the
30554 attachments sent to you in the message that you are replying to. The default
30555 is to use the value of the configuration option
30556 <A HREF="h_config_attach_in_reply"><!--#echo var="FEAT_include-attachments-in-reply"--></A> and can be overridden by using this command.
30557
30558 <LI><B>H</B>: This command determines if the headers of a message are
30559 included in the body of the message that is being replied to. By default
30560 Alpine will use the value of the configuration option
30561 <A HREF="h_config_include_header"><!--#echo var="FEAT_include-header-in-reply"--></A>.
30562 Observe that by toggling this option to include headers, text will be toggled
30563 to be included by default.
30564
30565 <LI><B>R</B>: Can be used to set a role different from the default.
30566
30567 <LI><B>S</B>: Determines if Alpine will strip the signature from a
30568 message. The default is to strip the signature when the message is not
30569 viewed in headers mode, and you either have enabled
30570 <A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>
30571 or
30572 <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>.
30573
30574 <LI><B>Ctrl-R</B>: Can be used to edit the
30575 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>.
30576 </OL>
30577 <P>
30578 In order to include the text of the original message in the reply
30579 you either need to press 'y' to include the original text, or 'n' to
30580 exclude it from the reply. Pressing return will execute the default
30581 action, which is to include text only if the option
30582 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
30583 is enabled. However, notice that the default is to include text if you edit the
30584 reply indent string or if you explicitly set through this menu that you
30585 want headers included in the reply message.
30586
30587 <P>
30588 &lt;End of help on this topic&gt;
30589 </BODY>
30590 </HTML>
30591 ====== h_config_del_from_dot =====
30592 <HTML>
30593 <HEAD>
30594 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
30595 </HEAD>
30596 <BODY>
30597 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
30598
30599 This feature controls the behavior of the Ctrl-K command in the composer.
30600 If set, ^K will cut from the current cursor position to the end of the line,
30601 rather than cutting the entire line.
30602
30603 <P>
30604 &lt;End of help on this topic&gt;
30605 </BODY>
30606 </HTML>
30607 ====== h_config_print_index =====
30608 <HTML>
30609 <HEAD>
30610 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
30611 </HEAD>
30612 <BODY>
30613 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
30614
30615 This feature controls the behavior of the Print command when in the
30616 MESSAGE INDEX screen.  If set, the print command will give you a prompt
30617 asking if you wish to print the message index, or the currently highlighted
30618 message. If not set, the message will be printed.
30619
30620 <P>
30621 &lt;End of help on this topic&gt;
30622 </BODY>
30623 </HTML>
30624 ====== h_config_allow_talk =====
30625 <HTML>
30626 <HEAD>
30627 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
30628 </HEAD>
30629 <BODY>
30630 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
30631
30632 UNIX Alpine only.
30633 <P>
30634 By default, permission for others to &quot;talk&quot; to your terminal is turned
30635 off when you are running Alpine.  When this feature is set, permission is
30636 instead turned on.  If enabled, you may see unexpected messages in the
30637 middle of your Alpine screen from someone attempting to contact you via the
30638 &quot;talk&quot; program.
30639
30640 <P>
30641 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
30642 talk daemon on your system will attempt to print a message on your screen
30643 when someone else is trying to contact you.  If you wish to see these
30644 messages while you are running Alpine, you should enable this feature.
30645
30646 <P>
30647 If you do enable this feature and see a &quot;talk&quot; message, you must
30648 suspend or quit Alpine before you can respond.
30649
30650 <P>
30651 &lt;End of help on this topic&gt;
30652 </BODY>
30653 </HTML>
30654 ====== h_config_send_filter_dflt =====
30655 <HTML>
30656 <HEAD>
30657 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
30658 </HEAD>
30659 <BODY>
30660 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
30661 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
30662 configured, setting this feature will cause
30663 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
30664 instead of unfiltered, the usual default.
30665 <P>
30666 <UL>
30667 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30668 </UL><P>
30669 &lt;End of help on this topic&gt;
30670 </BODY>
30671 </HTML>
30672 ====== h_config_custom_print =====
30673 <HTML>
30674 <HEAD>
30675 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
30676 </HEAD>
30677 <BODY>
30678 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
30679
30680 When this feature is set, the print command will have an additional
30681 subcommand called "C CustomPrint".  If selected, you will have
30682 the opportunity to enter any system print command --instead of being
30683 restricted to using those that have been previously configured in the
30684 printer setup menu.
30685 <P>
30686
30687 &lt;End of help on this topic&gt;
30688 </BODY>
30689 </HTML>
30690 ====== h_config_enable_dot_files =====
30691 <HTML>
30692 <HEAD>
30693 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
30694 </HEAD>
30695 <BODY>
30696 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
30697
30698 When this feature is set, files beginning with dot (".") will be
30699 visible in the file browser.  For example, you'll be able to select them
30700 when using the browser to add an attachment to a message.
30701 <P>
30702 &lt;End of help on this topic&gt;
30703 </BODY>
30704 </HTML>
30705 ====== h_config_enable_dot_folders =====
30706 <HTML>
30707 <HEAD>
30708 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
30709 </HEAD>
30710 <BODY>
30711 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
30712
30713 When this feature is set, folders beginning with dot (".") may be added
30714 and viewed.
30715 <P>
30716 &lt;End of help on this topic&gt;
30717 </BODY>
30718 </HTML>
30719 ====== h_config_ff_between_msgs =====
30720 <HTML>
30721 <HEAD>
30722 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
30723 </HEAD>
30724 <BODY>
30725 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
30726
30727 Setting this feature causes a formfeed to be printed between messages when
30728 printing multiple messages (with Apply Print command).
30729 <P>
30730 &lt;End of help on this topic&gt;
30731 </BODY>
30732 </HTML>
30733 ====== h_config_blank_keymenu =====
30734 <HTML>
30735 <HEAD>
30736 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
30737 </HEAD>
30738 <BODY>
30739 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
30740
30741 If this feature is set the command key menu that normally appears on the
30742 bottom two lines of the screen will not usually be there.  Asking for
30743 help with ^G or ? will cause the key menu to appear instead of causing
30744 the help message to come up.  If you want to actually see the help text,
30745 another ^G or ? will show it to you.  After the key menu has popped
30746 up with the help key it will remain there for an O for Other command but
30747 disappear if any other command is typed.
30748 <P>
30749 &lt;End of help on this topic&gt;
30750 </BODY>
30751 </HTML>
30752 ====== h_config_enable_mouse =====
30753 <HTML>
30754 <HEAD>
30755 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
30756 </HEAD>
30757 <BODY>
30758 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
30759
30760 This feature controls whether or not an X terminal mouse can be used with
30761 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
30762 being used, the left mouse button on the mouse can be used to select text
30763 or commands.
30764 Clicking on a command at the bottom of the screen will behave as if you had
30765 typed that command.
30766 Clicking on an index line will move the current message highlight to
30767 that line.
30768 Double-clicking on an index line will view the message.
30769 Double-clicking on a link will view the link.
30770 <P>
30771 This type of mouse support will also work in some terminal emulators which are
30772 not actually X terminals, but which have extra code to support the xterm
30773 style mouse.
30774 For those emulators you not only need to turn this feature on but you also
30775 have to set the $DISPLAY environment variable even though it isn't needed
30776 for your terminal.
30777 That will cause Alpine to think that it is an xterm and to properly interpret the
30778 escape sequences sent by the mouse.
30779 <P>
30780 Note: if this feature is set, the behavior of X terminal cut-and-paste is
30781 also modified.  It is sometimes possible to hold the shift key down while clicking
30782 left or middle mouse buttons for the normal xterm cut/paste operations.
30783 There is also an Alpine command to toggle this mode on or off.
30784 The command is Ctrl-&#92; (Control-backslash).
30785 <P>
30786 &lt;End of help on this topic&gt;
30787 </BODY>
30788 </HTML>
30789 ====== h_config_enable_xterm_newmail =====
30790 <HTML>
30791 <HEAD>
30792 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
30793 </HEAD>
30794 <BODY>
30795 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
30796
30797 This feature controls whether or not Alpine will attempt to announce new
30798 mail arrival when it is running in an X terminal window and that window
30799 is iconified.  If set, and the $DISPLAY variable indicates that an X
30800 terminal is being used, Alpine will send appropriate escape sequences to
30801 the X terminal to modify the label on Alpine's icon to indicate that new
30802 mail has arrived. Alpine will also modify the Alpine window's title to
30803 indicate new mail.
30804 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
30805 <P>
30806 &lt;End of help on this topic&gt;
30807 </BODY></HTML>
30808 ====== h_config_enable_newmail_short_text =====
30809 <HTML>
30810 <HEAD>
30811 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
30812 </HEAD>
30813 <BODY>
30814 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
30815
30816 This feature controls the text to be displayed in an icon in the event
30817 of a new message arrival.  Normally, the message will
30818 be the one that is displayed on the screen.  This feature shortens the
30819 message to a count of the number of new messages in brackets.  This may be
30820 more useful for those who use the window's title bar in the task bar as a
30821 new mail indicator.  This feature is only useful if the
30822 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
30823 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
30824 feature, this feature is only relevant when run in an xterm environment.
30825 <P>
30826 &lt;End of help on this topic&gt;
30827 </BODY></HTML>
30828 ====== h_config_copy_to_to_from =====
30829 <HTML>
30830 <HEAD>
30831 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
30832 </HEAD>
30833 <BODY>
30834 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
30835
30836 This feature affects the From address used when Replying to a message.
30837 It is probably only useful if you have some
30838 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
30839 defined.
30840 When enabled, it checks to see if any of the addresses in the To or Cc
30841 fields of the message you are replying to is one of your addresses.
30842 If it is, and there is only one of them, then that address is used as
30843 the From address in the message you are composing.
30844 In other words, you will be using a From address that is the same
30845 as the To address that was used to get the mail to you in the first place.
30846
30847 <P>
30848 If a role is being used and it has a From address defined, that From address will
30849 be used rather than the one derived from this feature.
30850
30851 <P>
30852 <UL>
30853 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30854 </UL><P>
30855 &lt;End of help on this topic&gt;
30856 </BODY>
30857 </HTML>
30858 ====== h_config_prefix_editing =====
30859 <HTML>
30860 <HEAD>
30861 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
30862 </HEAD>
30863 <BODY>
30864 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
30865
30866 This feature affects the Reply command's &quot;Include original message
30867 in Reply?&quot; prompt.  When enabled, it causes the
30868 &quot;Edit Indent String&quot; sub-command to appear which allows
30869 you to edit the string Alpine would otherwise use to denote included
30870 text from the message being replied to.<P>
30871
30872 Thus, you can change Alpine's default message quote character (usually
30873 an angle bracket) on a per message basis. So you could change your quoted message to
30874 look, for example, like this:<p>
30875
30876 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
30877
30878 John: I just wanted to say hello and to congratulate you
30879 John: on a job well done!</pre><p>
30880
30881 The configuration option
30882 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
30883 may be used to change what appears as the default string to be edited.
30884 <P>
30885 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
30886 currently being replied to.
30887 <P>
30888 If you change your <!--#echo var="VAR_reply-indent-string"-->
30889 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
30890 quoted text will not be flowed
30891 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
30892 when you reply.
30893 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
30894 set to the default value.
30895 <P>
30896 <UL>
30897 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30898 </UL><P>
30899 &lt;End of help on this topic&gt;
30900 </BODY>
30901 </HTML>
30902 ====== h_config_enable_search_and_repl =====
30903 <HTML>
30904 <HEAD>
30905 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
30906 </HEAD>
30907 <BODY>
30908 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
30909
30910 This feature modifies the behavior of Alpine's composer.  Setting this
30911 feature causes Alpine to offer the "^R Replace" subcommand, which
30912 allows you to search and replace text strings in a message you are composing,
30913 inside the "^W Where is" command.
30914
30915 <P>
30916
30917 To search and replace text, first enter the text to be replaced at the
30918 "Search: " prompt.  Then, rather than pressing Enter to just search for that
30919 text, press ^R, which turns the prompt into
30920
30921 <P>
30922
30923 Search (to replace):
30924
30925 <P>
30926
30927 and then press Enter.  The cursor will highlight the first occurrence
30928 of the text string you entered, and the prompt will show:
30929
30930 <P>
30931
30932 Replace "<your text string>" with :
30933
30934 <P>
30935
30936 where <your text string> is what you entered at the previous prompt;
30937 here, enter the replacement text.  To only replace the highlighted
30938 occurrence, simply press Enter now; to replace all occurrences in the
30939 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
30940 each replacement.
30941
30942 <P>
30943
30944 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
30945 ^X toggles between "Replace All" and "Replace One."
30946
30947 <P>
30948
30949 If you previously searched for text in a message, it will be offered for
30950 re-use as part of the prompt, shown in [ ] brackets.
30951
30952 <P>
30953 &lt;End of help on this topic&gt;
30954 </BODY>
30955 </HTML>
30956 ====== h_config_enable_view_attach =====
30957 <HTML>
30958 <HEAD>
30959 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
30960 </HEAD>
30961 <BODY>
30962 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
30963
30964 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30965 Setting this feature causes Alpine to present attachments in boldface.
30966 The first available attachment is displayed in inverse.  This is the
30967 "selected" attachment.  Pressing RETURN will cause Alpine to display
30968 the selected attachment.  Use the arrow keys to change which of the
30969 attachments displayed in boldface is the current selection.
30970
30971 <P>
30972
30973 Speaking of arrow keys, the Up and Down Arrows will select the next
30974 and previous attachments if one is available on the screen for selection.
30975 Otherwise, they will simply adjust the viewed text one line up or down.
30976
30977 <P>
30978
30979 Similarly, when selectable items are present in a message, the Ctrl-F key
30980 can be used to select the next item in the message independent of which
30981 portion of the viewed message is currently displayed. The Ctrl-B key can
30982 be used to select the previous item in the same way.
30983 <P>
30984 &lt;End of help on this topic&gt;
30985 </BODY>
30986 </HTML>
30987 ====== h_config_enable_y_print =====
30988 <HTML>
30989 <HEAD>
30990 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
30991 </HEAD>
30992 <BODY>
30993 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
30994
30995 This feature modifies the behavior of Alpine's Print command.
30996 <P>
30997 By default, Alpine's print command is available by pressing the "%" key.
30998 (This command is a substantial change from Pine versions before 4.00 --
30999 where the print command was "Y" -- based on numerous complaints about
31000 printing being invoked inadvertently, since Y also means "Yes.")
31001
31002 <P>
31003
31004 This feature is supplied to mitigate any disruption or anxiety users
31005 might feel as a result of this change.
31006
31007 <P>
31008
31009 Enabling this feature will cause Alpine to recognize both the old
31010 command, "Y" for Prynt, as well the new "%" method for invoking
31011 printing.  Note, key menu labels are not changed as a result of
31012 enabling this feature.
31013
31014 <P>
31015
31016 &lt;End of help on this topic&gt;
31017 </BODY>
31018 </HTML>
31019 ====== h_config_enable_lessthan_exit =====
31020 <HTML>
31021 <HEAD>
31022 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
31023 </HEAD>
31024 <BODY>
31025 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
31026
31027 If this feature is set, then on screens where there is an Exit command
31028 but no < command, the < key will perform the same function as the Exit
31029 command.
31030 This feature is set by default.
31031 <P>
31032 &lt;End of help on this topic&gt;
31033 </BODY>
31034 </HTML>
31035 ====== h_config_enable_view_url =====
31036 <HTML>
31037 <HEAD>
31038 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
31039 </HEAD>
31040 <BODY>
31041 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
31042 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31043 When this feature is set (the default) Alpine will select possible URLs from the
31044 displayed text and display them in boldface for selection.
31045 <P>
31046 The first available URL is displayed in inverse.  This is the
31047 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
31048 the selected URL via either built-in means as with mailto:, imap:,
31049 news:, and nntp:, or via an external application as defined
31050 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
31051 variable.
31052 <P>
31053 Use the arrow keys to change which of the URLs displayed in boldface
31054 is the current selection.
31055 <P>
31056 Speaking of arrow keys, the Up and Down Arrows will select the next
31057 and previous URL if one is available on the screen for selection (unless
31058 you have set the feature
31059 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
31060 Otherwise, they will simply adjust the viewed text one line up or down.
31061 <P>
31062 Similarly, when selectable items are present in a message, the Ctrl-F
31063 key can be used to select the next item in the message independent
31064 of which portion of the viewed message is currently displayed. The
31065 Ctrl-B key can be used to select the previous item in the same way.
31066 <P>
31067 <UL>
31068 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31069 </UL><P>
31070 &lt;End of help on this topic&gt;
31071 </BODY>
31072 </HTML>
31073 ====== h_config_enable_view_web_host =====
31074 <HTML>
31075 <HEAD>
31076 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
31077 </HEAD>
31078 <BODY>
31079 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
31080
31081 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31082 When this feature is set (the default) Alpine will select possible web hostnames
31083 from the displayed text and display them in boldface for selection.
31084 This can be useful when you receive messages referencing World Wide Web
31085 sites without the use of complete URLs; for example, specifying only
31086 &quot;www.some.site.com&quot; (which will <B>not</B> become a
31087 selectable
31088 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
31089 rather than explicitly
31090 &quot;http://www.some.site.com&quot;.
31091 <P>
31092 The first available hostname is displayed in inverse.  This is the
31093 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
31094 the selected hostname via an external application as defined
31095 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
31096 variable.
31097 <P>
31098 Use the arrow keys (unless you have set the feature
31099 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
31100 to change which of the hostnames displayed in
31101 boldface is the current selection.
31102 <P>
31103 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
31104 key can be used to select the next web hostname in the message independent
31105 of which portion of the viewed message is currently displayed. The
31106 Ctrl-B key can be used to select the previous web hostnames in the same way.
31107 <P>
31108 <UL>
31109 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31110 </UL><P>
31111 &lt;End of help on this topic&gt;
31112 </BODY>
31113 </HTML>
31114 ====== h_config_enable_view_addresses =====
31115 <HTML>
31116 <HEAD>
31117 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
31118 </HEAD>
31119 <BODY>
31120 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
31121
31122 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
31123 Setting this feature causes Alpine to select possible email addresses
31124 from the displayed text and display them in boldface for selection.
31125
31126 <P>
31127 The first available email address is displayed in inverse.  This is the
31128 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
31129 the message composition screen with the To: field filled in with the
31130 selected address.
31131 <P>
31132 Use the arrow keys (unless you have set the feature
31133 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
31134 to change which of the hostnames displayed in
31135 boldface is the current selection.
31136 <P>
31137 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
31138 key can be used to select the next web hostname in the message independent
31139 of which portion of the viewed message is currently displayed. The
31140 Ctrl-B key can be used to select the previous web hostnames in the same way.
31141 <P>
31142 <UL>
31143 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31144 </UL><P>
31145 &lt;End of help on this topic&gt;
31146 </BODY>
31147 </HTML>
31148 ====== h_external_loads_inline_images_only =====
31149 <HTML>
31150 <HEAD>
31151 <TITLE>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></TITLE>
31152 </HEAD>
31153 <BODY>
31154 <H1>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></H1>
31155
31156 Alpine allows you to pass a HTML message to the browser that you have configured in your
31157 <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A> variable. This allows
31158 you to read a message outside of Alpine. This is desirable when Alpine does not display
31159 html correctly, or when you wish to read the message and see the inline images in the message.
31160
31161 <P>
31162 An inline image is one that comes with the message and is necessary for the correct display of
31163 the message. However, there are instances in which the source of an image will come from
31164 external servers. If this feature is enabled (the default) then Alpine will only pass inline
31165 images to the browser and will remove the link to external images, so only inline images will
31166 be used to display the message, and no external image will be loaded. Alpine does this to protect
31167 your privacy and security.
31168
31169 <P>
31170 Please note that messages are usually formatted by the sender so that they display correctly once
31171 all images have been loaded. Enabling this feature might cause the message not to be correctly
31172 displayed by your browser.
31173
31174 <P>
31175 Also consider security and privacy implications of opening an HTML message in a browser. You are
31176 always protected when you do not use this feature, but you might not have the same level of
31177 protection if you try to open a spam or scam using the html view. Also commercial email is
31178 normally embedded with links to external images that let them, their partners, and your internet
31179 service provider (which could be your employer or school)  know that you opened their message or
31180 connected to a web site, violating your privacy.
31181
31182 <P>
31183 If you are worried about your privacy and security, do not use an external viewer to open
31184 html files, and keep using the internal mechanisms that Alpine provides to read messages.
31185
31186 <P>
31187 &lt;End of help on this topic&gt;
31188 </BODY>
31189 <HTML>
31190 ====== h_config_enable_view_arrows =====
31191 <HTML>
31192 <HEAD>
31193 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
31194 </HEAD>
31195 <BODY>
31196 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
31197
31198 This feature modifies Up and Down arrow key behavior in Alpine's
31199 MESSAGE TEXT screen when selectable Attachments, URL's, or
31200 web-hostnames are presented. Alpine's usual behavior is to move to
31201 the next or previous selectable item if currently displayed or
31202 simply to adjust the screen view by one line.
31203
31204 <P>
31205
31206 Setting this feature causes the UP and Down arrow key to behave as
31207 if no selectable items were present in the message.
31208
31209 <P>
31210
31211 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
31212 item) functionality is unchanged.
31213 <P>
31214
31215 &lt;End of help on this topic&gt;
31216 </BODY>
31217 <HTML>
31218 ====== h_config_quell_charset_warning =====
31219 <HTML>
31220 <HEAD>
31221 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
31222 </HEAD>
31223 <BODY>
31224 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
31225
31226 By default, if the message you are viewing contains characters that are
31227 not representable in your
31228 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
31229 then Alpine will
31230 add a warning to the start of the displayed text.
31231 If this option is set, then that editorial message will be suppressed.
31232 <P>
31233 Setting this feature also suppresses the comment about the character set
31234 in header lines.
31235 For example, when viewing a message you might see
31236 <P>
31237 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
31238 <P>
31239 in the From header if your Character-Set is something other than ISO-8859-2.
31240 If you set this feature, the comment about the character set will
31241 no longer be there.
31242 <P>
31243 &lt;End of help on this topic&gt;
31244 </BODY>
31245 </HTML>
31246 ====== h_config_quell_host_after_url =====
31247 <HTML>
31248 <HEAD>
31249 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
31250 </HEAD>
31251 <BODY>
31252 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
31253
31254 By default, links in HTML text are displayed with the host the link
31255 references appended, within square brackets, to the link text.  Alpine
31256 does this to help indicate where a link will take you, particularly when
31257 the link text might suggest a different destination.
31258
31259 <P>
31260 Setting this feature will prevent the server name from being appended
31261 to the displayed text.
31262
31263 <P>
31264 &lt;End of help on this topic&gt;
31265 </BODY>
31266 </HTML>
31267 ====== h_config_prefer_plain_text =====
31268 <HTML>
31269 <HEAD>
31270 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
31271 </HEAD>
31272 <BODY>
31273 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
31274
31275 A message being viewed may contain alternate versions of the same content.
31276 Those alternate versions are supposed to be ordered by the sending software such that the
31277 first alternative is the least preferred and the last alternative is the
31278 most preferred. Alpine will normally display the most-preferred version that
31279 it knows how to display. This is most often encountered where the two
31280 alternate versions are a plain text version and an HTML version, with the
31281 HTML version listed last as the most preferred.
31282 <P>
31283 If this option is set, then any plain text version will be preferred to
31284 all other versions.
31285 <P>
31286 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
31287 which will temporarily change the sense of this option.
31288 If this option is set you will first see the plain text version of a
31289 message.
31290 If you then type the &quot;A&quot; command, you will see the most preferred version,
31291 most likely HTML, instead.
31292 Typing the &quot;A&quot; command a second time will switch it back.
31293 Alternatively, if the present option is not set you will originally see
31294 the most preferred version of the message and typing &quot;A&quot; will switch to
31295 the plain text version.
31296 <P>
31297 &lt;End of help on this topic&gt;
31298 </BODY>
31299 </HTML>
31300 ====== h_config_pass_control =====
31301 <HTML>
31302 <HEAD>
31303 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
31304 </HEAD>
31305 <BODY>
31306 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
31307
31308 It is probably not useful to set this option.
31309 This is a legacy option left behind &quot;just in case&quot;.
31310 Multi-byte characters that have an octet that has the same
31311 value as a control character are permitted through whether or not
31312 this option is turned on.
31313 <P>
31314 This feature controls how certain characters contained in messages are
31315 displayed.
31316 If set, all characters in a message will be sent to the
31317 screen. Normally, control characters are displayed as shown below to
31318 avoid a garbled screen and to
31319 avoid inadvertently changing terminal setup parameters.
31320 Control characters are usually displayed as two character sequences like
31321 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
31322 for Control-C,
31323 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
31324 for ESCAPE,
31325 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
31326 for DELETE, and
31327 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
31328 for the character with value 133 (0x85).
31329 (The DEL character is displayed as ^?, regular control characters are displayed
31330 as the character ^ followed by the character obtained by adding the
31331 five low-order bits of the character to 0x40, and the C1
31332 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
31333 character obtained by adding the
31334 five low-order bits of the character to 0x40.)
31335 Sometimes, in cases where changing a single control character into a
31336 two-character sequence would confuse Alpine's display routines,
31337 a question mark is substituted for the control character.
31338 <P>
31339 If you wish to filter out regular control characters but pass the
31340 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31341 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.
31342 <P>
31343 &lt;End of help on this topic&gt;
31344 </BODY>
31345 </HTML>
31346 ====== h_config_pass_c1_control =====
31347 <HTML>
31348 <HEAD>
31349 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
31350 </HEAD>
31351 <BODY>
31352 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
31353
31354 It is probably not useful to set this option.
31355 This is a legacy option left behind &quot;just in case&quot;.
31356 Multi-byte characters that have an octet that has the same
31357 value as a control character are permitted through whether or not
31358 this option is turned on.
31359 <P>
31360 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31361 is set, then this feature has no effect.
31362 However, if you wish to filter out regular control characters but pass the
31363 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31364 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31365 unset and set this feature.
31366 <P>
31367 &lt;End of help on this topic&gt;
31368 </BODY>
31369 </HTML>
31370 ====== h_config_fcc_on_bounce =====
31371 <HTML>
31372 <HEAD>
31373 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
31374 </HEAD>
31375 <BODY>
31376 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
31377
31378 This feature controls an aspect of Alpine's behavior when bouncing a
31379 message. If set, normal FCC ("File Carbon Copy") processing will be
31380 done, just as if you had composed a message to the address you are
31381 bouncing to.  If not set, no FCC of the message will be saved.
31382 <P>
31383 &lt;End of help on this topic&gt;
31384 </BODY>
31385 </HTML>
31386 ====== h_config_show_cursor =====
31387 <HTML>
31388 <HEAD>
31389 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
31390 </HEAD>
31391 <BODY>
31392 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
31393
31394 This feature controls an aspect of Alpine's displays.  If set, the system
31395 cursor will move to convenient locations in the displays.  For example,
31396 to the beginning of the status field of the highlighted index line, or
31397 to the highlighted word after a successful WhereIs command.  It is intended
31398 to draw your attention to an "interesting" spot on the screen.
31399 <P>
31400 &lt;End of help on this topic&gt;
31401 </BODY>
31402 </HTML>
31403 ====== h_config_sort_fcc_alpha =====
31404 <HTML>
31405 <HEAD>
31406 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
31407 </HEAD>
31408 <BODY>
31409 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
31410
31411 This feature controls an aspect of Alpine's FOLDER LIST screen.
31412 If set, the default Fcc folder will be sorted alphabetically with the other
31413 folders instead of appearing right after the INBOX.
31414 <P>
31415 &lt;End of help on this topic&gt;
31416 </BODY>
31417 </HTML>
31418 ====== h_config_sort_save_alpha =====
31419 <HTML>
31420 <HEAD>
31421 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
31422 </HEAD>
31423 <BODY>
31424 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
31425
31426 This feature controls an aspect of Alpine's FOLDER LIST screen.
31427 If set, the default save folder will be sorted alphabetically with the other
31428 folders instead of appearing right after the INBOX (and default FCC folder).
31429 <P>
31430 &lt;End of help on this topic&gt;
31431 </BODY>
31432 </HTML>
31433 ====== h_config_single_list =====
31434 <HTML>
31435 <HEAD>
31436 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
31437 </HEAD>
31438 <BODY>
31439 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
31440
31441 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
31442 the folders will be listed one per line instead of several per line
31443 in the FOLDER LIST display.
31444 <P>
31445 &lt;End of help on this topic&gt;
31446 </BODY>
31447 </HTML>
31448 ====== h_config_vertical_list =====
31449 <HTML>
31450 <HEAD>
31451 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
31452 </HEAD>
31453 <BODY>
31454 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
31455
31456 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
31457 the folders will be listed alphabetically down the columns rather
31458 than across the columns as is the default.
31459 <P>
31460 &lt;End of help on this topic&gt;
31461 </BODY>
31462 </HTML>
31463 ====== h_config_verbose_post =====
31464 <HTML>
31465 <HEAD>
31466 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
31467 </HEAD>
31468 <BODY>
31469 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
31470 This feature controls an aspect of Alpine's message sending.  When enabled,
31471 Alpine will send a VERB (i.e., VERBose) command early in the posting process
31472 intended to cause the SMTP server to provide a more detailed account of
31473 the transaction.  This feature is typically only useful to system
31474 administrators and other support personnel as an aid in troubleshooting
31475 problems.
31476 <P>
31477 Note, this feature relies on a specific capability of the system's mail
31478 transport agent or configured
31479 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
31480 It is possible that this
31481 feature will cause problems for some transport agents, and may result in
31482 sending failure.  In addition, as the verbose output comes from the mail
31483 transport agent, it is likely to vary from one system to another.
31484 <P><UL>
31485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31486 </UL><P>
31487 &lt;End of help on this topic&gt;
31488 </BODY>
31489 </HTML>
31490 ====== h_config_auto_reply_to =====
31491 <HTML>
31492 <HEAD>
31493 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
31494 </HEAD>
31495 <BODY>
31496 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
31497
31498 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
31499 will not prompt when a message being replied to contains a "Reply-To:"
31500 header value, but will simply use its value (as opposed to using the
31501 "From:" field's value).
31502
31503 <P>
31504
31505 Note: Using the "Reply-To:" address is usually the preferred behavior,
31506 however, some mailing list managers choose to place the list's address in
31507 the "Reply-To:" field of any message sent out to the list.  In such
31508 cases, this feature makes it all too easy for personal replies to be
31509 inadvertently sent to the entire mail list, so be careful!
31510 <P>
31511 &lt;End of help on this topic&gt;
31512 </BODY>
31513 </HTML>
31514 ====== h_config_del_skips_del =====
31515 <HTML>
31516 <HEAD>
31517 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
31518 </HEAD>
31519 <BODY>
31520 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
31521
31522 This feature controls an aspect of Alpine's Delete command.  If set, this
31523 feature will cause the Delete command to advance past following messages that
31524 are marked deleted.  In other words, pressing "D" will both mark the
31525 current message deleted and advance to the next message that is not marked
31526 deleted.
31527 This feature is set by default.
31528 <P>
31529 &lt;End of help on this topic&gt;
31530 </BODY></HTML>
31531 ====== h_config_expunge_manually =====
31532 <HTML>
31533 <HEAD>
31534 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
31535 </HEAD>
31536 <BODY>
31537 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
31538
31539 Normally, when you close a folder that contains deleted messages you are
31540 asked if you want to expunge those messages from the folder permanently.
31541 If this feature is set, you won't be asked and the deleted messages will
31542 remain in the folder.
31543 If you choose to set this feature you will have to expunge the
31544 messages manually using the eXpunge command, which you can use while
31545 in the MESSAGE INDEX screen.
31546 If you do not expunge deleted messages the size of your
31547 folder will continue to increase until you are out of disk space.
31548 <P>
31549 <UL>
31550 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31551 </UL><P>
31552 &lt;End of help on this topic&gt;
31553 </BODY>
31554 </HTML>
31555 ====== h_config_auto_expunge =====
31556 <HTML>
31557 <HEAD>
31558 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
31559 </HEAD>
31560 <BODY>
31561 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
31562
31563 This features controls an aspect of Alpine's eXpunge command.  If set, you
31564 will <B>not</B> be prompted to confirm your intent before the expunge takes
31565 place.
31566 Actually, this is only true for the INBOX folder and for folders in the
31567 Incoming Folders collection. See the feature
31568 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
31569 <P>
31570 <UL>
31571 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31572 </UL><P>
31573 &lt;End of help on this topic&gt;
31574 </BODY>
31575 </HTML>
31576 ====== h_config_full_auto_expunge =====
31577 <HTML>
31578 <HEAD>
31579 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
31580 </HEAD>
31581 <BODY>
31582 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
31583
31584 This features controls an aspect of Alpine's eXpunge command.  If set, you
31585 will <B>not</B> be prompted to confirm your intent before the expunge
31586 takes place.  This feature sets this behavior for all folders, unlike the
31587 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
31588 feature that works only for incoming folders.
31589 <P>
31590 <UL>
31591 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31592 </UL><P>
31593 &lt;End of help on this topic&gt;
31594 </BODY>
31595 </HTML>
31596 ====== h_config_auto_read_msgs =====
31597 <HTML>
31598 <HEAD>
31599 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
31600 </HEAD>
31601 <BODY>
31602 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
31603 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
31604 and the
31605 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
31606 option is also set, then Alpine will
31607 automatically transfer all read messages to the designated folder and mark
31608 them as deleted in the INBOX.  Messages in the INBOX marked with an
31609 &quot;N&quot; (meaning New, or unseen) are not affected.
31610 <P>
31611 <UL>
31612 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31613 </UL><P>
31614 &lt;End of help on this topic&gt;
31615 </BODY>
31616 </HTML>
31617 ====== h_config_auto_fcc_only =====
31618 <HTML>
31619 <HEAD>
31620 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
31621 </HEAD>
31622 <BODY>
31623 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
31624 This features controls an aspect of Alpine's composer.
31625 The only time this feature will be used is if you attempt to send mail
31626 that has no recipients but does have an Fcc.
31627 Normally, Alpine will ask if you really mean to copy the message only to
31628 the Fcc.
31629 That is, it asks if you really meant to have no recipients.
31630 If this feature is set, you
31631 will <B>not</B> be prompted to confirm your intent to make only a copy
31632 of a message with no recipients.
31633 <P>
31634 This feature is closely related to
31635 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
31636 The difference between this feature and that feature is that this feature
31637 considers a Bcc to be a recipient while that feature will ask for confirmation
31638 even if there is a Bcc when there is no To, Cc, or Newsgroup.
31639 The default values also differ. This feature defaults to asking the question
31640 and you have to turn it off.
31641 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
31642 unless you turn it on.
31643 <P>
31644
31645 <UL>
31646 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31647 </UL><P>
31648 &lt;End of help on this topic&gt;
31649 </BODY>
31650 </HTML>
31651 ====== h_config_mark_fcc_seen =====
31652 <HTML>
31653 <HEAD>
31654 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
31655 </HEAD>
31656 <BODY>
31657 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
31658
31659 This features controls the way Fccs (File carbon copies) are
31660 made of the messages you send.
31661
31662 <P>
31663 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
31664 copy will be marked as Unseen.
31665 When you look at the folder it was saved in the message will appear to
31666 be a New message until you read it.
31667 When this feature is enabled, the message will be marked as having
31668 been Seen.
31669
31670 <P>
31671 <UL>
31672 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31673 </UL><P>
31674 &lt;End of help on this topic&gt;
31675 </BODY>
31676 </HTML>
31677 ====== h_config_no_fcc_attach =====
31678 <HTML>
31679 <HEAD>
31680 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
31681 </HEAD>
31682 <BODY>
31683 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
31684
31685 This features controls the way Fcc's (File carbon copies) are
31686 made of the messages you send.
31687
31688 <P>
31689 Normally, Alpine saves an exact copy of your message as it was sent.
31690 When this feature is enabled, the &quot;body&quot; of the message
31691 you send (the text you type in the composer) is preserved in the
31692 copy as before, however all attachments are replaced with text
31693 explaining what had been sent rather than the attachments themselves.
31694
31695 <P>
31696 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
31697 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
31698 allows you to interactively set whether or not attachments are saved
31699 to the Fcc'd copy.
31700
31701 <P>
31702 <UL>
31703 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31704 </UL><P>
31705 &lt;End of help on this topic&gt;
31706 </BODY>
31707 </HTML>
31708 ====== h_config_read_in_newsrc_order =====
31709 <HTML>
31710 <HEAD>
31711 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
31712 </HEAD>
31713 <BODY>
31714 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
31715
31716 This feature controls the order in which newsgroups will be presented.  If
31717 set, they will be presented in the same order as they occur in your
31718 <!--chtml if pinemode="os_windows"-->
31719 &quot;NEWSRC&quot;
31720 <!--chtml else-->
31721 &quot;.newsrc&quot;
31722 <!--chtml endif-->
31723 file (the default location of which can be changed with the
31724 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
31725 <P>
31726 If not set, the newsgroups will be presented in alphabetical order.
31727 <P>
31728 <UL>
31729 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31730 </UL><P>
31731 &lt;End of help on this topic&gt;
31732 </BODY>
31733 </HTML>
31734 ====== h_config_quell_tz_comment =====
31735 <HTML>
31736 <HEAD>
31737 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
31738 </HEAD>
31739 <BODY>
31740 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
31741
31742 Normally, when Alpine generates a Date header for outgoing mail,
31743 it will try to include the symbolic timezone at the end of the
31744 header inside parentheses.
31745 The symbolic timezone is often three characters long, but on
31746 some operating systems, it may be longer.
31747 Apparently there are some SMTP servers in the world that will reject an
31748 incoming message if it has a Date header longer than about 80 characters.
31749 If this feature is set, the symbolic timezone normally generated by
31750 Alpine will not be included.
31751 You probably don't need to worry about this feature unless you run into
31752 the problem described above.
31753
31754 <P>
31755 &lt;End of help on this topic&gt;
31756 </BODY>
31757 </HTML>
31758 ====== h_config_post_wo_validation =====
31759 <HTML>
31760 <HEAD>
31761 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
31762 </HEAD>
31763 <BODY>
31764 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
31765
31766 This feature controls whether the NNTP server is queried as newsgroups
31767 are entered for posting.  Validation over slow links (e.g. dialup using
31768 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
31769 <P>
31770 &lt;End of help on this topic&gt;
31771 </BODY>
31772 </HTML>
31773 ====== h_config_send_wo_confirm =====
31774 <HTML>
31775 <HEAD>
31776 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
31777 </HEAD>
31778 <BODY>
31779 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
31780
31781 By default, when you send or post a message you will be asked to confirm
31782 with a question that looks something like:
31783
31784 <P>
31785 <CENTER><SAMP>Send message?</SAMP></CENTER>
31786 <P>
31787
31788 If this feature is set, you
31789 will <B>not</B> be prompted to confirm your intent to send
31790 and your message will be sent.
31791 <P>
31792 If this feature is set it disables some possibilities and renders some
31793 other features meaningless.
31794 You will not be able to use
31795 <A HREF="h_config_sending_filter">Sending Filters</A>,
31796 Verbose sending mode,
31797 <A HREF="h_config_compose_bg_post">Background Sending</A>,
31798 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
31799 or ^V to turn off the generation of flowed text for this message.
31800 These options are normally available as suboptions in the Send prompt, but
31801 with no Send prompt the options are gone.
31802
31803 <P>
31804 A somewhat related feature is
31805 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
31806 which may be used to eliminate the extra confirmation
31807 question when posting to a newsgroup.
31808 <P>
31809 <UL>
31810 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31811 </UL><P>
31812 &lt;End of help on this topic&gt;
31813 </BODY>
31814 </HTML>
31815 ====== h_config_quell_filtering_done_message =====
31816 <HTML>
31817 <HEAD>
31818 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
31819 </HEAD>
31820 <BODY>
31821 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
31822
31823 If you use Filter Rules that move messages or set status of messages
31824 you sometimes see a message from Alpine that looks like
31825
31826 <P>
31827 <CENTER><SAMP>filtering done</SAMP></CENTER>
31828 <P>
31829
31830 If this feature is set, this message will be suppressed.
31831 If the feature
31832 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
31833 is set then this message will be suppressed regardless.
31834
31835 <P>
31836 <UL>
31837 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31838 </UL><P>
31839 &lt;End of help on this topic&gt;
31840 </BODY>
31841 </HTML>
31842 ====== h_config_quell_filtering_messages =====
31843 <HTML>
31844 <HEAD>
31845 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
31846 </HEAD>
31847 <BODY>
31848 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
31849
31850 If you use Filter Rules that move messages or set status of messages
31851 you sometimes see messages from Alpine that look like
31852
31853 <P>
31854 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
31855 <P>
31856
31857 or
31858
31859 <P>
31860 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
31861 <P>
31862
31863 or
31864
31865 <P>
31866 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
31867 <P>
31868
31869 If this feature is set, these messages will be suppressed.
31870 The feature
31871 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
31872 is related.
31873
31874 <P>
31875 <UL>
31876 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31877 </UL><P>
31878 &lt;End of help on this topic&gt;
31879 </BODY>
31880 </HTML>
31881 ====== h_config_quell_post_prompt =====
31882 <HTML>
31883 <HEAD>
31884 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
31885 </HEAD>
31886 <BODY>
31887 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
31888
31889 By default, when you post a message to a newsgroup you are asked to confirm
31890 that you want to post with the question
31891
31892 <P>
31893 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
31894 <P>
31895
31896 If this feature is set, you
31897 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
31898 and your message will be posted.
31899
31900 <P>
31901 <UL>
31902 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31903 </UL><P>
31904 &lt;End of help on this topic&gt;
31905 </BODY>
31906 </HTML>
31907 ====== h_config_check_mail_onquit =====
31908 <HTML>
31909 <HEAD>
31910 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
31911 </HEAD>
31912 <BODY>
31913 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
31914
31915 If this feature is set, Alpine will check for new mail after you give the
31916 Quit command.
31917 If new mail has arrived since the previous check, you will be notified
31918 and given the choice of quitting or not quitting.
31919 <P>
31920 <UL>
31921 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31922 </UL><P>
31923 &lt;End of help on this topic&gt;
31924 </BODY>
31925 </HTML>
31926 ====== h_config_inbox_no_confirm =====
31927 <HTML>
31928 <HEAD>
31929 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
31930 </HEAD>
31931 <BODY>
31932 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
31933
31934 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
31935 command and there are no more folders or newsgroups to visit, you are asked
31936 if you want to return to the INBOX.
31937 If this feature is set you will not be asked.
31938 It will be assumed that you do want to return to the INBOX.
31939 <P>
31940 <UL>
31941 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31942 </UL><P>
31943 &lt;End of help on this topic&gt;
31944 </BODY>
31945 </HTML>
31946 ====== h_config_dates_to_local =====
31947 <HTML>
31948 <HEAD>
31949 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
31950 </HEAD>
31951 <BODY>
31952 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
31953
31954 Normally, the message dates that you see in the
31955 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
31956 For example, if a message was sent to you from a few timezones to the east
31957 it might appear that it was sent from the future;
31958 or if it was sent from somewhere to the west it might appear
31959 as if it is from yesterday even though it was sent only a few minutes ago.
31960 If this feature is set an attempt will be made to convert the dates
31961 to your local timezone to be displayed.
31962 <P>
31963 Note that this does not affect the results of Select by Date or of
31964 anything else other than these displayed dates.
31965 When viewing the message you may look at the original unconverted value of the Date
31966 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
31967 <P>
31968 <UL>
31969 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31970 </UL><P>
31971 &lt;End of help on this topic&gt;
31972 </BODY>
31973 </HTML>
31974 ====== h_config_tab_no_prompt =====
31975 <HTML>
31976 <HEAD>
31977 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
31978 </HEAD>
31979 <BODY>
31980 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
31981
31982 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
31983 command and there is a problem checking a folder, you are asked
31984 whether you want to continue with the search in the following folder or not.
31985 This question gives you a chance to stop the NextNew processing.
31986 (The checking problem might be caused by the fact that the folder does not
31987 exist, or by an authentication problem, or by a server problem
31988 of some sort.)
31989 <P>
31990
31991 If this feature is set you will not be asked.
31992 It will be assumed that you do want to continue.
31993 <P>
31994 <UL>
31995 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31996 </UL><P>
31997 &lt;End of help on this topic&gt;
31998 </BODY>
31999 </HTML>
32000 ====== h_config_input_history =====
32001 <HTML>
32002 <HEAD>
32003 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
32004 </HEAD>
32005 <BODY>
32006 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
32007
32008 Many of the prompts that ask for input in the status line near the
32009 bottom of the screen will respond to Up Arrow and Down Arrow
32010 with the history of previous entries.
32011 For example, in the MESSAGE INDEX screen when you use the WhereIs
32012 command the text you entered will be remembered and can be recalled
32013 by using the Up Arrow key.
32014 Another example, when saving a message the folders saved to will
32015 be remembered and can be recalled using the arrow keys.
32016 <P>
32017 In the Save prompt, some users prefer that the Up and Down arrow keys
32018 be used for the Previous Collection and Next Collection commands
32019 instead of for a history of previous saves.
32020 If this option is set the Up and Down arrow keys will become synonyms for the
32021 Previous Collection and Next Collection (^P and ^N) commands in the
32022 prompt for the name of a folder to Save to or in the prompt for the
32023 name of a folder to GoTo.
32024 When this feature is not set (the default), ^P and ^N will change the
32025 collection and the arrow keys will show the history.
32026 <P>
32027 <UL>
32028 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32029 </UL><P>
32030 &lt;End of help on this topic&gt;
32031 </BODY>
32032 </HTML>
32033 ====== h_config_confirm_role =====
32034 <HTML>
32035 <HEAD>
32036 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
32037 </HEAD>
32038 <BODY>
32039 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
32040
32041 If you have roles, when you Reply to or Forward a message, or Compose
32042 a new message, Alpine
32043 will search through your roles for one that matches.
32044 Normally, if no matches are found you will be placed into the composer
32045 with no opportunity to select a role.
32046 If this feature is set, then you will be asked to confirm that you don't
32047 want a role.
32048 This will give you the opportunity to select a role (with the ^T command).
32049 If you confirm no role with a Return, you will be placed in
32050 the composer with no role.
32051 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
32052 These behave the same as if you pressed the Return.
32053 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
32054 match what you might type if there was a role match.)
32055 <P>
32056 If you are using the alternate form of the Compose command called
32057 &quot;Role&quot;, then all of your roles will be available to you,
32058 independent of the value of this feature and of the values set for all of
32059 Reply Use, Forward Use, and Compose Use.
32060 <P>
32061 <UL>
32062 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32063 </UL><P>
32064 &lt;End of help on this topic&gt;
32065 </BODY>
32066 </HTML>
32067 ====== h_config_news_cross_deletes =====
32068 <HTML>
32069 <HEAD>
32070 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
32071 </HEAD>
32072 <BODY>
32073 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
32074
32075 This feature controls what Alpine does when you delete a message in a
32076 newsgroup that appears in more than one newsgroup.  Such a message
32077 is sometimes termed a &quot;crossposting&quot; in that it was posted
32078 across several newsgroups.
32079
32080 <P>
32081 Alpine's default behavior when you delete such a message is to remove
32082 only the copy in the current newsgroup from view when you use the
32083 &quot;Exclude&quot; command or the next time you visit the newsgroup.
32084
32085 <P>
32086 Enabling this feature causes Alpine to remove every occurrence of the
32087 message from all newsgroups it appears in and to which you are
32088 subscribed.
32089
32090 <P>
32091 NOTE: As currently implemented, enabling this feature may increase the
32092 time it takes the Expunge command and newsgroup closing to complete.
32093
32094 <P>
32095 <UL>
32096 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32097 </UL><P>
32098 &lt;End of help on this topic&gt;
32099 </BODY>
32100 </HTML>
32101 ====== h_config_news_catchup =====
32102 <HTML>
32103 <HEAD>
32104 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
32105 </HEAD>
32106 <BODY>
32107 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
32108
32109 This feature controls what Alpine does as it closes a newsgroup.
32110 When set, Alpine will offer to delete all messages from the newsgroup
32111 as you are quitting Alpine or opening a new folder.
32112
32113 <P>
32114 This feature is useful if you typically read all the interesting messages
32115 in a newsgroup each time you open it.  This feature saves you from
32116 having to delete each message in a newsgroup as you read it or from
32117 selecting all the messages and doing an
32118 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
32119 move on to the next folder or newsgroup.
32120
32121 <P>
32122 <UL>
32123 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32124 </UL><P>
32125 &lt;End of help on this topic&gt;
32126 </BODY>
32127 </HTML>
32128 ====== h_config_next_thrd_wo_confirm =====
32129 <HTML>
32130 <HEAD>
32131 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
32132 </HEAD>
32133 <BODY>
32134 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
32135
32136 This feature controls an aspect of Alpine's Next and Prev commands in
32137 the case where you are using one of the
32138 &quot;separate-index-screen&quot; styles for the configuration option
32139 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
32140 and currently have the folder sorted by a Threaded or OrderedSubject sort.
32141 When you are Viewing a particular thread you have a
32142 MESSAGE INDEX of only the messages in that thread.
32143 If you press the Next command with the last message in the thread highlighted
32144 you will normally be asked if you want to &quot;View next thread?&quot;,
32145 assuming there is a next thread to view.
32146 If this feature is set it will be assumed that you always want to view the
32147 next thread and you won't be asked to confirm that.
32148 Similarly, if the first message of the thread is highlighted and you
32149 press the Prev command, this feature will prevent the question
32150 &quot;View previous thread&quot;.
32151 <P>
32152 This feature only has an effect in the MESSAGE INDEX screen.
32153 If you then view a particular message from that screen and press the
32154 Next command, you will be sent to the next thread without being asked,
32155 independent of the setting of this feature.
32156 <P>
32157 The feature
32158 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
32159 <P>
32160 &lt;End of help on this topic&gt;
32161 </BODY>
32162 </HTML>
32163 ====== h_config_kw_braces =====
32164 <HTML>
32165 <HEAD>
32166 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
32167 </HEAD>
32168 <BODY>
32169 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
32170
32171 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
32172 TEXT screens.
32173 If you have modified the
32174 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
32175 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
32176 are used to display keywords or their initials along with the Subject; then
32177 this option may be used to modify the resulting display slightly.
32178 By default, the keywords or initials displayed for these tokens will be
32179 surrounded with curly braces ({ and }) and a trailing space.
32180 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
32181 a message, the &quot;SUBJKEY&quot; token will normally look like
32182 <P>
32183 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
32184 <P>
32185 and the SUBJKEYINIT token would look like
32186 <P>
32187 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
32188 <P>
32189 The default character before the keywords is the left brace ({) and the
32190 default after the keywords is the right brace followed by a space (} ).
32191 <P>
32192 This option allows you to change that.
32193 You should set it to two values separated by a space.
32194 The values may be quoted if they include space characters.
32195 So, for example, the default value could be specified explicitly by setting this
32196 option to
32197 <P>
32198 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
32199 <P>
32200 The first part wouldn't need to be quoted (but it doesn't hurt).
32201 The second part does need the quotes because it includes a space character.
32202 If you wanted to change the braces to brackets you could use
32203 <P>
32204 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
32205 <P>
32206 Inside the quotes you can use backslash quote to mean quote, so
32207 <P>
32208 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
32209 <P>
32210 would produce
32211 <P>
32212 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
32213 <P>
32214 It is also possible to color keywords in the index using the
32215 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
32216 <P>
32217 It is not possible to change the fact that a space character is used to
32218 separate the keywords if more than one keyword is set for a message.
32219 It is also not possible to change the fact that there are no separators
32220 between the keyword initials if more than one keyword is set.
32221 <P>
32222 &lt;End of help on this topic&gt;
32223 </BODY>
32224 </HTML>
32225 ====== h_config_opening_sep =====
32226 <HTML>
32227 <HEAD>
32228 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
32229 </HEAD>
32230 <BODY>
32231 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
32232
32233 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
32234 With some setups the text of the subject is followed
32235 by the opening text of the message if there is any room available in the index line.
32236 If you have configured your
32237 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32238 to include one of the Subject tokens that causes this behavior
32239 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
32240 to modify what is displayed slightly.
32241 By default, the Subject is separated from the opening text of the message by
32242 the three characters space dash space;
32243 <P>
32244 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
32245 <P>
32246 Use this option to set it to something different.
32247 The value must be quoted if it includes any space characters.
32248 For example, the default value could be specified explicitly by setting this
32249 option to
32250 <P>
32251 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
32252 <P>
32253 &lt;End of help on this topic&gt;
32254 </BODY>
32255 </HTML>
32256 ====== h_config_select_wo_confirm =====
32257 <HTML>
32258 <HEAD>
32259 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
32260 </HEAD>
32261 <BODY>
32262 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
32263
32264 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
32265 These commands all take text input to specify the name of the folder or
32266 file to be used, but allow you to press ^T for a list of possible names.
32267 If set, the selected name will be used immediately, without further
32268 opportunity to confirm or edit the name.
32269 <P>
32270 Some related help topics are
32271 <UL>
32272 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
32273 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
32274 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
32275 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
32276 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
32277 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
32278 </UL>
32279 <P>
32280 &lt;End of help on this topic&gt;
32281 </BODY>
32282 </HTML>
32283 ====== h_config_save_part_wo_confirm =====
32284 <HTML>
32285 <HEAD>
32286 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
32287 </HEAD>
32288 <BODY>
32289 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
32290
32291 This feature controls an aspect of Alpine's Save command.
32292 By default, when you Save a message that has some deleted parts, you will
32293 be asked to confirm that you want to Save with a prompt that looks like:
32294 <P>
32295 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
32296 <P>
32297 If this feature is set, you will not be asked.
32298 <P>
32299 &lt;End of help on this topic&gt;
32300 </BODY>
32301 </HTML>
32302 ====== h_config_use_resentto =====
32303 <HTML>
32304 <HEAD>
32305 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
32306 </HEAD>
32307 <BODY>
32308 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
32309
32310 This feature is turned off by default because turning it on causes problems
32311 with some deficient IMAP servers.
32312 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
32313 <A HREF="h_rule_patterns">Pattern</A>
32314 contains a To header pattern and this feature is turned on,
32315 then a check is made in the message to see
32316 if a Resent-To header is present, and that is used instead of the To header.
32317 If this feature is not turned on, then the regular To header will always
32318 be used.
32319
32320 <P>
32321 &lt;End of help on this topic&gt;
32322 </BODY>
32323 </HTML>
32324 ====== h_config_use_reg_start_for_stayopen =====
32325 <HTML>
32326 <HEAD>
32327 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
32328 </HEAD>
32329 <BODY>
32330 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
32331
32332 This feature affects which message is selected as the current message
32333 when you enter a
32334 <A HREF="h_config_permlocked">Stay Open</A> folder.
32335 <P>
32336 Normally, the starting position for an incoming folder (which most Stay Open
32337 folders will likely be) is controlled by the
32338 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
32339 However, if a folder is a Stay Open folder, when you re-enter the folder
32340 after the first time the current message will be the same as it was when
32341 you left the folder.
32342 An exception is made if you use the TAB command to get to the folder.
32343 In that case, the message number will be incremented by one from what it
32344 was when you left the folder.
32345 <P>
32346 The above special behavior is thought to be useful.
32347 However, it is special and different from what you might at first expect.
32348 If this feature is set, then Stay Open folders will not be treated specially
32349 as far as the startup rule is concerned.
32350
32351 <P>
32352 &lt;End of help on this topic&gt;
32353 </BODY>
32354 </HTML>
32355 ====== h_config_use_current_dir =====
32356 <HTML>
32357 <HEAD>
32358 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
32359 </HEAD>
32360 <BODY>
32361 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
32362
32363 This feature controls an aspect of several commands.
32364 If set, your &quot;current working directory&quot;
32365 <!--chtml if pinemode="running"-->
32366 (which, at least for your current Alpine &quot;session,&quot;
32367 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
32368 <!--chtml endif-->
32369 will be used instead of your home directory
32370 <!--chtml if pinemode="running"-->
32371 (which, in the present configuration of your system, is
32372  &quot;<!--#echo var="HOME_DIR"-->&quot;)
32373 <!--chtml endif-->
32374 for all of the following operations:<UL>
32375     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
32376     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
32377     <LI> <!--chtml if pinemode="function_key"-->F4
32378          <!--chtml else-->Ctrl-R
32379          <!--chtml endif--> file inclusion in the COMPOSER
32380     <LI> <!--chtml if pinemode="function_key"-->F5
32381          <!--chtml else-->Ctrl-J
32382          <!--chtml endif--> file attachment in the COMPOSER
32383 </UL>
32384 <!--chtml if pinemode="os_windows"-->
32385 <P>
32386 If you are starting PC-Alpine from a desktop icon or the Start menu,
32387 you can set the &quot;current drive&quot;
32388 by specifying it in the &quot;Start in:&quot;
32389 box found in the Shortcut tab of the Properties.
32390 <!--chtml endif-->
32391 <P>
32392 <UL>
32393 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32394 </UL>
32395
32396 <P>
32397 &lt;End of help on this topic&gt;
32398 </BODY>
32399 </HTML>
32400 ====== h_config_save_wont_delete =====
32401 <HTML>
32402 <HEAD>
32403 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
32404 </HEAD>
32405 <BODY>
32406 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
32407
32408 This feature controls one aspect of the Save command.  If set, Save will
32409 not mark the message &quot;deleted&quot; (its default behavior) after
32410 it has been copied to the designated folder.
32411
32412 <P>
32413 &lt;End of help on this topic&gt;
32414 </BODY>
32415 </HTML>
32416 ====== h_config_use_boring_spinner =====
32417 <HTML>
32418 <HEAD>
32419 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
32420 </HEAD>
32421 <BODY>
32422 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
32423
32424 When Alpine is delayed for some reason it usually shows that
32425 something is happening with a small animated display in the status
32426 message line near the bottom of the screen.
32427 Setting this feature will cause that animation to be the same
32428 each time instead of having Alpine choose a random animation.
32429 You may turn the animation off altogether by setting the
32430 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
32431 option to zero.
32432
32433 <P>
32434 &lt;End of help on this topic&gt;
32435 </BODY>
32436 </HTML>
32437 ====== h_config_unsel_wont_advance =====
32438 <HTML>
32439 <HEAD>
32440 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
32441 </HEAD>
32442 <BODY>
32443 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
32444
32445 This feature controls one aspect of the Unselect Current message command.
32446 Normally, when the Unselect current message command (:) is typed when the
32447 current message is selected, the message will be unselected and the next
32448 message will become the current message.
32449 If this feature is set, the cursor will not advance to the next message.
32450 Instead, the current message will remain the current message after
32451 unselecting.
32452
32453 <P>
32454 &lt;End of help on this topic&gt;
32455 </BODY>
32456 </HTML>
32457 ====== h_config_prune_uses_iso =====
32458 <HTML>
32459 <HEAD>
32460 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
32461 </HEAD>
32462 <BODY>
32463 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
32464
32465 By default, Alpine asks monthly whether or not you would like to rename
32466 some folders to a new name containing the date.
32467 It also asks whether or not you would like to delete some old folders.
32468 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
32469 explanation.
32470
32471 <P>
32472 By default, the name used when renaming a folder looks like
32473 <P>
32474 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
32475 <P>
32476 For example, the first time you run Alpine in May of 2004,
32477 the folder &quot;sent-mail&quot; might be renamed to
32478 <P>
32479 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
32480 <P>
32481 If this feature is set, the name used will be of the form
32482 <P>
32483 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
32484 <P>
32485 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
32486 month (01, 02, ..., 12).
32487 For the April, 2004 example above, it would instead be
32488 <P>
32489 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
32490 <P>
32491 because April is the 4th month of the year.
32492 A reason you might want to set this feature is so that the folders
32493 will sort in chronological order.
32494
32495 <P>
32496 &lt;End of help on this topic&gt;
32497 </BODY>
32498 </HTML>
32499 ====== h_config_save_advances =====
32500 <HTML>
32501 <HEAD>
32502 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
32503 </HEAD>
32504 <BODY>
32505 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
32506
32507 This feature controls one aspect of the Save command.  If set, Save will
32508 (in addition to copying the current message to the designated folder) also
32509 advance to the next message.
32510
32511 <P>
32512 &lt;End of help on this topic&gt;
32513 </BODY>
32514 </HTML>
32515 ====== h_config_force_arrow =====
32516 <HTML>
32517 <HEAD>
32518 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
32519 </HEAD>
32520 <BODY>
32521 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
32522
32523 This feature affects Alpine's MESSAGE INDEX display routine.
32524 If set, the normal inverse-video cursor will be
32525 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
32526 second column of the index display.
32527 <P>
32528 This is the same index cursor you get if you turn on
32529 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
32530 line coloring will still be present if this feature is turned on and
32531 <!--#echo var="FEAT_assume-slow-link"--> is off.
32532 <P>
32533 An alternative version of the Arrow cursor is available by including the
32534 <A HREF="h_config_index_arrow_color">ARROW</A>
32535 token in the
32536 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32537 <P>
32538 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
32539 but that is not implemented.
32540
32541 <P>
32542 &lt;End of help on this topic&gt;
32543 </BODY>
32544 </HTML>
32545 ====== h_config_ignore_size =====
32546 <HTML>
32547 <HEAD>
32548 <TITLE>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></TITLE>
32549 </HEAD>
32550 <BODY>
32551 <H1>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></H1>
32552
32553 When you have an account residing in an IMAP server, Alpine records the
32554 size of each message as reported by the server. However, when Alpine saves
32555 a message in such IMAP server, Alpine will compute the size of the message
32556 independently, from the data it received. If these two numbers do not
32557 match for a message, Alpine asks you if you still want to take the risk of
32558 saving such message, since data corruption or loss of data could result
32559 from this save.
32560
32561 <P>
32562 Sometimes the root of this problem is that the IMAP server does not
32563 compute sizes correctly, and there will not be loss of information when
32564 saving such message. Enabling this feature will make Alpine ignore such
32565 error and continue saving the message without producing any warnings or
32566 ever stopping the process, as if there had not been any error. This option
32567 applies to all IMAP servers that you use, so if you enable this feature,
32568 size discrepancy warnings will not be given for any IMAP server you
32569 connect to.
32570
32571 <P>
32572 Example of a server where you could reproduce this problem is the Gmail
32573 IMAP server. Another example can be found in some versions of the Exchange
32574 server.
32575
32576 <P>
32577 It is recommended that this feature be disabled most of the time and only
32578 enabled when you find a server which you can determine that has the above
32579 mentioned defect, but be disabled again after making the save operation
32580 succeed.
32581
32582 <P>
32583 &lt;End of help on this topic&gt;
32584 </BODY>
32585 </HTML>
32586 ====== h_config_force_low_speed =====
32587 <HTML>
32588 <HEAD>
32589 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
32590 </HEAD>
32591 <BODY>
32592 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
32593
32594 UNIX Alpine only.
32595 <P>
32596 This feature affects Alpine's display routines.  If set, the normal
32597 inverse-video cursor (used to highlight the current item in a list) will be
32598 replaced by an &quot;arrow&quot; cursor and other
32599 screen update optimizations for
32600 low-speed links (e.g. 2400 bps dialup connections) will be activated.
32601 One of the optimizations is that colored index lines (set up with Indexcolor
32602 Rules) will not be colored.
32603 If you are just turning this feature on because you like using
32604 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
32605 coloring by turning this feature off and the
32606 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
32607
32608 <P>
32609 &lt;End of help on this topic&gt;
32610 </BODY>
32611 </HTML>
32612 ====== h_config_show_delay_cue =====
32613 <HTML>
32614 <HEAD>
32615 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
32616 </HEAD>
32617 <BODY>
32618 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
32619
32620 If set, this feature will cause an asterisk to appear in the upper
32621 left-hand corner of the screen whenever Alpine checks for new mail.
32622 Two asterisks whenever Alpine saves (checkpoints) the state of the current
32623 mailbox to disk.
32624
32625 <!--chtml if pinemode="os_windows"-->
32626 <P>
32627 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
32628 it is trying to open a network connection (e.g, to open your INBOX
32629 on an IMAP
32630 server) or read from the network connection.  A greater-than symbol,
32631 will be displayed when PC-Alpine is trying to write to the network
32632 connection (e.g, sending a command to your IMAP server).
32633 <!--chtml endif-->
32634
32635 <P>
32636 &lt;End of help on this topic&gt;
32637 </BODY>
32638 </HTML>
32639 ====== h_config_color_style =====
32640 <HTML>
32641 <HEAD>
32642 <TITLE>OPTION: Color Style</TITLE>
32643 </HEAD>
32644 <BODY>
32645 <H1>OPTION: Color Style</H1>
32646
32647 UNIX Alpine only.
32648 <P>
32649 If the terminal or terminal emulator you are using is capable of displaying
32650 colors, this option controls whether or not color will be used in Alpine.
32651 If you turn color on and things are set up correctly,
32652 you should see color appear on the screen immediately.
32653 Modern terminal emulators are usually capable of displaying colors.
32654 <P>
32655 The available options include:
32656 <P>
32657
32658 <DL>
32659 <DT>no-color</DT>
32660 <DD>Don't use color.
32661 </DD>
32662
32663 <DT>use-termdef</DT>
32664 <DD>In order to decide if your terminal is capable of color, Alpine looks in
32665 the terminal capabilities database, TERMINFO or TERMCAP, depending on
32666 how Alpine was compiled.
32667 This is a good option to choose if you switch between a color and a non-color
32668 terminal with the same Alpine configuration.
32669 Alpine will know to use color on the color terminal because it is described
32670 in the termcap entry, and Alpine will know to use black and white on the
32671 non-color terminal.
32672 The Alpine Technical Notes, distributed with the source code of Alpine
32673 have more information on configuring a TERMCAP or TERMINFO
32674 entry for color Alpine.
32675 This is usually something a system administrator does.
32676 </DD>
32677
32678 <DT>force-ansi-8color</DT>
32679 <DD>This is probably the setting that most people should use.
32680 Because setting up a termcap entry is confusing and because the
32681 terminal capabilities database is often not correctly configured for color,
32682 this choice and the next may be easier for you to use.
32683 If your terminal emulator responds to ANSI color escape sequences, which
32684 many do, this option will cause Alpine to believe your terminal will respond
32685 to the escape sequences that produce eight different foreground and background
32686 colors.
32687 The escape sequences used to set the foreground colors are
32688
32689   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
32690
32691 where the color_number is an ASCII digit between 0 and 7.
32692 The numbers 0 through 7 should correspond to the colors black, red, green,
32693 yellow, blue, magenta, cyan, and white.
32694 Some terminal emulators use a pre-ANSI scheme that swaps
32695 the colors blue and red and the colors yellow and cyan.
32696 This will cause the default colors to be different, but other than that
32697 things should work fine.
32698 There is also a 9th color available, the last one shown, which is the default
32699 color from the terminal emulator.
32700 When used as a background color some people refer to this color as
32701 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
32702 shown in the color swatch of the SETUP COLOR screen.
32703 The foreground transparent color is shown as
32704 the color of the &quot;TRAN&quot; text.
32705 (The transparent color will not work correctly in a PC-Alpine configuration.)
32706 The escape sequences used to set the background colors are the same
32707 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
32708 The escape sequences for foreground and background default colors (transparent)
32709 are 39m and 49m.
32710 <P>
32711 Note: With the Tera Term terminal emulator this setting works well.
32712 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
32713 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
32714 menu, in the &quot;Window&quot; submenu.
32715 </DD>
32716
32717 <DT>force-ansi-16color</DT>
32718 <DD>Many terminal emulators know about the same eight colors above
32719 plus eight more.
32720 This option attempts to use all 16 colors.
32721 The same escape sequences as for the eight-color terminal are used
32722 for the first eight colors.
32723 The escape sequences used to set foreground colors 8-15 are the same as
32724 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
32725 The background color sequences for colors 8-15 are the same as for 0-7
32726 except the &quot;4&quot; is replaced with &quot;10&quot;.
32727 You can tell if the 16 colors are working by turning on this option
32728 and then going into one of the color configuration screens, for example,
32729 the configuration screen for Normal Color.
32730 If you see 16 different colors to select from (plus a 17th for
32731 the transparent color), it's working.
32732 </DD>
32733
32734 <DT>force-xterm-256color</DT>
32735 <DD>Some versions of xterm (and some other terminal emulators)
32736 have support for 256 colors.
32737 The escape sequences used to set the foreground colors are
32738
32739   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
32740
32741 where the color_number is an ASCII digit between 0 and 255.
32742 Background colors are the same with the 38 replaced with a 48.
32743 The numbers 0 through 15 are probably similar to the 16 color version
32744 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
32745 The terminal default (transparent) color is the 257th color at the bottom.
32746 Some terminal emulators will misinterpret these escape sequences causing
32747 the terminal to blink or overstrike characters or to do something else
32748 undesirable.
32749 <P>
32750 The PuTTY terminal emulator has an option called &quot;Allow terminal to
32751 use xterm 256-colour mode&quot; which allows PuTTY to work well with
32752 this 256-color setting.
32753
32754 </DD>
32755 </DL>
32756
32757 <P>
32758 The normal default is &quot;no-color&quot;.
32759 <P>
32760
32761 Once you've turned on color you may set the
32762 colors of many objects on the screen individually.
32763 For example, you may add colors to the status letters on the MESSAGE
32764 INDEX page.
32765 Most categories of color that Alpine supports are configurable here.
32766 For example, &quot;Normal Color&quot;
32767 is the color used to display most of the text in Alpine, and
32768 &quot;Reverse Color&quot; is used to display highlighted text, such as the
32769 current message in the MESSAGE INDEX.
32770 <P>
32771 Lines in the MESSAGE INDEX may also be colored.
32772 Use Setup Rules to get to the Indexcolor configuration screen.
32773 <P>
32774
32775 <UL>
32776 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32777 </UL><P>
32778 &lt;End of help on this topic&gt;
32779 </BODY>
32780 </HTML>
32781 ====== h_config_disable_index_locale_dates =====
32782 <HTML>
32783 <HEAD>
32784 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
32785 </HEAD>
32786 <BODY>
32787 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
32788
32789 This feature affects the display of dates in the MESSAGE INDEX.
32790 Normally an attempt is made to localize the dates
32791 used in the MESSAGE INDEX display to your locale.
32792 This is controlled with the
32793 LC_TIME locale setting on a UNIX system.
32794 On Windows the Regional Options control panel may be used to set the date format.
32795 At the programming level, Alpine is using the strftime routine
32796 to print the parts of a date.
32797 <P>
32798 If this feature is set, dates are displayed in English and
32799 with the conventions of the United States.
32800 <P>
32801
32802 <UL>
32803 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32804 </UL><P>
32805 &lt;End of help on this topic&gt;
32806 </BODY>
32807 </HTML>
32808 ====== h_config_auto_open_unread =====
32809 <HTML>
32810 <HEAD>
32811 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
32812 </HEAD>
32813 <BODY>
32814 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
32815
32816 This feature controls the behavior of the TAB key when traversing folders
32817 in the optional
32818 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
32819 collection or in optional <!--#echo var="VAR_news-collections"-->.
32820 <P>
32821 When the TAB
32822 (<A HREF="h_common_nextnew">NextNew</A>)
32823 key is pressed, and there
32824 are no more unseen messages in the current (incoming message or news)
32825 folder, Alpine will search the list of folders in the current collection for
32826 one containing New or Recent (new since the last time the folder was
32827 opened) messages.
32828 This behavior may be modified slightly with the
32829 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
32830 feature that causes Alpine to look for Unseen messages instead of Recent
32831 messages.
32832 Normally, when such a folder is found, Alpine will ask
32833 whether you wish to open the folder.  If this feature is set, Alpine will
32834 automatically open the folder without prompting.
32835 <P>
32836 This feature also affects some other similar situations.
32837 If you have a
32838 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
32839 that is equal to one of the &quot;separate-&quot; values, and you are
32840 viewing a thread; then when you type the NextNew command and are at the
32841 end of the current thread you will automatically go to the next thread
32842 if this feature is set.
32843 By default, you would be asked if you want to view the next thread.
32844 You will also be asked at times whether or not you want to view the next
32845 thread after you delete the last message in the thread.
32846 Setting this feature will also cause that question to be skipped.
32847 <P>
32848
32849 <UL>
32850 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32851 </UL><P>
32852 &lt;End of help on this topic&gt;
32853 </BODY>
32854 </HTML>
32855 ====== h_config_auto_include_reply =====
32856 <HTML>
32857 <HEAD>
32858 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
32859 </HEAD>
32860 <BODY>
32861 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
32862
32863 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
32864 will ask whether you wish to include the original message in your reply.
32865 If this feature is set and the feature
32866 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
32867 is <EM>not</EM> set, then the original message will be included in the reply
32868 automatically, without prompting.
32869 <P>
32870 &lt;End of help on this topic&gt;
32871 </BODY>
32872 </HTML>
32873 ====== h_config_select_in_bold =====
32874 <HTML>
32875 <HEAD>
32876 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
32877 </HEAD>
32878 <BODY>
32879 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
32880
32881 This feature controls an aspect of Alpine's
32882 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
32883 commands; in
32884 particular, the Select and WhereIs commands. Select and WhereIs (with the
32885 ^X subcommand) will search the current folder for messages meeting a
32886 specified criteria, and &quot;tag&quot; the resulting messages with an
32887 &quot;X&quot; in the
32888 first column of the applicable lines in the MESSAGE INDEX.  If this feature
32889 is set, instead of using the &quot;X&quot; to denote a selected message,
32890 Alpine will
32891 attempt to display those index lines in boldface. Whether this is
32892 preferable to the &quot;X&quot; will depend on personal taste and the type of
32893 terminal being used.
32894 <P>
32895 <UL>
32896 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32897 </UL><P>
32898 &lt;End of help on this topic&gt;
32899 </BODY>
32900 </HTML>
32901 ====== h_config_alt_auth =====
32902 <HTML>
32903 <HEAD>
32904 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
32905 </HEAD>
32906 <BODY>
32907 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
32908
32909 This feature affects how Alpine connects to IMAP servers.
32910 Its utility has largely been overtaken by events,
32911 but it may still be useful in some circumstances.
32912 If you only connect to modern IMAP servers that support
32913 &quot;STARTTLS&quot; you can ignore this feature.
32914
32915 <P>
32916 Details:
32917
32918 <P>
32919 By default, Alpine will attempt to connect to an IMAP server on the
32920 normal IMAP service port (143), and if the server offers &quot;Transport Layer
32921 Security&quot; (STARTTLS) and Alpine has been compiled with encryption capability,
32922 then a secure (encrypted) session will be negotiated.
32923
32924 <P>
32925 With this feature enabled, before connecting on the normal IMAP port, Alpine
32926 will first attempt to connect to an alternate IMAP service port (993) used
32927 specifically for encrypted IMAP sessions via the Secure Sockets Layer
32928 (SSL) or Transport Layer Security (TLS) method.
32929 If the SSL attempt fails, Alpine will then try the default
32930 behavior described in the previous paragraph.
32931
32932 <P>
32933 STARTTLS negotiation on the normal port is preferred, and supersedes the use of
32934 SSL on port 993, but older servers may not provide STARTTLS support.
32935 This feature may be convenient when accessing IMAP servers that do not support
32936 STARTTLS, but do support SSL or TLS connections on port 993.
32937 However, it is important to understand that with this feature enabled,
32938 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
32939 but it will proceed to make an insecure connection if that is the only
32940 option offered by the server, or if the Alpine in question has been built
32941 without encryption capability.
32942
32943 <P>
32944 Note that this feature specifies a per-user (or system-wide) default
32945 behavior, but host/folder specification flags may be used to control the
32946 behavior of any specific connection.
32947 This feature interacts with some of
32948 the possible host/folder path specification flags as follows:
32949
32950 <P>
32951 The <SAMP>/starttls</SAMP> host flag, for example,
32952
32953 <P>
32954 <CENTER><SAMP>{foo.example.com/starttls}INBOX</SAMP></CENTER>
32955 <P>
32956 will over-ride this feature for the specified host by bypassing the
32957 SSL or TLS connection attempt.
32958 Moreover, with <SAMP>/starttls</SAMP> specified,
32959 the connection attempt will fail if the
32960 service on port 143 does not offer TLS support.
32961
32962 <P>
32963 The <SAMP>/ssl</SAMP> host flag, for example,
32964
32965 <P>
32966 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
32967 <P>
32968 will insist on an SSL or TLS connection for the specified host,
32969 and will fail if the SSL or TLS service on port 993 is not available.
32970 Alpine will not subsequently retry a connection
32971 on port 143 if <SAMP>/ssl</SAMP> is specified.
32972
32973 <P>
32974 <UL>
32975 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32976 </UL><P>
32977 &lt;End of help on this topic&gt;
32978 </BODY>
32979 </HTML>
32980 ====== h_config_file_dir ======
32981 <HTML>
32982 <HEAD>
32983 <TITLE>OPTION: File Directory</TITLE>
32984 </HEAD>
32985 <BODY>
32986 <H1>OPTION: File Directory</H1>
32987
32988 PC-Alpine only.
32989 <P>
32990 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
32991 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
32992 Message Index's &quot;E&nbsp;Export&quot; command.
32993
32994 <P>
32995 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
32996 component, Alpine assumes the file exists in the user's home directory.
32997 Under Windows operating systems, this definition isn't always clear.  This
32998 feature allows you to explicitly set where Alpine should look for files
32999 without a leading path.
33000
33001 <P>
33002 NOTE: this feature's value is ignored if either
33003 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
33004 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
33005
33006 <P>
33007 <UL>
33008 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33009 </UL><P>
33010 &lt;End of help on this topic&gt;
33011 </BODY>
33012 </HTML>
33013 ====== h_config_quote_all_froms =====
33014 <HTML>
33015 <HEAD>
33016 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
33017 </HEAD>
33018 <BODY>
33019 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
33020
33021 This feature controls an aspect of the Save command (and also the way
33022 outgoing messages are saved to an FCC folder).  If set, Alpine will add
33023 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
33024 when they are saved to another folder, including lines syntactically
33025 distinguishable from the type of message separator line commonly used on
33026 Unix systems.
33027
33028 <P>
33029 The default behavior is that a &quot;>&quot; will be prepended only to lines
33030 beginning with &quot;From &quot; that might otherwise be confused with a message
33031 separator line on Unix systems.  If pine is the only mail program you use,
33032 this default is reasonable.  If another program you use has trouble
33033 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
33034 enable this feature.  This feature only applies to the common Unix mailbox
33035 format that uses message separator lines beginning with &quot;From &quot;.  If
33036 Alpine has been configured to use a different mailbox format (possibly
33037 incompatible with other mail programs), then this issue does not arise,
33038 and the feature is irrelevant.
33039
33040 <P>
33041 &lt;End of help on this topic&gt;
33042 </BODY>
33043 </HTML>
33044 ====== h_config_normal_color =====
33045 <HTML>
33046 <HEAD>
33047 <TITLE>OPTION: Normal Color</TITLE>
33048 </HEAD>
33049 <BODY>
33050 <H1>OPTION: Normal Color</H1>
33051
33052 Sets the color Alpine normally uses.
33053 The foreground color is the color of the actual character and the
33054 background color is the color of the area behind the character.
33055 By default this color is black characters on a white background.
33056 <P>
33057 <A HREF="h_color_setup">Descriptions of the available commands</A>
33058 <P>
33059 Look <A HREF="h_edit_nav_cmds">here</A>
33060 to see the available Editing and Navigation commands.
33061 <P>
33062 &lt;End of help on this topic&gt;
33063 </BODY>
33064 </HTML>
33065 ====== h_config_reverse_color =====
33066 <HTML>
33067 <HEAD>
33068 <TITLE>OPTION: Reverse Color</TITLE>
33069 </HEAD>
33070 <BODY>
33071 <H1>OPTION: Reverse Color</H1>
33072
33073 Sets the color Alpine uses for reverse video characters.
33074 The foreground color is the color of the actual character and the
33075 background color is the color of the area behind the character.
33076 <P>
33077 <A HREF="h_color_setup">Descriptions of the available commands</A>
33078 <P>
33079 Look <A HREF="h_edit_nav_cmds">here</A>
33080 to see the available Editing and Navigation commands.
33081 <P>
33082 &lt;End of help on this topic&gt;
33083 </BODY>
33084 </HTML>
33085 ====== h_config_title_color =====
33086 <HTML>
33087 <HEAD>
33088 <TITLE>OPTION: Title Color</TITLE>
33089 </HEAD>
33090 <BODY>
33091 <H1>OPTION: Title Color</H1>
33092
33093 Sets the color Alpine uses for the titlebar (the top line on the screen).
33094 The foreground color is the color of the actual character and the
33095 background color is the color of the area behind the character.
33096 By default, the Title Color is black characters on a yellow background.
33097 <P>
33098 The actual titlebar color may be different from the Title Color if
33099 the option
33100 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
33101 is set to some value other than the default.
33102 It may also be different if the current folder is closed and the
33103 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
33104 color is set to something different from the Title Color.
33105 <P>
33106 <A HREF="h_color_setup">Descriptions of the available commands</A>
33107 <P>
33108 Look <A HREF="h_edit_nav_cmds">here</A>
33109 to see the available Editing and Navigation commands.
33110 <P>
33111 &lt;End of help on this topic&gt;
33112 </BODY>
33113 </HTML>
33114 ====== h_config_titleclosed_color =====
33115 <HTML>
33116 <HEAD>
33117 <TITLE>OPTION: Title Closed Color</TITLE>
33118 </HEAD>
33119 <BODY>
33120 <H1>OPTION: Title Closed Color</H1>
33121
33122 Sets the color Alpine uses for the titlebar (the top line on the screen)
33123 when the current folder is closed.
33124 The foreground color is the color of the actual character and the
33125 background color is the color of the area behind the character.
33126 By default, the Title Color Closed Color is white characters on a red background.
33127 <P>
33128 By setting this color to something noticeable you will be alerted to the
33129 fact that the current folder is closed, perhaps unexpectedly.
33130 <P>
33131 &lt;End of help on this topic&gt;
33132 </BODY>
33133 </HTML>
33134 ====== h_config_status_color =====
33135 <HTML>
33136 <HEAD>
33137 <TITLE>OPTION: Status Color</TITLE>
33138 </HEAD>
33139 <BODY>
33140 <H1>OPTION: Status Color</H1>
33141
33142 Sets the color Alpine uses for status messages written to the message
33143 line near the bottom of the screen.
33144 The foreground color is the color of the actual character and the
33145 background color is the color of the area behind the character.
33146 By default, the Status Color is the same as the Reverse Color.
33147 <P>
33148 <A HREF="h_color_setup">Descriptions of the available commands</A>
33149 <P>
33150 Look <A HREF="h_edit_nav_cmds">here</A>
33151 to see the available Editing and Navigation commands.
33152 <P>
33153 &lt;End of help on this topic&gt;
33154 </BODY>
33155 </HTML>
33156 ====== h_config_index_opening_color =====
33157 <HTML>
33158 <HEAD>
33159 <TITLE>OPTION: Index Opening Color</TITLE>
33160 </HEAD>
33161 <BODY>
33162 <H1>OPTION: Index Opening Color</H1>
33163
33164 With some setups the text of the subject is followed
33165 by the opening text of the message if there is any room available in the index line.
33166 If you have configured your
33167 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
33168 to include one of the Subject tokens that causes this behavior
33169 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
33170 this opening text with this option.
33171 This coloring takes place for all but the current index line, and the Opening
33172 Color appears to be in front of any color from an Index Color Rule.
33173 <P>
33174 By default the Index Opening Color is gray characters on a white background.
33175
33176 <P>
33177 <A HREF="h_color_setup">Descriptions of the available commands</A>
33178 <P>
33179 Look <A HREF="h_edit_nav_cmds">here</A>
33180 to see the available Editing and Navigation commands.
33181 <P>
33182 &lt;End of help on this topic&gt;
33183 </BODY>
33184 </HTML>
33185 ====== h_config_index_pri_color =====
33186 <HTML>
33187 <HEAD>
33188 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
33189 </HEAD>
33190 <BODY>
33191 <H1>OPTION: Index Priority Symbol Colors</H1>
33192
33193 The X-Priority header is a non-standard header that is used in a
33194 somewhat standard way by many mail programs.
33195 Alpine expects the value of this header to be a digit with a value
33196 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
33197 Alpine can be made to display an indication of this priority in
33198 messages by use of one of the tokens
33199 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
33200 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
33201 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
33202
33203 <P>
33204 You may set the color used to draw these tokens by use of the colors
33205 Index High Priority Symbol Color and Index Low Priority Symbol Color.
33206 This coloring takes place for all but the current index line, and the Priority
33207 Color appears to be in front of any color from an Index Color Rule.
33208 If the priority has a value of 1 or 2 the High Priority color will be
33209 used,
33210 and if the value is 4 or 5 the Low Priority color will be used.
33211 <P>
33212 If you don't set these colors the index line will be colored in the same color as
33213 the bulk of the index line.
33214
33215 <P>
33216 <A HREF="h_color_setup">Descriptions of the available commands</A>
33217 <P>
33218 Look <A HREF="h_edit_nav_cmds">here</A>
33219 to see the available Editing and Navigation commands.
33220 <P>
33221 &lt;End of help on this topic&gt;
33222 </BODY>
33223 </HTML>
33224 ====== h_config_index_subject_color =====
33225 <HTML>
33226 <HEAD>
33227 <TITLE>OPTION: Index Subject Color</TITLE>
33228 </HEAD>
33229 <BODY>
33230 <H1>OPTION: Index Subject Color</H1>
33231
33232 You may set the color used to draw the Subject part of the index line.
33233 This coloring takes place for all but the current index line, and the Subject
33234 Color appears to be in front of any color from an Index Color Rule.
33235 <P>
33236 If you don't set this color it will be colored in the same color as
33237 the bulk of the index line.
33238
33239 <P>
33240 <A HREF="h_color_setup">Descriptions of the available commands</A>
33241 <P>
33242 Look <A HREF="h_edit_nav_cmds">here</A>
33243 to see the available Editing and Navigation commands.
33244 <P>
33245 &lt;End of help on this topic&gt;
33246 </BODY>
33247 </HTML>
33248 ====== h_config_index_from_color =====
33249 <HTML>
33250 <HEAD>
33251 <TITLE>OPTION: Index From Color</TITLE>
33252 </HEAD>
33253 <BODY>
33254 <H1>OPTION: Index From Color</H1>
33255
33256 You may set the color used to draw the From part of the index line.
33257 This coloring takes place for all but the current index line, and the From
33258 Color appears to be in front of any color from an Index Color Rule.
33259 <P>
33260 If you don't set this color it will be colored in the same color as
33261 the bulk of the index line.
33262
33263 <P>
33264 <A HREF="h_color_setup">Descriptions of the available commands</A>
33265 <P>
33266 Look <A HREF="h_edit_nav_cmds">here</A>
33267 to see the available Editing and Navigation commands.
33268 <P>
33269 &lt;End of help on this topic&gt;
33270 </BODY>
33271 </HTML>
33272 ====== h_config_index_arrow_color =====
33273 <HTML>
33274 <HEAD>
33275 <TITLE>OPTION: Index Arrow Color</TITLE>
33276 </HEAD>
33277 <BODY>
33278 <H1>OPTION: Index Arrow Color</H1>
33279
33280 If you have configured your
33281 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
33282 to include the &quot;ARROW&quot; token, you may set the color of
33283 the arrow displayed with this option.
33284 If you don't set the color it will be colored in the same color as
33285 the bulk of the index line.
33286
33287 <P>
33288 <A HREF="h_color_setup">Descriptions of the available commands</A>
33289 <P>
33290 Look <A HREF="h_edit_nav_cmds">here</A>
33291 to see the available Editing and Navigation commands.
33292 <P>
33293 &lt;End of help on this topic&gt;
33294 </BODY>
33295 </HTML>
33296 ====== h_config_index_color =====
33297 <HTML>
33298 <HEAD>
33299 <TITLE>OPTION: Index Colors</TITLE>
33300 </HEAD>
33301 <BODY>
33302 <H1>OPTION: Index Colors</H1>
33303
33304 You may add color to the single character symbols that give the status
33305 of each message in the MESSAGE INDEX.
33306 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
33307 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
33308 screen depending on whether the message is addressed to you, and whether
33309 the message is marked Important, is Deleted, is Answered, or is New.
33310 The color for each of those characters may be specified by setting the
33311 &quot;Index-to-me&quot; Symbol Color,
33312 the &quot;Index-important&quot; Symbol Color,
33313 the &quot;Index-deleted&quot; Symbol Color,
33314 the &quot;Index-answered&quot; Symbol Color,
33315 and the &quot;Index-new&quot; Symbol Color.
33316 There are also two other symbol colors called &quot;Index-recent&quot;
33317 and &quot;Index-unseen&quot;.
33318 These two colors will only be used if you have configured your
33319 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
33320 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
33321 <P>
33322 The default colors for these symbols are:
33323 <TABLE>
33324 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
33325 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
33326 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33327 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
33328 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
33329 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33330 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33331 </TABLE>
33332 <P>
33333 Besides coloring the message status symbols, you may also color the
33334 entire index line.
33335 This is done by using the
33336 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
33337 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
33338 When the entire line is colored that color will be &quot;behind&quot; the
33339 status symbol colors talked about in the paragraph above.
33340 <P>
33341 You may also color
33342 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33343 in the index using the
33344 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
33345 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
33346 the Subject using
33347 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
33348 the From field using
33349 <A HREF="h_config_index_from_color">Index From Color</A>;
33350 and the
33351 <A HREF="h_config_index_opening_color">Index Opening</A> text.
33352 <P>
33353 <A HREF="h_color_setup">Descriptions of the available commands</A>
33354 <P>
33355 Look <A HREF="h_edit_nav_cmds">here</A>
33356 to see the available Editing and Navigation commands.
33357 <P>
33358 &lt;End of help on this topic&gt;
33359 </BODY>
33360 </HTML>
33361 ====== h_config_metamsg_color =====
33362 <HTML>
33363 <HEAD>
33364 <TITLE>OPTION: Meta-Message Color</TITLE>
33365 </HEAD>
33366 <BODY>
33367 <H1>OPTION: Meta-Message Color</H1>
33368
33369 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
33370 that aren't part of the message itself.
33371 For example, an attachment that isn't shown might produce a meta
33372 message something like:
33373 <P>
33374 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
33375 <P>
33376 If you set the
33377 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
33378 option you might see
33379 <P>
33380 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
33381 <P>
33382 Warnings about suspicious looking URLs in HTML will also be colored
33383 with this color.
33384 <P>
33385 The foreground color is the color of the actual character and the
33386 background color is the color of the area behind the character.
33387 By default, the Meta-Message Color is black characters on a yellow background.
33388 <P>
33389 <A HREF="h_color_setup">Descriptions of the available commands</A>
33390 <P>
33391 Look <A HREF="h_edit_nav_cmds">here</A>
33392 to see the available Editing and Navigation commands.
33393 <P>
33394 &lt;End of help on this topic&gt;
33395 </BODY>
33396 </HTML>
33397 ====== h_config_keylabel_color =====
33398 <HTML>
33399 <HEAD>
33400 <TITLE>OPTION: KeyLabel Color</TITLE>
33401 </HEAD>
33402 <BODY>
33403 <H1>OPTION: KeyLabel Color</H1>
33404
33405 Sets the color Alpine uses for the labels of the keys in the two-line
33406 menu at the bottom of the screen.
33407 For example, some of the screens have a &quot;P PrevMsg&quot; command.
33408 This option sets the color used when displaying &quot;PrevMsg&quot;.
33409 The foreground color is the color of the actual character and the
33410 background color is the color of the area behind the character.
33411 By default, the KeyLabel Color is the same as the Normal Color.
33412 <P>
33413 WARNING: Some terminal emulators have the property that the screen will scroll
33414 down one line whenever a character is written to the character cell in the
33415 lower right corner of the screen.
33416 Alpine can usually avoid writing a character in that corner of the screen.
33417 However, if you have defined a KeyLabel Color then Alpine does have to write
33418 a character in that cell in order to color the cell correctly.
33419 If you find that your display sometimes scrolls up a line this could be
33420 the problem.
33421 The most obvious symptom is probably that the titlebar at the top of the
33422 screen scrolls off the screen.
33423 Try setting KeyLabel Color to Default to see if that fixes the problem.
33424 <P>
33425 <A HREF="h_color_setup">Descriptions of the available commands</A>
33426 <P>
33427 Look <A HREF="h_edit_nav_cmds">here</A>
33428 to see the available Editing and Navigation commands.
33429 <P>
33430 &lt;End of help on this topic&gt;
33431 </BODY>
33432 </HTML>
33433 ====== h_config_keyname_color =====
33434 <HTML>
33435 <HEAD>
33436 <TITLE>OPTION: KeyName Color</TITLE>
33437 </HEAD>
33438 <BODY>
33439 <H1>OPTION: KeyName Color</H1>
33440
33441 Sets the color Alpine uses for the names of the keys in the two-line
33442 menu at the bottom of the screen.
33443 For example, some of the screens have a &quot;P PrevMsg&quot; command.
33444 This option sets the color used when displaying the &quot;P&quot;.
33445 The foreground color is the color of the actual character and the
33446 background color is the color of the area behind the character.
33447 By default, the KeyName Color is the same as the Reverse Color.
33448 <P>
33449 <A HREF="h_color_setup">Descriptions of the available commands</A>
33450 <P>
33451 Look <A HREF="h_edit_nav_cmds">here</A>
33452 to see the available Editing and Navigation commands.
33453 <P>
33454 &lt;End of help on this topic&gt;
33455 </BODY>
33456 </HTML>
33457 ====== h_config_slctbl_color =====
33458 <HTML>
33459 <HEAD>
33460 <TITLE>OPTION: Selectable Item Color</TITLE>
33461 </HEAD>
33462 <BODY>
33463 <H1>OPTION: Selectable Item Color</H1>
33464
33465 Sets the color Alpine uses for selectable items, such as URLs.
33466 The foreground color is the color of the actual character and the
33467 background color is the color of the area behind the character.
33468 By default, the Selectable Item Color is the same as the Normal Color,
33469 except that it is bold.
33470 <P>
33471 <A HREF="h_color_setup">Descriptions of the available commands</A>
33472 <P>
33473 Look <A HREF="h_edit_nav_cmds">here</A>
33474 to see the available Editing and Navigation commands.
33475 <P>
33476 &lt;End of help on this topic&gt;
33477 </BODY>
33478 </HTML>
33479 ====== h_config_quote_color =====
33480 <HTML>
33481 <HEAD>
33482 <TITLE>OPTION: Quote Colors</TITLE>
33483 </HEAD>
33484 <BODY>
33485 <H1>OPTION: Quote Colors</H1>
33486
33487 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
33488 screen.
33489 If a line begins with a &gt; character (or space followed by &gt;)
33490 it is considered a quote.
33491 That line will be given the Quote1 Color (first level quote).
33492 If there is a second level of quoting then the Quote2 Color will be used.
33493 Alpine considers there to be a second level of quoting if that first &gt; is
33494 followed by another &gt; (or space followed by &gt;).
33495 If there are characters other than whitespace and &gt; signs, then it isn't
33496 considered another level of quoting.
33497 Similarly, if there is a third level of quoting the Quote3 Color will be
33498 used.
33499 If there are more levels after that the Quote Colors are re-used.
33500 If you define all three colors then it would repeat like Color1, Color2, Color3,
33501 Color1, Color2, Color3, ...
33502 If you only define the first two it would be
33503 Color1, Color2, Color1, Color2, ...
33504 If you define only the Quote1 Color, then the entire quote would be that
33505 color regardless of the quoting levels.
33506 By default, the Quote1 Color is black characters on a greenish-blue background;
33507 the Quote2 Color is black characters on a dull yellow background; and
33508 the Quote3 Color is black characters on a green background.
33509 <P>
33510 <A HREF="h_color_setup">Descriptions of the available commands</A>
33511 <P>
33512 Look <A HREF="h_edit_nav_cmds">here</A>
33513 to see the available Editing and Navigation commands.
33514 <P>
33515 &lt;End of help on this topic&gt;
33516 </BODY>
33517 </HTML>
33518 ====== h_config_folder_color =====
33519 <HTML>
33520 <HEAD>
33521 <TITLE>OPTION: Folder Color</TITLE>
33522 </HEAD>
33523 <BODY>
33524 <H1>OPTION: Folder Color</H1>
33525
33526 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
33527 screen. By default, the Folder Color is the normal text color.
33528
33529 <P>
33530 If you set a color for this feature, other than the normal color
33531 (the default), or a color for
33532 <A HREF="h_config_directory_color">Directory Color</A>, then directories
33533 will be colored according to the color specified in the
33534 <A HREF="h_config_directory_color">Directory Color</A> option. In this
33535 case, the color will be the only indication that the colored name
33536 refers to a directory. The normal behavior is that Alpine
33537 indicates that a name refers to a directory by appending a
33538 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
33539 the folder.
33540
33541 <P>
33542 If a folder is a directory, then the folder name will be painted
33543 according to the color defined by this variable, and a separator
33544 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
33545 to the name. That
33546 indicator will be painted according to the color defined in the
33547 <A HREF="h_config_directory_color">Directory Color</A> option.
33548
33549 <P>
33550 &lt;End of help on this topic&gt;
33551 </BODY>
33552 </HTML>
33553 ====== h_config_directory_color =====
33554 <HTML>
33555 <HEAD>
33556 <TITLE>OPTION: Directory Color</TITLE>
33557 </HEAD>
33558 <BODY>
33559 <H1>OPTION: Directory Color</H1>
33560
33561 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
33562 screen. By default, the Folder Color is the normal text color.
33563 <P>
33564 If you set a color for this feature, other than the normal color
33565 (the default), or a color for
33566 <A HREF="h_config_folder_color">Folder Color</A>, then folders
33567 will be colored according to the color specified in the
33568 <A HREF="h_config_folder_color">Folder Color</A> option. In this
33569 case, the color will be the only indication that the colored name
33570 refers to a directory. The normal behavior is that Alpine
33571 indicates that a name refers to a directory by appending a
33572 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
33573 the folder.
33574 <P>
33575 If a folder is a directory, then the folder name will be painted
33576 according to the color defined by the option
33577 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
33578 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
33579 after the name. That
33580 indicator will be painted according to the color defined in this
33581 option.
33582 <P>
33583 &lt;End of help on this topic&gt;
33584 </BODY>
33585 </HTML>
33586 ====== h_config_folder_list_color =====
33587 <HTML>
33588 <HEAD>
33589 <TITLE>OPTION: Folder-List Color</TITLE>
33590 </HEAD>
33591 <BODY>
33592 <H1>OPTION: Folder-List Color</H1>
33593
33594 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
33595 screen. By default, the Folder-List Color is the normal text color.
33596 <P>
33597 This text refers to the informative text that Alpine displays so you
33598 can recognize each collection. The color of the content of each collection
33599 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
33600 and <A HREF="h_config_directory_color">Directory Color</A>.
33601 <P>
33602 Unlike the options
33603 <A HREF="h_config_folder_color">Folder Color</A>
33604 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
33605 this option does not affect the way that Alpine reports folders,
33606 directories and folders that are directories.
33607 <P>
33608 &lt;End of help on this topic&gt;
33609 </BODY>
33610 </HTML>
33611 ====== h_config_incunseen_color =====
33612 <HTML>
33613 <HEAD>
33614 <TITLE>OPTION: Incoming Unseen Color</TITLE>
33615 </HEAD>
33616 <BODY>
33617 <H1>OPTION: Incoming Unseen Color</H1>
33618
33619 If the option
33620 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
33621 is turned on it is possible to highlight the folders that contain
33622 unseen messages by coloring them with this color.
33623 By default, this is the same as the Normal Color and no highlighting is done.
33624 <P>
33625 Usually the &quot;current&quot; folder (the folder the cursor is on)
33626 is highlighted using reverse video.
33627 If the current folder is colored because it contains unseen messages then
33628 the color used to show that it is also the current folder is controlled
33629 by the
33630 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
33631 feature at the top of the SETUP COLOR screen.
33632 <P>
33633 <A HREF="h_color_setup">Descriptions of the available commands</A>
33634 <P>
33635 Look <A HREF="h_edit_nav_cmds">here</A>
33636 to see the available Editing and Navigation commands.
33637 <P>
33638 &lt;End of help on this topic&gt;
33639 </BODY>
33640 </HTML>
33641 ====== h_config_signature_color =====
33642 <HTML>
33643 <HEAD>
33644 <TITLE>OPTION: Signature Color</TITLE>
33645 </HEAD>
33646 <BODY>
33647 <H1>OPTION: Signature Color</H1>
33648
33649 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
33650 screen. According to USENET conventions, the signature is defined as the
33651 paragraph following the &quot;sigdashes&quot;, that is, the special line
33652 consisting of the three characters
33653 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
33654 empty line right after the sigdashes to be considered as part of the
33655 signature.
33656 By default, the Signature Color is blue characters on a white background.
33657 <P>
33658 <A HREF="h_color_setup">Descriptions of the available commands</A>
33659 <P>
33660 Look <A HREF="h_edit_nav_cmds">here</A>
33661 to see the available Editing and Navigation commands.
33662 <P>
33663 &lt;End of help on this topic&gt;
33664 </BODY>
33665 </HTML>
33666 ====== h_config_prompt_color =====
33667 <HTML>
33668 <HEAD>
33669 <TITLE>OPTION: Prompt Color</TITLE>
33670 </HEAD>
33671 <BODY>
33672 <H1>OPTION: Prompt Color</H1>
33673
33674 Sets the color Alpine uses for confirmation prompts and questions that
33675 appear in the status line near the bottom of the screen.
33676 The foreground color is the color of the actual character and the
33677 background color is the color of the area behind the character.
33678 By default, the Prompt Color is the same as the Reverse Color.
33679 <P>
33680 <A HREF="h_color_setup">Descriptions of the available commands</A>
33681 <P>
33682 Look <A HREF="h_edit_nav_cmds">here</A>
33683 to see the available Editing and Navigation commands.
33684 <P>
33685 &lt;End of help on this topic&gt;
33686 </BODY>
33687 </HTML>
33688 ====== h_config_header_general_color =====
33689 <HTML>
33690 <HEAD>
33691 <TITLE>OPTION: Header General Color</TITLE>
33692 </HEAD>
33693 <BODY>
33694 <H1>OPTION: Header General Color</H1>
33695
33696 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
33697 screen.
33698 The foreground color is the color of the actual character and the
33699 background color is the color of the area behind the character.
33700 By default, this is the same as the Normal Color.
33701 <P>
33702 It is also possible to set the colors for specific header fields, for
33703 example the Subject, using
33704 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
33705 If both a Header General Color and a specific Viewer Header Color are set
33706 the specific color will override the general color, as you would expect.
33707 <P>
33708 <A HREF="h_color_setup">Descriptions of the available commands</A>
33709 <P>
33710 Look <A HREF="h_edit_nav_cmds">here</A>
33711 to see the available Editing and Navigation commands.
33712 <P>
33713 &lt;End of help on this topic&gt;
33714 </BODY>
33715 </HTML>
33716 ====== h_config_incol =====
33717 <HTML>
33718 <HEAD>
33719 <TITLE>Index Line Color</TITLE>
33720 </HEAD>
33721 <BODY>
33722 <H1>Index Line Color</H1>
33723
33724 This option is used to set the color of a line in the index when the
33725 message for that line matches the Pattern.
33726 This colors the whole index line, except possibly the status letters,
33727 which may be colored separately using the
33728 <A HREF="h_color_setup">Setup Kolor</A> screen.
33729 The foreground color is the color of the actual characters and the
33730 background color is the color of the area behind the characters.
33731 <P>
33732 <A HREF="h_color_setup">Descriptions of the available commands</A>
33733 <P>
33734 Look <A HREF="h_edit_nav_cmds">here</A>
33735 to see the available Editing and Navigation commands.
33736 <P>
33737 &lt;End of help on this topic&gt;
33738 </BODY>
33739 </HTML>
33740 ====== h_config_usetransparent_color =====
33741 <HTML>
33742 <HEAD>
33743 <TITLE>OPTION: Use Transparent Color</TITLE>
33744 </HEAD>
33745 <BODY>
33746 <H1>OPTION: Use Transparent Color</H1>
33747
33748 This is a special color supported by some terminal emulators.
33749 It is intended to result in the default foreground or background color
33750 from the terminal emulator.
33751 This is the color the terminal was displaying characters in before you started Alpine.
33752 The reason it is called Transparent is because you could set the foreground color
33753 to some specific color, like Red, and then set the background color to the
33754 Transparent Color. If it works as expected, the background color from the terminal
33755 window in which Alpine is running will show through but with the Red characters
33756 in the foreground.
33757 <P>
33758 <A HREF="h_color_setup">Descriptions of the available commands</A>
33759 <P>
33760 Look <A HREF="h_edit_nav_cmds">here</A>
33761 to see the available Editing and Navigation commands.
33762 <P>
33763 &lt;End of help on this topic&gt;
33764 </BODY>
33765 </HTML>
33766 ====== h_config_usenormal_color =====
33767 <HTML>
33768 <HEAD>
33769 <TITLE>OPTION: Use Normal Color</TITLE>
33770 </HEAD>
33771 <BODY>
33772 <H1>OPTION: Use Normal Color</H1>
33773
33774 When you use this color value, the actual color used will be the same
33775 as the corresponding Normal Color.
33776 For example if your Normal Color is black on white and you set both
33777 the foreground and background colors here to use the Normal Color, you'll
33778 get black on white. If you later change the Normal Color to red on blue
33779 this color will also change to red on blue.
33780 <P>
33781 <A HREF="h_color_setup">Descriptions of the available commands</A>
33782 <P>
33783 Look <A HREF="h_edit_nav_cmds">here</A>
33784 to see the available Editing and Navigation commands.
33785 <P>
33786 &lt;End of help on this topic&gt;
33787 </BODY>
33788 </HTML>
33789 ====== h_config_usenone_color =====
33790 <HTML>
33791 <HEAD>
33792 <TITLE>OPTION: Use None Color</TITLE>
33793 </HEAD>
33794 <BODY>
33795 <H1>OPTION: Use None Color</H1>
33796
33797 This is a special color that simply means to leave the color alone.
33798 It is useful for Index symbols and for Keyword Colors used in the Subject
33799 field of an index line.
33800 The most likely use is to set an explicit foreground color and then set
33801 the background color to the None Color.
33802 That will cause the symbol or keyword to be drawn in the foreground color
33803 with a background equal to whatever color the rest of the index line is already
33804 drawn in.
33805 You will see no visible effect unless you have assigned Indexcolor Rules to
33806 color index lines or you have set an actual color for the Reverse Color.
33807 <P>
33808 <A HREF="h_color_setup">Descriptions of the available commands</A>
33809 <P>
33810 Look <A HREF="h_edit_nav_cmds">here</A>
33811 to see the available Editing and Navigation commands.
33812 <P>
33813 &lt;End of help on this topic&gt;
33814 </BODY>
33815 </HTML>
33816 ====== h_config_dflt_color =====
33817 <HTML>
33818 <HEAD>
33819 <TITLE>OPTION: Default Color</TITLE>
33820 </HEAD>
33821 <BODY>
33822 <H1>OPTION: Default Color</H1>
33823
33824 Setting default will cause the color to be the default color.
33825 Unsetting default is normally done by choosing a color, but in some cases
33826 you may want to declare the current default color to be your non-default
33827 choice.
33828 For example, the default Keyname Color is the same as the Reverse Color.
33829 Whenever the Reverse Color changes the Keyname Color will also change, unless
33830 you've changed it or unset the default box.
33831 <P>
33832 <A HREF="h_color_setup">Descriptions of the available commands</A>
33833 <P>
33834 Look <A HREF="h_edit_nav_cmds">here</A>
33835 to see the available Editing and Navigation commands.
33836 <P>
33837 &lt;End of help on this topic&gt;
33838 </BODY>
33839 </HTML>
33840 ====== h_config_bold_slctbl =====
33841 <HTML>
33842 <HEAD>
33843 <TITLE>OPTION: Bold</TITLE>
33844 </HEAD>
33845 <BODY>
33846 <H1>OPTION: Bold</H1>
33847
33848 The color for this particular section may have the Bold attribute turned
33849 on or off.
33850 Setting bold will cause the characters to be bold.
33851 <P>
33852 <A HREF="h_color_setup">Descriptions of the available commands</A>
33853 <P>
33854 Look <A HREF="h_edit_nav_cmds">here</A>
33855 to see the available Editing and Navigation commands.
33856 <P>
33857 &lt;End of help on this topic&gt;
33858 </BODY>
33859 </HTML>
33860 ====== h_config_kw_color =====
33861 <HTML>
33862 <HEAD>
33863 <TITLE>OPTION: Keyword Colors</TITLE>
33864 </HEAD>
33865 <BODY>
33866 <H1>OPTION: Keyword Colors</H1>
33867
33868 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
33869 Keywords are displayed as part of the Subject by default.
33870 They are also displayed as part of the Subject if the tokens
33871 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
33872 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
33873 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
33874 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
33875 <P>
33876 For example, you might have set up a Keyword
33877 &quot;Work&quot; using the
33878 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
33879 You could cause that Keyword to show up as a special color
33880 by setting up the Keyword Color using this option, and then including it
33881 in the MESSAGE INDEX screen using one of the tokens listed above in the
33882 <!--#echo var="VAR_index-format"-->.
33883 <P>
33884 <A HREF="h_color_setup">Descriptions of the available commands</A>
33885 <P>
33886 Look <A HREF="h_edit_nav_cmds">here</A>
33887 to see the available Editing and Navigation commands.
33888 <P>
33889 &lt;End of help on this topic&gt;
33890 </BODY>
33891 </HTML>
33892 ====== h_config_customhdr_color =====
33893 <HTML>
33894 <HEAD>
33895 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
33896 </HEAD>
33897 <BODY>
33898 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
33899
33900 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
33901 For example, you may set the color of the Subject header or the From header.
33902 The foreground color is the color of the actual character and the
33903 background color is the color of the area behind the character.
33904 <P>
33905 In addition to setting the colors for particular headers (like the Subject)
33906 you may also set a color to be used for all headers unless overridden by a
33907 more specific Viewer Header Color.
33908 To do this use the
33909 <A HREF="h_config_header_general_color">Header General Color</A>.
33910 <P>
33911 For Header Colors,
33912 there is an additional line on the
33913 screen labeled &quot;Pattern to match&quot;.
33914 If you leave that blank, then the whole field for that header will
33915 be colored.
33916 However, if you give a pattern to match, the coloring will only take place
33917 if there is a match for that pattern in the value of the field.
33918 For example, if you are working on a color for the Subject header and
33919 you fill in a pattern of &quot;important&quot;, then only Subjects that
33920 contain the word &quot;important&quot; will be colored.
33921 <P>
33922 If the pattern you enter is a comma-separated list of patterns, then coloring
33923 happens if any of those patterns matches.
33924 <P>
33925 <A HREF="h_color_setup">Descriptions of the available commands</A>
33926 <P>
33927 Look <A HREF="h_edit_nav_cmds">here</A>
33928 to see the available Editing and Navigation commands.
33929 <P>
33930 &lt;End of help on this topic&gt;
33931 </BODY>
33932 </HTML>
33933 ====== h_config_indextoken_color =====
33934 <HTML>
33935 <HEAD>
33936 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
33937 </HEAD>
33938 <BODY>
33939 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
33940
33941 This option allows you to set up the color in which any token, not specified by the
33942 previous options, will be colored in the MESSAGE INDEX screen.
33943 <P>
33944 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
33945 a token that can be used in the index format.
33946 The list of available tokens is <A HREF="h_index_tokens">here</A>.
33947 <P>
33948 If you fail to enter a valid token your entry will be ignored, and you will be asked to
33949 enter a new one. Once you have entered a valid token, a line will be added to the
33950 configuration screen that you can use to set up the colors in which that token will
33951 be painted. This is done in the same way that you configure colors for other
33952 variables.
33953
33954 <A HREF="h_color_setup">Descriptions of the available commands</A>
33955 <P>
33956 Look <A HREF="h_edit_nav_cmds">here</A>
33957 to see the available Editing and Navigation commands.
33958 <P>
33959 &lt;End of help on this topic&gt;
33960 </BODY>
33961 </HTML>
33962 ====== h_config_customhdr_pattern =====
33963 <HTML>
33964 <HEAD>
33965 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
33966 </HEAD>
33967 <BODY>
33968 <H1>OPTION: Viewer Header Color Pattern</H1>
33969
33970 If you leave this blank, then the whole field for the header will
33971 be colored.
33972 If you give a pattern to match, the coloring will only take place
33973 if there is a match for that pattern in the value of the field.
33974 For example, if you are working on a color for the Subject header and
33975 you fill in a pattern of &quot;important&quot;, then only Subjects that
33976 contain the word &quot;important&quot; will be colored.
33977 <P>
33978 For address headers (like From and To) and for the Newsgroups header,
33979 a pattern match will cause only the matched addresses or newsgroups to be
33980 colored.
33981 If there is no pattern to match, then all of the addresses or newsgroups
33982 in the relevant header will be colored.
33983 <P>
33984 The matching pattern may be a comma-separated list of patterns to match
33985 instead of a single pattern.
33986 For example, you could use the pattern &quot;important,urgent&quot; which would
33987 cause a match if either the word &quot;important&quot; or the word
33988 &quot;urgent&quot; appeared in the value of the header.
33989 You could list several comma-separated email addresses in the Header
33990 From Color pattern so that those addresses will be colored when any of
33991 them appear in the From header.
33992 <P>
33993 To add a new matching pattern or change the existing pattern use the
33994 <!--chtml if pinemode="function_key"-->
33995 &quot;F4&quot;
33996 <!--chtml else-->
33997 &quot;C&quot;
33998 <!--chtml endif-->
33999 &quot;Change&quot; command that is available when the &quot;Pattern to
34000 match&quot; line is highlighted.
34001 The
34002 <!--chtml if pinemode="function_key"-->
34003 &quot;F10&quot;
34004 <!--chtml else-->
34005 &quot;D&quot;
34006 <!--chtml endif-->
34007 &quot;Delete&quot; command may be used to quickly remove all patterns
34008 for a particular header.
34009 <P>
34010 &lt;End of help on this topic&gt;
34011 </BODY>
34012 </HTML>
34013 ====== h_color_setup =====
34014 <HTML>
34015 <HEAD>
34016 <TITLE>SETUP COLOR COMMANDS</TITLE>
34017 </HEAD>
34018 <BODY>
34019 <H1>SETUP COLOR COMMANDS</H1>
34020 <!--chtml if pinemode="function_key"-->
34021 <PRE>
34022 Available Commands -- Group 1
34023 -------------------------------
34024 F1  Display this help text
34025 F2  Show other available commands
34026 F3  Exit to MAIN MENU
34027 F4  Select the highlighted foreground or background color
34028 F5  Move to previous line
34029 F6  Move to next line
34030 F7  Previous page
34031 F8  Next page
34032 F9  Add a config section for a header field
34033 F10 Restore all default colors (for all sections)
34034 F11 Print color configuration screen
34035 F12 Whereis (search for word)
34036
34037 Available Commands -- Group 2
34038 -------------------------------
34039 F1  Display this help text
34040 F2  Show other available commands
34041 F5  Delete config section for highlighted header field
34042 F6  Shuffle the order of Header Color sections
34043 </PRE>
34044 <!--chtml else-->
34045 <PRE>
34046 General commands
34047 -------------------------------------------------
34048  ?  Display this help text     E  Exit back to MAIN MENU
34049  P  Previous Line              N  Next Line
34050  -  Previous page             Spc (space bar) Next page
34051  W  WhereIs (search for word)  %  Print color configuration screen
34052
34053 Color Setup Commands
34054 ------------------------------------------------
34055  *  Select the highlighted foreground or background color
34056  A  Add a config section for a header field
34057  D  Delete config section for highlighted header field
34058  R  Restore all default colors (for all sections)
34059  $  Shuffle the order of Header Color sections
34060 </PRE>
34061 <!--chtml endif-->
34062
34063 <H2>Description of the Setup Color Screen</H2>
34064
34065 From this screen you may turn on color and set the colors of
34066 various parts of the Alpine display.
34067 For help on turning on color move your cursor into the Color Style section
34068 at the top of the Setup Color screen and ask for help.
34069
34070 <P>
34071 There are several sections in the Setup Color Screen.
34072 At the top are some settings that handle the style of color used
34073 with your terminal emulator (UNIX only), and some settings that
34074 control how the current indexline and the titlebar are colored.
34075 After that comes a long section called GENERAL COLORS that allows
34076 you to set the color of many elements in the Alpine screens.
34077 For example, the color of the titlebar, status messages,
34078 selectable links, quotes and signatures in messages, and so on.
34079 After that is a section called INDEX COLORS that allows you to
34080 set the colors of various pieces of the displayed index lines in
34081 the MESSAGE INDEX screen.
34082 The next section is HEADER COLORS. This is for coloring headers of
34083 messages in the MESSAGE TEXT screen in just about any way you would like.
34084 Finally, the KEYWORD COLORS section allows you to highlight
34085 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
34086 in the MESSAGE INDEX screen.
34087
34088 <P>
34089 To change a color, highlight the color you want to change (for example,
34090 the Status Color) by moving
34091 the cursor into it.
34092 You may want to read the help text for the color to see a brief description
34093 of what you are coloring.
34094 Then press &quot;C&quot; for Change to set the color to something new.
34095 That will put you into a screen with two columns of colors, one for
34096 the foreground color and one for the background color.
34097 The foreground color is just the color you want the actual characters
34098 to be and the background color is the color of the rest of the rectangle
34099 behind the characters.
34100 Select the foreground and background colors desired by using the Next and
34101 Prev keys to highlight the color, and the * command to select it.
34102 <P>
34103 To set a color to its default value, set the X in the Default line at
34104 the bottom of the list of colors.
34105 <P>
34106
34107 The HEADER COLORS section is a little bit different from the others.
34108 Besides coloring the specific fields that Alpine knows about, you may also
34109 color specific header fields when viewing a message in the MESSAGE TEXT
34110 screen.
34111 For example, you may color the Subject header a particular color.
34112 There are a few commands for use with headers.
34113 The &quot;AddHeader&quot; command adds a section to the color
34114 configuration screen that allows you to set the color for that header.
34115 You'll be asked for the name of the header field you want to color.
34116 If you wanted to color the Subject, you would answer
34117 with the word &quot;subject&quot;.
34118 Once you've added a header field, the color setting works just like the
34119 other color fields, except that there is an additional line on the
34120 configuration screen labeled &quot;Pattern to match&quot;.
34121 If you leave that blank, then the whole field for that header will always
34122 be colored.
34123 However, if you give a pattern to match, the coloring will only take place
34124 if there is a match for that pattern in the value of the field.
34125 For example, if you are working on a color for the Subject header and
34126 you fill in a pattern of &quot;important&quot;, then only Subjects that
34127 contain the word &quot;important&quot; will be colored.
34128 <P>
34129 The &quot;DeleteHdr&quot; command removes a header section from the
34130 configuration altogether.
34131 The &quot;Shuffle&quot; command changes the order of header sections.
34132 This is only necessary if you use header sections with pattern fields.
34133 For example, if you have two Subject sections, one with one pattern and
34134 another with another pattern, and the subject for a particular message
34135 happens to match both, then the color from the first match is used.
34136 <P>
34137
34138 The command &quot;RestoreDefs&quot; will restore all of the default colors.
34139 Each section will change to the default value used for that section when
34140 color is first enabled.
34141 When you restore all default colors the color settings for the Header Colors
34142 will be unset (since that's the default), but the header fields you've
34143 added will remain so that you may easily reset them.
34144 In order to get rid of them completely you'd have to use
34145 the &quot;DeleteHdr&quot; command.
34146
34147 <P>
34148 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
34149 may be set with matching rules and that is configured separately from
34150 the rest of the color settings described here.
34151 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
34152 instead of in the Setup/Kolor section.
34153
34154 <P><UL>
34155 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34156 </UL><P>
34157 &lt;End of help on this topic&gt;
34158 </BODY>
34159 </HTML>
34160 ====== h_config_news_uses_recent ======
34161 <HTML>
34162 <HEAD>
34163 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
34164 </HEAD>
34165 <BODY>
34166 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
34167
34168 This feature causes certain messages to be marked as "New" in the
34169 MESSAGE INDEX of newsgroups.
34170 This feature is set by default.
34171
34172 <P>
34173
34174 When opening a newsgroup, Alpine will consult your "newsrc" file and
34175 determine the last message you have previously disposed of via the "D"
34176 key.  If this feature is set, any subsequent messages will be shown in the
34177 Index with an "N", and the first of these messages will be highlighted.
34178 Although this is only an approximation of true "New" or "Unseen"
34179 status, it provides a useful cue to distinguish more-or-less recent
34180 messages from those you have seen previously, but are not yet ready to
34181 mark deleted.
34182
34183 <P>
34184
34185 Background: your "newsrc" file (used to store message status information
34186 for newsgroups) is only capable of storing a single flag, and Alpine uses
34187 this to record whether or not you are "done with" a message, as
34188 indicated by marking the message as "Deleted".  Unfortunately, this
34189 means that Alpine has no way to record exactly which messages you have
34190 previously seen, so it normally does not show the "N" status flag for
34191 any messages in a newsgroup. This feature enables a starting
34192 *approximation* of seen/unseen status that may be useful.
34193 <P>
34194 &lt;End of help on this topic&gt;
34195 </BODY>
34196 </HTML>
34197 ====== h_config_expose_hidden_config =====
34198 <HTML>
34199 <HEAD>
34200 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
34201 </HEAD>
34202 <BODY>
34203 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
34204
34205 If set, this causes configuration options and features that are normally
34206 hidden from view to be editable in the Setup/Config screen.
34207
34208 <P>
34209 The purpose of this feature is to allow you to change configuration
34210 features and variables that are normally hidden.
34211 This is particularly useful if you are using a remote configuration,
34212 where it is difficult to edit the contents manually, but it may also be used
34213 on a local pinerc configuration file.
34214 <P>
34215 If set, several configuration variables and features that are normally
34216 hidden from view will show up in the Setup/Configuration screen.
34217 They will be at the bottom of the configuration screen.
34218 You can find them by searching for the words &quot;hidden configuration&quot;.
34219 <P>
34220
34221 Note that this is an advanced feature that should be used with care.
34222 The reason that this part of the configuration is normally hidden is because
34223 there is a significant potential for causing problems if you change these
34224 variables.
34225 If something breaks after a change try changing it back to see if that is
34226 what is causing the problem.
34227 There are also some variables that are normally hidden because they are
34228 manipulated through Alpine in other ways.
34229 For example, colors are normally set using the Setup/Kolors screen and
34230 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
34231 the Setup/AddressBooks screen, so there is little reason to edit these directly.
34232 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
34233 the Add, Delete, and Rename commands in the FOLDER LIST screen,
34234 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
34235 internally by Alpine and not set directly by the user.
34236 <P>
34237 <UL>
34238 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34239 </UL><P>
34240 &lt;End of help on this topic&gt;
34241 </BODY>
34242 </HTML>
34243 ====== h_config_disable_signature_edit =====
34244 <HTML>
34245 <HEAD>
34246 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
34247 </HEAD>
34248 <BODY>
34249 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
34250
34251 If set, this disables the editing of signature files from within
34252 the Setup/Config screen.
34253 <P>
34254 <UL>
34255 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34256 </UL><P>
34257 &lt;End of help on this topic&gt;
34258 </BODY>
34259 </HTML>
34260 ====== h_config_disable_roles_templateedit =====
34261 <HTML>
34262 <HEAD>
34263 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
34264 </HEAD>
34265 <BODY>
34266 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
34267
34268 If set, this disables the editing of template files within the
34269 Role setup screen.
34270 <P>
34271 <UL>
34272 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34273 </UL><P>
34274 &lt;End of help on this topic&gt;
34275 </BODY>
34276 </HTML>
34277 ====== h_config_disable_roles_sigedit =====
34278 <HTML>
34279 <HEAD>
34280 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
34281 </HEAD>
34282 <BODY>
34283 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
34284
34285 If set, this disables the editing of signature files within the
34286 Role setup screen.
34287 <P>
34288 <UL>
34289 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34290 </UL><P>
34291 &lt;End of help on this topic&gt;
34292 </BODY>
34293 </HTML>
34294 ====== h_config_disable_roles_setup =====
34295 <HTML>
34296 <HEAD>
34297 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
34298 </HEAD>
34299 <BODY>
34300 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
34301
34302 If set, this disables the Setup/Rules/Roles command.
34303 <P>
34304 <UL>
34305 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34306 </UL><P>
34307 &lt;End of help on this topic&gt;
34308 </BODY>
34309 </HTML>
34310 ====== h_config_disable_pipes_in_templates =====
34311 <HTML>
34312 <HEAD>
34313 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
34314 </HEAD>
34315 <BODY>
34316 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
34317
34318 By default, if a template file name is followed by a vertical bar (|) then
34319 that causes the file to be executed to produce the text for the template.
34320 If this feature is set, then this is not allowed.
34321 <P>
34322 <UL>
34323 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34324 </UL><P>
34325 &lt;End of help on this topic&gt;
34326 </BODY>
34327 </HTML>
34328 ====== h_config_disable_pipes_in_sigs =====
34329 <HTML>
34330 <HEAD>
34331 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
34332 </HEAD>
34333 <BODY>
34334 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
34335
34336 By default, if a signature file name is followed by a vertical bar (|) then
34337 that causes the file to be executed to produce the text for the signature.
34338 If this feature is set, then this is not allowed.
34339 <P>
34340 <UL>
34341 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34342 </UL><P>
34343 &lt;End of help on this topic&gt;
34344 </BODY>
34345 </HTML>
34346 ====== h_config_disable_password_cmd =====
34347 <HTML>
34348 <HEAD>
34349 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
34350 </HEAD>
34351 <BODY>
34352 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
34353
34354 If set, then the Setup/Newpassword command is disabled.
34355 <P>
34356 <UL>
34357 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34358 </UL><P>
34359 &lt;End of help on this topic&gt;
34360 </BODY>
34361 </HTML>
34362 ====== h_config_disable_password_caching =====
34363 <HTML>
34364 <HEAD>
34365 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
34366 </HEAD>
34367 <BODY>
34368 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
34369
34370 Normally, loginname/password combinations are cached in Alpine so that
34371 you do not have to enter the same password more than once in a session.
34372 A disadvantage to this approach is that the password must be stored in
34373 the memory image of the running Alpine in order that it can be re-used.
34374 In the event that Alpine crashes and produces a core dump, and that core
34375 dump is readable by others, the loginname and password could be read
34376 from the core dump.
34377 <P>
34378 If this feature is set, then the passwords will not be cached and you
34379 will have to retype the password whenever Alpine needs it.
34380 Even with this feature set there is still some chance that the core
34381 file will contain a password, so care should be taken to make the
34382 core files unreadable.
34383 <P>
34384 NOTE: If PASSFILE caching is enabled, this does not disable it.
34385 That is a separate and independent feature.
34386 <UL>
34387 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34388 </UL><P>
34389 &lt;End of help on this topic&gt;
34390 </BODY>
34391 </HTML>
34392 ====== h_config_disable_password_file_saving =====
34393 <HTML>
34394 <HEAD>
34395 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></TITLE>
34396 </HEAD>
34397 <BODY>
34398 <H1>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></H1>
34399
34400 <P> This feature disables caching of passwords, even if your version of Alpine allows
34401 saving passwords. For MAC OS users saving passwords is done using the Apple Key Chain, for
34402 Windows users caching passwords is done using the internal Windows Credentials, and for
34403 other users this is done by using the password file. In this feature, the phrase
34404 &quot;password file&quot; is a misnomer and represents the way in which your system
34405 stores passwords.
34406
34407 <P>
34408 Specifically, this feature changes the behavior of Alpine when a login name and password combination
34409 for a specific server is not found in the password file. The default behavior is that
34410 Alpine will ask the user if they wish to save this information in the password file for future
34411 use. It is assumed that if a user created a password file it is because they intend
34412 to use it, but in some instances a user might want to save some passwords and not others.
34413 In this case, enabling this feature will make Alpine not add any more passwords to the
34414 password file and will only use the passwords that it already saved. If you wish to allow
34415 Alpine to save more passwords in the password file, disable this feature.
34416
34417 <P> Regardless of which method Alpine uses to store passwords, this is done in a secure
34418 way when compiled with OpenSSL or LibreSSL. This is very likely to be your version, and
34419 you can check this by reading the encryption features
34420 <A HREF="X-Alpine-Config:">supported</A> by Alpine.
34421
34422 <P>
34423 <UL>
34424 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34425 </UL><P>
34426 &lt;End of help on this topic&gt;
34427 </BODY>
34428 </HTML>
34429 ====== h_config_disable_kb_lock =====
34430 <HTML>
34431 <HEAD>
34432 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
34433 </HEAD>
34434 <BODY>
34435 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
34436
34437 If set, then the Keyboard Lock command is removed from the MAIN MENU.
34438 <P>
34439 <UL>
34440 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34441 </UL><P>
34442 &lt;End of help on this topic&gt;
34443 </BODY>
34444 </HTML>
34445 ====== h_config_disable_config_cmd =====
34446 <HTML>
34447 <HEAD>
34448 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
34449 </HEAD>
34450 <BODY>
34451 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
34452
34453 If set, then the Setup/Config screen is disabled.
34454 <P>
34455 <UL>
34456 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34457 </UL><P>
34458 &lt;End of help on this topic&gt;
34459 </BODY>
34460 </HTML>
34461 ====== h_config_allow_chg_from =====
34462 <HTML>
34463 <HEAD>
34464 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
34465 </HEAD>
34466 <BODY>
34467 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
34468
34469 This feature affects Alpine's handling of the &quot;From:&quot; header field
34470 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
34471 option.
34472 <P>
34473 If this feature is set then the From line can be changed just like
34474 all the other header fields that can be changed.
34475 This feature defaults to <EM>ON</EM>.
34476 <P>
34477 Even with this feature turned ON (the default) you will not be able
34478 to change the From header unless you add it to your list of
34479 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
34480 You may also want to change the
34481 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
34482 if you want the From header to always show up in the composer without
34483 having to type the Rich Headers command first.
34484 <P>
34485 Note that many sites restrict the use of this feature in order to
34486 reduce the chance of falsified addresses and misdirected mail.
34487 If you want to change the value of what gets included in the From header
34488 in messages you send
34489 look <A HREF="h_config_change_your_from">here</A> for a description.
34490 <P>
34491 <UL>
34492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34493 </UL><P>
34494 &lt;End of help on this topic&gt;
34495 </BODY>
34496 </HTML>
34497 ====== h_config_disable_collate =====
34498 <HTML>
34499 <HEAD>
34500 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
34501 </HEAD>
34502 <BODY>
34503 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
34504
34505 This is a hard to understand feature that should only be used in rare cases.
34506 Normally, the C function call
34507 <P>
34508 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
34509 <P>
34510 is used by Alpine.
34511 If you want to try turning it off,
34512 setting this feature will turn it off.
34513 This part of the locale has to do with the sort order
34514 of characters in your locale.
34515 <P>
34516 <UL>
34517 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34518 </UL><P>
34519 &lt;End of help on this topic&gt;
34520 </BODY>
34521 </HTML>
34522 ====== h_config_quell_attach_extra_prompt =====
34523 <HTML>
34524 <HEAD>
34525 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
34526 </HEAD>
34527 <BODY>
34528 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
34529
34530 By default, when you attempt to view an attachment externally
34531 from the &quot;Attachment View&quot; screen, you are asked if you
34532 really want to view the selected attachment.
34533
34534 <P>
34535 If this feature is set, you will <B>not</B> be prompted to confirm
34536 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
34537 prompt. This feature was added for those wanting to preserve that
34538 behavior (along with
34539 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
34540
34541 <P>
34542 <UL>
34543 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34544 </UL><P>
34545 &lt;End of help on this topic&gt;
34546 </BODY>
34547 </HTML>
34548 ====== h_config_quell_attach_ext_warn =====
34549 <HTML>
34550 <HEAD>
34551 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
34552 </HEAD>
34553 <BODY>
34554 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
34555
34556 <P>
34557 This feature suppresses the extra warning you can get when trying
34558 to view an attachment for which there is no mime-type match.  Turning
34559 on this feature will just run the program according to extension
34560 instead of first warning the user that it will run according to the
34561 file's extension.
34562 <P>
34563 This feature can be used along side
34564 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
34565 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
34566 <P>
34567 <UL>
34568 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34569 </UL><P>
34570 &lt;End of help on this topic&gt;
34571 </BODY>
34572 </HTML>
34573 ====== h_config_mailcap_params =====
34574 <HTML>
34575 <HEAD>
34576 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
34577 </HEAD>
34578 <BODY>
34579 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
34580
34581 If set, this will allow mailcap named parameter substitution to occur
34582 in mailcap entries.
34583 By default, this is turned off to prevent security problems that may occur
34584 with some incorrect mailcap configurations.
34585 For more information, see RFC1524 and look for "named parameters" in the
34586 text of the RFC.
34587 <P>
34588 <UL>
34589 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34590 </UL><P>
34591 &lt;End of help on this topic&gt;
34592 </BODY>
34593 </HTML>
34594 ====== h_config_disable_shared =====
34595 <HTML>
34596 <HEAD>
34597 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
34598 </HEAD>
34599 <BODY>
34600 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
34601
34602 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
34603 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
34604 will be disabled.
34605 The reason this feature exists is because there are some implementations
34606 of system password lookup routines that are very slow when presented with
34607 a long loginname that does not exist.
34608 This feature could be set to prevent the delay at startup time when the
34609 names above are searched for in the password file.
34610 <P>
34611 <UL>
34612 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34613 </UL><P>
34614 &lt;End of help on this topic&gt;
34615 </BODY>
34616 </HTML>
34617 ====== h_config_hide_nntp_path =====
34618 <HTML>
34619 <HEAD>
34620 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
34621 </HEAD>
34622 <BODY>
34623 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
34624
34625 Normally the Path header that Alpine generates when posting to a newsgroup
34626 contains the name of the computer from which the message is being sent and
34627 the user name.
34628 Some believe that this information is used by spammers.
34629 If this feature is set, that information will be replaced with the text
34630 <P>
34631 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
34632 <P>
34633 instead.
34634 <P>
34635 It should be noted that many servers being connected to will still reveal
34636 the information that this feature attempts to protect.
34637 <P>
34638 <UL>
34639 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34640 </UL><P>
34641 &lt;End of help on this topic&gt;
34642 </BODY>
34643 </HTML>
34644 ====== h_config_no_bezerk_zone =====
34645 <HTML>
34646 <HEAD>
34647 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
34648 </HEAD>
34649 <BODY>
34650 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
34651
34652 POSIX mandates a timezone in UNIX mailbox format folder delimiters
34653 (the line that begins with From <SPACE>).
34654 Some versions of Berkeley mail have trouble with this, and don't recognize
34655 the line as a message delimiter.
34656 If this feature is set, the timezone will be left off the delimiter line.
34657 <P>
34658 <UL>
34659 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34660 </UL><P>
34661 &lt;End of help on this topic&gt;
34662 </BODY>
34663 </HTML>
34664 ====== h_config_quell_domain_warn =====
34665 <HTML>
34666 <HEAD>
34667 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
34668 </HEAD>
34669 <BODY>
34670 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
34671
34672 When your configuration is set up so that your domain name contains no dots,
34673 it is usually a configuration error.
34674 By default, Alpine will warn you about this when you start it up.
34675 You will see a warning message that looks like
34676
34677 <P>
34678 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
34679
34680 <P>
34681 If this feature is set, the warning is turned off.
34682 <P>
34683 <UL>
34684 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34685 </UL><P>
34686 &lt;End of help on this topic&gt;
34687 </BODY>
34688 </HTML>
34689 ====== h_config_quell_imap_env =====
34690 <HTML>
34691 <HEAD>
34692 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
34693 </HEAD>
34694 <BODY>
34695 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
34696
34697 In the MESSAGE INDEX screen, if the open folder is being accessed
34698 using IMAP, Alpine normally tries to paint the index lines on the screen
34699 as soon as the information arrives from the IMAP server.
34700 This means that the index information makes it onto the screen more quickly
34701 than it otherwise would.
34702 This sometimes results in behavior that bothers some users.
34703 For example, when paging to a new page of the index, it may be possible for
34704 the lines to be painted on the screen in a random order, rather than from
34705 top to bottom.
34706 <P>
34707
34708 Setting this feature causes Alpine to wait for all of the information
34709 to be gathered before it paints the index screen.
34710 Once it collects all of the information, the screen will be painted quickly
34711 from top to bottom.
34712 <P>
34713 <UL>
34714 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34715 </UL><P>
34716 &lt;End of help on this topic&gt;
34717 </BODY>
34718 </HTML>
34719 ====== h_config_quell_news_env =====
34720 <HTML>
34721 <HEAD>
34722 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
34723 </HEAD>
34724 <BODY>
34725 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
34726
34727 In the MESSAGE INDEX screen, if the open folder is being accessed
34728 using NNTP (News), Alpine normally tries to paint the index lines on the screen
34729 as soon as the information arrives from the NNTP server.
34730 This means that the index information makes it onto the screen more quickly
34731 than it otherwise would.
34732 This sometimes results in behavior that bothers some users.
34733 For example, when paging to a new page of the index, it may be possible for
34734 the lines to be painted on the screen in a random order, rather than from
34735 top to bottom.
34736 <P>
34737
34738 Setting this feature causes Alpine to wait for all of the information
34739 to be gathered before it paints the index screen.
34740 Once it collects all of the information, the screen will be painted quickly
34741 from top to bottom.
34742 <P>
34743 <UL>
34744 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34745 </UL><P>
34746 &lt;End of help on this topic&gt;
34747 </BODY>
34748 </HTML>
34749 ====== h_config_quell_content_id =====
34750 <HTML>
34751 <HEAD>
34752 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
34753 </HEAD>
34754 <BODY>
34755 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
34756
34757 This feature changes the behavior of Alpine when sending messages.
34758 It is intended to work around a bug in Microsoft's Outlook XP mail user
34759 agent.
34760 As of this writing, Microsoft has acknowledged the bug but
34761 has not added it to the Knowledge Base.
34762 We have been told that there will be a post-SP1 hotfix for Outlook XP.
34763 This particular bug has bug fix number OfficeQFE:4781.
34764 The nature of the bug is that messages with attachments that
34765 contain a Content-ID header (which standard Alpine attachments do)
34766 do not show the attachment indicator (a paperclip) when viewed with
34767 Outlook XP.
34768 So the user has no indication that the message contains an attachment.
34769
34770 <P>
34771 If this feature is set then Alpine will remove most Content-ID headers
34772 before sending a message.
34773 If an attachment is of type MESSAGE, then the existing Content-ID headers
34774 inside the message will be left intact.
34775 This would only happen with Alpine if a message was forwarded as an attachment
34776 or if a message with a message attached was forwarded.
34777 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
34778 the Content-ID headers of the alternative parts will not be removed.
34779
34780 <P>
34781 Because the Content-ID header is a standard part of MIME it is possible
34782 that setting this feature will break something.
34783 For example, if an attachment has a Content-ID header that is necessary
34784 for the correct functioning of that attachment, it is possible that Alpine
34785 may remove that header when the attachment is forwarded.
34786 However, it seems fairly safe at this time.
34787
34788 <P>
34789 <UL>
34790 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34791 </UL><P>
34792 &lt;End of help on this topic&gt;
34793 </BODY>
34794 </HTML>
34795 ====== h_config_winpos_in_config =====
34796 <HTML>
34797 <HEAD>
34798 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
34799 </HEAD>
34800 <BODY>
34801 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
34802
34803 PC-Alpine only.
34804 <P>
34805
34806 Normally, PC-Alpine will store its window size and position in the
34807 Windows Registry.
34808 This is convenient if you want to use the same remote
34809 configuration from more than one PC.
34810 If you use multiple configuration files to start PC-Alpine, you may want
34811 to store the window size and position in the configuration file instead
34812 of in the Registry.
34813 Setting this feature causes the value to be stored in
34814 <A HREF="h_config_window_position">Window-Position</A>.
34815
34816 <P>
34817 <UL>
34818 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34819 </UL><P>
34820 &lt;End of help on this topic&gt;
34821 </BODY>
34822 </HTML>
34823 ====== h_config_quell_ssl_largeblocks =====
34824 <HTML>
34825 <HEAD>
34826 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
34827 </HEAD>
34828 <BODY>
34829 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
34830
34831 PC-Alpine only.
34832 <P>
34833 This feature changes the behavior of fetching messages
34834 and attachments so that the message data is fetched in chunks no larger
34835 than 12K bytes.
34836 This works around a bug in Microsoft's SSL/TLS support.
34837 Some versions of Microsoft SSL are not able to read full-sized (16K)
34838 SSL/TLS packets.
34839 Some servers will send such packets and this will
34840 cause PC-Alpine to crash with the error
34841
34842 <P>
34843 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
34844
34845 <P>
34846 Microsoft is aware of the problem and has developed a hotfix for it, it is
34847 discussed in article 300562 in the Microsoft Knowledge Base.
34848 <P>
34849 <UL>
34850 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34851 </UL><P>
34852 &lt;End of help on this topic&gt;
34853 </BODY>
34854 </HTML>
34855 ====== h_config_quell_partial =====
34856 <HTML>
34857 <HEAD>
34858 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
34859 </HEAD>
34860 <BODY>
34861 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
34862
34863 Partial fetching is a feature of the IMAP protocol.
34864 By default, Alpine
34865 will use partial fetching when copying the contents of a message or attachment
34866 from the IMAP server to Alpine.
34867 This means that the fetch will be done in many
34868 small chunks instead of one big chunk. The main benefit of this approach is
34869 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
34870 to stop the fetch early. In some cases partial fetching may cause a performance
34871 problem so that the fetching of data takes significantly longer when partial
34872 fetching is used. Turning on this feature will turn off partial fetching.
34873 <P>
34874 <UL>
34875 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34876 </UL><P>
34877 &lt;End of help on this topic&gt;
34878 </BODY>
34879 </HTML>
34880 ====== h_config_quell_personal_name_prompt =====
34881 <HTML>
34882 <HEAD>
34883 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
34884 </HEAD>
34885 <BODY>
34886 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
34887
34888 PC-Alpine only.  This feature quells the prompting for a
34889 <A HREF="h_config_pers_name">personal name</A>.  This
34890 prompt normally happens before composing a message, and only happens when
34891 there is no personal name already set.
34892 <P>
34893 <UL>
34894 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34895 </UL><P>
34896 &lt;End of help on this topic&gt;
34897 </BODY>
34898 </HTML>
34899 ====== h_config_quell_user_id_prompt =====
34900 <HTML>
34901 <HEAD>
34902 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
34903 </HEAD>
34904 <BODY>
34905 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
34906
34907 PC-Alpine only.  This feature quells the prompting for a
34908 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
34909 if the information can be obtained from the login name used
34910 to open the INBOX.  Normally, this prompt happens before composing
34911 a message, and only happens when there is no user-id already set
34912 in the configuration.
34913 <P>
34914 With this feature set, composing a message is only possible after
34915 establishing a connection to the INBOX.
34916 <P>
34917 <UL>
34918 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34919 </UL><P>
34920 &lt;End of help on this topic&gt;
34921 </BODY>
34922 </HTML>
34923 ====== h_config_save_aggregates =====
34924 <HTML>
34925 <HEAD>
34926 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
34927 </HEAD>
34928 <BODY>
34929 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
34930
34931 This feature will optimize an aggregate copy operation, if
34932 possible, by issuing a single IMAP <EM>COPY</EM> command with a
34933 list of the messages to be copied.
34934 This feature is set by default.
34935 This may reduce network traffic and elapsed time for the Save.
34936 <EM>However, many IMAP servers (including the UW IMAP server) do
34937 not preserve the order of messages when this optimization is applied.</EM>
34938 If this feature is not set,
34939 Alpine will copy each message individually and the order of the messages
34940 will be preserved.
34941 <P>
34942 <UL>
34943 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34944 </UL><P>
34945 &lt;End of help on this topic&gt;
34946 </BODY>
34947 </HTML>
34948 ====== h_config_use_system_translation =====
34949 <HTML>
34950 <HEAD>
34951 <TITLE>FEATURE: Use System Translation</TITLE>
34952 </HEAD>
34953 <BODY>
34954 <H1>FEATURE: Use System Translation</H1>
34955
34956 UNIX Alpine only.
34957 <P>
34958 Alpine normally uses its own internal software to convert between the multi-byte
34959 representation of characters and the Unicode representation of those
34960 same characters.
34961 It converts from the multi-byte characters your keyboard produces to Unicode,
34962 and from Unicode to the multi-byte characters your display expects.
34963 Alpine also uses its own internal software to decide how much space on
34964 the screen a particular Unicode character will occupy.
34965
34966 <P>
34967 Setting this feature tells Alpine to use the system-supplied routines to
34968 perform these tasks instead.
34969 In particular there are three tasks and three system routines that will
34970 be used for these tasks.
34971
34972 <P>
34973 To convert from multi-byte to Unicode the routine
34974
34975 <P>
34976 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
34977 <P>
34978
34979 is used.
34980 To convert from Unicode to multi-byte the routine
34981
34982 <P>
34983 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
34984 <P>
34985
34986 is used.
34987 And to find the screen width a particular Unicode character will
34988 occupy the routine used is
34989
34990 <P>
34991 <CENTER><SAMP>wcwidth</SAMP></CENTER>
34992 <P>
34993
34994 This feature has been only lightly tested.
34995 The internal routines should normally be used unless you run into
34996 a problem that you think may be solved by using the system routines.
34997 Note that your environment needs to be set up for these
34998 routines to work correctly.
34999 In particular, the LANG or LC_CTYPE variable in your environment will
35000 need to be set.
35001
35002 <P>
35003 <UL>
35004 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35005 </UL><P>
35006 &lt;End of help on this topic&gt;
35007 </BODY>
35008 </HTML>
35009 ====== h_config_suspend_spawns =====
35010 <HTML>
35011 <HEAD>
35012 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
35013 </HEAD>
35014 <BODY>
35015 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
35016
35017 This feature affects Alpine's behavior when process suspension is enabled
35018 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
35019 temporarily interact with the operating system command &quot;shell&quot;
35020 without
35021 quitting Alpine, and then subsequently resume the still-active Alpine session.
35022 <P>
35023
35024 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
35025 is set and subsequently the Ctrl-Z key
35026 is pressed, Alpine will normally suspend itself and return temporary control
35027 to Alpine's parent shell process.  However, if this feature is set, Alpine
35028 will instead create an inferior subshell process.  This is useful when the
35029 parent process is not intended to be used interactively.  Examples include
35030 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
35031 or via a menu system.<P>
35032
35033 Note that one typically resumes a suspended Alpine by entering the Unix
35034 &quot;fg&quot; command, but if this feature is set, it will be necessary to
35035 enter the &quot;exit&quot; command instead.
35036 <P>
35037 <UL>
35038 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35039 </UL><P>
35040 &lt;End of help on this topic&gt;
35041 </BODY>
35042 </HTML>
35043 ====== h_config_8bit_smtp =====
35044 <HTML>
35045 <HEAD>
35046 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
35047 </HEAD>
35048 <BODY>
35049 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
35050
35051 This feature affects Alpine's behavior when sending mail.
35052 By default, this feature is set.
35053 Internet standards
35054 require that all electronic mail messages traversing the global Internet
35055 consist of 7bit ASCII characters unless a pair of cooperating mail
35056 transfer agents explicitly agree to allow 8bit messages.  In general,
35057 then, exchanging messages in non-ASCII characters requires MIME encoding.
35058 <P>
35059 However, there are now Internet standards that allow for unencoded 8bit
35060 exchange of messages between cooperating systems.  When this feature is set
35061 Alpine will try to negotiate unencoded 8bit transmission during the
35062 sending process.  Should the negotiation fail, Alpine will fall back to its
35063 ordinary encoding rules.
35064 <P>
35065 Note, this feature relies on your system's mail transport agent or
35066 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
35067 having the negotiation mechanism introduced in
35068 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
35069 &quot;8BITMIME&quot;.
35070 <P>
35071 ESMTP allows for graceful migration to upgraded mail transfer agents, but
35072 it is possible that this feature might cause problems for some servers.
35073 <P><UL>
35074 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35075 </UL>
35076 <P>&lt;End of help on this topic&gt;
35077 </BODY>
35078 </HTML>
35079 ====== h_config_8bit_nntp =====
35080 <HTML>
35081 <HEAD>
35082 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
35083 </HEAD>
35084 <BODY>
35085 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
35086
35087 This feature affects Alpine's behavior when posting news.
35088
35089 <P>
35090
35091 The Internet standard for exchanging USENET news messages (RFC-1036)
35092 specifies that USENET messages should conform to Internet mail standards
35093 and contain only 7bit characters, but much of the news transport software
35094 in use today is capable of successfully sending messages containing 8bit
35095 characters.  Hence, many people believe that it is appropriate to send 8bit
35096 news messages without any MIME encoding.
35097
35098 <P>
35099
35100 Moreover, there is no Internet standard for explicitly negotiating 8bit
35101 transfer, as there is for Internet email.  Therefore, Alpine provides the
35102 option of posting unencoded 8bit news messages, though not as the default.
35103 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
35104 postings that contain 8bit characters.
35105
35106 <P>
35107
35108 Note, articles may cross a path or pass through news transport software
35109 that is unsafe or even hostile to 8bit characters.  At best this will only
35110 cause the posting to become garbled.  The safest way to transmit 8bit
35111 characters is to leave Alpine's MIME encoding turned on, but recipients
35112 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
35113 messages.
35114 <P>
35115 &lt;End of help on this topic&gt;
35116 </BODY>
35117 </HTML>
35118 ====== h_config_mark_for_cc =====
35119 <HTML>
35120 <HEAD>
35121 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
35122 </HEAD>
35123 <BODY>
35124 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
35125
35126 This feature affects Alpine's MESSAGE INDEX display.
35127 By default, a '+' is displayed in the first column if the
35128 message is addressed directly to you.
35129 When this feature is set and the message is not addressed to you, then a
35130 '-' character is displayed if the message is instead Cc'd directly
35131 to you.
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_tab_uses_unseen =====
35141 <HTML>
35142 <HEAD>
35143 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
35144 </HEAD>
35145 <BODY>
35146 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
35147
35148 This feature affects Alpine's behavior when using the TAB
35149 <A HREF="h_common_nextnew">NextNew Command</A>
35150 to move from one folder to the next.
35151 Alpine's usual behavior is to search for folders
35152 with <EM>Recent</EM> messages in them.
35153 Recent messages are messages that have arrived since the last time the
35154 folder was opened.
35155
35156 <P>
35157 Setting this feature causes Alpine to search for <EM>Unseen</EM>
35158 messages instead of Recent messages.
35159 Unseen messages remain Unseen until you view them (or flag then as Seen with
35160 the <A HREF="h_common_flag">Flag Command</A>).
35161 Setting this feature allows you to locate messages you have not read
35162 instead of only recently received messages.
35163 When this feature is set, the feature
35164 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
35165 will have no effect, so the checking may be slower.
35166
35167 <P>
35168 Another reason why you might want to use this feature is that Alpine sometimes
35169 opens folders implicitly behind the scenes, and this clears the
35170 Recent status of all messages in the folder.
35171 One example where this happens is when Saving or filtering a
35172 message to another folder.
35173 If that message has some <A HREF="h_config_keywords">keywords</A>
35174 set, then because of some shortcomings
35175 in the IMAP specification, the best way to ensure that those keywords are
35176 still set in the saved copy of the message is to open the folder and
35177 set the keywords explicitly.
35178 Because this clears the Recent status of all messages in that folder the
35179 folder will not be found by the NextNew command unless this feature is set.
35180
35181 <P>
35182 &lt;End of help on this topic&gt;
35183 </BODY>
35184 </HTML>
35185 ====== h_config_tab_new_only =====
35186 <HTML>
35187 <HEAD>
35188 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
35189 </HEAD>
35190 <BODY>
35191 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
35192
35193 This feature affects Alpine's behavior when using the TAB key to move from
35194 one message to the next.  Alpine's usual behavior is to select the next
35195 unread message or message flagged as "Important".
35196
35197 <P>
35198
35199 Setting this feature causes Alpine to skip the messages flagged as important,
35200 and select unread messages exclusively.  Tab behavior when there are no
35201 new messages left to select remains unchanged.
35202 <P>
35203 &lt;End of help on this topic&gt;
35204 </BODY>
35205 </HTML>
35206 ====== h_config_warn_if_subj_blank =====
35207 <HTML>
35208 <HEAD>
35209 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
35210 </HEAD>
35211 <BODY>
35212 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
35213
35214 This feature affects Alpine's behavior when you send a message being
35215 composed.
35216 If this option is set, Alpine will check to see if the message about to be sent
35217 has a subject or not.
35218 If not, you will be asked if you want to send the message anyway.
35219 <P>
35220
35221 <UL>
35222 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35223 </UL><P>
35224 &lt;End of help on this topic&gt;
35225 </BODY>
35226 </HTML>
35227 ====== h_config_warn_if_fcc_blank =====
35228 <HTML>
35229 <HEAD>
35230 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
35231 </HEAD>
35232 <BODY>
35233 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
35234
35235 This feature affects Alpine's behavior when you send a message being
35236 composed.
35237 If this option is set, Alpine will check to see if the message about to be sent
35238 has an Fcc or not.
35239 If not, you will be asked if you want to send the message anyway.
35240 <P>
35241
35242 <UL>
35243 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35244 </UL><P>
35245 &lt;End of help on this topic&gt;
35246 </BODY>
35247 </HTML>
35248 ====== h_config_warn_if_no_to_or_cc =====
35249 <HTML>
35250 <HEAD>
35251 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
35252 </HEAD>
35253 <BODY>
35254 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
35255
35256 This feature affects Alpine's behavior when you send a message being
35257 composed.
35258 If this option is set, Alpine will check to see if the message about to be sent
35259 has either a To address, a Cc address, or a Newsgroup.
35260 If none of these is set,
35261 you will be asked if you want to send the message anyway.
35262 <P>
35263
35264 This feature is closely related to
35265 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
35266 Alpine will normally ask if you want to copy a message only to the Fcc.
35267 This feature also applies to cases where there is a Bcc but still no To, Cc,
35268 or Newsgroup.
35269 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
35270 message with only an Fcc, then you won't be asked about sending with
35271 a blank To and Cc and Newsgroups header even if this feature is set.
35272 Similarly, if you have already been asked if you want to send to the Fcc
35273 only and you have answered Yes, then you won't be asked again about sending with
35274 blank To, Cc, and Newsgroups headers even if this feature is set.
35275 <P>
35276
35277 <UL>
35278 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35279 </UL><P>
35280 &lt;End of help on this topic&gt;
35281 </BODY>
35282 </HTML>
35283 ====== h_config_quell_dead_letter =====
35284 <HTML>
35285 <HEAD>
35286 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
35287 </HEAD>
35288 <BODY>
35289 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
35290
35291 This feature affects Alpine's behavior when you cancel a message being
35292 composed.  Alpine's usual behavior is to write the canceled message to
35293 a file named
35294 <!--chtml if pinemode="os_windows"-->
35295 &quot;DEADLETR&quot;,
35296 <!--chtml else-->
35297 &quot;dead.letter&quot; in your home directory,
35298 <!--chtml endif-->
35299 overwriting any previous message. Under
35300 some conditions (some routine), this can introduce a noticeable delay.
35301 Setting this feature will cause Alpine NOT to write canceled compositions
35302 into the file.
35303 <P>
35304 NOTE: Enabling this feature means NO record of canceled messages is
35305 maintained.
35306 <P>
35307 This feature affects the newer option
35308 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
35309 number of dead letter files to keep around.
35310 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
35311 <P>
35312 <UL>
35313 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35314 </UL><P>
35315 &lt;End of help on this topic&gt;
35316 </BODY>
35317 </HTML>
35318 ====== h_config_quell_beeps =====
35319 <HTML>
35320 <HEAD>
35321 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
35322 </HEAD>
35323 <BODY>
35324 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
35325
35326 This feature affects Alpine's behavior when it displays status message
35327 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
35328 will not affect the display of such messages, but will cause those that
35329 emit a beep to become silent.
35330
35331 <P>
35332 <UL>
35333 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35334 </UL><P>
35335 &lt;End of help on this topic&gt;
35336 </BODY>
35337 </HTML>
35338 ====== h_config_suppress_user_agent =====
35339 <HTML>
35340 <HEAD>
35341 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
35342 </HEAD>
35343 <BODY>
35344 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
35345
35346 If this feature is set then Alpine will not generate a
35347 <CODE>User-Agent</CODE> header in outgoing messages.
35348 <P>
35349 <UL>
35350 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35351 </UL><P>
35352 &lt;End of help on this topic&gt;
35353 </BODY>
35354 </HTML>
35355 ====== h_config_quell_lock_failure_warnings =====
35356 <HTML>
35357 <HEAD>
35358 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
35359 </HEAD>
35360 <BODY>
35361 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
35362
35363 This feature affects Alpine's behavior when it encounters a problem
35364 acquiring a mail folder lock.  Typically, a secondary file associated
35365 with the mail folder being opened is created as part of the locking
35366 process.  On some systems, such file creation has been administratively
35367 precluded by the system configuration.
35368 <P>
35369 Alpine issues a warning when such failures occur, which can become bothersome
35370 if the system is configured to disallow such actions.  Setting this
35371 feature causes Alpine to remain silent when this part of lock creation fails.
35372 <P>
35373 WARNING: systems that have been configured in a way that precludes locking
35374 introduce some risk of mail folder corruption when more than one program
35375 attempts to modify the mail folder.  This is most likely to occur to one's
35376 INBOX or other incoming message folder.
35377 <P>
35378 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
35379 <P>
35380 <UL>
35381 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35382 </UL><P>
35383 &lt;End of help on this topic&gt;
35384 </BODY>
35385 </HTML>
35386 ====== h_config_enable_role_take ======
35387 <HTML>
35388 <HEAD>
35389 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
35390 </HEAD>
35391 <BODY>
35392 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
35393
35394 Normally, the Take command takes addresses from a message and helps you
35395 put them into your Address Book.
35396 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
35397 you may find it useful
35398 to be able to Take information from a message's headers and put it into
35399 a new Rule.
35400 When this feature is set, you will be given an extra prompt that gives
35401 you the choice to Take into the Address Book or Take into a rule.
35402 <P><UL>
35403 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35404 </UL>
35405 <P>
35406 &lt;End of help on this topic&gt;
35407 </BODY>
35408 </HTML>
35409 ====== h_config_enable_take_export ======
35410 <HTML>
35411 <HEAD>
35412 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
35413 </HEAD>
35414 <BODY>
35415 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
35416
35417 Normally, the Take command takes addresses from a message and helps you
35418 put them into your Address Book.
35419 When this feature is set, you will be given an extra prompt that gives you
35420 the choice to Take addresses into a file instead of your Address
35421 Book.
35422 Only the user@domain_name part of the address is put in the file.
35423 <P><UL>
35424 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35425 </UL>
35426 <P>
35427 &lt;End of help on this topic&gt;
35428 </BODY>
35429 </HTML>
35430 ====== h_config_quell_folder_internal_msg ======
35431 <HTML>
35432 <HEAD>
35433 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
35434 </HEAD>
35435 <BODY>
35436 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
35437
35438 This feature determines whether or not Alpine will create
35439 &quot;pseudo messages&quot; in folders that are in standard Unix or
35440 MMDF format. <P>
35441
35442 Alpine will normally create these pseudo messages when they are not already
35443 present in a standard Unix or MMDF folder.  Their purpose is to record
35444 certain mailbox state data needed for correct IMAP and POP server
35445 operation, and also for Alpine to be able to mark messages as Answered when
35446 the Reply has been postponed.<P>
35447
35448 Sites that do not use IMAP/POP for remote mail access, and that need to
35449 support mail tools that are adversely affected by the presence of the
35450 pseudo-messages (e.g. some mail notification tools) may enable this
35451 feature to tell Alpine not to create them.  Note that Alpine's
35452 &quot;Answered&quot; flag
35453 capability will be adversely affected if this is done.<P>
35454
35455 Note too that, even if this feature is enabled, Alpine will not remove
35456 pseudo-messages when it encounters them (e.g. those created by UW's imapd
35457 or ipopd servers.) This feature has no effect on folders that are not in
35458 standard Unix or MMDF format, as pseudo-messages are not needed in the
35459 other formats to record mailbox state information.
35460 <P><UL>
35461 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35462 </UL>
35463 <P>
35464 &lt;End of help on this topic&gt;
35465 </BODY>
35466 </HTML>
35467 ====== h_config_mulnews_as_typed ======
35468 <HTML>
35469 <HEAD>
35470 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
35471 </HEAD>
35472 <BODY>
35473 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
35474
35475 This feature will be of little use to most users.
35476 It has no effect unless the feature
35477 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
35478 is set.
35479
35480 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
35481 then the setting of this feature may have an effect on the names of the
35482 newsrc files used.
35483 Normally, the name of the news server will be canonicalized before it is
35484 used in the newsrc file name.
35485 For example, if you type the news server name
35486
35487 <P>
35488 <CENTER><SAMP>servername</SAMP></CENTER>
35489 <P>
35490
35491 it is likely that the canonical name will be something like
35492
35493 <P>
35494 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
35495 <P>
35496
35497 Or it may be the case that
35498
35499 <P>
35500 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
35501 <P>
35502
35503 is really an alias (a DNS CNAME) for
35504
35505 <P>
35506 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
35507 <P>
35508
35509 If this feature is not set, then the canonicalized names will be used.
35510 If this feature is set, then the name you typed in (or put in your
35511 configuration) will be used.
35512
35513 <P><UL>
35514 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35515 </UL>
35516 <P>
35517 &lt;End of help on this topic&gt;
35518 </BODY>
35519 </HTML>
35520 ====== h_config_quell_empty_dirs ======
35521 <HTML>
35522 <HEAD>
35523 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
35524 </HEAD>
35525 <BODY>
35526 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
35527
35528 This feature causes Alpine to remove from the display any directories
35529 that do not contain at least one file or directory.  This can be useful
35530 to prevent overly cluttered folder lists when a collection is stored on
35531 a server that treats all names as both a folder and a directory.
35532
35533 <P>
35534 Note, enabling this feature can cause surprising behavior!  For example,
35535 you can still use Add to create a directory, but unless you immediately
35536 enter that directory and create a folder, that newly created directory
35537 may not be displayed next time you enter the folder list.
35538
35539 <P>
35540 The description above is not quite correct.
35541 Only directories which potentially may hold messages are hidden if empty.
35542 That is, a directory which is really just a directory and is not selectable
35543 as a folder will not be hidden.
35544 Such directories can occur on servers that treat most names as both a folder
35545 and a directory.
35546 These directories are typically created implicitly when a folder is created
35547 inside a directory that does not yet exist.
35548
35549 <P>
35550 <UL>
35551 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35552 </UL><P>
35553 &lt;End of help on this topic&gt;
35554 </BODY>
35555 </HTML>
35556 ====== h_config_termcap_wins =====
35557 <HTML>
35558 <HEAD>
35559 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
35560 </HEAD>
35561 <BODY>
35562 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
35563
35564 This feature may affect Alpine's low-level input routines.  Termcap (or
35565 terminfo, depending on how your copy of Alpine was compiled and linked)
35566 is the name of the database that describes terminal capabilities.  In
35567 particular, it describes the sequences of characters that various keys
35568 will emit.
35569
35570 <P>
35571 An example would be the Up Arrow key on the keyboard.  Up
35572 Arrow is not a distinct character on most Unix systems.  When you press
35573 the Up Arrow key a short sequence of characters are produced.  This
35574 sequence is supposed to be described in the termcap database by the
35575 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
35576 are using terminfo instead of termcap).
35577
35578 <P>
35579 By default, Alpine defines some terminal
35580 escape sequences that are commonly used.  For example, the sequence
35581 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
35582 &quot;ESC&nbsp;[&nbsp;A&quot;
35583 is also recognized as an Up Arrow key.  These are chosen because common
35584 terminals like VT100's or ANSI standard terminals produce these
35585 sequences when you press the Up Arrow key.
35586
35587 <P>
35588 If your system's termcap
35589 (terminfo) database assigns some other function to the sequence
35590 &quot;ESC&nbsp;O&nbsp;A&quot;
35591 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
35592 database assigns a sequence that doesn't begin with an escape
35593 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
35594 This usually works fine
35595 because most terminals emit the escape sequences that Alpine has defined
35596 by default.  We have also found that it is usually better to have these
35597 defaults take precedence over the definitions contained in the database
35598 because the defaults are more likely to be correct than the database.
35599
35600 <P>
35601 There are some terminals where this breaks down.  If you want Alpine to
35602 believe the definitions given in your termcap (terminfo) database in
35603 preference to the defaults the Alpine itself sets up, then you may turn
35604 this feature on.  Then, sequences of characters that are defined in
35605 both termcap (terminfo) and in Alpine's set of defaults will be
35606 interpreted the way that termcap (terminfo) says they should be
35607 interpreted.  Also, if your terminal capabilities database assigns a
35608 sequence that doesn't begin with escape, it will not be ignored.
35609
35610 <P>
35611 <UL>
35612 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35613 </UL><P>
35614 &lt;End of help on this topic&gt;
35615 </BODY>
35616 </HTML>
35617 ====== h_config_cruise_mode =====
35618 <HTML>
35619 <HEAD>
35620 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
35621 </HEAD>
35622 <BODY>
35623 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
35624
35625 This feature affects Alpine's behavior when you hit the
35626 &quot;Space&nbsp;Bar&quot; at
35627 the end of a displayed message.  Typically, Alpine complains that the end
35628 of the text has already been reached.  Setting this feature causes such
35629 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
35630 taking you to the next &quot;interesting&quot; message,
35631 or scanning ahead to the
35632 next incoming folder with &quot;interesting&quot; messages.
35633
35634 <P>
35635 <UL>
35636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35637 </UL><P>
35638 &lt;End of help on this topic&gt;
35639 </BODY>
35640 </HTML>
35641 ====== h_config_cruise_mode_delete =====
35642 <HTML>
35643 <HEAD>
35644 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
35645 </HEAD>
35646 <BODY>
35647 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
35648
35649 This feature modifies the behavior of Alpine's
35650 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
35651 Setting this feature causes Alpine to implicitly delete read
35652 messages when it moves on to display the next &quot;interesting&quot; message.
35653 <P>
35654 NOTE: Beware when enabling this feature AND the
35655 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
35656 feature.
35657 <P>
35658 <UL>
35659 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35660 </UL><P>
35661 &lt;End of help on this topic&gt;
35662 </BODY>
35663 </HTML>
35664 ====== h_config_slash_coll_entire =====
35665 <HTML>
35666 <HEAD>
35667 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
35668 </HEAD>
35669 <BODY>
35670 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
35671
35672 The slash (/) command is available from the MESSAGE INDEX screen when
35673 the folder is sorted by either Threads or OrderedSubject, and the
35674 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
35675 is set to something other than &quot;none&quot;.
35676 Normally, the slash command Collapses or Expands the subthread that
35677 starts at the currently highlighted message, if any.
35678 If this option is set, then the slash command Collapses or Expands the
35679 <EM>entire</EM> current thread instead of just the subthread.
35680 The current thread is simply the top-level thread that contains the
35681 current message.
35682
35683 <P>
35684 <UL>
35685 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35686 </UL><P>
35687 &lt;End of help on this topic&gt;
35688 </BODY>
35689 </HTML>
35690 ====== h_config_color_thrd_import =====
35691 <HTML>
35692 <HEAD>
35693 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
35694 </HEAD>
35695 <BODY>
35696 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
35697
35698 This option affects only the THREAD INDEX screen.
35699 Whether or not you ever see a THREAD INDEX screen depends on the setting
35700 of the configuration option
35701 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
35702 and on the sort order of the index.
35703
35704 <P>
35705 If a message within a thread is flagged as Important
35706 and this option is set, then
35707 the entire line in the THREAD INDEX will be colored the color of the
35708 Index-important Symbol, which can be set using the
35709 <A HREF="h_color_setup">Setup Kolor</A> screen.
35710
35711 <P>
35712 <UL>
35713 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35714 </UL><P>
35715 &lt;End of help on this topic&gt;
35716 </BODY>
35717 </HTML>
35718 ====== h_config_allow_goto =====
35719 <HTML>
35720 <HEAD>
35721 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
35722 </HEAD>
35723 <BODY>
35724 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
35725
35726 This feature modifies the behavior of Alpine's file browser.  Setting this
35727 feature causes Alpine to offer the "G Goto" command in the file browser.
35728 That is the default.
35729
35730 <P>
35731
35732 The Goto command allows you to explicitly type in the desired directory.
35733 <P>
35734 &lt;End of help on this topic&gt;
35735 </BODY></HTML>
35736 ====== h_config_add_ldap =====
35737 <HTML>
35738 <HEAD>
35739 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
35740 </HEAD>
35741 <BODY>
35742 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
35743
35744 If both the Directory option
35745 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
35746 and this feature are set,
35747 then when an implicit directory lookup is done from the
35748 composer you will automatically be prompted to add the result of the
35749 directory lookup to your address book.
35750 <P>
35751 <UL>
35752 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35753 </UL><P>
35754 &lt;End of help on this topic&gt;
35755 </BODY>
35756 </HTML>
35757 ===== h_patterns_compat_behavior =====
35758 <HTML>
35759 <HEAD>
35760 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
35761 </HEAD>
35762 <BODY>
35763 <H1>Rules Behavior Changes in Pine 4.50</H1>
35764
35765 In Alpine, Rules that contain unrecognized elements
35766 are ignored.
35767 In most cases, the unrecognized elements will be something that was
35768 added as a new Rules feature in a later version of Alpine.
35769 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
35770 ignore rules that contained unrecognized elements.
35771 For example, a new element of Rules that was added in Pine 4.50 is
35772 Age interval.
35773 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
35774 all messages older than a week red.
35775 Now, if you run Pine 4.44 using that same configuration file, it will not
35776 recognize the Age interval and so will just ignore it.
35777 That means that all messages will match that rule so all messages will
35778 be colored red when using Pine version 4.44.
35779
35780 <P>
35781 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
35782 However, since the behavior still exists in versions prior to Pine 4.50 and
35783 since Filtering is a potentially destructive operation, another measure
35784 was taken to attempt to avoid unintentional Filtering of messages.
35785 The first time that you run Alpine or a Pine that is version 4.50 or greater,
35786 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
35787 will be copied to a new Filters configuration variable
35788 with a different name (&quot;Patterns-Filters2&quot;).
35789 From then on, Alpine will continue to use the new
35790 variable.
35791 Of course, Pine version 4.44 or lower will continue to use the old
35792 variable.
35793 That means that if you are using Alpine
35794 and also using a version of Pine that is older than 4.50, they will not
35795 share the configuration information about Filters.
35796 If you make a change in one version you won't see it in the other version.
35797
35798 <P>
35799 Since Scoring can be used to trigger Filtering, the same thing has been
35800 done for Score rules.
35801 The old configuration variable name is (&quot;Patterns-Scores&quot;)
35802 and the new name is (&quot;Patterns-Scores2&quot;).
35803 The same is not true of Role, Indexcolor, and Other rules that are
35804 thought to be less harmful when a mistake is made.
35805
35806 <P>
35807 &lt;End of help on this topic&gt;
35808 </BODY>
35809 </HTML>
35810 ======= h_config_filt_opts_sentdate =======
35811 <HTML>
35812 <HEAD>
35813 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
35814 </HEAD>
35815 <BODY>
35816 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
35817
35818 By default, the Age interval of a Pattern uses a message's time of
35819 arrival to compute the age of the message.
35820 If this feature is set, the date in the message's Date header will
35821 be used instead.
35822 <P>
35823 &lt;End of help on this topic&gt;
35824 </BODY>
35825 </HTML>
35826 ======= h_config_filt_opts_notdel =======
35827 <HTML>
35828 <HEAD>
35829 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
35830 </HEAD>
35831 <BODY>
35832 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
35833
35834 If this option is set then a message will be moved into the
35835 specified folder only if it is not marked for deletion.
35836 This is useful if you have multiple Alpine sessions running
35837 simultaneously and you don't want messages to be filtered into a
35838 folder more than once.
35839 It is also useful if you want to filter
35840 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
35841 This method is not foolproof.
35842 There may be cases where a message
35843 gets marked deleted and so it is never filtered into the folder.
35844 For example, if you deleted it in another Alpine session or another mail
35845 program that didn't use the filtering rule.
35846 <P>
35847 This option has no effect if the Filter Action is not set to Move.
35848 <P>
35849 &lt;End of help on this topic&gt;
35850 </BODY>
35851 </HTML>
35852 ======= h_config_filt_opts_nonterm =======
35853 <HTML>
35854 <HEAD>
35855 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
35856 </HEAD>
35857 <BODY>
35858 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
35859
35860 If this option is set then this is a non-terminating rule.
35861 Usually, for each message, Alpine searches through the Filter Rules until
35862 a match is found and then it performs the action associated with that rule.
35863 Rules following the match are not considered.
35864 If this option is set then the search for matches will continue at the next
35865 rule.
35866 <P>
35867 If a non-terminating rule matches then the actions associated with
35868 that rule, except for any implied deletion of the message, are performed
35869 before the match for the next rule is checked.
35870 For example, if the non-terminating rule sets the Important status, then that
35871 status will be set when the next rule is considered.
35872 However, if the non-terminating rule Moves the message, the message will
35873 actually be copied instead of copied and deleted so that it is still there
35874 for the next rule.
35875 A moved message is deleted after all the relevant rules have been checked.
35876 The name of the &quot;Move&quot; action is confusing in this case because
35877 a single message can be moved to more than one folder.
35878 It turns the Move into a Copy instead, but it is still followed by a deletion
35879 at the end.
35880 <P>
35881 This option may be useful if you want to have a single message filtered to
35882 two different folders because it matches two different Patterns.
35883 For example, suppose you normally filter messages to a particular mailing
35884 list into one folder, and messages addressed directly to you into a second
35885 folder.
35886 If a message is sent to both you and the list (and you can tell that by
35887 looking at the headers of the message) this option may give you a convenient
35888 way to capture a copy to each folder.
35889 (It may also cause you to capture two copies to each folder,
35890 depending on whether your mail system delivers one or two copies of the
35891 message to you and on how the list works.)
35892 <P>
35893 &lt;End of help on this topic&gt;
35894 </BODY>
35895 </HTML>
35896 ====== h_command_external_browser =====
35897 <HTML>
35898 <HEAD>
35899 <TITLE>The External Browser Command</TITLE>
35900 </HEAD>
35901 <BODY>
35902 <H1>The External Browser Command</H1>
35903
35904 <P>
35905 A new command was added to Alpine that allows users to send HTML messages to be displayed
35906 by a web browser. This is helpful when a user wants to see images in the context of the
35907 message, or get a better display of the message than Alpine provides.
35908
35909 <P>
35910 The simplest way to use this command is to do as follows. While reading a message,
35911 press the &quot;V&quot; to go to the <A href="h_attachment_screen">ATTACHMENT SCREEN</A>.
35912 In that screen move the cursor until it is on top of a TEXT/HTML attachment and press the
35913 &quot;X&quot; key. This will make Alpine launch the browser you have configured for
35914 in the <a href="h_config_browser"><!--#echo var="VAR_url-viewers"--></a> variable, and
35915 you should be able to read the message in your browser, as well as in Alpine.
35916
35917 <P> If the message you sent to your browser has inline images, then the images attached to
35918 the message that are necessary for the display of the message are also sent to the browser
35919 for its display.
35920
35921 <P> The text that follows will explain more details about this command, and is only
35922 recommended for more advanced users.
35923
35924 <h1><CENTER>Displaying Images</CENTER></h1>
35925
35926 <P> First, we will talk about displaying images in an HTML file. Typically, HTML images
35927 are displayed as the result of some specific code of the form
35928 <center>
35929 <PRE>
35930 &lt;img src=&quot;...&quot;&gt;,
35931 </PRE>
35932 </center>
35933 where the text between the quotes tells Alpine how to find the image.
35934 If the source of the image is internal to the message, Alpine passes that image to the
35935 browser. Otherwise Alpine erases the link to the image. This is done so that
35936 you can be protected from a bad use of external images. Images can be used to track
35937 that you read the message, or your location, devices you own, etc.. Since Alpine does
35938 not open images in any messages, your
35939 privacy is always protected this way. Therefore, when you do not pass the links to
35940 external images to a browser, your privacy is being protected. However, doing this
35941 might make the message not be displayed correctly, since when the message was
35942 created the images were part of the formatted message, and not having images might make
35943 this formatting look awkward.
35944
35945 <P> If you would like that Alpine display all images, regardless of their source, and
35946 regardless of the sender, then you need to disable the feature <a
35947 href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>.
35948 The message will display as intended, but you will leak information to the sender of the
35949 message, as well as to your internet service provider, which could be your employer, or
35950 school, etc.
35951
35952 <P> Alpine provides an alternative mechanism to either send all links to the images to the
35953 external browser or to send only those that are attached to the message you are trying to
35954 display. In order to use this mechanism you must first enable
35955 <a href="h_config_enable_view_attach"><!--#echo var="FEAT_enable-msg-view-attachments"--></a>.
35956 This allows Alpine to add direct links to each attachments. If you want to send an HTML
35957 attachment to an external browser, you would place the cursor over the attachment and press
35958 the &quot;Return&quot; or &quot;Enter&quot; key to open the attachment. When you do that
35959 you will see a prompt and menu which says
35960
35961 <pre>
35962 View selected Attachment  ?
35963 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
35964 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
35965 </pre>
35966
35967 <P>In order to send this message to an external browser, you would press the &quot;X&quot;
35968 key. This will change the prompt and menu to
35969
35970 <pre>
35971 View selected Attachment using external viewer including inline images only ?
35972 &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
35973 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I All images
35974 </pre>
35975
35976 <P>This is telling you that if you answer &quot;Yes&quot; to this question, and external
35977 browser will be used to send this messages, and only inline images, that is, those attached
35978 in the message will be sent to the browser. If you would like to send all images in
35979 this case, the menu tells you that you must press the &quot;I&quot; key. Pressing
35980 that key changes the prompt and menu to
35981
35982 <pre>
35983 View selected Attachment using external viewer including all images ?
35984 &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
35985 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I Inline imgs
35986 </pre>
35987
35988 <P>and as you can see the prompt says that if you press &quot;Yes&quot; then the message
35989 will be sent to the browser including the source of all images, including those in
35990 external servers. Notice that the &quot;X&quot; command now is a toggle. If you
35991 were to press it now, you would return to the original prompt,
35992
35993 <pre>
35994 View selected Attachment  ?
35995 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
35996 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
35997 </pre>
35998
35999 <P>which means that if you answer &quot;Yes&quot; at this time your message would not
36000 be sent to your external browser for display, unless you have configured a mailcap
36001 entry to display HTML files.
36002
36003 <P> One of the lessons of this discussion is that if you never press the &quot;X&quot;
36004 command in the ATTACHMENT SCREEN, and you never press the &quot;X&quot; command when
36005 launching a viewer for an attachment in the MESSAGE TEXT screen, you will never use this
36006 mechanism, and Alpine will resort to your already configured mechanisms to open HTML
36007 text.This means you can live your life without worrying that Alpine will do anything
36008 different because of this new feature. You do not have to use it, but if you do, you should
36009 know the risks and advantages and decide when and how to use it.
36010
36011 <h1><CENTER>Saving HTML Messages to Disk</CENTER></h1>
36012
36013 <P>
36014 No matter what your reason to send a message to an external web browser is, Alpine must
36015 write your message to a file (and also all related inline images), and point your browser
36016 to open that file. Alpine saves all your messages and auxiliary images in a subdirectory
36017 of the ~/.alpine-html directory in unix-like Alpine, or the alpine-html folder in your home
36018 directory in PC-Alpine. If Alpine cannot access these directories, or create folders
36019 in them, then the full mechanism described above will fail, and you will not be able
36020 to send messages to an external browser for display.
36021
36022 <P>
36023 Unfortunately browsers do not remove the file that Alpine created, nor the images
36024 that Alpine saved in order to display this message, so if you use this mechanism often
36025 you will create many directories and files which the browser will not remove. Alpine
36026 will remove these files when you exit Alpine. Any temporary directory that Alpine
36027 created that has existed for longer than 10 minutes will be automatically erased.
36028 Alpine also erases these directories upon exiting.
36029
36030 <P>
36031 When Alpine creates a directory to house the files associated to a message that will
36032 pass to an external browser, it tries to delete that directory later on, according to
36033 the discussion above. What this means is that you should consider the contents of the
36034 ~/.alpine-html directory in unix-like Alpine and the alpine-html folder in PC-Alpine
36035 as temporary, and not rely on their existence. If you attempt to save files in one of
36036 these directories, chances are your data will be deleted by Alpine. Since deleting is
36037 a destructive action,
36038 every session of Alpine that you have open will only attempt to remove the directories
36039 it created, with their content in them. If this operation fails, Alpine will not try
36040 to investigate, nor will report to you, why the operation failed. Therefore, users
36041 should periodically check their html directory to see if there is content there that
36042 they wish to delete.
36043
36044 <P>
36045 <UL>
36046 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36047 </UL><P>
36048 &lt;End of help on this topic&gt;
36049 </BODY>
36050 </HTML>
36051 ===== h_mainhelp_smime ======
36052 <HTML>
36053 <HEAD>
36054 <TITLE>S/MIME Overview</TITLE>
36055 </HEAD>
36056 <BODY>
36057 <H1>S/MIME Overview</H1>
36058
36059 S/MIME is a standard for the public key encryption and signing of email.
36060 UNIX Alpine contains a basic implementation of S/MIME based on
36061 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries. The
36062 same support can be provided using the
36063 <A HREF="http://www.libressl.org/">LibreSSL</A> libraries. The
36064 support for S/MIME in PC-Alpine is fully based on the LibreSSL libraries.
36065 To check if this version of Alpine supports S/MIME look at
36066 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
36067 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
36068 <P>
36069 Some limitations:
36070 <UL>
36071    <LI> There is no provision for checking for CRLs
36072         (Certificate Revocation Lists) in Alpine.
36073    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
36074    <LI> There is no mechanism available for feeding either an entire incoming
36075         or an entire outgoing message to an external
36076         filter and using that external filter to do S/MIME or PGP processing.
36077    <LI> Because the implementation currently uses OpenSSL, there is only a very
36078         limited integration with the Mac OS Keychain (the storing and access of
36079         public certificates).
36080 </UL>
36081 <P>
36082 The S/MIME configuration screen is reached by going to the Main Menu and typing
36083 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
36084 <P>
36085
36086 <H2>S/MIME BASICS</H2>
36087
36088 In order to digitally sign messages you send you must have a public/private key-pair.
36089 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
36090 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
36091 users or a company which provides certificates for its workers.
36092 These certificates are bound to an email address, so the identity being verified is the
36093 email address not a person's name.
36094 <P>
36095 Mail is signed by using the sender's private key, which only the owner of the private key
36096 has access to.
36097 The signature is verified using the signer's public key, which anyone can
36098 have access to.
36099 With Alpine, the first time you receive a signed message the public key of the
36100 sender will be stored for future use.
36101
36102 <P>
36103 Mail is encrypted using the recipient's public key and decrypted by
36104 the recipient with their private key.
36105
36106 <P>
36107 You need a key of your own in order to sign outgoing messages and to have others
36108 encrypt messages sent to you.
36109 You do not need a key of your own to verify signed messages sent by others or to
36110 encrypt messages sent to others.
36111
36112 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
36113
36114 By default UNIX Alpine stores the certificates it uses in a directory in your
36115 home directory.
36116 The directory name is
36117 <P>
36118 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
36119 <P>
36120 For PC-Alpine, the equivalent directory is called
36121 <CENTER><SAMP>alpine-smime</SAMP></CENTER>
36122 and is also located under your home directory.
36123 <P>
36124 Within that directory are three subdirectories.
36125 Each of the three subdirectories contains files with PEM-encoded contents,
36126 the default format for OpenSSL.
36127 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
36128 The files within that directory have names that are email addresses with the
36129 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
36130 An example filename is
36131 <P>
36132 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
36133 <P>
36134 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
36135 your private key.
36136 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
36137 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
36138 Authorities that you want to trust but that aren't contained in the set of system CAs.
36139 Those files may have arbitrary names as long as they end with the
36140 suffix &quot;<SAMP>.crt</SAMP>&quot;.
36141
36142 <H2>HOW TO SIGN AND ENCRYPT</H2>
36143
36144 If you have a certificate you may sign outgoing messages.
36145 After typing the Ctrl-X command to send a message you will see the prompt
36146 <P>
36147 <CENTER><SAMP>Send message?</SAMP></CENTER>
36148 <P>
36149 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
36150 Typing the &quot;G&quot; command will change the prompt to
36151 <P>
36152 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
36153 <P>
36154 Typing the &quot;E&quot; command will change the prompt to
36155 <P>
36156 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
36157 <P>
36158 You may even type both to get
36159 <P>
36160 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
36161 <P>
36162
36163 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
36164
36165 The reading of a signed message should not require any special action on
36166 your part.
36167 There should be an editorial addition at the start of the message which
36168 says either
36169 <P>
36170 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
36171 <P>
36172 or
36173 <P>
36174 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
36175 <P>
36176 If an encrypted message is sent to you the encrypted text will not
36177 be shown.
36178 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
36179 you are viewing the message) and supply your passphrase when asked.
36180 <P>
36181 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
36182 which gives you some information about the certificate used to sign or encrypt the message.
36183
36184 <H2>MISCELLANEOUS</H2>
36185
36186 If you have access to a private certificate in the PKCS12 format, which
36187 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
36188 use the following commands to generate private keys, public and certificate
36189 authorities certificates. In the examples below, we assume that the
36190 certificate in the p12 format is called &quot;certificate.p12&quot;, and
36191 that your email address is &quot;your@address.com&quot;.
36192
36193 <P>
36194 In order to create a private key use the command
36195 <P>
36196 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
36197 <P>
36198 In order to create a public certificate use the command
36199 <P>
36200 <CENTER><SAMP>
36201 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
36202 </SAMP></CENTER>
36203 <P>
36204 In order to create a certificate authority certificate use the command
36205 <P>
36206 <CENTER><SAMP>
36207 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
36208 </SAMP></CENTER>
36209
36210 <P> If the previous command produces an empty file, it means that the
36211 certificate authority was not included in the .p12 file, so you will have
36212 to get it from some other sources. You will need these certificates, so
36213 that you can validate correctly signatures.
36214
36215 <P>
36216 After you have exported these certificates and keys, you can  use the import
36217 command in Alpine, from the S/MIME configuration screen,
36218 to import these certificates into Alpine. They will be available for use
36219 as soon as you import them.
36220 <P>
36221 &lt;End of help on this topic&gt;
36222 </BODY>
36223 </HTML>
36224 ====== h_config_smime_pubcertdir =====
36225 <HTML>
36226 <HEAD>
36227 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
36228 </HEAD>
36229 <BODY>
36230 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
36231
36232 <P>
36233 If the option
36234 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36235 is set then this option will have no effect.
36236 <P>
36237 Normally, Public Certificates for use with S/MIME will be stored in the directory
36238 which is the value of this option.
36239 Those certificates will be stored in PEM format, one certificate per file.
36240 The name of the file for the certificate corresponding to
36241 <P>
36242 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36243 <P>
36244 should be
36245 <P>
36246 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
36247 <P>
36248 For example, a file for user@example.com would be in the file
36249 <P>
36250 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
36251 <P>
36252 in this directory.
36253 <P>
36254 Use the Setup/SMIME screen to modify this variable.
36255 <P>
36256 Typically, the public certificates that you have will come from S/MIME signed
36257 messages that are sent to you.
36258 Alpine will extract the public certificate from the signed message and store
36259 it in the certificates directory.
36260 These PEM format public certificates look something like:
36261 <PRE>
36262 -----BEGIN CERTIFICATE-----
36263 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
36264 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
36265 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
36266 ...
36267 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
36268 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
36269 -----END CERTIFICATE-----
36270 </PRE>
36271 <P>
36272 <UL>
36273 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36274 </UL><P>
36275 <P>
36276 <UL>
36277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36278 </UL><P>
36279 &lt;End of help on this topic&gt;
36280 </BODY>
36281 </HTML>
36282 ====== h_config_smime_pubcertcon =====
36283 <HTML>
36284 <HEAD>
36285 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
36286 </HEAD>
36287 <BODY>
36288 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
36289
36290 <P>
36291 If this option is set it will be used instead of
36292 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
36293 <P>
36294 This option gives you a way to store certificates remotely on an IMAP server
36295 instead of storing the certificates one per file locally.
36296 In order to do that you just give this option a remote folder name for a folder
36297 which does not yet exist.
36298 The name is similar to the name you might use for a remote configuration file.
36299 A remote folder name might look something like:
36300 <P>
36301 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
36302 <P>
36303 See
36304 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36305 about the syntax of folder names.
36306 <P>
36307 Use the Setup/SMIME screen to modify this variable.
36308 <P>
36309 <UL>
36310 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36311 </UL><P>
36312 <P>
36313 <UL>
36314 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36315 </UL><P>
36316 &lt;End of help on this topic&gt;
36317 </BODY>
36318 </HTML>
36319 ====== h_config_smime_privkeydir =====
36320 <HTML>
36321 <HEAD>
36322 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
36323 </HEAD>
36324 <BODY>
36325 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
36326
36327 <P>
36328 In order to sign outgoing S/MIME messages you will need a
36329 personal digital ID certificate.
36330 You will usually get such a certificate from a certificate authority such as
36331 Thawte or CAcert.
36332 (In order to encrypt outgoing messages you don't need a personal digital ID, you
36333 need the public certificate of the recipient instead.)
36334 If the option
36335 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
36336 is set then this option will have no effect.
36337 <P>
36338 Normally, Private Keys for use with S/MIME will be stored in the directory
36339 which is the value of this option.
36340 Those certificates will be stored in PEM format, one certificate per file.
36341 The name of the file for the certificate corresponding to your
36342 <P>
36343 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36344 <P>
36345 should be
36346 <P>
36347 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
36348 <P>
36349 For example, if your address is user@example.com the name of the file would be
36350 <P>
36351 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
36352 <P>
36353 in this directory.
36354 <P>
36355 Use the Setup/SMIME screen to modify this variable.
36356 <P>
36357 Typically, the private key that you have will come from a Certificate
36358 Authority.
36359 The private key should be stored in a PEM format file that
36360 looks something like:
36361 <PRE>
36362 -----BEGIN RSA PRIVATE KEY-----
36363 Proc-Type: 4,ENCRYPTED
36364 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
36365
36366 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
36367 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
36368 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
36369 ...
36370 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
36371 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
36372 -----END RSA PRIVATE KEY-----
36373 </PRE>
36374 <P>
36375 <UL>
36376 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36377 </UL><P>
36378 <P>
36379 <UL>
36380 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36381 </UL><P>
36382 &lt;End of help on this topic&gt;
36383 </BODY>
36384 </HTML>
36385 ====== h_config_smime_privkeycon =====
36386 <HTML>
36387 <HEAD>
36388 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
36389 </HEAD>
36390 <BODY>
36391 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
36392
36393 <P>
36394 If this option is set it will be used instead of
36395 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36396 <P>
36397 This option gives you a way to store keys remotely on an IMAP server
36398 instead of storing the keys one per file locally.
36399 In order to do that you just give this option a remote folder name for a folder
36400 which does not yet exist.
36401 The name is similar to the name you might use for a remote configuration file.
36402 A remote folder name might look something like:
36403 <P>
36404 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
36405 <P>
36406 See
36407 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36408 about the syntax of folder names.
36409 <P>
36410 Use the Setup/SMIME screen to modify this variable.
36411 <P>
36412 <UL>
36413 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36414 </UL><P>
36415 <P>
36416 <UL>
36417 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36418 </UL><P>
36419 &lt;End of help on this topic&gt;
36420 </BODY>
36421 </HTML>
36422 ====== h_config_smime_cacertdir =====
36423 <HTML>
36424 <HEAD>
36425 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
36426 </HEAD>
36427 <BODY>
36428 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
36429
36430 <P>
36431 If the option
36432 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
36433 is set then this option will have no effect.
36434 <P>
36435 CACert is a shorthand name for certification authority certificate.
36436 Normally Alpine will use the CACerts that are located in the standard system
36437 location for CACerts.
36438 It may be the case that one of your correspondents has a Digital ID which has
36439 been signed by a certificate authority that is not in the regular set of system certificate
36440 authorities.
36441 You may supplement the system list by adding further certificates of your own.
36442 These should  be stored in the directory
36443 which is the value of this option.
36444 The certificates will be stored in PEM format, one certificate per file.
36445 The names of the files can be anything ending in &quot;.crt&quot;.
36446 <P>
36447 Use the Setup/SMIME screen to modify this variable.
36448 <P>
36449 These PEM format CA certificates look very similar to your public
36450 certificates for particular email addresses
36451 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
36452 <P>
36453 <UL>
36454 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36455 </UL><P>
36456 <P>
36457 <UL>
36458 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36459 </UL><P>
36460 &lt;End of help on this topic&gt;
36461 </BODY>
36462 </HTML>
36463 ====== h_config_smime_cacertcon =====
36464 <HTML>
36465 <HEAD>
36466 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
36467 </HEAD>
36468 <BODY>
36469 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
36470
36471 <P>
36472 If this option is set it will be used instead of
36473 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
36474 <P>
36475 This option gives you a way to store certificates remotely on an IMAP server
36476 instead of storing the certificates one per file locally.
36477 In order to do that you just give this option a remote folder name for a folder
36478 which does not yet exist.
36479 The name is similar to the name you might use for a remote configuration file.
36480 A remote folder name might look something like:
36481 <P>
36482 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
36483 <P>
36484 See
36485 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36486 about the syntax of folder names.
36487 <P>
36488 Use the Setup/SMIME screen to modify this variable.
36489 <P>
36490 <UL>
36491 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36492 </UL><P>
36493 <P>
36494 <UL>
36495 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36496 </UL><P>
36497 &lt;End of help on this topic&gt;
36498 </BODY>
36499 </HTML>
36500 ========== h_config_smime_sign_by_default ==========
36501 <HTML>
36502 <HEAD>
36503 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
36504 </HEAD>
36505 <BODY>
36506 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
36507
36508 <P>
36509 This feature only has an effect if your version of Alpine includes
36510 support for S/MIME.
36511 It affects Alpine's behavior when you send a message.
36512 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
36513 <P>
36514 Only the default value is affected.
36515 In any case, you may still toggle the Signing option on or off before sending
36516 with the &quot;G Sign&quot; command (provided you have a personal digital ID
36517 certificate).
36518 <P>
36519 <UL>
36520 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36521 </UL><P>
36522 <P>
36523
36524 <UL>
36525 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36526 </UL><P>
36527 &lt;End of help on this topic&gt;
36528 </BODY>
36529 </HTML>
36530 ========== h_config_smime_use_cert_store ==========
36531 <HTML>
36532 <HEAD>
36533 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
36534 </HEAD>
36535 <BODY>
36536 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
36537
36538 <P>
36539 This feature only has an effect if your version of Alpine includes
36540 support for S/MIME.
36541 It affects Alpine's behavior when you validate a message, and should
36542 not be disabled, unless you are performing a test.
36543 <P>
36544 There are two important aspects of validation: validation of the message
36545 (that is, the message was not modified after it was sent)
36546 as well as validation of the identity of the sender. This option has to
36547 do with the latter.
36548 <P>
36549 In order to validate that the message came from the sender in the message
36550 and not an impersonator, Alpine can
36551 either use the certificates that come in the message, or the ones that
36552 you have personally stored. If this feature is enabled (the default) then
36553 Alpine will use certificates that you have already saved in your store
36554 and not those that come in the message to validate the sender of the
36555 message. In particular, the first time that you receive a signed message
36556 from a sender, and their certificate does not validate against your
36557 store, then you will be asked if you wish to save such certificate. If
36558 you do not wish to save the certificate, then Alpine will fail to validate
36559 the signature of the message. Otherwise, Alpine will proceed to validate
36560 the signature of the message. This behavior helps you prevent against impersonation, because
36561 it is assumed that you trust the certificates that you have saved, and
36562 might not trust those that came with the message that you are validating.
36563 <P>
36564 <UL>
36565 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36566 </UL><P>
36567 <P>
36568
36569 <UL>
36570 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36571 </UL><P>
36572 &lt;End of help on this topic&gt;
36573 </BODY>
36574 </HTML>
36575 ========== h_config_smime_pubcerts_in_keychain ==========
36576 <HTML>
36577 <HEAD>
36578 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
36579 </HEAD>
36580 <BODY>
36581 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
36582
36583 <P>
36584 If this feature is set the Mac OS X default keychain will be used as the place
36585 to store public certificates instead of a
36586 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
36587 or a
36588 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
36589 <P>
36590 <UL>
36591 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36592 </UL><P>
36593 <P>
36594 <UL>
36595 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36596 </UL><P>
36597 &lt;End of help on this topic&gt;
36598 </BODY>
36599 </HTML>
36600 ========== h_config_smime_dont_do_smime ==========
36601 <HTML>
36602 <HEAD>
36603 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
36604 </HEAD>
36605 <BODY>
36606 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
36607
36608 <P>
36609 Setting this feature turns off all of Alpine's S/MIME support.
36610 You might want to set this if you are having trouble due to the S/MIME support.
36611 <P>
36612 <UL>
36613 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36614 </UL><P>
36615 <P>
36616
36617 <UL>
36618 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36619 </UL><P>
36620 &lt;End of help on this topic&gt;
36621 </BODY>
36622 </HTML>
36623 ========== h_config_smime_encrypt_by_default ==========
36624 <HTML>
36625 <HEAD>
36626 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
36627 </HEAD>
36628 <BODY>
36629 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
36630
36631 <P>
36632 This feature only has an effect if your version of Alpine includes
36633 support for S/MIME.
36634 It affects Alpine's behavior when you send a message.
36635 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
36636 <P>
36637 Only the default value is affected.
36638 In any case, you may still toggle the Encrypt option on or off before sending
36639 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
36640 for the recipient).
36641 <P>
36642 <UL>
36643 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36644 </UL><P>
36645 <P>
36646
36647 <UL>
36648 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36649 </UL><P>
36650 &lt;End of help on this topic&gt;
36651 </BODY>
36652 </HTML>
36653 ========== h_config_smime_remember_passphrase ==========
36654 <HTML>
36655 <HEAD>
36656 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
36657 </HEAD>
36658 <BODY>
36659 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
36660
36661 <P>
36662 This feature only has an effect if your version of Alpine includes
36663 support for S/MIME.
36664 If this option is set, you will only have to enter your passphrase for your private key
36665 once during an Alpine session.
36666 <P>
36667 <UL>
36668 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36669 </UL><P>
36670 <P>
36671
36672 <UL>
36673 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36674 </UL><P>
36675 &lt;End of help on this topic&gt;
36676 </BODY>
36677 </HTML>
36678 ====== h_config_smime_transfer_pub_to_con =====
36679 <HTML>
36680 <HEAD>
36681 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
36682 </HEAD>
36683 <BODY>
36684 <H1>S/MIME: Transfer Public Certs to Container</H1>
36685
36686 <P>
36687 The Transfer command will copy the public certificates in your configured
36688 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
36689 to the container in your configured
36690 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
36691 This might be useful if you decide to switch from using a cert directory to a cert
36692 container.
36693 <P>
36694 Warning: Any previous contents in the container will be lost.
36695 <P>
36696 <UL>
36697 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36698 </UL><P>
36699 <P>
36700 <UL>
36701 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36702 </UL><P>
36703 &lt;End of help on this topic&gt;
36704 </BODY>
36705 </HTML>
36706 ====== h_config_smime_transfer_pub_to_dir =====
36707 <HTML>
36708 <HEAD>
36709 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
36710 </HEAD>
36711 <BODY>
36712 <H1>S/MIME: Transfer Public Certs to Directory</H1>
36713
36714 <P>
36715 The Transfer command will copy the public certificates in your configured
36716 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36717 to the directory in your configured
36718 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
36719 This might be useful if you decide to switch from using a cert container to a cert
36720 directory.
36721 <P>
36722 <UL>
36723 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36724 </UL><P>
36725 <P>
36726 <UL>
36727 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36728 </UL><P>
36729 &lt;End of help on this topic&gt;
36730 </BODY>
36731 </HTML>
36732 ====== h_config_smime_transfer_priv_to_con =====
36733 <HTML>
36734 <HEAD>
36735 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
36736 </HEAD>
36737 <BODY>
36738 <H1>S/MIME: Transfer Private Keys to Container</H1>
36739
36740 <P>
36741 The Transfer command will copy the private keys in your configured
36742 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36743 to the container in your configured
36744 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
36745 This might be useful if you decide to switch from using a key directory to a key
36746 container.
36747 <P>
36748 Warning: Any previous contents in the container will be lost.
36749 <P>
36750 <UL>
36751 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36752 </UL><P>
36753 <P>
36754 <UL>
36755 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36756 </UL><P>
36757 &lt;End of help on this topic&gt;
36758 </BODY>
36759 </HTML>
36760 ====== h_config_smime_transfer_priv_to_dir =====
36761 <HTML>
36762 <HEAD>
36763 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
36764 </HEAD>
36765 <BODY>
36766 <H1>S/MIME: Transfer Private Keys to Directory</H1>
36767
36768 <P>
36769 The Transfer command will copy the private keys in your configured
36770 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
36771 to the directory in your configured
36772 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36773 This might be useful if you decide to switch from using a key container to a key
36774 directory.
36775 <P>
36776 <UL>
36777 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36778 </UL><P>
36779 <P>
36780 <UL>
36781 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36782 </UL><P>
36783 &lt;End of help on this topic&gt;
36784 </BODY>
36785 </HTML>
36786 ====== h_config_smime_transfer_cacert_to_con =====
36787 <HTML>
36788 <HEAD>
36789 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
36790 </HEAD>
36791 <BODY>
36792 <H1>S/MIME: Transfer CA Certs to Container</H1>
36793
36794 <P>
36795 The Transfer command will copy the CA certificates in your configured
36796 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
36797 to the container in your configured
36798 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
36799 This might be useful if you decide to switch from using a CA cert directory to a CA cert
36800 container.
36801 <P>
36802 Warning: Any previous contents in the container will be lost.
36803 <P>
36804 <UL>
36805 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36806 </UL><P>
36807 <P>
36808 <UL>
36809 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36810 </UL><P>
36811 &lt;End of help on this topic&gt;
36812 </BODY>
36813 </HTML>
36814 ====== h_config_smime_transfer_cacert_to_dir =====
36815 <HTML>
36816 <HEAD>
36817 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
36818 </HEAD>
36819 <BODY>
36820 <H1>S/MIME: Transfer CA Certs to Directory</H1>
36821
36822 <P>
36823 The Transfer command will copy the CA certificates in your configured
36824 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
36825 to the directory in your configured
36826 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
36827 This might be useful if you decide to switch from using a CA cert container to a CA cert
36828 directory.
36829 <P>
36830 <UL>
36831 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36832 </UL><P>
36833 <P>
36834 <UL>
36835 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36836 </UL><P>
36837 &lt;End of help on this topic&gt;
36838 </BODY>
36839 </HTML>
36840 ====== h_config_smime_transfer_pubcon_to_key =====
36841 <HTML>
36842 <HEAD>
36843 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
36844 </HEAD>
36845 <BODY>
36846 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
36847
36848 Mac OS X Alpine only.
36849 <P>
36850 The Transfer command will copy the public certificates in your configured
36851 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36852 to your default Mac OS X Keychain.
36853 This might be useful if you decide to switch from using a cert container to using
36854 the Keychain to store your public certs, which you may do by using the
36855 feature
36856 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
36857 <P>
36858 <UL>
36859 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36860 </UL><P>
36861 <P>
36862 <UL>
36863 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36864 </UL><P>
36865 &lt;End of help on this topic&gt;
36866 </BODY>
36867 </HTML>
36868 ====== h_config_smime_transfer_pubkey_to_con =====
36869 <HTML>
36870 <HEAD>
36871 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
36872 </HEAD>
36873 <BODY>
36874 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
36875
36876 <P>
36877 The Transfer command will copy the public certificates in your configured
36878 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36879 to your default Mac OS X Keychain.
36880 This might be useful if you decide to switch from using a cert container to using
36881 the Keychain to store your public certs.
36882 <P>
36883 <UL>
36884 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36885 </UL><P>
36886 <P>
36887 <UL>
36888 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36889 </UL><P>
36890 &lt;End of help on this topic&gt;
36891 </BODY>
36892 </HTML>
36893 ====== h_config_smime_public_certificates =====
36894 <HTML>
36895 <HEAD>
36896 <TITLE>S/MIME: Manage Public Certificates</TITLE>
36897 </HEAD>
36898 <BODY>
36899 <H1>S/MIME: Manage Public Certificates</H1>
36900
36901 <P>
36902 This menu item allows you to manage your public certificates, this
36903 may include your own public certificate, but it normally includes
36904 certificates of people you correspond with. These certificates are
36905 saved by Alpine automatically when they are found in signed messages
36906 that you receive. This interface allows you to manage them, by
36907 giving you the option to delete them, or trust them (in the case
36908 of self-signed certificates).
36909
36910 <P>
36911 Please note that Alpine will not validate a message that was sent to you
36912 using a self-signed certificate, unless you decide to trust that certificate.
36913 Internally, a certificate is trusted by copying it to the
36914 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
36915 collection. If you decide that you want to stop trusting a self-signed
36916 certificate, you must delete such certificate from such collection.
36917 <P>
36918 The <B>I</B> Import command available in this screen allows you to
36919 import a command to this collection.
36920 <P>
36921 <UL>
36922 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36923 </UL><P>
36924 <P>
36925 <UL>
36926 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36927 </UL><P>
36928 &lt;End of help on this topic&gt;
36929 </BODY>
36930 </HTML>
36931 ====== h_config_smime_private_keys =====
36932 <HTML>
36933 <HEAD>
36934 <TITLE>S/MIME: Manage Private Keys</TITLE>
36935 </HEAD>
36936 <BODY>
36937 <H1>S/MIME: Manage Private Keys</H1>
36938
36939 <P>
36940 This option allows you to manage your private key. Normally a person has only
36941 one key, in the same way that a person only has one valid passport, or ID card,
36942 at any given time. This option allows you to manage private keys. You can
36943 delete them or import them. Additionally, you can view information
36944 about your public certificate, such as the issuer and the dates of validity
36945 of such certificate, among others.
36946
36947 <P>
36948 If you have more than one e-mail address for which you want to use the
36949 same private key, you must add all those addresses to the private key at
36950 the moment that the key is generated. When you receive a signed message using
36951 a key generated for several e-mail addresses, Alpine will save a
36952 certificate for each e-mail address included in such certificate.
36953 <P>
36954 The <B>I</B> Import command available in this screen allows you to
36955 import a command to this collection.
36956 <P>
36957 <UL>
36958 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36959 </UL><P>
36960 <P>
36961 <UL>
36962 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36963 </UL><P>
36964 &lt;End of help on this topic&gt;
36965 </BODY>
36966 </HTML>
36967 ====== h_config_smime_certificate_authorities =====
36968 <HTML>
36969 <HEAD>
36970 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
36971 </HEAD>
36972 <BODY>
36973 <H1>S/MIME: Manage Certificate Authorities</H1>
36974
36975 <P>
36976 This collection contains certificates that are needed to validate the
36977 certificate of another person, and therefore contains certificates that
36978 you trust. Typically a certificate is signed by another entity, called a
36979 certificate authority. This option allows you to manage which certificates
36980 you trust, allowing you to import them and to delete them or view information
36981 about each certificate, such as the issuer and the dates of validity
36982 of such certificate.
36983 <P>
36984 The <B>I</B> Import command available in this screen allows you to
36985 import a command to this collection.
36986 <P>
36987 <UL>
36988 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36989 </UL><P>
36990 <P>
36991 <UL>
36992 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36993 </UL><P>
36994 &lt;End of help on this topic&gt;
36995 </BODY>
36996 </HTML>
36997 ====== h_config_smime_password_file_certificates =====
36998 <HTML>
36999 <HEAD>
37000 <TITLE>S/MIME: Manage Password File Certificates</TITLE>
37001 </HEAD>
37002 <BODY>
37003 <H1>S/MIME: Manage Password File Certificates</H1>
37004
37005 <P>
37006 This option allows you to manage the certificates that are used to
37007 encrypt and decrypt your password file. This is useful in case you
37008 want to change the certificates used to encrypt your password file.
37009 <P>
37010 Depending on the version of Alpine that you used for the first time
37011 to set this up, you might have had to enter a password to enter this
37012 screen. In the case that you did not enter a password to enter this
37013 screen, you should know two things that are important:
37014 <UL>
37015 <LI> If anyone takes control of your computer (for example, if you
37016 left it unattended) then that person can add a password to your
37017 password file and make it unreadable to you in the future.
37018 <LI> If anyone can access your computer (this includes remote access)
37019 then that person can steal your password file and decrypt it without
37020 your help. This gives access to that person to the same services you
37021 have access and such person can use your name to access that service.
37022 In particular, that person can try to hack into your service provider
37023 with your name on it, or that person could try to send spam with
37024 your name.
37025 </UL>
37026 <P> Needless to say, this is not advisable. You should keep your
37027 password file protected. In order to do so, all you need to do is use
37028 the &quot;Create Key&quot; command to create a key. Once you do this,
37029 Alpine will use that key, encrypted with the password used to create that
37030 key, to protect your password file.
37031 <P>
37032 In this screen you can import a new key to encrypt your password file,
37033 and read cryptographic information on your current key.
37034 <P>
37035 To import a new key press &quot;RETURN&quot; and enter the location of
37036 the new key. You will be asked to enter the password of the new key. If
37037 this part of the process is successful, Alpine will search for the
37038 certificate that matches that key. If your key is named
37039 &quot;your_email@address.com.key&quot;, then Alpine will look for your
37040 certificate in the same directory in the file named
37041 &quot;your_email@address.com.crt&quot;, otherwise it will look for it
37042 as part of your key (that is, it will look to see if your certificate
37043 is in the file &quot;your_email@address.com.key&quot;), if all of this
37044 fails, Alpine will ask you to enter the location of the certificate
37045 that matches the key you unlocked. If a certificate is found, it will be
37046 used, and in this case, the password file will be read, decrypted with the
37047 old key and encrypted with the new key. Once this is done, the new key and
37048 certificates are saved, and the old keys are permanently deleted.
37049 <P>
37050 Alpine does not create a backup of your password file, or your old keys
37051 that will be replaced. If you need to keep old copies, you will have to do
37052 this operation outside Alpine.
37053 <P>
37054 Observe that you can use this screen to remove the password for the key.
37055 As explained earlier, this is not advisable, but you can always restore the
37056 password to encrypt your password file by creating a new key.
37057 <P>
37058 Be safe and keep your password file encrypted with a password.
37059 <UL>
37060 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37061 </UL><P>
37062 <P>
37063 <UL>
37064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37065 </UL><P>
37066 &lt;End of help on this topic&gt;
37067 </BODY>
37068 </HTML>
37069 ====== h_certificate_information =====
37070 <HTML>
37071 <HEAD>
37072 <TITLE>S/MIME: Certificate Information Screen</TITLE>
37073 </HEAD>
37074 <BODY>
37075 <H1>S/MIME: Certificate Information Screen</H1>
37076
37077 <P>
37078 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
37079 such as its owner, e-mail address, issuer, and interval of validity,
37080 among others.
37081 <P>
37082 In the case of public certificates, this screen shows you if there was a
37083 failure when attempting to validate such message. If the certificate is
37084 self-signed, then the <B>T</B> Trust command will be available, which
37085 you can use to trust such certificate and make Alpine not fail validating
37086 signatures signed with such certificate.
37087 <P>
37088 You can also mark a certificate deleted, with the <B>D</B> command, or
37089 remove the deleted mark with the <B>U</B> undelete command.
37090 <P>
37091 In the case of your private key, Alpine shows you the information
37092 from your public key. Additionally, Alpine allows you to see public
37093 and private information about your key, with the <B>B</B> and
37094 <B>R</B> commands respectively.
37095 <UL>
37096 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37097 </UL><P>
37098 <P>
37099 <UL>
37100 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37101 </UL><P>
37102 &lt;End of help on this topic&gt;
37103 </BODY>
37104 </HTML>
37105 ====== h_config_smime_manage_public_menu =====
37106 <HTML>
37107 <HEAD>
37108 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
37109 </HEAD>
37110 <BODY>
37111 <H1>S/MIME: Commands that Manage Public Certificates</H1>
37112
37113 <P>
37114 This screen allows you to manage your public certificates.
37115 <P>
37116 The format of this screen is as follows. There are five fields: The
37117 leftmost field is normally empty, but it could contain the letter
37118 &quot;D&quot; to indicate that that certificate has been marked for
37119 deletion. The next field is the e-mail address of the owner of the
37120 certificate, shown in its entirety. The third and fourth field are the
37121 first and last day validity for that certificate, respectively. The date
37122 is displayed in the user's locale unless the option
37123 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
37124 is set. In this case, the month, day and year are represented by two
37125 digits, and the format used is mm/dd/yy. Finally, the fifth
37126 field is what can be displayed of the MD5 hash of the certificate. You can
37127 use any of the last three fields to distinguish between two certificates
37128 for the same owner.
37129 <P>
37130 Available commands in this screen and a short description of what they
37131 do follows.
37132 <UL>
37133 <LI> <B>I</B> Imports a public certificate to this collection.
37134 <LI> <B>V</B> View information about a certificate such as the name of the person the
37135 certificate was issued to, its dates of validity, and validity status.
37136 <LI> <B>D</B> Marks a certificate deleted.
37137 <LI> <B>U</B> Removes the deletion mark on a certificate.
37138 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
37139 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
37140 trust a certificate by copying it to the collection of trusted certificates.
37141 </UL>
37142 <P>
37143 All commands provide feedback to let you know about their success or failure.
37144 <P>
37145 <UL>
37146 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37147 </UL><P>
37148 <P>
37149 <UL>
37150 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37151 </UL><P>
37152 &lt;End of help on this topic&gt;
37153 </BODY>
37154 </HTML>
37155 ====== h_config_smime_manage_private_menu =====
37156 <HTML>
37157 <HEAD>
37158 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
37159 </HEAD>
37160 <BODY>
37161 <H1>S/MIME: Commands that Manage Private Keys</H1>
37162
37163 <P>
37164 This screen allows you to manage your private key.
37165 <P>
37166 The format of this screen is as follows. There are five fields: The
37167 leftmost field is normally empty, but it could contain the letter
37168 &quot;D&quot; to indicate that that certificate has been marked for
37169 deletion. The next field is the e-mail address of the owner of the
37170 certificate, shown in its entirety. The third field is the first day of
37171 validity for that certificate; the fourth field in the last day that that
37172 certificate is valid, and the fifth field is what can be displayed of the
37173 MD5 hash of the public certificate corresponding to this private key. You
37174 can use any of the last three fields to distinguish between two
37175 certificates for the same owner.
37176 <P>
37177 Available commands and a short description of what they do follows.
37178 <UL>
37179 <LI> <B>I</B> Imports a new public key to this collection.
37180 <LI> <B>V</B> View information about the public certificate corresponding to this
37181 key.
37182 <LI> <B>D</B> Marks a key to be deleted.
37183 <LI> <B>U</B> Removes the deletion mark on a key.
37184 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
37185 Note that expunging a private key does not remove the public key, which must
37186 be removed separately.
37187 </UL>
37188 <P>
37189 All commands provide feedback to let you know about their success or failure.
37190 <P>
37191 <UL>
37192 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37193 </UL><P>
37194 <P>
37195 <UL>
37196 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37197 </UL><P>
37198 &lt;End of help on this topic&gt;
37199 </BODY>
37200 </HTML>
37201 ====== h_config_smime_manage_cacerts_menu =====
37202 <HTML>
37203 <HEAD>
37204 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
37205 </HEAD>
37206 <BODY>
37207 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
37208
37209 <P>
37210 This screen allows you to manage your collection of certificates that you
37211 trust.
37212 <P>
37213 The format of this screen is as follows. There are five fields: The
37214 leftmost field is normally empty, but it could contain the letter
37215 &quot;D&quot; to indicate that that certificate has been marked for
37216 deletion. The next field is the e-mail address of the owner of the
37217 certificate, shown in its entirety. The third field is the first day of
37218 validity for that certificate; the fourth field in the last day that that
37219 certificate is valid, and the fifth field is what can be displayed of the
37220 MD5 hash of the certificate. You can use any of the last three fields to
37221 distinguish between two certificates for the same owner.
37222 <P>
37223 Available commands and a short description of what they do follows.
37224 <UL>
37225 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
37226 done by reading the certificate and validating it. Once a certificate
37227 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
37228 to the certificate, if necessary.
37229 <LI> <B>V</B> View information about this certificate, such as its issuer
37230 and validity dates.
37231 <LI> <B>D</B> Marks a certificate to be deleted.
37232 <LI> <B>U</B> Removes the deletion mark on a certificate.
37233 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
37234 </UL>
37235 <P>
37236 All commands provide feedback to let you know about their success or failure.
37237 <P>
37238 <UL>
37239 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37240 </UL><P>
37241 <P>
37242 <UL>
37243 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37244 </UL><P>
37245 &lt;End of help on this topic&gt;
37246 </BODY>
37247 </HTML>
37248 ====== h_config_lame_list_mode =====
37249 <HTML>
37250 <HEAD>
37251 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
37252 </HEAD>
37253 <BODY>
37254 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
37255
37256 This feature modifies the method Alpine uses to ask your IMAP
37257 server for folder names to display in the FOLDER LIST screen.
37258 It is intended to compensate for a small set of IMAP servers that
37259 are programmed to ignore a part of the request, and thus respond
37260 to Alpine's query with nonsensical results.
37261 <P>
37262
37263 If you find that Alpine is erroneously displaying blank folder lists,
37264 try enabling this feature.
37265 <P>
37266
37267 NOTE: Enabling this feature has consequences for the Goto and Save
37268 commands.  Many servers allow access to folders outside the area
37269 reserved for your personal folders via some reserved character,
37270 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
37271 allows, at the Goto and Save prompts, quick access to folders
37272 outside your personal folder collection without requiring a specific
37273 collection definition.  This behavior will generally not be available
37274 when this feature is enabled.
37275
37276 <P>
37277 <UL>
37278 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37279 </UL><P>
37280 &lt;End of help on this topic&gt;
37281 </BODY>
37282 </HTML>
37283 ====== h_config_enable_mulnewsrcs =====
37284 <HTML>
37285 <HEAD>
37286 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
37287 </HEAD>
37288 <BODY>
37289 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
37290
37291 This feature makes it so Alpine can use multiple newsrcs based on
37292 the news server being connected to, which allows for separate lists
37293 of subscribed-to newsgroups. When this feature is not set, there is only
37294 one list of newsgroups.
37295 <P>
37296 Under this feature, the name of a newsrc is based on the news server.
37297 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
37298 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
37299 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
37300 Setting this feature for the first time will allow for the option of using
37301 your old newsrc the next time you read news.
37302 <P>
37303 If this feature is set, then the feature
37304 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
37305 also may affect the name of the newsrc file that is used.
37306 <P>
37307 <UL>
37308 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37309 </UL><P>
37310 &lt;End of help on this topic&gt;
37311 </BODY>
37312 </HTML>
37313 ======= h_ab_export_vcard =======
37314 <HTML>
37315 <HEAD>
37316 <TITLE>Address Book Export Format</TITLE>
37317 </HEAD>
37318 <BODY>
37319 <H1>Address Book Export Format</H1>
37320
37321 You are exporting address book data from Alpine to a file outside of Alpine.
37322 You are being asked to choose the format of the export.
37323 Here are the choices:
37324
37325 <DL>
37326 <DT><EM>A</EM>ddress List</DT>
37327 <DD>
37328 The addresses from the address book entries you are saving
37329 from will be saved one address per line.
37330 Address book lists (those with more than one address) will have
37331 all of their addresses saved separately.
37332 </DD>
37333
37334 <DT><EM>V</EM>Card</DT>
37335 <DD>
37336 The entries will be saved in
37337 <A HREF="h_whatis_vcard">vCard</A> format.
37338 </DD>
37339
37340 <DT><EM>T</EM>ab Separated</DT>
37341 <DD>
37342 The entries will be saved in tab-separated columns.
37343 There will be just 4 columns of data that correspond to Alpine's
37344 Nickname field, Full Name field, Address field, and Comment field.
37345 It might prove useful to Select only the Simple, non-List address book
37346 entries before Saving.
37347 </DD>
37348
37349 <DT><EM>^C</EM> Cancel</DT>
37350 <DD>
37351 Cancel out of the Save.
37352 </DD>
37353
37354 </DL>
37355
37356
37357 <P>
37358 &lt;End of help on this topic&gt;
37359 </BODY>
37360 </HTML>
37361 ====== h_config_predict_nntp_server =====
37362 <HTML>
37363 <HEAD>
37364 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
37365 </HEAD>
37366 <BODY>
37367 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
37368
37369 This feature allows Alpine to assume that the open NNTP server at the
37370 time of composition is the NNTP server to which the message should be
37371 posted.  This is especially recommended when there are multiple News
37372 collections.  If this feature is not set, Alpine will try to post to the first server in
37373 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
37374 this feature also negates the need to add News collection servers to
37375 the <!--#echo var="VAR_nntp-server"--> variable.
37376 <P>
37377 This feature can be especially handy when used in conjunction with
37378 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
37379 <P>
37380 <UL>
37381 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37382 </UL><P>
37383 &lt;End of help on this topic&gt;
37384 </BODY>
37385 </HTML>
37386 ====== h_config_nntp_search_uses_overview =====
37387 <HTML>
37388 <HEAD>
37389 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
37390 </HEAD>
37391 <BODY>
37392 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
37393
37394 This feature should probably be turned on unless it causes trouble.
37395 The results of the NNTP overview command (XOVER) may be used to help
37396 with some searches in news groups.
37397 It should result in quicker response time.
37398 Turning this feature on apparently causes search results which are
37399 different from what you would get with the feature turned off on some
37400 servers.
37401 <P>
37402 <UL>
37403 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37404 </UL><P>
37405 &lt;End of help on this topic&gt;
37406 </BODY>
37407 </HTML>
37408 ====== h_config_thread_sorts_by_arrival =====
37409 <HTML>
37410 <HEAD>
37411 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
37412 </HEAD>
37413 <BODY>
37414 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
37415
37416 This feature affects how a threading sort arranges threads.  The default way
37417 to arrange threads is by the date of the earliest message in the thread.
37418 This feature arranges threads by the last message to arrive in a thread.
37419 <P>
37420 This feature causes old threads that get recent messages to sort to the bottom,
37421 where previously a message arrival to a thread would not rearrange the order of
37422 that thread.
37423 <P>
37424 <UL>
37425 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37426 </UL><P>
37427 &lt;End of help on this topic&gt;
37428 </BODY>
37429 </HTML>
37430 ====== h_config_textplain_int =====
37431 <HTML>
37432 <HEAD>
37433 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
37434 </HEAD>
37435 <BODY>
37436 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
37437
37438 This feature modifies the method Alpine uses to display Text/Plain
37439 MIME attachments from the Attachment Index screen.  Normally, the
37440 &quot;View&quot; command searches for any externally defined (usually
37441 via the
37442 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
37443 and displays the selected text within that viewer.
37444
37445 <P>
37446 Enabling this feature causes Alpine to ignore any external viewer
37447 settings and always display text with Alpine's internal viewer.
37448
37449 <P>
37450 <UL>
37451 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37452 </UL><P>
37453 &lt;End of help on this topic&gt;
37454 </BODY>
37455 </HTML>
37456 ====== h_config_wp_columns =====
37457 <HTML>
37458 <HEAD>
37459 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
37460 </HEAD>
37461 <BODY>
37462 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
37463
37464 Web Alpine only.
37465 <P>
37466 This configuration setting specifies the number of horizontal characters
37467 used to format various WebAlpine pages.  Smaller values will tend to reduce
37468 the amount of horizontal scrolling required to view pages within narrow
37469 browsers, such as those found on PDAs, and larger values will tend to
37470 spread more information across the page.
37471
37472 <P>
37473 The Message List page uses the width to determine how many characters
37474 to assign each field.  Note, a smaller value may result in a disproportionate
37475 amount of blank space between fields on each line.  Similarly, a large
37476 value may result in cramped fields or horizontal scrolling.
37477
37478 <P>
37479 The Message View page uses this value to determine when to wrap lines
37480 in displayed message text.  Note, a smaller value may result in jagged
37481 right margins or confusing quoting.  A larger value may cause lines of text to
37482 run beyond the browser's right edge, requiring horizontal scrolling.
37483
37484 <P>
37485 <UL>
37486 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37487 </UL><P>
37488 &lt;End of help on this topic&gt;
37489 </BODY>
37490 </HTML>
37491 ====== h_config_wp_state =====
37492 <HTML>
37493 <HEAD>
37494 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
37495 </HEAD>
37496 <BODY>
37497 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
37498
37499 Web Alpine only.
37500 <P>
37501 Various aspects of cross-session state.
37502
37503 <P>
37504 <UL>
37505 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37506 </UL><P>
37507 &lt;End of help on this topic&gt;
37508 </BODY>
37509 </HTML>
37510 ====== h_config_wp_aggstate =====
37511 <HTML>
37512 <HEAD>
37513 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
37514 </HEAD>
37515 <BODY>
37516 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
37517
37518 Web Alpine only.
37519 <P>
37520 Aggregate operations tab state.
37521
37522 <P>
37523 <UL>
37524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37525 </UL><P>
37526 &lt;End of help on this topic&gt;
37527 </BODY>
37528 </HTML>
37529 ====== h_config_wp_indexlines =====
37530 <HTML>
37531 <HEAD>
37532 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
37533 </HEAD>
37534 <BODY>
37535 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
37536
37537 Web Alpine only.
37538 <P>
37539 Number of index lines in table.
37540
37541 <P>
37542 <UL>
37543 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37544 </UL><P>
37545 &lt;End of help on this topic&gt;
37546 </BODY>
37547 </HTML>
37548 ====== h_config_wp_indexheight =====
37549 <HTML>
37550 <HEAD>
37551 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
37552 </HEAD>
37553 <BODY>
37554 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
37555
37556 Web Alpine only.
37557 <P>
37558 Index table row height.
37559
37560 <P>
37561 <UL>
37562 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37563 </UL><P>
37564 &lt;End of help on this topic&gt;
37565 </BODY>
37566 </HTML>
37567 ====== h_config_rss_news =====
37568 <HTML>
37569 <HEAD>
37570 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
37571 </HEAD>
37572 <BODY>
37573 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
37574
37575 Web Alpine only.
37576 <P>
37577 RSS News feed.
37578
37579 <P>
37580 <UL>
37581 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37582 </UL><P>
37583 &lt;End of help on this topic&gt;
37584 </BODY>
37585 </HTML>
37586 ====== h_config_rss_weather =====
37587 <HTML>
37588 <HEAD>
37589 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
37590 </HEAD>
37591 <BODY>
37592 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
37593
37594 Web Alpine only.
37595 <P>
37596 RSS Weather feed.
37597
37598 <P>
37599 <UL>
37600 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37601 </UL><P>
37602 &lt;End of help on this topic&gt;
37603 </BODY>
37604 </HTML>
37605 ====== h_config_send_confirms_only_expanded =====
37606 <HTML>
37607 <HEAD>
37608 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
37609 </HEAD>
37610 <BODY>
37611 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
37612
37613 This Web Alpine option specifies whether or not a Send confirmations
37614 happens when a composed message is readied for sending or not.  The
37615 default behavior is to not confirm that the nicknames were expanded to
37616 the intended addresses.
37617
37618 <P>
37619 <UL>
37620 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37621 </UL><P>
37622 &lt;End of help on this topic&gt;
37623 </BODY>
37624 </HTML>
37625 ====== h_config_enable_jump_command =====
37626 <HTML>
37627 <HEAD>
37628 <TITLE>FEATURE: enable-jump-command</TITLE>
37629 </HEAD>
37630 <BODY>
37631 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
37632
37633 This Web Alpine option specifies whether or not a Jump command is
37634 offered in the Message List and Message View pages.  The command is
37635 implemented as an input field in the left column of the List and View
37636 screens.
37637
37638 <P>
37639 When enabled and a number is entered in the input field while the
37640 Message List is displayed, the Message List is reframed with the
37641 specified message.  While viewing a message, the message associated
37642 with the specified message number is displayed.
37643
37644 <P>
37645 <UL>
37646 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37647 </UL><P>
37648 &lt;End of help on this topic&gt;
37649 </BODY>
37650 </HTML>
37651 ====== h_config_enable_newmail_sound =====
37652 <HTML>
37653 <HEAD>
37654 <TITLE>FEATURE: enable-newmail-sound</TITLE>
37655 </HEAD>
37656 <BODY>
37657 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
37658
37659 This Web Alpine option specifies whether or not a sound file is sent
37660 to the web browser along with the newmail notification message.
37661
37662
37663 <P>
37664 <UL>
37665 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37666 </UL><P>
37667 &lt;End of help on this topic&gt;
37668 </BODY>
37669 </HTML>
37670 ====== h_config_render_html_internally =====
37671 <HTML>
37672 <HEAD>
37673 <TITLE>FEATURE: render-html-internally</TITLE>
37674 </HEAD>
37675 <BODY>
37676 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
37677
37678 By default, Web Alpine will pass cleansed HTML text you receive in messages
37679 to the browser for display (rendering).  This feature causes Web Alpine to convert
37680 the HTML text into plain text in the same way Unix and PC-Alpine do.
37681
37682
37683 <P>
37684 <UL>
37685 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37686 </UL><P>
37687 &lt;End of help on this topic&gt;
37688 </BODY>
37689 </HTML>
37690 ====== h_config_role_undo =====
37691 Yes, remember changes and exit back to list of roles; No, discard changes
37692 made in this screen; ^C, cancel exit and stay in this config screen.
37693 ====== h_exit_editor =====
37694 S, save changes and exit from the editor; D, do not save changes but
37695 do exit from the editor; or ^C, cancel exit and stay in the editor.
37696 ====== h_config_undo =====
37697 Yes, save changes and exit; No, exit without saving any changes made since
37698 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
37699 ====== h_os_index_whereis =====
37700 Enter ^V or ^Y to go immediately to the last or first message in the index.
37701 Or, enter the match string followed by RETURN.
37702 ====== h_os_index_whereis_agg =====
37703 Enter ^V or ^Y to go immediately to the last or first message in the index,
37704 Or, enter the match string followed by RETURN (or ^X to select all matches).
37705 =========== h_oe_add_full ==================
37706 Type the full name of the person being added and press the RETURN key.
37707 Press ^C to cancel addition.
37708 =========== h_oe_add_nick ==================
37709 Type a short nickname and press RETURN.  A nickname is a short easy-to-
37710 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
37711 ========== h_oe_add_addr ================
37712 Type the e-mail address and press RETURN.
37713 Press ^C to cancel addition.
37714 ========== h_oe_crlst_full ==============
37715 Type a long name or description for the list that you are creating and
37716 press RETURN.  Press ^C to cancel creation of list.
37717 =========== h_oe_crlst_nick =============
37718 Type a nickname (short, easy-to-remember name or single word) for the list
37719 you are creating and press RETURN.  Press ^C to cancel.
37720 ========== h_oe_crlst_addr ==============
37721 Type an e-mail address, or a nickname already in the address book that you
37722 want to be part of this list and press RETURN.
37723 ========== h_oe_adlst_addr =============
37724 Type an e-mail address or a nickname already in the address book that you
37725 want to add to this list and press RETURN.
37726 ========== h_oe_editab_nick ============
37727 Change the nickname using the arrow keys and delete key.  Press RETURN
37728 when done.  Press ^C to cancel editing and leave the nickname as it was.
37729 ========== h_oe_editab_full ============
37730 Change the full name using the arrow keys and delete key.  Press RETURN
37731 when done.  Press ^C to cancel editing and leave the full name as it was.
37732 ========== h_oe_editab_addr ============
37733 Change the address using the arrow keys and delete key.  Press RETURN
37734 when done.  Press ^C to cancel editing and leave the address as it was.
37735 ========== h_oe_editab_fcc ============
37736 Change the fcc using the arrow keys and delete key.  Press RETURN when
37737 done.  Press ^C to cancel editing and leave the fcc as it was.
37738 ========== h_oe_editab_comment ============
37739 Change the comment field using the arrow keys and delete key.  Press RETURN
37740 when done.  Press ^C to cancel editing and leave the comment as it was.
37741 ====== h_ab_forward =====
37742 Yes, expand nicknames and qualify local names with your current domain name;
37743 No, leave nicknames and local names as is;  ^C, cancel.
37744 ========== h_ab_export ==========
37745 Type the name of a file to write the addresses into and
37746 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
37747 ========== h_ab_edit_a_field ==========
37748 Edit any of the fields of the currently selected entry by typing one of the
37749 letters at the bottom of the screen.  Press ^C to cancel edit.
37750 ====== h_ab_del_data_revert =====
37751 Press B to completely delete addrbook and revert to default, C to delete config
37752 and revert while leaving data, or D to only delete data (make it empty).
37753 ====== h_ab_del_data_modify =====
37754 Press B to completely delete addrbook, C to delete configuration while leaving
37755 data, or D to delete data (make it empty) but leave config. ^C to cancel.
37756 ====== h_ab_del_config_modify =====
37757 Yes, remove this address book from my configuration.
37758 No, make no changes now.
37759 ====== h_ab_del_config_revert =====
37760 Yes, remove this address book from my config and revert to default.
37761 No, make no changes now.
37762 ====== h_ab_del_default =====
37763 Yes, remove this default address book from my configuration.
37764 No, make no changes now.
37765 ====== h_ab_really_delete =====
37766 Yes, delete the actual contents of the address book, not just the
37767 configuration.  No, don't delete the data after all, cancel and start over.
37768 ====== h_ab_del_ignore =====
37769 Press I to ignore all the default address books for this category.  Press R to
37770 remove this one address book and add the others to your personal list.
37771 ====== h_ab_del_dir_ignore =====
37772 Press I to ignore all the default directory servers for this category.
37773 Press R to remove this one server and add the others to your personal list.
37774 ====== h_ab_copy_dups =====
37775 Yes, overwrite the existing entry.
37776 No, skip duplicates but save the rest. Press ^C to cancel.
37777 ====== h_confirm_cancel =====
37778 Type C to Confirm that you want to abandon the message you are composing.
37779 Type N or ^C to cancel out of the cancel and keep composing.
37780 ====== h_ab_text_or_vcard =====
37781 Text, start composer with displayed text already included.
37782 VCard, start composer with address book entry attached as a vCard. ^C cancels.
37783 ====== h_ab_backup_or_ldap =====
37784 Backup, copy email address from entry and allow editing of it.
37785 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
37786 ====== h_ldap_text_or_vcard =====
37787 Text: export displayed text for selected entry. Address: export only the
37788 email address. VCard: export entry in vCard format. ^C cancels.
37789 ====== h_ab_save_exp =====
37790 Save, save entry or entries to an address book.
37791 Export, save to file outside of pine. ^C cancels save.
37792 ====== h_ab_add =====
37793 A, add a brand new entry to this address book.
37794 E, edit the entry that is currently highlighted. ^C to cancel.
37795 ====== h_ab_shuf =====
37796 U, swap order of highlighted address book and the one above it.
37797 D, swap order of highlighted address book and the one below it. ^C to cancel.
37798 ====== h_ab_shuf_up =====
37799 U, swap order of highlighted address book and the one above it.
37800 Press ^C to cancel.
37801 ====== h_ab_shuf_down =====
37802 D, swap order of highlighted address book and the one below it.
37803 Press ^C to cancel.
37804 ====== h_folder_prop =====
37805 Count is # of messages in the folder, Unseen means messages that have not
37806 been read, New means messages that were Recently added to the folder.
37807 ====== h_role_shuf =====
37808 U, swap order of highlighted rule and the one above it.
37809 D, swap order of highlighted rule and the one below it. ^C to cancel.
37810 ====== h_role_shuf_up =====
37811 U, swap order of highlighted rule and the one above it.
37812 Press ^C to cancel.
37813 ====== h_role_shuf_down =====
37814 D, swap order of highlighted rule and the one below it.
37815 Press ^C to cancel.
37816 ====== h_incoming_shuf =====
37817 B, swap order of highlighted directory and the one before it.
37818 F, swap order of highlighted directory and the one after it. ^C to cancel.
37819 ====== h_incoming_shuf_up =====
37820 B, swap order of highlighted directory and the one before it.
37821 Press ^C to cancel.
37822 ====== h_incoming_shuf_down =====
37823 F, swap order of highlighted directory and the one after it.
37824 Press ^C to cancel.
37825 ====== h_dir_shuf =====
37826 U, swap order of highlighted directory and the one above it.
37827 D, swap order of highlighted directory and the one below it. ^C to cancel.
37828 ====== h_dir_shuf_up =====
37829 U, swap order of highlighted directory and the one above it.
37830 Press ^C to cancel.
37831 ====== h_dir_shuf_down =====
37832 D, swap order of highlighted directory and the one below it.
37833 Press ^C to cancel.
37834 ====== h_hdrcolor_shuf =====
37835 U, swap order of highlighted Header Color and the one above it.
37836 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
37837 ====== h_hdrcolor_shuf_up =====
37838 U, swap order of highlighted Header Color and the one above it.
37839 Press ^C to cancel.
37840 ====== h_hdrcolor_shuf_down =====
37841 D, swap order of highlighted Header Color and the one below it.
37842 Press ^C to cancel.
37843 ========== h_oe_editab_al ============
37844 Change the address using the arrow keys and delete key.  Press RETURN
37845 when done.  Press ^C to cancel editing and leave the address as it was.
37846 ========== h_dir_comp_search ===============
37847 Type a string to look for just like you would in the composer. Your configured
37848 rules for the servers with the implicit flag set will be used.
37849 ========== h_oe_searchab ===============
37850 Type the word or name you want to search for and press RETURN.  If you press
37851 RETURN without entering anything the word in [] will be searched for.
37852 ========== h_oe_chooseabook ==========
37853 Choose the address book you want to save the new entry in.
37854 Use ^N or ^P to change address books.  ^C to cancel.
37855 ========== h_oe_takeaddr ==========
37856 Edit the e-mail address using the arrow and delete keys.  Press RETURN
37857 when done.  Press ^C to cancel adding this entry to the address book.
37858 ========== h_oe_take_replace ==========
37859 Press R to replace the old entry with this new data.  You will still have
37860 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
37861 ========== h_oe_take_replace_or_add ==========
37862 Press R to replace the old entry.  Press A to add the selected addresses to
37863 the old existing list.  N to enter another nickname. ^C to cancel now.
37864 ========== h_oe_takename ==========
37865 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
37866 when done.  Press ^C to cancel adding this entry to the address book.
37867 ========== h_oe_takenick ==========
37868 Type a nickname (short easy-to-remember name, initials or single word) for this
37869 entry in the address book and press RETURN.  Press ^C to cancel addition.
37870 ========== h_oe_jump ==========
37871 Type the message number you want to jump to and press RETURN.  The word "end"
37872 represents the last message. Press ^C to cancel jumping to another message.
37873 ========== h_oe_jump_thd ==========
37874 Type the thread number you want to jump to and press RETURN.  The word "end"
37875 represents the last thread. Press ^C to cancel jumping to another thread.
37876 ========== h_oe_debuglevel ==========
37877 Higher number shows more debugging details.
37878 Press ^C if you want to cancel the change.
37879 ========== h_oe_broach ==========
37880 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
37881 to go to the previous/next collections in the list.  Press ^C to cancel goto.
37882 ========== h_oe_foldsearch ==========
37883 Type the text you want to search for in foldernames and press RETURN.  If you
37884 press RETURN without entering anything, any text in [] will be searched for.
37885 ========== h_oe_foldrename ==========
37886 Change the old name of the folder to the new name using the arrow and
37887 delete keys and press RETURN.  Press ^C to cancel rename.
37888 ========== h_oe_login ==========
37889 Enter your login name for the host you are opening the mailbox on.  Just press
37890 RETURN to use your login from this host as is, or edit it with delete key.
37891 ========== h_oe_passwd ==========
37892 Type your password for the host and login shown as part of the prompt.
37893 Press ^C to cancel opening folder.
37894 ========== h_oe_choosep ==========
37895 Enter the number associated with the printer you want to select.  Press ^C to
37896 cancel the printer selection.  The current selection is highlighted.
37897 ========== h_oe_customp ==========
37898 Type the name of the Unix print command and press RETURN.  Press ^C to
37899 cancel the printer selection.
37900 ========== h_oe_searchview ==========
37901 Type the word or name you want to search for and press RETURN.  If you press
37902 RETURN without entering anything the word in [] will be searched for.
37903 ========== h_oe_keylock ==========
37904 The keyboard is in use and locked by another user.  Only that user can
37905 unlock this keyboard by typing the password.
37906 ========== h_wt_expire ==========
37907 At the beginning of each month Alpine offers to rename your current sent-mail
37908 folder to one named for the month so you have a sent-mail folder for each month
37909 ========== h_wt_delete_old ==========
37910 It is the beginning of the month, and we need to conserve disk
37911 space.  Please delete any sent-mail that you do not need.
37912 ========== h_select_sort ==========
37913 Select the order for sorting the index by typing the capitalized letter.
37914 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
37915 ========== h_no_F_arg ============
37916 Enter name of file to be opened.
37917
37918 ========== h_sticky_personal_name ==========
37919 Type in your name as you want it to appear on outgoing email.  This entry
37920 will be saved into your Alpine configuration file.
37921 ========== h_sticky_inbox ============
37922 INBOX syntax is usually {complete.machine.name}INBOX
37923 This entry will be saved in your Alpine configuration file.
37924 ========== h_sticky_smtp ============
37925 The name of the computer on your campus that relays your outgoing email
37926 to the Internet.  This entry will be saved in your Alpine configuration file.
37927 ========== h_sticky_user_id ==========
37928 The username or login-id part of your email address.  This entry will be
37929 saved in your Alpine configuration file.
37930 ========== h_sticky_domain ==========
37931 The domain part of your email address, NOT the name of your PC.  This
37932 entry will be saved in your Alpine configuration file.
37933 ========== h_bounce =========
37934 Enter the address or nickname of the intended recipient.  Alpine will resend
37935 the message, which will retain the original author's From: address.
37936 ========== h_incoming_add_folder_nickname =========
37937 Enter an (optional) nickname that will be used in lieu of the actual
37938 host and folder names in the FOLDER LIST display.
37939 ========== h_anon_forward ==========
37940 Enter the address of your intended recipient, or ^C to cancel.
37941 Example: jsmith@somewhere.edu
37942 ========== h_news_subscribe ==========
37943 Enter the name of the newsgroup to which you wish to subscribe,
37944 or ^C to cancel.  Example: comp.mail.pine
37945 ========== h_pipe_msg ==========
37946 Enter the name of the Unix command to which you wish to send this
37947 message, or ^C to cancel.
37948 ========== h_pipe_attach ==========
37949 Enter the name of the Unix command to which you wish to send this
37950 attachment, or ^C to cancel.
37951 ========== h_select_by_num ==========
37952 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
37953 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
37954 ========== h_select_by_gm_content ==========
37955 Enter your search key in the same way that you would enter a search
37956 key in the web interface for Gmail.
37957 ========== h_select_by_thrdnum ==========
37958 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
37959 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
37960 ========== h_select_txt_from ==========
37961 Messages with From: headers containing the entered string will be selected.
37962 ^C to cancel. ^G again to see original options.
37963 ========== h_select_txt_not_from ==========
37964 Messages without From: headers containing the entered string will be selected.
37965 ^C to cancel. ^G again to see original options.
37966 ========== h_select_txt_to ==========
37967 Messages with To: headers containing the entered string will be selected.
37968 ^C to cancel. ^G again to see original options.
37969 ========== h_select_txt_not_to ==========
37970 Messages without To: headers containing the entered string will be selected.
37971 ^C to cancel. ^G again to see original options.
37972 ========== h_select_txt_cc ==========
37973 Messages with Cc: headers containing the entered string will be selected.
37974 ^C to cancel. ^G again to see original options.
37975 ========== h_select_txt_not_cc ==========
37976 Messages without Cc: headers containing the entered string will be selected.
37977 ^C to cancel. ^G again to see original options.
37978 ========== h_select_txt_subj ==========
37979 Messages with Subject: headers containing the entered string will be selected.
37980 ^C to cancel.  ^X enters Subject: line of current message.
37981 ========== h_select_txt_not_subj ==========
37982 Messages without Subject headers containing the entered string will be selected.
37983 ^C to cancel.  ^X enters Subject: line of current message.
37984 ========== h_select_txt_all ==========
37985 All messages containing the entered string will be selected.  Headers and body,
37986 but not encoded attachments, will be compared.  Enter ^C to cancel.
37987 ========== h_select_txt_not_all ==========
37988 All messages that don't contain the entered string will be selected.  Headers
37989 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
37990 ========== h_select_txt_body ==========
37991 All messages containing the entered string will be selected. Body text, but
37992 not headers or encoded attachments, will be compared. ^C to cancel.
37993 ========== h_select_txt_not_body ==========
37994 All messages that don't contain the entered string will be selected. Body
37995 text, but not headers or encoded attachments, will be compared. ^C to cancel.
37996 ========== h_select_txt_recip ==========
37997 Messages with Cc: or To: headers containing the entered string will be selected.
37998 ^C to cancel. ^G again to see original options.
37999 ========== h_select_txt_not_recip ==========
38000 Messages without Cc: or To: headers containing the string will be selected.
38001 ^C to cancel. ^G again to see original options.
38002 ========== h_select_txt_partic ==========
38003 Messages with Cc, To, or From headers containing the string will be selected.
38004 ^C to cancel. ^G again to see original options.
38005 ========== h_select_txt_not_partic ==========
38006 Messages without Cc, To, or From headers containing the string will be selected.
38007 ^C to cancel. ^G again to see original options.
38008 ========== h_select_date ==========
38009 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
38010 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
38011 ========== h_attach_index_whereis ==========
38012 Enter some text that appears in the Attachment Index entry for the desired
38013 attachment.  The first attachment containing that text will be highlighted.
38014 ========== h_kb_lock ==========
38015 Keystrokes entered here (up to a RETURN) comprise a password that must
38016 be entered again later in order to unlock the keyboard.
38017 ========== h_compose_default ==========
38018 N, compose a new message. R, set a role.
38019 ^C to cancel.
38020 ========== h_untranslatable ==========
38021 Send using UTF-8 character set; Send but replace untranslatable characters
38022 with question marks; return to the composer; or cancel message altogether.
38023 ========== h_compose_intrptd ==========
38024 N, compose a new msg. I, continue interrupted msg. R, set a role.
38025 ^C to cancel.
38026 ========== h_compose_postponed ==========
38027 N, compose a new message. P, continue postponed msg. R, set a role.
38028 ^C to cancel.
38029 ========== h_compose_intrptd_postponed ==========
38030 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
38031 R, set a role. ^C to cancel.
38032 ========== h_compose_form ==========
38033 N, compose a new message. F, use form letter. R, set a role.
38034 ^C to cancel.
38035 ========== h_compose_intrptd_form ==========
38036 N, compose a new msg. I, continue interrupted msg. F, use form letter.
38037 R, set a role. ^C to cancel.
38038 ========== h_compose_postponed_form ==========
38039 N, compose a new message. P, continue postponed msg. F, use form letter.
38040 R, set a role. ^C to cancel.
38041 ========== h_compose_intrptd_postponed_form ==========
38042 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
38043 F, use form letter. R, set a role. ^C to cancel.
38044 ========== h_config_context_del_except ==========
38045 If you delete the last exceptional collection you can only add it back by
38046 manually editing the exceptions config file.
38047 ========== h_config_whereis ==========
38048 To move quickly to a particular line, enter a search string or
38049 ^C to cancel.
38050 ========== h_config_edit_scorei ==========
38051 Enter interval in the form (min,max). -INF and INF may be used to represent
38052 -infinity and infinity. ^C to cancel change. RETURN to accept change.
38053 ========== h_config_add ==========
38054 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
38055 pressing RETURN sets the Empty Value (this turns off any global default).
38056 ========== h_config_add_custom_color ==========
38057 Enter a header fieldname. For example, "subject" or "from".
38058
38059 ========== h_config_add_pat_hdr ==========
38060 Enter a header fieldname. For example, "reply-to" or "organization" or
38061 any fieldname you want that isn't included already.
38062 ========== h_config_print_opt_choice ==========
38063 You may edit either the initialization string (characters printed before
38064 printing starts) or the trailer string.  Choose one or ^C to cancel.
38065 ========== h_config_print_init ==========
38066 Enter a C-style string for this.  You may use common backslash escapes like
38067 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
38068 ========== h_config_change ==========
38069 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
38070 delete current (highlighted) character, etc.  Enter ^C to cancel change.
38071 ========== h_config_replace_add ==========
38072 Replace ignores the current default, Add places the current default in your
38073 editing buffer as if you had typed it in.
38074 ========== h_config_insert_after ==========
38075 Enter a nickname for this print command.  (InsertBefore puts the new item
38076 before the current line, InsertAfter puts it after the current line.)
38077 ========== h_config_print_cmd ==========
38078 Enter command to be executed for the printer.  Use normal editing keys
38079 to modify, ^C to cancel, carriage return to accept current value.
38080 ========== h_config_role_del ==========
38081 Answering Yes will remove this rule completely from your rules list.
38082 ========== h_config_role_addfile ==========
38083 Type the name of a file to add to your configuration. You don't need to
38084 use a file, you may add rules directly (with Add) without using a file.
38085 ========== h_config_role_delfile ==========
38086 Answering Yes will remove this rule file completely from your rules list.
38087 The rules data file itself will not be removed.
38088 ========== h_config_print_del ==========
38089 Answering Yes will remove this printer completely from your printer list.
38090 ========== h_config_print_name_cmd ==========
38091 You may edit the Nickname of this printer, the Command to be executed when
38092 printing, or change the Options associated with this printer.
38093 ========== h_send_check_fcc ==========
38094 Yes, send message without an Fcc.
38095 No, return to composer.
38096 ========== h_send_check_subj ==========
38097 Yes, send message without a Subject.
38098 No, return to composer.
38099 ========== h_send_check_to_cc ==========
38100 Yes, send message without a To address, or a Cc address, or a Newsgroup.
38101 No, return to composer.
38102 ========== h_send_fcc_only ==========
38103 Yes, copy message to Fcc only and send to NO recipients.
38104 No, return to composer.
38105 ========== h_send_prompt ==========
38106 Yes, send the message.
38107 No or ^C, return to composer.
38108 ========== h_send_prompt_flowed ==========
38109 Yes, send the message.  No or ^C, return to composer.
38110 What's Flowed? See Do Not Send Flowed Text in config screen.
38111 ========== h_send_prompt_dsn ==========
38112 Yes, send the message.  No or ^C, return to composer.
38113 What's DSNOpts? See Enable Delivery Status Notification in config screen.
38114 ========== h_send_prompt_dsn_flowed ==========
38115 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
38116 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
38117 ========== h_role_confirm ==========
38118 Yes, use displayed role. No, compose without a role.
38119 ^C, cancel the message. ^T, select a role from your other eligible roles.
38120 ========== h_norole_confirm ==========
38121 Return, compose without a role.
38122 ^C, cancel the message. ^T, select a role from your eligible roles.
38123 ========== h_custom_print ==========
38124 Enter a Unix command that accepts its data on standard input.
38125 Alpine will display any information the command sends to standard output.
38126 ========== h_convert_abooks_and_sigs ==========
38127 You will be given the opportunity to convert address books and signature files
38128 to remote configurations.
38129 ========== h_convert_abooks ==========
38130 You will be given the opportunity to convert address books to remote
38131 configurations.
38132 ========== h_flag_keyword ==========
38133 Enter the name of the keyword you want to add for this folder.
38134 No spaces, parentheses, braces, percents or asterisks are allowed.
38135 ========== h_select_keyword ==========
38136 Enter the keyword you want to match, or use ^T to select a keyword from a list
38137 of possible keywords for this folder. Use ! to look for non-matches instead.
38138 ========== h_type_keyword ==========
38139 Enter the keyword you want to add. You may add a nickname in the next step.
38140 No spaces, parentheses, braces, percents or asterisks are allowed.
38141 ========== h_type_keyword_nickname ==========
38142 Enter an optional nickname for the keyword you want to add.
38143 Type Carriage return to use the keyword name instead of a nickname.
38144 ========== h_convert_sigs ==========
38145 You will be given the opportunity to convert signature files to remote
38146 configurations.
38147 ========== h_convert_abook ==========
38148 Yes is fairly safe. You will be ADDing a remote address book that is a copy
38149 of the current address book. The current abook won't be removed automatically.
38150 ========== h_convert_sig ==========
38151 Answering Yes copies the contents of the signature file into your Alpine
38152 configuration file. After that, the contents of the file will not be used.
38153 ========== h_save_addman ==========
38154 Enter the simple name of the folder you want to add. Carriage return to
38155 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
38156 ========== h_reopen_folder ==========
38157 Yes reopens the folder, as if you were starting over. This uncovers new mail.
38158 No leaves the folder index as it was without discovering new mail.
38159 ========== h_convert_pinerc_server ==========
38160 This is the name of the host (computer) where the remote Alpine configuration
38161 will be stored. This should be an IMAP server that you have permission to use.
38162 ========== h_convert_pinerc_folder ==========
38163 Enter the correct remote folder name. This folder is special and should
38164 contain only configuration data. It shouldn't contain other mail messages.
38165 ========== h_role_compose ==========
38166 Compose a New message, Reply to current message, Forward current message, or
38167 Bounce message. Then you will be asked to choose one of your Roles to be used.
38168 ========== h_role_aggregate ==========
38169 Compose a reply, or forward, or bounce the selected messages. Then you
38170 will be asked to choose one of your Roles to be used for this operation.
38171 ========== h_save_size_changed ==========
38172 The reported size of a message is not the same as the actual size. Answer Yes
38173 to continue and hope for the best or No to Cancel the entire Save.
38174 ========== h_select_by_larger_size ==========
38175 Enter a number or ^C to cancel. All messages greater than this many characters
38176 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
38177 ========== h_select_by_smaller_size ==========
38178 Enter a number or ^C to cancel. All messages less than this many characters
38179 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
38180 ========== h_preserve_field ==========
38181 Use 'p' to toggle between preserving or not preserving the original To:
38182 and Cc: fields of the message. Enter ^C to cancel message.
38183 ========== h_privacy_policy ==========
38184 x-alpine-http:http://alpine.x10host.com/privacy.html
38185 ========== h_apache_license ==========
38186 x-alpine-http:http://alpine.x10host.com/legal/apache_license.html
38187