#@(#)$Id: elmrc-info,v 2.92 2024/06/10 18:05:34 hurtta Exp $
# Elm Version ME+ 2.5
#
#$HDR - magic line to mark comments to put at top of user's elmrc file.
#
# For yes/no settings, ON means yes, OFF means no.
#
# Lines beginning with "#" (like this one!) are comments.
#
#
# Some of the option settings are commented out with "###".  This means
# that you do NOT have a value set for the option, and the system default
# will be used.  (The value shown is the default at the time this file
# was created.)  If you wish to enable one of these options, you MUST
# delete the "###" to de-comment the entry.
#
# For the yes/no settings, say ON for yes and OFF for no.

$user
#
# --- Table of Contents ---
#
#       1. General Program Configuration Options
#       2. Main Message Selection Screen Options
#       3. Message Display/Pager Options
#       4. Editor Options
#       5. Message Composition Options
#       6. Signature Options
#       7. Program Termination/Folder Cleanup Options
#       8. Folder Handling Options
#       9. MIME and Character Set Options
#      10. Metamail and mailcap options
#      11. IMAP and POP options
#      12. PGP and GPG options
#

$section
#-----------------------------------------------------------------------
#
# Section 1:  General Program Configuration Options
#

address-lookup
# This option specifies how translation from IP-address to hostname
# is done.
#
# Possible values: 
#
#	  	   normal		Use normal address -lookup API
#		   			(that is gethostbyaddr()).
#		   gethostbyaddr	Use gethostbyaddr()
#		   getnameinfo		Use getnameinfo()
#
# Note that getnameinfo() can return only one name for IP-address.
#
# See also: mail-services-lookup

alias-group-phrase
# if this variable is ON, it is possible to give phrase
# for group aliases, which is included to address list

aliassortby
# How to sort the alias list, "Name" by default
# Possible values: alias, reverse-alias
#                  name, reverse-name
#                  text, reverse-text

alternatives
# alternative addresses that I could receive mail from (usually a
# forwarding mailbox) and don't want to have listed...
#
# Only ASCII characters are allowed on addresses.
#
# See also: showto, mailname (on global elm.rc)

browser-tabcomplete-prompt
# if this variable is ON, TABulator on folder and file browser completes
# filename on prompt against current listing of file or folder browser
#
# If
#   - filename prefix does not match current directory of folder or
#     file browser, or
#   - filename matches without completion to some entry on folder or
#     file browser, or
#   - this variable is OFF
# TABulator changes current directory of folder and file browser.

browser-wildcard-matching
# If '*' or '?' are used on filename prompts, should these interpret
# as wildcards?   
#
# Possible values:
#
#    off                Disables wildcard feature and therefore 
#                       allows selecting filenames that include '?' 
#                       or '*' characters.
#    on                 Enables wildcard feature. Characters '*' 
#                       and '?' are treated as wildcards. Pressing 
#                       ENTER gives directory listing limited with 
#                       that wildcard specification on Elm ME+ style 
#                       file and folder browser.
#    file browser       Enables wildcard feature. Characters '*' 
#                       and '?' are treated as wildcards. Pressing
#                       ENTER invokes Elm 2.5 style file browser
#                       with files (not directories) limited with 
#                       that wildcard specification.
#
#   With values "on" or "file browser" pressing TAB gives directory 
#   listing limited with that wildcard specification on Elm ME+ style 
#   file and folder browser.

calendar
# Pathname to the saved calendar entries file.

conf-merge-locking
# Tells what locking use with configuraton merge
#
# Original file is exclusively (read-write) locked, when new file is written
# and changes from original file is merged to new file. When lock is
# acquired, writer check that is orignal file changed (replaced with new file),
# if it is then file reopend and locked again before is its readed for merge.
#
# Also readers may lock file with shared (lock) and check that is file changed
# after lock is acquired, but that not strictly necessary because new file is
# atomically renamed to originla name after it is rewritten.
#
# Exclusive locking is needed fof merging of changes to new file, because that
# is not atomic operarion.
#
# Currently that is used for .elm/elmaliases
#
# Other config files not support merging (and only .elm/elmrc is another config
# file which can be modified from Elm ME+'s menus).
#
# This option includes list of keywords:
#       flock                  Use flock() locking. 
#                              flock() does not lock files over NFS
#       fcntl                  Use fcntl() locking. 
#
# If value is "none", then locking is disabled.
#
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc) 
#      are listed:
#               +flock          -flock
#               +fcntl          -fcntl
#
#  See also: mailhome-locking, mailbox-locking, folder-locking

configoptions
# list of options that can be configured at the "o)ptions" screen

connect-mode
# This option enables parallel connect(), where next connect attempt is tried
# before previous is not completed (or failed). If this option is set to
# "parallel", Elm ME+ uses non-blocking connect() and tries next connect()
# attempt after given "delay" seconds or milliseconds if previous connect was
# not completed. This also requires that getsockopt(...,SOL_SOCKET,SO_ERROR,...,...)
# is available.     
#
# Possible values:
#
#     parallel                  Use parallel connect (with non-blocking connect())    
#     blocking                  Make connect attemps sequentially
#     non-blocking              Make connect attemps sequentially with
#                               non-blocking connect()
#
#  After that parameter there can be following additional options:
#     delay=                    Gives delay (in seconds or milliseconds) before
#                               next connect() attempt is tried if previous
#                               attempt is in progress.
#     address-delay=            Gives delay (in seconds or milliseconds) before
#                               next address for connect() attempt is tried if
#                               previous attempt is in progress.
#     port-delay=               Gives delay (in seconds or milliseconds) before
#                               next port for connect() attempt is tried if
#                               previous attempt is in progress.
#     display-time=             Gives time (in seconds or millisecond) how long
#                               "Connecting ... [...], port ..." message is shown.
#                               After this number of connection attemps in
#                               in progress is shown on "Connecting ..." message.
#                               This time gives lower limit for "delay" before
#                               next connect() attempt is tried.
#     concurrency-limit=        Gives maximum number concurrent  connect() attempts
#                               in progress.
#
# These options have no effect when "connect-mode" is "blocking". They are usefull only
# when "connect-mode" is "parallel".
#
# Option "delay" sets both "address-delay" and "port-delay".

convert-comment-to-fullname
# Elm 2.4ME+ PL55 or Elm ME+ 2.5 parses addresses like:
#    fullname <address>
#    fullname <address> (comment)
#    address (comment)
# When convert-comment-to-fullname is set, addresses are parsed like
#    address (fullname)
# instead. That convert-comment-to-fullname is set by default for
# compatibility of older versions of Elm.

ipv6-scope-id
# This option tells how textual (non-numeric) scope id's (part after %
# character) on numerical IPv6 addresses are interpreted
# 
# This option includes list of keywords:
#      auto                    sets link-local-if-index flag
#                              if numeric scope id's of link
#                              local addresses matches to interface
#                              index on where address is located
#      link-local-if-index     use interface index as scope id
#                              for link local IPv6 addresses and
#                              print scope id on textual form
# 
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc
#      on user's elmrc) are listed:
#                +auto                  -auto
#                +link-local-if-index   -link-local-if-index
#
# If auto -flag is active after global elm.rc, that 
# IPv6 addresses check is done before user's elmrc is read
#
# See also: mail-services-lookup

editor-elmrc-propline
# Specifies what editor property line is written to user's elmrc file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of elmrc file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
# See also: editor-ms-propline

editor-ml-propline
# Specifies what editor property line is written to user's 
# elm.mailinglists file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of elm.mailinglists file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# See also: editor-elmrc-propline

editor-ms-propline
# Specifies what editor property line is written to user's mail.services file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of mail.services file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# See also: editor-elmrc-propline

editor-tfent-propline
# Specifies what editor property line is written to user's tagfilter.entities file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of mail.services file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# See also: editor-elmrc-propline

name-lookup-cancel
# This option enables cancelable dns lookups. This may require
# that resolv -module is enabled.  Used for "mail-services-lookup"
# and "verify-domain".
#
# Possible values:
#
#                disabled       hostname / mail domain name
#                                 lookups are not interruptible.
#                enabled        hostname / mail domain name
#                                 lookups are assumed to be
#                                 interruptible (but that is
#                                 not likely not work with
#                                 gethostbyname(),  getaddrinfo(),
#                                 res_query() and res_search()).
#                auto           hostname / mail domain names
#                                 lookup result waiting is
#                                 interuptible when  res_send()
#                                 helper process is used.
#
# Value "auto" is default. This may case that this is disabled (unless
# "mail-services-lookup" is modified to use resolv -module).
#
# Also boolean ON, OFF, TRUE, FALSE, YES and NO values are allowed.
#
# See also: mail-services-lookup, verify-domain

print
# Command to print a message ('%s' is the filename)

printhdrs
# List of headers to select and weed when printing messages.
#
# NOTE: This is used with p)rint -command
#       and not with P)rint text command

readmsginc
# When initially reading in a mail folder, the status display is updated
# whenever this many more messages are processed.  A large number helps
# avoid lots of output on slow terminal connections.
# See also: readdatapercentinc

readdatapercentinc
# Value by which percent count is incremented while reading a new mailbox.
# Actual increments depends both of "readdatapercentinc" and "readmsginc".
# See also: readmsginc

readmsg
# path to readmsg program

