nail.1: an "option" is command line, the rest are "variables"

[s-mailx.git] / nail.rc

#--MKRC-START--
#@ /etc/s-nail.rc - configuration file for S-nail(1)
#--MKRC-END--
#@ The syntax of this file is interpreted as follows:
#@ - A lines' leading whitespace is removed.
#@ - Empty lines are ignored.
#@ - Any other line is a command line.  Such lines can be spread over
#@   multiple lines if the newline character is "escaped" by placing
#@   a backslash character \ as the last character of the line; any leading
#@   whitespace of follow lines is ignored, trailing whitespace before the
#@   escaped newline is not.
#@ - The number sign # is the comment-command and causes the (joined) line
#@   (content) to be ignored.  No other form of comments exist.
#--MKREL-START--
#@ S-nail(1): v14.9.0-pre2 / 2016-10-31
#--MKREL-END--

## The standard POSIX 2008/Cor 2-2016 mandates the following initial settings:
# [a]   noallnet, noappend, asksub, noaskbcc, noaskcc, noautoprint,
# [b-e] nobang, nocmd, nocrt, nodebug, nodot, escape="~",
# [f-i] noflipr, nofolder, header, nohold, noignore, noignoreeof,
# [j-o] nokeep, nokeepsave, nometoo, nooutfolder,
# [p-r] nopage, prompt="? ", noquiet, norecord,
# [s]   save, nosendwait, noshowto, nosign, noSign,
# [t-z] toplines="5"
# Notes:
# - *hold, *keep*, *keepsave* and *sendwait* are deliberately set below.
# - no*onehop* doesn't exist in this implementation.
#   (To pass options through to the MTA, either add them after a "--"
#   separator on the command line or set the *sendmail-arguments* variable.)
# (Keep in SYNC: ./nail.h:okeys, ./nail.rc, ./nail.1:"Initial settings"!)

## The remaining content adjusts the standard-imposed default settings.
# Note that some of the following flags are specific to S-nail(1) and may thus
# not work with other Mail(1) / mailx(1) programs.
# Entries are marked [OPTION] if their availability is compile-time dependent

## Variables

# If threaded mode is activated, automatically collapse thread
set autocollapse

# Enter threaded mode automatically
#set autosort=thread

# Append rather than prepend when writing to mbox automatically.
# This has no effect unless *hold* is unset (it is set below)
set append

# Ask for a message subject.
set ask

# *bsdannounce* prints a header summary on folder change and thus complements
# *header* on a per-folder basis (it is meaningless unless *header* is set)
set bsdannounce

# Uncomment this in order to get coloured output in $PAGER (if possible).
#set colour-pager
# Btw., if your $PAGER is less(1) or lv(1) you will usually be served, as
# documented for $PAGER in the manual, very well by doing, e.g., less(1):
#  set PAGER=less
#  environ unset LESS

# Assume a CRT-like terminal and invoke a $PAGER if output doesn't fit on a
# the screen.  (Set crt=0 to always page; value treated as number of lines)
set crt

# Define date display in header summary
#set datefield="%R %m-%d" datefield-markout-older="   %g-%m-%d"

# When composing messages a line consisting of `.' finalizes a message
#set dot

# Startup into $EDITOR (or $VISUAL) in compose mode ("automatic `~e'")
#set editalong

# When spawning an editor in compose mode (*editalong*, ~e), edit headers
set editheaders

# Startup into interactive mode even if the (given) mailbox is empty
set emptystart

# When replying to or forwarding a message the comment and name parts of email
# addresses are removed unless this variable is set.
set fullnames

# [OPTION] Add more entries to the history as is done by default.
# The latter will cause the builtin editor to save those entries, too
set history-gabby history-gabby-persist

# Do not move read messages of system mailboxes to MBOX by default since this
# is likely to be irritating for most users today; also see *keepsave*
set hold

# Quote the original message in replies by "> " as usual on the Internet
set indentprefix="> "

# Mark messages that have been answered
set markanswered

