make-config.in: complete path (leftover of [807f64e2], 2015-12-26!)
[s-mailx.git] / nail.rc
blob818514794e3639915c9472d10238f56c360b3a6a
1 #--MKRC-START--
2 #@ /etc/s-nail.rc - configuration file for S-nail(1)
3 #--MKRC-END--
4 #@ The syntax of this file is interpreted as follows:
5 #@ - Any leading and trailing whitespace (space, tabulator, newline: " \t\n"),
6 #@   and all members of *ifs-ws* are removed.
7 #@ - Empty lines are ignored.
8 #@ - Any other line is a command line.  Such lines may spread over multiple
9 #@   lines if a reverse solidus character \ is placed as the last character of
10 #@   all lines except the final one; any leading whitespace of follow lines is
11 #@   removed, but trailing whitespace before "escaped newlines" is not.
12 #@ - The number sign # is the comment-command and causes the (joined) line
13 #@   (content) to be ignored.
14 #--MKREL-START--
15 #@ S-nail v14.9.11 / 2018-08-08
16 #--MKREL-END--
18 ## Variables
20 # The standard POSIX 2008/Cor 2-2016 mandates the following initial settings:
21 # [a]   noallnet, noappend, asksub, noaskbcc, noaskcc, noautoprint,
22 # [b-e] nobang, nocmd, nocrt, nodebug, nodot, escape="~",
23 # [f-i] noflipr, nofolder, header, nohold, noignore, noignoreeof,
24 # [j-o] nokeep, nokeepsave, nometoo, nooutfolder,
25 # [p-r] nopage, prompt="? ", noquiet, norecord,
26 # [s]   save, nosendwait, noshowto, nosign, noSign,
27 # [t-z] toplines="5"
29 # Notes:
30 # - *hold, *keep*, *keepsave* and *sendwait* are deliberately set below.
31 # - no*onehop* does not exist in this implementation.
32 #   (To pass options through to the MTA, either add them after a "--"
33 #   separator on the command line or set the *mta-arguments* variable.)
34 # (Keep in SYNC: ./nail.h:okeys, ./nail.rc, ./nail.1:"Initial settings"!)
36 # Adjustments of standard imposed default- as well as other settings follow.
37 # - Some of the latter are not portable and may thus have no effect with
38 #   other  Mail(1) / mailx(1) / mail(1) programs.
39 # - "wysh" is one of the "Command modifiers" and is not portable: before v15 it
40 #   changesthe syntax of some old-style commands to sh(1)ell style quoting,
41 #   also see "COMMANDS" -> "Shell-style argument quoting" in the manual.
42 # - Availability of entries marked [OPTION] is a compile-time decision.
44 # If threaded mode is activated, automatically collapse thread
45 set autocollapse
47 # Enter threaded mode automatically
48 #set autosort=thread
50 # Append rather than prepend when writing to mbox automatically.
51 # Has no effect unless *hold* is unset (it is set below).
52 # This is a traditional entry and should usually be set.
53 set append
55 # Ask for a message subject.
56 set ask
58 # Uncomment this in order to get coloured output in $PAGER (if possible).
59 #set colour-pager
60 # If your $PAGER is less(1) or lv(1) you will usually be served with
61 #  ? wysh set PAGER=less; environ unset LESS
62 #  ? wysh set PAGER=lv; environ unset LV
64 # Assume a CRT-like terminal and invoke $PAGER if output does not fit on
65 # the screen.  (Set crt=0 to always page; value treated as number of lines.)
66 set crt
68 # When entering compose mode, directly startup into $EDITOR, as via `~e'.
69 # If the value is "v", startup into $VISUAL instead, as via `~v'.
70 #set editalong=v
72 # When spawning an editor in compose mode (`~e', `~v', *editalong*), allow
73 # editing of headers.
74 set editheaders
76 # Startup into interactive mode even if the (given) mailbox is empty.
77 set emptystart
79 # When `reply'ing etc. name parts and comments are stripped from receiver
80 # addresses unless this variable is set.
81 set fullnames
83 # [OPTION] Add more entries to the history as is done by default.
84 # The latter will cause the built-in editor to save those entries, too.
85 # (The *history-file* variable controls persistency of the history.)
86 set history-gabby history-gabby-persist
88 # Do not move read messages of system mailboxes to MBOX by default since this
89 # is likely to be irritating for most users today; also see *keepsave*.
90 set hold
92 # Quote the original message in replies with "> " as usual on the Internet.
93 # POSIX mandates tabulator ("wysh set indentprefix=$'\t'") as default.
94 set indentprefix="> "
96 # Mark messages that have been answered.
97 set markanswered
99 # Try to circumvent false or missing MIME Content-Type descriptions.
100 # Do set a value for extended behaviour (see the manual).
101 #set mime-counter-evidence
102 set mime-counter-evidence=0b1111
104 # Control loading of mime.types(5) file, "s"ystem and/or "u"ser, etc.
105 # Builtin types exist and may be sufficient.  The default equals "us".
106 #set mimetypes-load-control
108 # Do not remove empty (MBOX) system mailboxes.  (_No_ empty (MBOX) mailbox
109 # at all if $POSIXLY_CORRECT a.k.a. *posix* is set!)
110 # This may be relevant for privacy since other users could otherwise create
111 # them with different permissions.
112 set keep
114 # Do not move `save'd or `write'n message to $MBOX by default since this is
115 # likely to be irritating for most users today; also see *hold*.
116 set keepsave
118 # An informational prompt (and see "Gimmicks" below).
119 # Note the _real_ evaluation occurs once used (see *prompt* manual entry).
120 #wysh set prompt='?\$?!\$!/\$^ERRNAME[\${account-name}#\${mailbox-display}]? '
122 # Automatically quote the text of the message that is responded to.
123 set quote
125 # When replying, do not merge From: and To: of the original message
126 # into To:.  Instead old From: -> new To:, old To: -> merge Cc:.
127 set recipients-in-cc
129 # When responding to a message, try to answer in the same character set
130 # (which is subject to `charsetalias' expansion, though).
131 #set reply-in-same-charset
133 # [OPTION] Outgoing messages are sent in UTF-8 if possible, otherwise LATIN1.
134 # Note: it is highly advisable to read the section "Character sets" of the
135 # manual in order to understand all the possibilities that exist to fine-tune
136 # charset usage (variables also of interest: *ttycharset*, *charset-8bit*,
137 # *sendcharsets-else-ttycharset*; and of course we inherit the $LC_CTYPE /
138 # $LC_ALL / $LANG environment variables and react upon them).
139 set sendcharsets=utf-8,iso-8859-1
141 # When sending a message wait until the MTA (including the built-in SMTP one)
142 # exits before accepting further commands.  Only with this variable set errors
143 # reported by the MTA will be recognizable!
144 set sendwait
146 # Display real sender names in header summaries instead of only addresses.
147 set showname
149 # Show recipients of messages sent by the user himself in header summaries.
150 set showto
152 ## Commands
154 # Most commands are not portable to other Mail(1) / mailx(1) / mail(1)
155 # programs, which is why most commands are commented out.  To remain portable,
156 # place anything specific in its own file, and then
157 #   set mailx-extra-rc=~/.my-file"
158 # in $MAILRC (usually ~/.mailrc).
160 # Map ISO-8859-1 to LATIN1, and LATIN1 to CP1252.
161 # (These mappings are not applied to character sets specified by other
162 # variables, e.g., *sendcharsets*).
163 #charsetalias iso-8859-1 latin1  latin1 cp1252
165 # Only include the selected header fields when printing messages
166 # `headerpick' is not portable, so use the standard `retain'
167 retain from_ date from to cc subject message-id mail-followup-to reply-to
168 #headerpick type retain from_ date from to cc subject \
169 #   message-id mail-followup-to reply-to
170 # ...when forwarding messages
171 #headerpick forward retain subject date from to cc
172 # ...and do not include these when saving message, etc.
173 #if [ "$features" =@ +regex ]
174 #  headerpick save ignore '^Original-.*$' '^X-.*$'
175 #end
177 ## Some pipe-TYPE/SUBTYPE entries
179 # HTML as text, inline display via lynx(1).
180 #if [ "$features" !@ +filter-html-tagsoup ]
181 #   set pipe-text/html='@* lynx -stdin -dump -force_html'
182 #endif
184 # "External body", URL type supported only.
185 #wysh set pipe-message/external-body='@* echo $MAILX_EXTERNAL_BODY_URL'
187 # PDF display, asynchronous display: via `mimeview' command only.
188 #wysh set pipe-application/pdf='@=&@\
189 #   trap "rm -f \"${MAILX_FILENAME_TEMPORARY}\"" EXIT;\
190 #   trap "trap \"\" INT QUIT TERM; exit 1" INT QUIT TERM;\
191 #   mupdf "${MAILX_FILENAME_TEMPORARY}"'
193 ## Gimmicks
195 # More key bindings for the Mailx-Line-Editor (when in interactive mode).
196 #if terminal && [ "$features" =@ +key-bindings ]
197 #   \bind base $'\e',d mle-snarf-word-fwd
198 #   \bind base $'\e',$'\c?' mle-snarf-word-bwd
199 #   \bind base $'\e',f mle-go-word-fwd
200 #   \bind base $'\e',b mle-go-word-bwd
201 #   \bind base $'\cL' mle-clear-screen
202 #   \bind compose :kf1 ~v
203 #endif
205 # Coloured prompt for the Mailx-Line-Editor (when in interactive mode).
206 #if terminal && [ "$features" =@ +mle ] && [ "$features" =@ +colour ]
207 #   colour 256 mle-position fg=202
208 #   colour 256 mle-prompt fg=red
209 #   colour iso mle-position ft=reverse
210 #   colour iso mle-prompt fg=red
211 #   colour mono mle-position ft=reverse
212 #   colour mono mle-prompt ft=bold
213 #endif
215 # Install file-extension handlers to handle MBOXes in various formats.
216 #filetype \
217 #   bz2 'bzip2 -dc' 'bzip2 -zc' \
218 #   gpg 'gpg -d' 'gpg -e' \
219 #   gz 'gzip -dc' 'gzip -c' \
220 #   xz 'xz -dc' 'xz -zc' \
221 #   zst 'zstd -dc' 'zstd -19 -zc' \
222 #   zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
224 # s-it-mode