set-window-title
# Enables automatic updating of window's tile and icon name when
# folder is changed. File ~/.elm/terminal.info or global elm.terminalinfo 
# must specify changing method used for given terminal.

shell
# The shell to use for shell escapes. If not set value from passwd is used.

showto
# if this variable is ON, Elm will show who the message is to rather than
# who it is from in the headers display if the message is not
# addressed to user.
#
# See also: alternatives

sleepmsg
# After displaying a transient message, Elm will pause this many seconds
# before erasing it.  Can be 0 or a positive integer.

special-use-domains-blacklist
# List of domains which are not accepted on mail addresses or as server
# names.
#
# See also RFC 6761: Special-Use Domain Names
#
# List only these domain names which application software should recognize
# as special.
#
# If domain name is given as ".domain" then it blacklists names under that 
# domain. If name is given as "domain" then also "domain" itself (and names 
# under it) are blacklisted. 
#
# These names are not looked up with name resolution APIs. However
# these are (still) read directly from /etc/hosts
#
# See also: static-hosts-max-names, name-lookup-cache-time,
#           special-use-domains-lookup

special-use-domains-lookup
# Indicates direct use of  /etc/hosts file
#
# Possible values:
#
#               none           Nothing specified
#
#               static-hosts   Names given on special-use-domains-blacklist
#                              are looked from /etc/hosts
#
# See also: static-hosts-max-names, special-use-domains-blacklist

static-hosts-max-names
# Max threshold for /etc/hosts caching 
#
# See also mail-services-lookup, name-lookup-cache-time,
#          special-use-domains-blacklist, special-use-domains-lookup

timeout
# After this many seconds of inactivity, Elm will re-check the mailbox
# for new messages.

tmpdir
# Directory to use for temporary files. 
#
# See also: local-sessionlock-dir

use-tls
# RFC 8314: Use of TLS for Email Submission/Access
#
# This option includes list of keywords:
#              none            None of values are selected
#	       implicit-tls    Use "Implicit TLS" (separate tcp port)
#	       		       for imap, pop, submission which is tried
#			       first before imap, pop, submission
#			       (and STARTTLS after that) is tried
#                              (see note 1)
#	       starttls	       libbelmme-tls module uses STARTTLS
#	       		       (IMAP, SMTP) or STLS (POP) if command
#			       is available. This is default.
#	      verify-tls-certificate	     connection must use tls
#					     and server certificate
#					     must have valid (see note [5,6])  
#	      require-tls-peer-name	     connection must use tls
#					     and certificates's CN must
#					     match (see note [3,4,6]).
#	      display-check-host	     display X509_check_host()
#	      				     matching when login (see note [7])
#
#
#          The  "use-tls"  elm.rc option accepts two forms:             
#            - Absolute form where used options are listed
#            - Additive form where changes from compile
#               time default are listed:
# 	       +implicit-tls	-implicit-tls
#	       +starttls	-starttls   (see note [2])
#	       +verify-tls-certificate
#	       -verify-tls-certificate
#	       +require-tls-peer-name
#	       -require-tls-peer-name
#        These two forms can not be mixed.
#
# This option requires
#         use-connect-library = tls
#
# Note 1: 'implicit-tls' is default if
#         	use-config-library = tls
#  	  is used.
#
# Note 2: Specifying tls:starttls-version on ~/.elm/mail.services or on
#         global elm.mailservices overrides starttls disable given on use-tls setting.
#
# Note 3: Specifying require-tls-peer-name={name} on  ~/.elm/mail.services or on global
#         elm.mailservices can used to make 'require-tls-peer-name' on use-tls accept
#         also other certificate's CN than given hostname.
#
# Note 4: 'require-tls-peer-name' checks certificate's CN when correct name is usually
#         certificate's 'Subject Alternative Name' (SAN). 'require-tls-peer-name' checks
#	  check DSN:name from 'Subject Alternative Name' (SAN) if openssl provides
#	  X509_check_host() and name is not IP-address. Therefore it is usually not
#         good idea to use 'require-tls-peer-name' on use-tls setting if OpenSSL
#	  is older than 1.0.2 where  X509_check_host() is not availabe.
#	  'require-tls-peer-name' do not use  X509_check_ip() to check IP address
#	  from IP:name of 'Subject Alternative Name' (SAN).
#
# Note 5: Specifying verify-tls-certificate=off on  ~/.elm/mail.services or on global
#         elm.mailservices overrides verify-tls-certificate given on use-tls setting.
#
# Note 6: Specifying use-tls-checks=no on ~/.elm/mail.services or on global
#         elm.mailservices overrides 'verify-tls-certificate' and 'require-tls-peer-name'
#         given on use-tls setting.
#
# Note 7: 'display-check-host' is default if
#         	use-config-library = tls
#  	  is used and openssl provides X509_check_host(). That 'display-check-host'
#         checks hostname against DSN:name from 'Subject Alternative Name' (SAN)
#	  and prints "host matches" if X509_check_ip() succeed and hostname is not
#	  ip address.

user-conf-rewrite
# Allows automatic resorting aand rewriting of some
# user configuration files on elm's startup
#
# Currently ~/.elm/elmaliases is rewritten.

userlevel
# Are we good at it?  0=beginner, 1=intermediate, 2 and above=expert.
# Lower levels give more verbose prompts.  Higher levels make advanced
# options available.

usetite
# Would you like to use termcap/terminfo ti/te (screen switch) entries?

valid-domains
# List of mail domains (that is everything after '@' on mail address) 
# are considered valid without verifying domain on mail address.
#
# This also overrides special-use-domains-blacklist
#
# If domain name is given as ".domain" then it marks valid all mail domains 
# on addresses {anyting}@{anything}.domain
#
# If domain name is given as "domain" then it marks valid only mail domains
# on addresses {anyting}@domain
#
# See: verify-domain,  special-use-domains-blacklist, valid-msg-id-domains

verify-domain
# If set, mail domains (that is everything after '@' on mail address) 
# are verified
#
# Possible values:
#
#    no                Mail domains are not verified
#    yes               Mail domains are verified
#    hostname          Mail domains are verified by gethostbyname(). 
#                      Error HOST_NOT_FOUND is treated as non-existing 
#                      domain and error  NO_DATA is treated as valid 
#                      mail domain.
#    shared            Mail domains are verified by shared library 
#                      if available.
#
# With elmrc option 
#          use-mailer-library = resolv 
# possible values includes:
#
#    resolv:mx-address   Mail domains are verified with DNS lookup
#                        for MX and address records
#    resolv:mx           Mail domains are verified with DNS lookup
#                        for MX record.
#    resolv:any          Mail domains are verified with DNS lookup
#                        for any record.
#
# See also: valid-domains, special-use-domains-blacklist,
#           mail-services-lookup, name-lookup-cancel,
#           verify-local-domain, verify-alias-domain

verify-local-address
# If set usernames of local addresses are verified. Using this option
# requires that on global elm.rc have "verify=yes" on mailer -option.
#
# See also: verify-local-domain

verify-alias-domain
# If set (default),  "verify-domain" applies also mail domain
# of alias expanded address.
#
# See also: verify-domain, verify-local-domain

verify-local-domain
# Should "verify-domain" applies also mail domain given on
# "mailname" or "hostfullname" ?
#
#
# Possible values:
#
#    no               Do not verify mail domain given on "mailname" or
#		      "hostfullname" when sending mail.
#    yes              Use "verify-domain" setting for mail domain given
#    		      on "mailname" or "hostfullname" when sending mail.
#    if-remote-mailer Use "verify-domain" setting for mail domain given
#    		      on "mailname" or "hostfullname" when sending
#		      mail if mailer is remote (mailer=submission and
#		      "server" is not local).
#
# Also boolean ON, OFF, TRUE, FALSE, YES and NO values are allowed.
#
# See also: verify-local-address, verify-domain, verify-alias-domain

mail-services-lookup
# This option specifies how names (normally hostnames, that is part after '@' 
# on folder name (before ':' or '/' characters) are searched for addresses. 
# And also that includes names given on ~/.elm/mail.services or on global 
# elm.mailservices file.
#
# This option does not affect how lookups of 'verify-domain' setting 
# are done.
#
# Possible values: 
#
#    hostname           Use normal hostname -lookup API (that is 
#                       gethostbyname() or getaddrinfo()).
#    shared             Lookup is done by shared library if available.
#    gethostbyname      Use gethostbyname()
#    getaddrinfo        Use getaddrinfo()
#
# With elmrc option 
#          use-connect-library = resolv
# possible values includes:
#
#    resolv:addresses   DNS lookup for address records is done
#                       for first found type.
#
#    resolv:all-addresses   DNS lookup for address records is done
#                           for all types (not just first found type).
#
# See also: special-use-domains-blacklist, verify-domain, 
#           ipv6-scope-id, name-lookup-cancel, name-lookup-cancel,
#           name-lookup-cache-time, static-hosts-max-names,
#	    address-lookup



name-lookup-cache-time
# Default cache time on seconds for name service lookups,
# if lookup is cached (some lookups may be cached if name
# is given on config file). Note that resolv: -library
# (use-mailer-library) uses ttl from DNS records instead.
#
# This is also uses for /etc/hosts entires if they are
# directly read
#
# See also: mail-services-lookup, static-hosts-max-names



 
editor-al-propline
# Specifies what editor property line is written to user's elmaliases file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of elmaliases file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# See also: editor-elmrc-propline


