#@(#)$Id: elmrc-info,v 1.8.4.3 1999/11/07 17:32:56 hurtta Exp $
# Elm Version 2.4ME+
#
#$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.
#
# The "###" lines mean that you do not have a value set and the system
# default will be used.  The value shown was the default at the time
# this file was created.  Yes...the default could have changed between
# then and now.
#

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

fullname
# The full user name for outbound mail

maildir
# where to save my mail to, default directory is "Mail"

mailpermissions
# permissions to be given to newly-created saved mail files, default rw-------
  
tmpdir
# where to place temporary files, default directory is "/tmp"

receivedmail
# where to save received messages to, default file is "=received"

editor
# what editor to use ("none" means simulate Berkeley Mail)

alteditor
# name of editor to use for replies that have text

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

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

sentmail
# where to save copies of outgoing mail to, default file is "=sent"

calendar
# where to save calendar entries

sortby
# how to sort folders, "Reverse Sent" by default

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)

aliassortby
# how to sort the alias list, "Name" by default

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

attribution
# attribution string for replies ('%s' is the author of original message)

prefix
# prefix sequence for indenting included message text in outgoing messages...

weedout
# what headers I DON'T want to see, ever.

bounceback
# threshold for bouncing copies of remote uucp messages...
# zero = disable function.

timeout
# Set the main prompt timeout for resynching...

autocopy
# automatically copy message being replied to into buffer?

copy
# save a copy of all outbound messages?

resolve
# emulate the mailx message increment mode (only increment after
# something has been 'done' to a message, either saved or deleted,
# as opposed to simply each time something is touched)?

weed
# enable the weedout list to be read?

metamail
# This tells path of metamail program
#
# That version (Elm 2.4ME+) does not use Metamail's companion programs 
# (suchs 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

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?
# Because 8-bit data is not allowed in headers, 
# it is STRONGLY recommended that this is left set to OFF

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

noheaderfwd
# when messages are copied into the outbound buffer, don't include headers?
# when forwarding 	
# (Notice that messages are not copiend to outbound buffer when
#  mimeworward = ON)


titles
# display message title when displaying pages of message?

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

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

movepage
# when using the page commands (+ - <NEXT> <PREV>) change the current
# message pointer...?

pointnew
# start up by pointing to the first new message received, if possible?

signature
# ".signature" file to append to outbound messages...

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

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

sigdashes
# do we want dashes above signatures? (News 2.11 compatibility and convention)

alwayskeep
# should the default be to keep unread messages in the incoming mailbox?

alwaysstore
# should the default be to store read messages to the "received" folder?

alwaysdelete
# should the default be to delete messages we've marked for deletion?

pager
# program to use for displaying messages ('builtin' is recommended)

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

builtinlines
# This is used to determine if the builtin pager should be used on some
# messages even if you would usually use an external pager program.
# There are two ways of determining whether the builtin pager should be
# used. If you want any message that is shorter than "n" lines to use the
# internal pager, set the parameter to "n".  If you want the builtin
# pager to be used if the message is "m" lines shorter than the number of
# lines on your screen set the parameter to be "-m".  Setting the
# parameter to zero will result in the message always being sent through
# your external pager.

keepempty
# should we keep folders from which all messages are deleted?

keypad
# are we running on an HP terminal and want HOME, PREV, NEXT, etc...?

softkeys
# are we running on an HP terminal and want softkeys available too?
# (this implies "keypad=ON" too)

alternatives
# alternative addresses that I could receive mail from (usually a
# forwarding mailbox) and don't want to have listed...

forms
# do we want to be able to mail out AT&T Mail Forms?

userlevel
# are we good at it?  beginner (0), intermediate (1), expert (2)

names
# just show the names when expanding aliases?

arrow
# should we use the "->" rather than the inverse video bar?

menu
# should we display the three-line 'mini' menu?

metoo
# would you like a copy of a message you send to an alias you are on?

ask
# should the message disposition questions be displayed(ON) or
# auto-answered(OFF) with the default answers when we resync or
# change folders?

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

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

charset
# name of Character Set used with MIME text/plain Content-type
# US-ASCII is default. Be aware that if you use a national charset
# elm probably needs metamail to display US-ASCII. Special value
# DISPLAY means that Charcter Set used in content-type is same
# which the display supports (see: displaycharset)

displaycharset
# name of Character Set which the display supports. This is independent
# of the above "charset". This is also copied to environment variable 
# MM_CHARSET when metamail is called. This is used only as default
# on systems which supports locale. In these systems LC_CTYPE locale
# is mapped to Character Set. Mapping is given in file elm.mimecharsets
# on elm library directory or on file .elm/mime.charsets

dsn-success
# If TRUE, success Delivery-Status-Notifications are asked by default.

compatcharsets
# list of Character Sets, which are superset of US-ASCII
# so we know that we can display messages with charset=US-ASCII without
# help of metamail. 
# NOTE: That same information can be given on .elm/mime.charsets file with 
# ';MIME-subset=US-ASCII' qualifier -- that is preferred method.

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

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.

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.

convert-comment-to-fullname
# Elm 2.4ME+ PL55 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
# compatibilty of older versions of Elm.

usetite
# would you like to use termcap/terminfo ti/te entries?

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

readmsginc
# Value by which message count is incremented while reading a new mailbox.
# Setting this value to a number larger than one will speed up the time it
# takes to read a large mailbox when using a slow terminal.
# Actual increments depends both of readdatapercentinc and readmsginc
# See also: readdatapercentinc

sleepmsg
# time in seconds which Elm will wait after displaying a transient message
# and before erasing it.  Can be 0 or positive integer.

textencoding
# Type of encoding to be put into the MIME Content-Transfer-Encoding header.
# Usual values are 7bit or 8bit.
#
# -- NOT Used in this version of elm (2.4 PL24 ME7) or ELM 2.4ME+ PLxx (25)
# Now elm analyzes mail when sending and does that encoding of quoted-printable
# when necessary.

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

showto
# if this variable is ON, Elm will show who the message is to rather than
# who it is from in the headers display.

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

pagealternative
# Should Elm use "pager" for display one part of multipart/alternative,
# if there are found one part which can be displayed. If not
# set, Elm uses "pager" for display one part of multipart/alternative,
# if are parts are displayable.

pagemultipart
# Should Elm use "pager" to display MIME multipart messages
# with unknown subparts or with unknown subtype?

pagesigned
# Should Elm use "pager" to display MIME multipart/signed
# with unknown signing protocol ?

mimeforward
# This option controls how Elm will forward messages when MIME is defined.
#	ON: Causes Elm to send the message as a MIME attachment 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 attachment.

quoteforward
# Forwarded messages are quoted like replies, rather than included
# with "Forwarded message" and "End of forwarded message" banners 
# above and below. This don't have effect if "mimeforward" is TRUE.

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

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

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)

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 directiry

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-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

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

lock-folder
# if set, elm will lock a folder, when it is open. 
#
# NOTICE: To locked folder is not possible to deliver mail. 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