# Try to circumvent false or missing MIME Content-Type descriptions.
# Do set a value for extended behaviour (see the manual)
#set mime-counter-evidence
set mime-counter-evidence=0xE

# Control loading of mime.types(5) file: the value may be a combination of the
# letters "s" and "u": if "u" is seen ~/.mime.types will be loaded if possible;
# "s" adds /etc/mime.types, if available; setting this without any value uses
# only a set of builtin mimetypes; the default behaviour equals "us".
# An extended syntax that allows loading of other, specified files is available
# if the value contains an equal sign "=", see the manual for more
#set mimetypes-load-control

# Do not remove empty mail folders.
# This may be relevant for privacy since other users could otherwise create
# them with different permissions
set keep

# Do not move `save'd or `write'n message to mbox by default since this is
# likely to be irritating for most users today; also see *hold*
set keepsave

# When writing mailbox files we strip Content-Length: and Lines: header fields
# from edited / changed messages, because S-nail doesn't deal with these
# (non-standard) fields -- and since other MUAs may rely on their content, if
# present, it seems more useful to strip them than to keep them, now that they
# became invalid; set this to include them nonetheless
#set keep-content-length

# An informational prompt (and see "Gimmicks" below).
# Note the _real_ evaluation occurs once used (see *prompt* manual entry)
#wysh set prompt='?\${-exit-status}[\${-account-name} \${-mailbox-display}]? '

# Automatically quote the text of the message that is responded to
set quote

# On group replies, specify only the sender of the original mail in  To: and
# mention it's other recipients in the secondary Cc: instead of placing them
# all together in To:
set recipients-in-cc

# When responding to a message, try to answer in the same character set
#set reply-in-same-charset

# [OPTION] Outgoing messages are sent in UTF-8 if possible, otherwise LATIN1.
# Note: it is highly advisable to read the section "Character sets" of the
# manual in order to understand all the possibilities that exist to fine-tune
# charset usage (variables also of interest: *ttycharset*, *charset-8bit*,
# *sendcharsets-else-ttycharset*; and of course we inherit the $LC_CTYPE /
# $LC_ALL / $LANG environment variables and react upon them)
set sendcharsets=utf-8,iso-8859-1

# When sending a message wait until the MTA (including the builtin SMTP one)
# exits before accepting further commands.  Only with this variable set errors
# reported by the MTA will be recognizable!
set sendwait

# Display real sender names in header summaries instead of only addresses
set showname

# Show recipients of messages sent by the user himself in header summaries
set showto

## Commands

# Only include these selected header fields when forwarding messages
fwdretain subject date from to cc

# Only include the selected header fields when printing messages
retain from_ date from to cc subject message-id mail-followup-to reply-to

## Some pipe-TYPE/SUBTYPE entries

# HTML as text, inline display via lynx(1)
#if $features !@ +filter-html-tagsoup
#   set pipe-text/html='lynx -stdin -dump -force_html'
#endif

# PDF display, asynchronous display
#wysh set pipe-application/pdf='@=&@\
#   trap "rm -f \"${NAIL_FILENAME_TEMPORARY}\"" EXIT;\
#   trap "trap \"\" INT QUIT TERM; exit 1" INT QUIT TERM;\
#   mupdf "${NAIL_FILENAME_TEMPORARY}"'

## Gimmicks

# More key bindings for the Mailx-Line-Editor (when in interactive mode)
#if terminal && $features =@ +key-bindings
#   bind base $'\e',d mle-snarf-word-fwd
#   bind base $'\e',$'\c?' mle-snarf-word-bwd
#   bind base $'\e',f mle-go-word-fwd
#   bind base $'\e',b mle-go-word-bwd
#endif

# Coloured prompt for the Mailx-Line-Editor (when in interactive mode)
#if terminal && $features =@ +mle && $features =@ +colour
#   colour 256 mle-position   fg=202
#   colour 256 mle-prompt     fg=red
#   colour iso mle-position   ft=reverse
#   colour iso mle-prompt     fg=red
#   colour mono mle-position  ft=reverse
#   colour mono mle-prompt    ft=bold
#endif

# s-it-mode