editor-hm-propline
# Specifies what editor property line is written to user's hash.marks file
#
# Possible values: 
#
#     auto              Use same property line than what was on top
#                       om top of elmrc file
#     emacs             Write emacs' property line -*- coding: ... -*-
#     ignore            Ignore editor's property line
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
# See also: editor-elmrc-propline


$usersection
#-----------------------------------------------------------------------
#
# Section 2:  Main Message Selection Screen Options
#

arrow
# Mark selected message with "->" rather than the inverse video bar?

mail-menu-time
# How to show time of messages on mailbox menu?
#
# This option includes list of keywords:   
#      year-separator               Show separator line (year)
#      auto-separator               Show separator line sometimes
#      today                        Show day of time and no
#                                   date for some messages (sent
#                                   on current date). Use
#                                   "today" on separator line.
#      today-separator              Show separator line (year/today)
#                                   sometimes; Show today
#                                   separator also when all
#                                   messages are from current year
#	year-or-time		    Add either year or time as hh:mm on
#				    date column when date is shown.
#				    Time is shown when year is
#				    current and timezone is same. 
#                                   
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc) 
#      are listed:
#           +year-separator           -year-separator
#           +auto-separator           -auto-separator
#           +today                    -today
#           +today-separator          -today-separator
#	    +year-or-time	      -year-or-time
#
# See also: pager-time-display

menu
# Display the three-line "mini-menu" of commands?

menu-display-host
# Should we display host on mailbox menu?

sortby
# how to sort messages of folders, "Reverse Sent" by default
# Possible values: sent, reverse-sent
#                  thread, reverse-thread
#                  received, reverse-received
#                  sender, reverse-sender
#                  size, reverse-size
#                  subject, reverse-subject
#                  mailbox, reverse-mailbox
#                  status, reverse-status
#
# See also: unstable-reverse-thread, sort-thread-max-time

thread-sortby
# how to sort threads, "Reverse Sent" by default
# Possible values: sent, reverse-sent
#                  subject, reverse-subject
#
# See also: unstable-reverse-thread, sort-thread-max-time

showmlists
# Should mailing list info be displayed for messages at startup?
# The "M" command toggles this on and off.


tochars
# When "showmlists" is off, a single-character mark is displayed
# to indicate who the message is to.  This five-character string
# defines the values to use for the mark.  The five characters are:
#   - Mark for mail to you and nobody else.
#   - Mark for mail to you and other recipients.
#   - Mark for mail to multiple recipients, and you are on the CC list.
#   - Mark for mail not addressed directly to you (e.g. mailing lists)
#   - Mark for mail which have List-Id header (i.e. mailing list identification)
# An underscore "_" in this list will display as a blank.
# the default value is  _TC*L

showreply
# Should messages to which you've replied be shown with an "r" mark?

pointnew
# Start up by pointing to the first new message received, if possible?
# If no new messages, start up by pointing to the first unread message.
#
# See also: pointflagged

pointflagged
# Start up by pointing to the first flagged message received, if possible?
#
# If "pointnew" is also set and new or unread message is found, then that is 
# selected instead.
#
# See also: pointnew

movepage
# When moving to next or previous page of messages or files, 
# should the current message or file pointer also move onto that page?

resolve
# Increment the message pointer only after the message has been fully
# disposed (saved or deleted)?  If OFF, then the message pointer is
# incremented after you do anything that touches the message.


$usersection
#-----------------------------------------------------------------------
#
# Section 3:  Message Display/Pager Options
#

confirmprint
# Should elm ask for confirmation before it print message ?

pager
# program to use for displaying messages ('builtin' is recommended)
#
# First line takes keywords:
#       builtin                 (or "builtin+", "builtin++", or "internal")
#       none                    No pager set
#
# Continuation line takes keyword:
#       use-$PAGER              Use $PAGER instead if set 

pager-header-display-mode
# Tells how header name is displayed on builtin pager
#       plain                   Display on plain text
#       bold                    Display header name as bold text

pager-indicate-wrapping
# Indicate wrapping of line with \ on builtin pager?
#
# See also: pager-paragraph-width

pager-paragraph-width
# Positive value indicate preferred width for flowed (word wrapped)
# paragraph. This is not hard limit, words may also wrapped after 
# this with, if they fit to screen width.
#
# Negative value indicate preferred distance from screen edge.
#
# Set to 0, if you want whole screen width to be used for paragraphs.
#
# Words are wrapped before indicated preferred paragraph width, if
# they not fit to screen width. If no one word fit to line, then
# line is printed on truncated form and if "pager-indicate-wrapping"
# is set, then \ character is printed.
#
# If lines are fixed (because of type "text/plain; format=flowed" and they
# are not part of flowed paragraph or because of type "text/plain; 
# format=fixed"), word wrapping is not done. In that case words are
# truncated if they not fit to screen width and if "pager-indicate-wrapping"
# is set, then \ character is printed.
#
# See also: pager-indicate-wrapping

pager-time-display
# Specifes how pager shows date and time on top line
#
#
# Possible values:
#
# (localization targets)
#	  	 legacy				(same than month-day-year-12h)
#                                               MeDateStrTimeFmt
#		 default			(same than month-day-year-HH-MM)
#                                               MeDateStrTime24Fmt
#
# (Rest are fixed)
#	  	 month-day-year-12h		month day, Year 12h (am/pm)
#		 				strftime %b %d, %Y %r
#		 month-day-year-24h		month day, Year 24h
#		 				strftime %b %d, %Y %T
#		 month-day-year-HH-MM           month day, Year HH:MH
#		 				strftime %b %d, %Y %R
#		 preferred			Local preferred format
#		 				strftime %c
#		 day-month-year-12h		day month year 12h (am/pm)
#		 				strftime %d %b %Y %r
#   		 day-month-year-24h		day month year 24h
#		 				strftime %d %b %Y %T
#    		 day-month-year-HH-MM		day month year  HH:MM
#		 				strftime %d %b %Y %R
#    		 YYYY-MM-DD-HH-MM               numeric YYYY-MM-DD HH:MM
#		 YYYY-MM-DD-HH-MM-SS            numeric YYYY-MM-DD HH:MM:SS
#
# See also: mail-menu-time, titles


titles
# display message title when displaying pages of message?
#
# See also: pager-time-display

builtinlines
# This determines whether the builtin pager should be used instead of
# an external pager (if you defined one above).  If the value is greater
# than zero, then the builtin pager is used for any message shorter than
# that number of lines.  If the value is less than zero, the builtin
# pager is used if the message is that many lines shorter than the size
# of the screen.  If zero, the external pager always is used.

prompt-after-metamail
# prompt after the metamail exits?

prompt-after-pager
# prompt for a command after the external pager exits?

prompt-metamail
# Ask from user, should metamail be called?

weed
# Enable the weedout list to be read?

weedout
# What headers I DON'T want to see, ever.
#
# If first element on list is "*clear-weed-list*" then builtin
# weedout list is not used.
#
# See also: weedout-without-title

weedout-without-title
# What headers I DON'T want to see. This list is used when pager
# does not print title. For example when mail is previewed for
# sending.
#
# See also: weedout

header-phrase-display-mode
# plain:  Show phrases as is (without quotation)
# quoted: Show phrases on quoted form

$usersection
#-----------------------------------------------------------------------
#
# Section 4:  Editor Options
#

editor
# Name of editor to use for composing messages.  "none" or "builtin"
# uses the simple built-in editor.
#
# First line takes keywords:
#       builtin                 (or "internal")
#       none                    No editor set
#
# Continuation line takes keywords:
#       use-$EDITOR             Use $EDITOR instead if set
#       use-$VISUAL             Use $VISUAL instead if set

alteditor
# name of editor to use for replies that have text
# Value EDITOR means that use value of "editor" 
#
# First line takes keywords:
#       EDITOR                  
#       none                    No editor set
#
# Continuation line takes keywords:
#       use-$EDITOR             Use $EDITOR instead if set
#       use-$VISUAL             Use $VISUAL instead if set

#
# See also: editor


easyeditor
# Name of editor for ~e command (when editor="builtin")

visualeditor
# Name of editor for ~v command (when editor="builtin")


escape
# The character to use in the builtin editor for entering commands

editflush
# Flush the input buffer after returning from an external editor?

$usersection
#-----------------------------------------------------------------------
#
# Section 5:  Message Composition Options
#

add-in-reply-to-phrase
# RFC 2822 (obsoletes RFC 822) allows only "Message-Id" to be included
# to "In-Reply-To" header.
#
# When set, adds also phrase to "In-Reply-To" (violates RFC 2822)

askcc
# would you like to be asked for Carbon-Copies information each msg?

askmimeforward
# This option controls is forwarding as message/rfc822 prompted or not
# if set, option mimeforward controls only default value for prompt
#
# See also: mimeforward

askreplycopy
# When replying to a message, ask "Copy message?" into editing buffer?
# If OFF, then the "replycopy" action is taken without asking.

attribution
# Attribution string for replies.  "%F" is the author of original message.
#
# Special strings for attribution and fwdattribution are:
#
# %[ .. | .. ]                  choice list
# \t                            tabulator
# \n                            newline
# \                             \ character quotes next character
# %s                            From: header field
# %F                            From: header field
# %D                            Time from Date: header field
# %I                            Message-ID: header field
# %S                            Subject: header field
# %[                            starts choice list
# %)F                           name(s) from From: header field
# %>F                           address(es) from From: header field
# %%                            % character
# 
# See also: fwdattribution

