c_addrcodec(): CID 1549184 (not on [next])
[s-mailx.git] / nail.rc
blobe077366bb7a86ec1cf43f3bcc45b72e74bcc7432
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 (the internal variable) *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.24 / 2022-03-26
16 #--MKREL-END--
18 ## Variables
20 # The standard POSIX 2008/Cor 2-2016 mandates the following initial settings
21 # which are established independendly from this file:
22 # [a]   noallnet, noappend, asksub, noaskbcc, noaskcc, noautoprint,
23 # [b-e] nobang, nocmd, nocrt, nodebug, nodot, escape="~",
24 # [f-i] noflipr, nofolder, header, nohold, noignore, noignoreeof,
25 # [j-o] nokeep, nokeepsave, nometoo, nooutfolder,
26 # [p-r] nopage, prompt="? ", noquiet, norecord,
27 # [s]   save, nosendwait, noshowto, nosign, noSign,
28 # [t-z] toplines="5"
30 # Notes:
31 # - In this implementation:
32 #   + *sendwait* is set by default (and has extended meaning).
33 #   + no*onehop* does not exist.
34 #     (To pass options through to the MTA, either add them after a "--"
35 #     separator on the command line or set the *mta-arguments* variable.)
36 # - *hold, *keep*, and *keepsave* are deliberately set below.
37 # (Keep in SYNC: mx/nail.h:okeys, ./nail.rc, ./nail.1:"Initial settings"!)
39 # Adjustments of standard imposed default- as well as other settings follow.
40 # - Some of the latter are not portable and may thus have no effect with
41 #   other Mail(1) / mailx(1) / mail(1) programs.
42 # - "wysh" is one of the "Command modifiers" and is not portable: before v15 it
43 #   changes the syntax of some old-style commands to sh(1)ell style quoting,
44 #   also see "COMMANDS" -> "Shell-style argument quoting" in the manual.
45 # - Availability of entries marked [OPTION] is a compile-time decision.
47 # If threaded mode is activated, automatically collapse thread.
48 set autocollapse
50 # Enter threaded mode automatically.
51 #set autosort=thread
53 # Append rather than prepend when writing to mbox automatically.
54 # Has no effect unless *hold* is unset (it is set below).
55 # This is a traditional entry and should usually be set.
56 set append
58 # Confirm sending of messages:
59 set asksend
61 # Uncomment this in order to get coloured output in $PAGER (if possible).
62 #set colour-pager
63 # If your $PAGER is less(1) or lv(1) you will usually be served with
64 #  ? wysh set PAGER=less; environ unset LESS
65 #  ? wysh set PAGER=lv; environ unset LV
67 # Assume a CRT-like terminal and invoke $PAGER if output does not fit on
68 # the screen.  (Set crt=0 to always page; value treated as number of lines.)
69 set crt
71 # When entering compose mode, directly startup into $EDITOR, as via `~e'.
72 # If the value is "v", startup into $VISUAL instead, as via `~v'.
73 #set editalong=v
75 # When spawning an editor in compose mode (`~e', `~v', *editalong*), allow
76 # editing of headers.
77 set editheaders
79 # Startup into interactive mode even if the (given) mailbox is empty.
80 set emptystart
82 # When `reply'ing etc. name parts and comments are stripped from receiver
83 # addresses unless this variable is set.
84 set fullnames
86 # [OPTION] Add more entries to the history as is done by default.
87 # The latter will cause the built-in editor to save those entries, too.
88 # (The *history-file* variable controls persistency of the history.)
89 set history-gabby=all history-gabby-persist
91 # Do not move read messages of system mailboxes to MBOX by default since this
92 # is likely to be irritating for most users today; also see *keepsave*.
93 set hold
95 # Quote the original message in replies with "> " as usual on the Internet.
96 # POSIX mandates tabulator ("wysh set indentprefix=$'\t'") as default.
97 set indentprefix="> "
99 # Honour Mail-Followup-To: headers when replying etc.
100 set followup-to-honour=ask-yes
102 # Mark messages that have been answered.
103 set markanswered
105 # Try to circumvent false or missing MIME Content-Type descriptions.
106 # Do set a value for extended behaviour (see the manual).
107 #set mime-counter-evidence
108 set mime-counter-evidence=0b1111
110 # Control loading of mime.types(5) file, "s"ystem and/or "u"ser, etc.
111 # Builtin types exist and may be sufficient.  The default equals "us".
112 #set mimetypes-load-control
114 # Do not remove empty (MBOX) system mailboxes.  (_No_ empty (MBOX) mailbox
115 # at all if $POSIXLY_CORRECT a.k.a. *posix* is set!)
116 # This may be relevant for privacy since other users could otherwise create
117 # them with different permissions.
118 set keep
120 # Do not move `save'd or `write'n message to $MBOX by default since this is
121 # likely to be irritating for most users today; also see *hold*.
122 set keepsave
124 # An informational prompt (and see "Gimmicks" below).
125 # Of interest may also be \${^ERRQUEUE-EXISTS} and \${^ERRQUEUE-COUNT}.
126 # Note the _real_ evaluation occurs once used (see *prompt* manual entry).
127 #wysh set prompt='?\$?!\$!/\$^ERRNAME[\${account-name}#\${mailbox-display}]? '
129 # Automatically quote the text of the message that is responded to.
130 set quote
132 # When replying, do not merge From: and To: of the original message
133 # into To:.  Instead old From: -> new To:, old To: -> merge Cc:.
134 set recipients-in-cc
136 # When responding to a message, try to answer in the same character set
137 # (which is subject to `charsetalias' expansion, though).
138 #set reply-in-same-charset
140 # Honour Reply-To: headers when replying etc.
141 set reply-to-honour=ask-yes
143 # [OPTION] Outgoing messages are sent in UTF-8 if possible, otherwise LATIN1.
144 # Note: it is highly advisable to read the section "Character sets" of the
145 # manual in order to understand all the possibilities that exist to fine-tune
146 # charset usage (variables also of interest: *ttycharset*, *charset-8bit*,
147 # *sendcharsets-else-ttycharset*; and of course we inherit the $LC_CTYPE /
148 # $LC_ALL / $LANG environment variables and react upon them).
149 set sendcharsets=utf-8,iso-8859-1
151 # Display real sender names in header summaries instead of only addresses.
152 set showname
154 # Show recipients of messages sent by the user himself in header summaries.
155 set showto
157 ## Commands
159 # Most commands are not portable to other Mail(1) / mailx(1) / mail(1)
160 # programs, which is why most commands are commented out.  To remain portable,
161 # place anything specific in its own file, and then
162 #   set mailx-extra-rc=~/.my-file"
163 # in $MAILRC (usually ~/.mailrc).
164 # The below use the \ command modifier to avoid `commandalias' checks
166 # Map ISO-8859-1 to LATIN1, and LATIN1 to CP1252.
167 # (These mappings are not applied to character sets specified by other
168 # variables, e.g., *sendcharsets*).
169 #\charsetalias iso-8859-1 latin1  latin1 cp1252
171 # Only include the selected header fields when printing messages
172 # (`headerpick' is not portable, so use the standard `retain')
173 retain date sender from to cc subject message-id mail-followup-to reply-to
174 #\headerpick type retain from_ date sender from to cc subject \
175 #   message-id mail-followup-to reply-to
176 # - when forwarding messages
177 #\headerpick forward retain subject date sender from to cc
178 # - and do not include these when saving message, etc.
179 #\if "$features" =@ ,+regex,
180 #  \headerpick save ignore '^Original-.*$' '^X-.*$'
181 #\end
183 ## Some pipe-TYPE/SUBTYPE entries
185 # HTML as text, inline display via lynx(1).
186 #\if "$features" !@ ,+filter-html-tagsoup,
187 #   \set pipe-text/html='?* lynx -stdin -dump -force_html'
188 #\endif
190 # "External body", URL type supported only.
191 #\wysh set pipe-message/external-body='?* echo $MAILX_EXTERNAL_BODY_URL'
193 # PDF display, asynchronous display: via `mimeview' command only.
194 #\wysh set pipe-application/pdf='?=&@\
195 #   trap "rm -f \"${MAILX_FILENAME_TEMPORARY}\"" EXIT;\
196 #   trap "trap \"\" INT QUIT TERM; exit 1" INT QUIT TERM;\
197 #   mupdf "${MAILX_FILENAME_TEMPORARY}"'
199 ## Gimmicks
201 # More key bindings for the Mailx-Line-Editor (when in interactive mode).
202 #\if terminal && "$features" =@ +key-bindings
203 #   \bind base $'\e',d mle-snarf-word-fwd
204 #   \bind base $'\e',$'\c?' mle-snarf-word-bwd
205 #   \bind base $'\e',f mle-go-word-fwd
206 #   \bind base $'\e',b mle-go-word-bwd
207 #   \bind base $'\cL' mle-clear-screen
208 #   \bind compose :kf1 ~v
209 #\endif
211 # Coloured prompt for the Mailx-Line-Editor (when in interactive mode).
212 #\if terminal && "$features" =@ +mle && "$features" =@ +colour
213 #   \colour 256 mle-position fg=202
214 #   \colour 256 mle-prompt fg=203
215 #   \colour 256 mle-error bg=124
216 #   \colour iso mle-position ft=bold
217 #   \colour iso mle-prompt fg=brown
218 #   \colour iso mle-error bg=red
219 #   \colour mono mle-position ft=reverse
220 #   \colour mono mle-prompt ft=bold
221 #   \colour mono mle-error ft=reverse
222 #\endif
224 # Install file-extension handlers to handle MBOXes in various formats.
225 #\filetype \
226 #   bz2 'bzip2 -dc' 'bzip2 -zc' \
227 #   gpg 'gpg -d' 'gpg -e' \
228 #   gz 'gzip -dc' 'gzip -c' \
229 #   xz 'xz -dc' 'xz -zc' \
230 #   zst 'zstd -dc' 'zstd -19 -zc' \
231 #   zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
233 # If mail is send from cron scripts and iconv(3) is compiled it, it could be
234 # that sending fails because of invalid (according to locale) character input.
235 # This undesired event can be prevented as follows, the (possibly) resulting
236 # octet-stream message data can be read nonetheless via
237 # *mime-counter-evidence*=0b1111:
238 #\if ! terminal && "$LOGNAME" == root
239 #   \set mime-force-sendout
240 #\endif
242 # s-it-mode