dsn-success
# If TRUE, success Delivery-Status-Notifications are asked by default.
#
# See also: dsnmail

expires-have-time
# Expires: -header field generated from Message Header Edit Screen have
# date and time; if not set, only date in shown.
#
# If Expires: -header field is generated from ~/.elm/elmheaders
# file, time is shown if header field on  ~/.elm/elmheaders
# included time.

fullname
# The full user name for outbound mail.  NOTE:  Many mail systems add
# From: lines on their own and this setting has no effect!!!  If your
# system is one of those, you might want to try things such as the
# "chfn" command or setting the NAME environment parameter.

fwdattribution
# Attribution for forwarded messages.  "%F" is original author.
# Something like: "--- %[begin|end] forwarded message from %F ---"
#
# See also: attribution, quoteforward

generate-message-id
# Should Message-ID: -header field generated for outgoing mail.
#
# Value is either
#
#	none				Message-ID: -header field is not generated
#
# or value have form
#
#	{localspec}@{domainspec}; {parameter}={value}...
# or
#
#	{localspec}@domain.name; {parameter}={value}...
#
# {localspec} values includes:
#
#	none				Message-ID: -header field is not generated
#	md5				Use 16 octets md5 hash value from message
#					content for generating local part of message-id.
#	/dev/urandom			Use 16 octets from /dev/urandom for
#					generating local part of message-id.
#	/proc/sys/kernel/random/uuid	Use content from /proc/sys/kernel/random/uuid
#					as local part of message-id.
#
#	Local part of message-id is generated from 16 octets same way on both
#	md5 and /dev/urandom cases. Result includes 2 or 4 "words" which are
#	separated by '.' characters (on 64-bit architecture result includes
#	2 "words" and 32-bit architecture result includes 4 shorter "words").
#
# {domainspec} values includes:
#
#	default				Try following as domain part of message id
#					    1) value of "hostfullname" elmrc option
#					    2) mailer specific value (name of local
#					       address of connected socket on "submission"
#					       mailer, if connection is remote)
#					    3) First value from "mailname" elmrc option
#	hostfullname			Try value of "hostfullname" elmrc option as
#					domain part of message id
#	maildomain			Try first value from "mailname" elmrc option as
#					domain part of message id
# 
# 'domain.name' is any dns name which is tried as domain part of message id. This
# must include at least one dot ('.'). Without dot ('.') it is interpreted as
# {domainspec} keyword.
#
# {parameter} values includes:
#
#	fallback-domain			Overrides possible compile time default
#					domain for domain part of message id
#	default-cache-timeout		Default timeout for cached results
#					of dns check for domain part of message id.
#					May include unit: "s" for seconds, "m"
#					for minutes, "h" for hours or "d" for days.
#					Without unit gives default cache timeout on
#					seconds.
#
#	check-domain			Value "none" indicates that dns check is not
#					done and "valid-msg-id-domains" elmrc option
#					must be used.
#
#	check-domain			Value "shared" indicates that shared routine
#					(resolv -module) is used for dns check.
#
#       min-domain-labels		Minimun number of domain labels (0-9) separated
#                                       by '.' characters required for dns check.
#					Value zero (0) disables counting of labels
#					and rfc 822 special characters and whitespace
#					are not checked.
#					Note that '\.' does not count as label separator.
#
# With elmrc option 
#          use-mailer-library = resolv 
# possible {parameter} value includes:
#
#	check-domain			Value "resolv" indicates that shared routine
#					from resolv -module is used for dns check.
#					
# {value} may be quoted string for "fallback-domain" and "check-domain".
#
# A domain part of message-id either must be listed on
# "valid-msg-id-domains" elmrc option or resolv -module must check that
# given dns name exists. If a  domain part of message-id is listed
# "special-use-domains-blacklist", dns check is not done and domain part
# is not accepted.
#
# See also: valid-msg-id-domains, special-use-domains-blacklist

long-encoded-headers
# Produce longer than 80 character mime encoded headers (mainly
# Subject), before wrapping them? 

metoo
# When you send a message to an alias that contains you, would you
# like to receive a copy of the message?

mimebodykeywords
# If TRUE detect following keywords from mail (when sending it):
#        [clear]
#        [encode]
#        [no save]
#        [nosave]
#        [include
#        [attach
#        [send-as-charset       (similar than text-charset option)
#        [no keywords]          (do not detect keywords after this)
#        [[                     (indicate line starting with [ )
# Unknown keywords gives error

mimeforward
# This option controls how Elm will forward messages when MIME is defined.
# Possible values include:
#
#       on      Causes Elm to send the message as a MIME part of type
#               message/rfc822.  Highly recommended when forwarding MIME
#               messages so that the receiver can correctly view the message!
#
#       off     Elm will include the forwarded message in your editor instead
#               of making it an separate mime body part.
#
#       auto    Enables forwarding mail as message/rfc822 body part if it top
#               level type of mail is not text/plain or charset is not good
#                       or top level disposition is attachment.
#
# Also boolean ON, OFF, TRUE, FALSE, YES and NO values are allowed.
#
# See also: askmimeforward, quoteforward

names
# When showing To: addresses, just display the recipient name?
# If OFF, show entire recipient address.

noheader
# when messages are copied into the outbound buffer, don't include headers
# in replied messages?

noheaderfwd
# when messages are copied into the outbound buffer, don't include headers
# in forwarded messages?
# (Notice that messages are not copied to outbound buffer when
#  mimeforward = ON)
#
# See also: mimeforward, fwdattribution

program-identification
# Tells how program identification header field is added to message
# 
# This option includes list of keywords:
#      none                    None of values are selected
#      X-Mailer	       	       Add X-Mailer: header field
#      version		       Add version information to header field
#      User-Agent              Add User-Agent header field
#
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default are listed:
#	+X-Mailer	-X-Mailer
#	+version	-version
# 	+User-Agent     -User-Agent
# These two forms can not be mixed.
#
# Note that also message-id domain, when it is msg-id.elmme-mailer.org,
# identifies program. Also X-ELM-OSV: header field, if generated,
# identifies program.
#
# See also: generate-message-id


precedences
# list of delivery precedences allowed, or empty to allow anything
# precedence may be followed by optional ":priority" specification

prefix
# Prefix to mark included message text.  Use "_" for a space.
#
# When printing quoted lines (as defined on RFC 2676),
# this elmrc option is used for quotation. When quotation
# level > 1 last printable character is repeated.

quoteforward
# Forwarded messages are quoted like replies, rather than included
# with "Forwarded message" and "End of forwarded message" banners 
# above and below. This has no effect if "mimeforward" is TRUE.
#
# See also: fwdattribution, askmimeforward, askmimeforward

replycopy
# Should the default for the "Copy message?" question be "yes"?

send-mime-plain-text
# When set, Text/Plain with charset US-ASCII is sent with MIME headers.
# When unset, MIME headers are not included to plain US-ASCII text messages
# when content-transfer-encoding is 7bit (identity). Default: True

valid-msg-id-domains
# List of message-id domains (that is everything after '@' on message-id
# inside of < >)  are considered valid without verifying domain on messsage-d.
#
# This also overrides special-use-domains-blacklist
#
# If domain name is given as ".domain" then it marks valid all 
# message-id domains on ids <{anyting}@{anything}.domain>
#
# If domain name is given as "domain" then it marks valid only 
# message-id domains on ids <{anyting}@domain>
#
#
# See also: special-use-domains-blacklist, valid-domains, generate-message-id

$usersection
#-----------------------------------------------------------------------
#
# Section 6:  Signature Options
#

localsignature
# Local ".signature" file to append to appropriate messages.

remotesignature
# Remote ".signature" file to append to appropriate messages.

sigdashes
# Place dashes line above signatures?  (Usenet compatibility and convention)

$usersection
#-----------------------------------------------------------------------
#
# Section 7:  Program Termination/Folder Cleanup Options
#

askdelete
# Should the "Delete messages?" question be asked when you exit, re-sync,
# or change folders?  If OFF, then the "alwaysdelete" action is taken
# without asking.

askkeep
# Should the "Keep unread messages in incoming mailbox?" question be
# asked when you exit, re-sync, or change folders?  If OFF, then the
# "alwayskeep" action is taken without asking.

askstore
# Should the "Move read messages to received folder?" question be asked
# when you exit, re-sync, or change folders?  If OFF, then the "alwaysstore"
# action is taken without asking.

alwaysdelete
# Should the default for the "Delete messages?" question be "yes"?

alwayskeep
# Should the default for the "Keep unread messages in incoming mailbox?"
# question be "yes"?

alwaysstore
# Should the default for the "Move read messages to received folder?"
# question be "yes"?

keepempty
# Should we keep folders from which all messages are deleted?
# If OFF then the empty folder files are deleted.

$section
#-----------------------------------------------------------------------
#
# Section 8:  Folder Handling Options
#

confirmcreate
# Should elm always ask the user to confirm before it creates
# any new files?
# This is used for both folders in the user's mail directory
# and ordinary files.

confirmfiles
# Should elm ask for confirmation before it appends a message
# to an existing file that is not a folder in the user's Mail
# directory?
# This is used for ordinary files only and does not affect
# folders in the user's mail directory.

confirmfolders
# Should elm ask for confirmation before it creates a new folder
# in the user's Mail directory?
# This is used only for folders in the user's mail directory and
# does not affect ordinary files.

confirmappend
# Should elm always ask the user to confirm before it appends
# messages to any existing file?
# This is used for both folders in the user's mail directory
# and ordinary files.

confirmtagsave
# Should Elm ask for confirmation before saving tagged messages to a
# folder when the cursor is on an untagged message?

copy
# save a copy of all outbound messages?

dead-letter-dir
# Name of Canceled.mail.dir

default-folder-status
# In folders, should messages without Status header be marked
#   Old   (0)
#   New   (1)
#   Read  (2)

dsnmail
# Name of folder in which received delivery status notificatios (DSN)
# are saved.
#
# First line takes keyword:
#       none                    Indicates that dsn mail folder
#                               is not set. 
#
# Continuation line takes keywords:
#       local-file              Given value is assumed to be
#                               local mailbox file
#
# See also: dsn-success, receivedmail, sentmail

env-from-source
# Tells which information to use for envelope from address.
# Possible values include:
#    forward-from            (0)  Use:  "From "        separator line
#                                       ">From "       forwarded indicator
#                                       "Return-Path:" header
#    from                    (1)  Use:  "From "        separator line
#                                       "Return-Path:" header
#    return-path             (2)  Use:  "Return-Path:" header
#
# Setting this to value return-path requires that on every mail have
# Return-Path: -header.

extra-mailbox-dir
# Folders on that directory is considered to be spool mailboxes
# (i.e. it is prepared that to they is arrived new mail when
#  they are open). This directory must be different than
# folders or maildir directory (i.e. ~/Mail).
#
# See also: incomingfolders, mailbox-locking

file-browser-show-dotfiles
# If this is set, .dotfiles are shown on Elm 2.5 style file browser 
# (.dotdirectories are always shown).

file-browser-show-protection
# If this is set, permission and owner columns are shown on 
# Elm 2.5 style file browser 

file-browser-show-title
# If this is set, title of columns is shown  on  Elm 2.5 style file browser 

file-browser-sortby
# How to sort local files and directories on Elm 2.5 style 
# file browser?
# Possible values: none
#                  name, reverse-name
#                  mtive, reverse-mtime
#
# See also: local-dir-sortby

folder-locking
# Tells what locking use with "lock-folders"
# 
# This option includes list of keywords:
#       flock                  Use flock() locking. 
#                              flock() does not lock files over NFS
#       fcntl                  Use fcntl() locking. 
#
# 
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc) 
#      are listed:
#               +flock          -flock
#               +fcntl          -fcntl
#
# See also: lock-folders, mailbox-locking

forcename
# Save outbound messages by login name of sender/recipient even if the
# associated folder doesn't already exist?

incomingfolders
# List of folders which are incoming folders.  Incoming folders are
# handled like your spool mailbox.
#
# See also: extra-mailbox-dir, mailbox-locking

last-read-fallback-locking
# What locking to use for .elm-last-read-{uid} file when
# use-last-read enables it.
#
# ~/.elm/last.read file uses conf-merge-locking
#
#  .elm-last-read-{uid} file uses either
#  			folder-locking,
#			mailbox-locking, or
#                  this last-read-fallback-locking
#
# This option includes list of keywords:
#       flock                  Use flock() locking. 
#                              flock() does not lock files over NFS
#       fcntl                  Use fcntl() locking. 
#       prefer                 Prefer this option
#			       instead of folder-locking or
#			       mailbox-locking
#
# If value is "none" or "prefer" alone, then locking is disabled.
#
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc) 
#      are listed:
#               +flock          -flock
#               +fcntl          -fcntl
#		+prefer		-prefer
#
#  See also: mailbox-locking, folder-locking, use-last-read-file,
#            extra-mailbox-dir

local-dir-sortby
# How to sort local files and folders on folder and file browser?
# Possible values: none
#                  name, reverse-name
#                  mtive, reverse-mtime
#
# See also: imap-dir-sortby, file-browser-sortby

local-lockfile-pidcheck
# This variable controls how {mailbox}.lock lockfile is parsed
#
# Possible values are:
#    no                 Do not check pid on file
#    yes                Removes lockfile if given pid does not exists
#    hostname           Removes lockfile if given pid does not exists.
#                       Writes pid@hostname format. 
#    ignore-hostname    Removes lockfile if given pid does not exists
#                       Ignores @hostname part on lockfile.
#    require-hostname   Removes lockfile if given pid does not exists 
#                       and @hostname part exists (and matches).
#                       Writes pid@hostname format. 
#
#  Either pid or pid@hostname is always written to lockfile.

local-sessionlock-dir
# If opened local mailbox is on spool directory, this setting tells
# to where put temporary file mbox.{mailbox}. ( If opened local
# mailbox is not on spool directory, location of temporary file
# mbox.{mailbox}-{username} is given on tmpdir variable )
#
# See also: tmpdir, local-sessionlock-use-home

local-sessionlock-use-home
# This variable controls to where put temporary file when local
# mailbox is opened.
#
# Possible values are:
#    never          Temporary file is put according of
#                   local-sessionlock-dir and tempdir
#    spool          Temporary file for mailbox on spool
#                   is put to home directory
#    always         Temporary file for mailbox is put
#                   to home directory
#    non-spool      Temporary file for mailbox on not in spool
#                   is put to home directory

lock-folders
# if set, elm will lock a folder, when it is open. 
#
# NOTICE: It is not possible to deliver mail to a locked folder. So
# take care that incoming mail folders are treated as mailboxes.
# This variable does not effect handling of mailboxes. 
#
# NOTICE: Does not work with dot-locking
#
# See also: folder-locking

lock-in-copy
# If set, elm will lock a folder when trying to save or copy to it.
# NOTICE: Does not work with dot-locking
#
# See also: mailhome-locking, folder-locking

mailbox-locking
# Tells what locking use with mailboxes which are not in mailhome 
# (local mail spool directory)
#
# This option includes list of keywords:
#       lockfile               Use {mailbox}.lock file
#       flock                  Use flock() locking. 
#                              flock() does not lock files over NFS
#       fcntl                  Use fcntl() locking. 
#
# 
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default (or changes from global elm.rc) 
#      are listed:
#               +lockfile       -lockfile
#               +flock          -flock
#               +fcntl          -fcntl
#
# See also: mailhome-locking, local-lockfile-pidcheck, extra-mailbox-dir,
#           incomingfolders, conf-merge-locking, folder-locking

maildir
# Where to save my mail to.

mailhome-dir
# Tells location of local mail spool directory. 
#
# Default value of incoming-mailbox uses mailhome-dir -value.
#
# Special values:   none                Do not provide default value
#                                       for incoming-mailbox. Opens
#                                       empty mailbox by default.
#
# See also: mailhome-locking, incoming-mailbox

mailhome-locking
# Tells what locking use with mailhome-dir (local mail spool directory)
#
# This option includes list of keywords:
#       lockfile               Use {mailbox}.lock file
#       flock                  Use flock() locking. 
#                              flock() does not lock files over NFS
#       fcntl                  Use fcntl() locking. 
#
# 
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default are listed:
#               +lockfile       -lockfile
#               +flock          -flock
#               +fcntl          -fcntl
#
# See also: mailbox-locking, local-lockfile-pidcheck, mailhome-dir

mailpermissions
# permissions to be given to newly-created saved mail files, default rw-------

message-hide-hack
# Possible values: none
#                  FOLDER INTERNAL DATA
# If set to FOLDER INTERNAL DATA, hides messages which have
# subject DON'T DELETE THIS MESSAGE -- FOLDER INTERNAL DATA
# and X-IMAP: -header.
#
# Hiding of mail do not affect to '-z' option -- that option
# still sees that mailbox is non-zero size. 

receivedmail
# Name of folder in which received messages are saved.
#
# First line takes keyword:
#       none                    Indicates that received mail folder
#                               is not set. Read mails are kept
#                               on incoming mailbox.
#
# Continuation line takes keywords:
#       local-file              Given value is assumed to be
#                               local mailbox file
# See also: incoming-mailbox, sentmail, dsnmail

savebyalias
# Save messages, incoming and outbound, by alias of sender/recipient?

savename
# Save messages, incoming and outbound, by login name of sender/recipient?

sentmail
# Name of folder in which copies of outgoing messages are saved.
#
# First line takes keyword:
#       none                    Indicates that sent mail folder
#                               is not set. Sent mails are not
#                               saved to that folder.
#
# Continuation line takes keywords:
#       local-file              Given value is assumed to be
#                               local mailbox file
# See also: incoming-mailbox, receivedmail, savename

show-header-errors
# Possible values:   OFF       do not show (certain) header errors
#                    ON        show certain header errors
#                    store     store certain  header errors and show
#                              them when viewing message

show-mail-quota
# Should mail quota to be shown on mailbox open?
#
# Supports RFC 2087: IMAP4 QUOTA extension
#
#  Possible values include:
#    off		Does not show mail quota on mailbox open
#    on-open		Shows mail quota (if supported) on mailbox open
#
# This does not affect command 'Eu' (show mail quota usage).

sort-thread-max-time
# What is maximum time in days between mails so that
# they can considered to be same thread (when subject is same)

unstable-reverse-thread
# If set, reverse thread sorting is based on latest message on thread.
# Therefore thread moves to new location, when new message arrives to
# thread.
#
# This affects   sortby:        reverse-thread
#         and    thread-sortby: reverse-sent
#
# See also: sortby, thread-sortby

use-last-read-file
# This option controls use of per directory .elm-last-read-{uid}
# file and use of user's ~/.elm/last.read file.
#
# A last read stores read time for folder/mailbox files if reading
# does not update access time of folder/mailbox files.
#
#	  Values are:
#	  	 no			Do not read or update
#		 			.elm-last-read-{uid} file
#	  	 yes			Create, use and update
#		 			.elm-last-read-{uid} file
#	  	 auto			Use and update existing
#		 			.elm-last-read-{uid} file.
#					Create file if access
#					time is not updated.
#	  	 existing		Use and update existing
#		 			.elm-last-read-{uid} file
# See also: last-read-fallback-locking

$usersection
#-----------------------------------------------------------------------
#
# Section 9:  MIME and Character Set Options
#

allow-charset-switching
# When set, switch display charset between charsets supported by terminal
#
# See also: page-known-charsets, displaycharset, charset-convert-ok

attachment-dir
# From which or to which directory read/save attachments.
# This is provided as {doc}/ prefix on corresponding filename prompts.

auto-attachment
# Possible values are: none, application, non-text
# This affect how mime-parts with no Content-Disposition header, 
# are treated. 
#          * If auto-attachment is none, missing Content-Disposition is 
#            treated as "Content-Disposition: inline". 
#            That is what MIME requires. 
#          * If auto-attachment is application, type is subtype of
#            application and Elm can not handle type without calling 
#            metamail (or mailcap programs), missing Content-Disposition 
#            is treated as "Content-Disposition: attachment".
#          * If auto-attachment is non-text, type is not subtype
#            of text or multipart, type is not message/rfc822
#            and Elm can not handle type without calling
#            metamail (or mailcap programs), missing Content-Disposition
#            is treated as "Content-Disposition: attachment". 
#
# See also: charset-convert-ok, page-known-charsets, pagealternative,
#           pagemultipart

auto-iso-8859
# Auto-create undefined ISO-8859-X charsets as superset of US-ASCII.
# RFC 2046 (MIME Part Two: Media Types) requires this.
#
# See also: compatcharsets, auto-attachment

attachment-fix-extension
# If set (default), default file extension is set according of mime 
# type (appending after existing extension of given filename) when
# saving attachment.
#
# If either "attachment-fix-extension" or "check-type-pattern",  
# mime types are checked, when saving mail, against elm.mimetypes and 
# mime.types. If content do not match to any pattern (magic number) 
# given for type, that causes warning.
#
# See also: check-type-pattern

bindata
# Binary charset map file. Includes type=ascii and type=one-byte-map maps
#  from map-text-dir (and elsewhere). If that variable is set both
#  on global elm.rc and user's elm.rc then both files may be read
#  or mmapped.
# Filename can be
#                filename                File is read from directory
#                                        given on map-bin-dir directory
#                                        (normally $lib/elm.map.bin)
#                {rc}/filename           File is read from .elm sub-directory
#                                        of user's home
#                ~/filename              File is read from  user's home
#                                        directory
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
# See also: map-bin-dir

charset-convert-ok
# Inhibit "[ Charset xxx converted... ]" message when charset
# is converted (to unicode i.e. without loss). Also use "pager" 
# to display charset (instead of metamail).
#
# See also: allow-charset-switching, displaycharset, page-known-charsets,
#           auto-attachment

check-type-pattern
# If set (default), mime types are checked, when paging mail, against 
# elm.mimetypes and mime.types. If content do not match to any pattern 
# (magic number) given for type, that causes warning. If on elm.mimetypes or
# mime.types is any entry for type without pattern, warning is NOT
# printed. If warning is printed, confirmation is required. This
# mainly protects routines on mailcap to get bogus types. Notice that this do
# NOT protect metamail (if used).
# See also: attachment-fix-extension

compatcharsets
# List of (8-bit) Character Sets, which are byte-to-byte supersets of 
# US-ASCII.  (obsolete)
#
# NOTE: That same information can be given on .elm/mime.charsets file with 
# ';MIME-subset=US-ASCII' qualifier -- that is preferred method.
#
# In fact this option should never be set explicitly.
#
# See also: page-known-charsets, iso646-charsets, auto-iso-8859

convert-cr-to-newline-hack
# This option enables conversion of lone CR to newline (LF or CRLF)
# when MIME encoded body part is decoded.
#
# This setting does not affect CR if MIME body part is not treated
# as text.
#
# This setting does not affect handling CR when it is part
# of CR LF sequence.
# 
# Possible values:
#
#		off		Do not convert lone CR
#		on-with-error	Convert lone CR to newline
#				with diagnostic message
#		on-silent	Convert lone CR to newline
#				without diagnostic message
#
# Also boolean ON, OFF, TRUE, FALSE, YES and NO values are allowed.


convert-utf-header
# Convert utf-8 mime encoded words to utf-7 when sending?  



default-mime-text-charset
# Name of (assumed) charset for text/plain MIME messages (if charset is
# not given):
#    DISPLAY            charset is same than used by terminal
#    SYSTEM             charset is same than used by system (locale charset)
#    TEXT               value of text-charset
#    US-ASCII           charset is US-ASCII (required by standards)

default-nomime-charset
# Name of (assumed) charset of non-MIME messages:
#    DISPLAY            charset is same than used by terminal
#    SYSTEM             charset is same than used by system (locale charset)
#    TEXT               value of text-charset
#    US-ASCII           charset is US-ASCII (required by standards)

displaycharset
# When set other that SYSTEM, specifies Character Set to which
# display should be switch if supported by terminal. Character
# Set of terminal is switched back to System Character Set (given
# on elm.mimecharsets or ~/.elm/mime.charsets file) when running
# external programs. This switching is done even when option
# allow-charset-switching is not set.
#
# Needs information from elm.terminalinfo or ~/.elm/terminal.info file.
#
# NOTICE that this (or Character Sets provided by locale) must have
# mapping tables available if "text-charset" value is not DISPLAY
#
#
# See also: page-known-charsets, allow-charset-switching, local-fs-charset,
#           text-charset

fragment-handling
# How fragmented (message/partial) should be handled?
#    none               Call metamail (if available) for these
#    manual             Let user give command 'A' to enter message
#                           assembly mode
#    auto               Go automatically message assembly mode

iso646-charsets
# List of 7-bit Character Sets, which are byte-to-byte supersets of 
# INVARIANT.
#
# NOTE: That same information can be given on .elm/mime.charsets file with 
# ';MIME-subset=INVARIANT' qualifier -- that is preferred method.
#
# In fact this option should never be set explicitly.
#
# See also: page-known-charsets, compatcharsets

local-fast-lookup
# If set indicates that directory listing not needed for lookup.
# Need to be unset, if same character on local-fs-charset has several
# representations (or encodings). 
#
# This is implicitly set always when ASCII filenames are looked.
#
# See also: local-fs-charset, imap-fast-lookup

local-fs-charset
# Character set used on local filenames
# Special values:     SYSTEM       character set used by system (from locale)
#                     DISPLAY      character set used by terminal
#                     TEXT         value of text-charset
#
# If local-fs-charset is well behaved (no multiple encodings for a
# single character), set local-fast-lookup also.
# Normally local-fs-charset have value SYSTEM, but sometime it is useful to
# set to fixed value.
#
# See also: allow-charset-switching, local-fast-lookup, displaycharset, 
#           text-charset, page-known-charsets

locale-charsets
# For these charsets is type type unknown used for system (locale)
# charset, even when Elm ME+ is builtin definition for charset.
#
# Available only if system supports wide characters and 
# __STDC_ISO_10646__ is defined.
#
# This option may cause error message
#       Unknown charsets are unsupported as keyboard input!
# to be printed in that case this option can not be used for given charset.

mime-encoded-filename-hack
# If this is set (default), then MIME encoded words (RFC 2047 or RFC 1522) 
# in filename parameter is detected. That is =? encoding. However RFC 2231 
# style encoding is preferred if elmrc option "mime-parameters" have not 
# value "plain".

mime-parameters
# Handling of RFC 2231 encoded mime parameters.
# Possible values: plain                just use and generate plain
#                                       non-encoded parameters
#                  encoded              generate RFC 2231 encoded mime
#                                       parameters, if needed
#                  plain-and-encoded    Generate RFC 2231 encoded and
#                                       plain ascii parameter values
#
# This parameter do not effect RFC 2231 language mark on mime encoded
# words!
#
# This is specially used for filename -parameter on content-disposition

noencoding
# This control makes it possible to send raw 8bit or binary data when the MTA
# doesn't support 8BITMIME and the -B8BITMIME option or
# BINARYMIME and the -BBINARYMIME option
#
# Possible values:
#    pass-7bit (0)   : Always convert 8BIT and BINARY data to QUOTED-PRINTABLE 
#                      if the MTA doesn't support the -B8BITMIME and 
#                      -BBINARYMIME options.
#    pass-8bit (1)   : Allow 8bit without -B8BITMIME, but binary data is 
#                      encoded
#    pass-binary (2) : Allow binary without -BBINARYMIME and and 8bit without 
#                      -B8BITMIME
#
# It is STRONGLY recommended that it be left set to pass-7bit unless you know 
# what you are doing!!
#
# Elm doesn't yet fully support BINARYMIME: it requires that text lines are
# terminated with \r\n, Unix's \n isn't sufficient!
# That is only partially implemented in this version of Elm.
#
# Quote from RFC 1830 (Experimental Protocol): 
#  SMTP Service Extensions for Transmission of Large and Binary MIME Messages
#
#      It is important to note that when using BINARYMIME, it is
#      especially important to ensure that the MIME message itself is
#      properly formed.  In particular, it is essential that text be
#      canonically encoded with each line properly terminated with <CR>
#      <LF>.  Any transformation of text into non-canonical MIME to
#      observe local storage conventions must be reversed before sending
#      as BINARYMIME.  The usual line-oriented shortcuts will break if
#      used with BINARYMIME.

nohdrencoding
# Don't do MIME part 2 (RFC 1522) encoding for 8-bit headers?
# That is =? encoding.
#
# Because 8-bit data is not allowed in headers, 
# it is STRONGLY recommended that this is left set to OFF

page-known-charsets
# Should Elm use "pager" to display charsets (other than display charset)
# if charset is known (i.e. it probably can be converted to display charset).
# This should be set, if mapping information is given to elm and metapager
# can not do better.
#
# See also: allow-charset-switching, displaycharset, charset-convert-ok,
#           auto-attachment

page-tagfilter
# Should Elm use "pager" to display type given as keyword?
#
# This option includes list of keywords:
#      none   	       	       None of values are selected
#      text/enriched	       text/enriched type does not require
#	       		         external programs or metamail
#      text/html	       text/html type does not require
#	       		         external programs or metamail
#
#  This does not take account possible unsupported
#  tags or that builtin++ pager is not used as "pager".
#
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default are listed  (or changes from global elm.rc) 
#      are listed:
#      	   +text/enriched	-text/enriched
#	   +text/html		-text/html
#
# See also: pagealternative, pagemultipart, pagerelated,
#     	    pagesigned, metamail

pagealternative
# Should Elm use "pager" to display one part of multipart/alternative,
# if found one part which can be displayed? Otherwise, Elm uses "pager"
# for doing this if all parts are displayable.
#
# See also: pagemultipart, pagesigned, metamail,
#     	    pagerelated, page-tagfilter

pagemultipart
# Should Elm use "pager" to display MIME multipart messages
# with unknown sub-parts or with unknown subtype?
#
# See also: auto-attachment, pagealternative, pagesigned, metamail,
#     	    pagerelated, page-tagfilter

pagerelated
# Should Elm use "pager" to display first part of
# multipart/related message or part indicated by "start"
# parameter ?
#
# multipart/related is not supported, and releated
# parts are not "passed" to first (or start) part.
#
# Note that multipart/related is used normally with
# text/html as first part. That is not supported,
# and also not work when mailcap is used for text/html.
#
# When multipart/related have only single part (that
# is start part), using multipart/related is superflows.
# In that case multipart/related is not required, and can
# be replaced with that single part.
#
# Option have values
#	 	no		NO (may use metamail, if available)
#		yes		Try page first (or start) part
#		single-part	Try page single part.

pagesigned
# Should Elm use "pager" to display MIME multipart/signed
# with unknown signing protocol ?
#
# See also: pagealternative, pagemultipart, metamail,
#     	    page-tagfilter

require-mime-version-for-body-encoding
# If set MIME Part 1 (RFC 1521) decoding is only done when MIME-version
# header is present. Default: True

require-mime-version-for-hdr-encoding
# If set MIME Part 2 (RFC 1522) decoding is only done when MIME-version
# header is present. That =? encoding. 
# Default: False

text-charset
# Name of Character Set used with MIME text/plain Content-type
# - Special value DISPLAY means that Character Set used in content-type 
#   is same than used by terminal
# - Special value SYSTEM means that Character Set used in content-type
#   is same than used by system (locale charset)
# - Text of current used display Character Set is converted to 
#   that Character Set
# NOTICE that both displaycharset and text-charset must have know,
# and both Character Set must have mapping tables available, otherwise 
# conversion fails (and produces no output) !
#
# So this variable should almost always have value DISPLAY
# Other useful values are UTF-7 and perhaps UTF-8 (however
# UTF-7 is better encoding of Unicode for Mail than UTF-8)
#
# See also: displaycharset, local-fs-charset, allow-charset-switching,
#           utf7-encode-optional

unidata
# Binary unidata file, filename can be
#                filename                File is read from directory
#                                        given on map-bin-dir directory
#                                        (normally $lib/elm.map.bin)
#                {rc}/filename           File is read from .elm sub-directory
#                                        of user's home
#                ~/filename              File is read from  user's home
#                                        directory
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
#
# See also: map-bin-dir

use-char-set-header-field-hack
# Recognise non-standard header field Char-Set for character set
# of header fields (specially Subject) and body of mail.

use-content-type-charset-for-8bit-subject-hack
# Process 8-bit subject with using charset parameter from
# header field Content-Type. This usage is non-standard.

utf7-encode-optional
# Should UTF-7 'optional direct characters' be utf-7 encoded?
# Optional direct characters are: 
#                 ! " # $ % & * ; < = > @ [ ] ^ _ ' { | }
# See also: text-charset

$usersection
#-----------------------------------------------------------------------
#
# Section 10: Metamail and mailcap options
#

metamail
# This tells path of metamail program
#
# That version (Elm 2.4ME+ or Elm ME+ 2.5) does not use Metamail's 
# companion programs (such as mmencode) directly, but metamail 
# package supposes that companion programs are installed to search path.
#
# Special values:   none                Don't call metamail
#                   metamail            Don't call metamail if environment
#                                               variable $NOMETAMAIL is defined

internal-mailcaps
# List of mailcaps for internal mailcap support  (without metamail).
# List may be space or ':' separated. Separate values may be quoted. 
# Set value to "none" (without quotes) to disable internal mailcap support.
# See also: metamail-mailcaps, internal-mailcap-trusted-programs,
#           mailcap-blacklist-programs, mailcap-tempfile-lifetime

internal-mailcap-trusted-programs
# List of programs which are executed by default when using internal
# mailcap. Programs given on test= are always executed without
# prompting.
# See also: internal-mailcap-prompt-trusted, internal-mailcaps,
#           mailcap-blacklist-programs

internal-mailcap-prompt-trusted
# If set, Mailcap program selection -screen is shown even when
# all programs asked on screen are executed by default
# See also: internal-mailcap-trusted-programs

metamail-mailcaps
# List of mailcaps for metamail. List may be space or ':' separated. Separate 
# values may be quoted. When metamail is called values are put to variable 
# $MAILCAPS (as ':' -separated list). metamail-mailcaps may include variables 
# (for example  $MAILCAPS). Value of variables is splitted only from ':' 
# (quotes and spaces are not treated specially).
# See also: internal-mailcaps, mailcap-blacklist-programs

mailcap-blacklist-programs
# List of programs which are not executed. If mailcaps given on 
# metamail-mailcaps refer these programs and corresponding content-type is
# used on mail, metamail is NOT called. This list also disabled these
# entries  when using internal mailcap. 
# See also: internal-mailcaps, metamail-mailcaps

mailcap-select-other
# If it is set (default), "Mailcap program selection"
# screen shows o)ther alternative programs.
#
# Setting test option means that "test=" commands from all 
# mailcap entries for given type is executed and if 
# test succeed, these entries are added as o)ther alternatives.
#
# If this is not set, "test=" commands from mailcap entries
# for given type is executed until some test succeed (or 
# mailcap entry without "test=" is found for given type).

mailcap-tempfile-lifetime
# Specifies minimum time on seconds which temporary file is kept before 
# it is deleted when using internal mailcap. 
#
# Only available if system supports poll() or select().

$usersection
#-----------------------------------------------------------------------
#
# Section 11: IMAP and POP options
#

incoming-mailbox
# Name of incoming mailbox, useful if POP or IMAP are used.
#
# First line takes keyword:
#       none                    Indicates that incoming mailbox
#                               is not set. Opens empty mailbox
#
# Continuation line takes keywords:
#       use-$MAIL               Use $MAIL instead if set.
#                               Value of $MAIL is assumed to be
#                               local mailbox (file)
#       local-file              Given value is assumed to be
#                               local mailbox file
#
# See also: mailhome-dir, sentmail, receivedmail

pop-idle-alive-interval
# Number of seconds, which POP connection is allowed to be idle. 
# After that idle timeout, NOOP command is sent.

pop-max-download-size
# maximum size of message on bytes which is downloaded by POP
# when mailbox is parsed. If POP server does not support TOP
# command, all messages are downloaded.
#
# Value -1 for pop-max-download-size causes all messages to be downloaded.
# ! character as second letter on message status indicates that message
# is not downloaded.
# See also: imap-max-download-size

pop-show-greeting
# Show server greeting?

imap-dir-sortby
# How to sort IMAP folders on folder browser?
# Possible values: none
#                  name, reverse-name
# See also: local-dir-sortby

imap-charset
# Character set used with IMAP
# Special values:     SYSTEM       character set used by system (from locale)
#                     DISPLAY      character set used by terminal
#                     TEXT         value of text-charset
# See also: imap-naming-convention, imap-fast-lookup

imap-connection-cache
# Should IMAP connections to be cached? (to reduce need to re-login to IMAP
# service)

imap-naming-convention
# Should IMAP's Mailbox International Naming Convention to be used?
#
# If path name on folder listing does not match use IMAP's Mailbox 
# International Naming Convention, imap-charset is used instead for
# interpreting of name. That requires that imap-fast-lookup is NOT
# set.
# 
# See also: imap-charset, imap-fast-lookup

imap-fast-lookup
# If set indicates that IMAP directory listing not needed for lookup
#
# Need to be unset, if same character on imap-charset is several
# representations (or encodings). Also need to be unset, if
# both imap-naming-convention and imap-charset is used.
#
# See also: imap-charset, imap-naming-convention, local-fast-lookup

imap-idle-alive-interval
# Number of seconds, which IMAP connection is allowed to be idle. 
# After that idle timeout, NOOP command is sent.

imap-max-download-size
# maximum size of message on bytes which is downloaded by IMAP
# when mailbox is parsed.
#
# Value -1 for imap-max-download-size causes that all messages are downloaded.
# ! character as second letter on message status indicates that message
# is not downloaded.
# See also: pop-max-download-size

imap-show-greeting
# Show server greeting and other untagged OK messages (without machine
# readable codes) ?

imap-show-warning
# Show untagged NO messages?

imap-show-error
# Show untagged BAD messages?

imap-use-examine
# Should IMAP use EXAMINE when looking mail (i.e. when using programs
# like "frm" or "newmail")? If this is set, EXAMINE is used to get
# read-only access (so that \Recent flag if mails is preserved).
# However seems that (some?) IMAP servers does not report new mails
# when mailbox is opened as read-only.

$usersection
#-----------------------------------------------------------------------
#
# Section 12: PGP and GPG options
#

showpgppreamble
# if this variable is ON, display text before PGP armor.


usepgppass
# If ON, Elm will prompt you for your PGP passphrase and use it whenever
# necessary to make it more convenient to hand PGP messages.

keeppassfor
# The number of seconds Elm should remember your passphrase.  -1 means never
# expire it.

askpgpsig
# If ON, Elm will prompt you for a username with which to sign the pgp
# message

pgp2
# What is the path for pgp 2?
# Possible values include:
#       none            Don't call pgp
#       /path           Call pgp via that path, if it is executable

pgp5-dir
# What is the directory path for pgp 5 binaries?
# Possible values include:
#       none            Don't call pgp
#       /path           Call pgp binaries from that directory

gpg
# What is the path for gnupg?
# Possible values include:
#       none            Don't call gpg
#       /path           Call gpg via that path, if it is executable

pgp-encrypt-type
# Specifies content-type for pgp encrypted messages.
# Possible values are: application/pgp, text/plain, text/x-pgp


pgp-interactive
# Run pgp/gpg signing and encryption always on interactive mode

pgp-sign-type
# Specifies content-type for pgp signed messages.
# Possible values are: application/pgp, text/plain, text/x-pgp

pgp-version
# What pgp use on sending of mail: pgp2, pgp5, gpg

$globalsection
#-----------------------------------------------------------------------
#
#   General global options
#

allow-setuid
# If set, running Elm as setuid is not prevented.

hostdomain
# Name of domain we're in
#
# Default value is from "hostfullname" option or
# from "hostname" option passed to gethostbyname() or 
# from $LOCALDOMAIN environment variable or
# from domain -file or from getdomainname()
#
# First character of this option value is '.' 
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
#
# See also: name-resolution

hostfullname
# Name of FQDN we're in
#
# - Is used when looking UUCP address 
#   hostfullname!username
#
# Default value is from "hostname" option passed to 
# gethostbyname() or from "hostname" and "hostdomain"
# option catenated.
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
# 
# See also: mailname, name-resolution

hostname
# Name of machine we're on
#
# - Is used when looking UUCP address 
#   hostname!username
#
# Default value is from "hostfullname" option or
# from gethostname() or from uname()
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
#
# See also: mailname, name-resolution, hostfullname

mailname
# That is name used for after the @ -character on addresses 
# and aliases of that. It similar than "alternatives" 
# option, but includes only part after the @ -character. 
#
# First name on mailname -list must be FQDN.
# Only ASCII characters are allowed on names.
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
#
# Normally that is hostfullname, hostname
#
# If on "mailer" option have "use-domain=yes"
# then first name from this option is used for 
# adding "@mail.domain" to email addresses.
#
# If first name on mailname -list is (none) or not include "."
# then "hostfullname" elmrc used is used instead, when sending mail.
#
# If value is "none", then 
#    - "hostfullname" elmrc used is used instead, when 
#      sending mail.
#    - no any address with @mail.domain -part is considered 
#      to be local.
#
# See also: mailer, alternatives, hostfullname, hostname, name-resolution

name-resolution
# This tells how default values for "hostname", "hostfullname",
# "hostdomain" and "mailname" elmrc options are generated.
#
# This option includes list of keywords:
#       none                    None of values are selected
#       gethostname             Use gethostname()
#       lookup                  Use gethostbyname()
#       getdomainname           Use getdomainname()
#       mailname-file           Use /etc/mailname (on
#                                 Debian systems) 
#       getifaddrs              Use getifaddrs() to
#                                 fill interface addresses
#                                 to "mailname" elmrc option
#
# This option accepts two forms:
#    - Absolute form where used options are listed
#    - Additive form where changes from compile
#      time default are listed:
#        +gethostname     -gethostname
#        +lookup          -lookup
#        +getdomainname   -getdomainname
#        +mailname-file   -mailname-file
# These two forms can not be mixed.
#
# NOTE: Interpreted as ASCII only (handled on first pass before @charset option
#       is parsed)
#
#
# See also: hostname, hostfullname, hostdomain, mailname

map-text-dir
# Default directory for map files (text)        (normally $lib/elm.map.txt)
# See also: map-bin-dir

map-bin-dir
# Default directory for map files (binary)      (normally $lib/elm.map.bin)
# See also: unidata, bindata, map-text-dir

user-map-dir
# Default directory for user map files          (normally $lib/elm.user.map)
# This gives directory location for files referenced with usermap-file:
# on global elm.hashmarks file.

$section
#-----------------------------------------------------------------------
#
#   Mailer options
#

background-wait-time
# If = 0  wait mailer to completion
#    > 0  wait background_wait_time seconds for completion
#         if not completed in this time, let it go to background
#
#         (completion of mailing is still reported if user have
#          not exited in that time when mailer have completed)

mailer
# This tells type of mailer, value can be one of
#             unknown, sendmail, submitmail, execmail
#
# After that parameter there can be following additional options:
#       path=                   gives path of mailer
#       add-from=dont,  add-from=yes,
#       use-domain=no,  use-domain=yes,         
#       supported-bodytype=7bit, supported-bodytype=8bit,
#       supported-bodytype=binary
#       supports-dsn=no, supports-dsn=yes
#       verify=no, verify=yes 
#       allow-set-sender=no, allow-set-sender=yes
#
# With mailers unknown, sendmail, and execmail also following option
# is available
#       sending-display=no, sending-display=yes
#
# Options are separated by ; -character
# Example:
#     mailer = sendmail; path=/usr/sbin/sendmail; add-from=dont
#
# With elmrc option 
#          use-mailer-library = smtp 
# type of mailer can also be one of
#       sendmail-bs, submission
#
# Also with smtp library following additional option is available
# when using mailer = submission
#       server=             gives hostname of submission server
#
# sending-display=yes is assumed with smtp library (with mailer 
# sendmail-bs or submission). Disable with sending-display=no.
#
# Example:
#    mailer = submission; server=smtp.example.com; allow-set-sender=yes
# NOTE: SMTP Authentication is not supported (and submission may require it).
#
# See also: add-sender, use-mailer-library

add-sender
# This option controls is Sender: header when user specifies From: -header
# or envelope sender address (aka Return-Path).
#
# Possible values include:
#	       	no		Add Sender: header only when there is
#			   	more than  one address on From: -header.
#		yes		Add Sender: header also when user
#				specifies From: -header or user changes
#				changes envelope sender address (aka Return-Path).
#		auto		If mailer is local or mail domain can
#				be verified (or verify is disabled), add 
#				Sender: header when user
#				specifies From: -header or user changes
#				changes envelope sender address (aka Return-Path).
#
# Value "auto" is default.  Also boolean ON, OFF, TRUE, FALSE, YES and NO
#  values are allowed.
#
# If there is more than one address on From: -header, 
#   Sender: -header is always added.
#
# See also: mailer


$section
#-----------------------------------------------------------------------
#
#   Library options
#

use-library
# Specify tags for shared libraries, which should be loaded.
# These libraries are loaded on startup and relocated to variables
# "use-base-library", "use-connect-library" and "use-mailer-library",
# "use-config-library".
#
# See also: use-base-library, use-connect-library, use-mailer-library,
#           use-config-library

use-base-library
# Specify tags for shared libraries, which should be loaded.

use-config-library
# Specify tags for shared libraries, which should be loaded.
#
# This includes shared libraries which are assumed
# to change default elmrc values. 

use-connect-library
# Specify tags for shared libraries, which should be loaded.

use-mailer-library
# Specify tags for shared libraries, which should be loaded.

