nail.1: last fixes
[s-mailx.git] / nail.rc
blob7c6e74bb527ac156c68ef67fe705848651e947a0
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 #@ - Leading and trailing " \t\n" + *ifs* whitespace is removed.
6 #@ - Empty lines are ignored.
7 #@ - Any other line is a command line.  Such lines can be spread over
8 #@   multiple lines if the newline character is "escaped" by placing
9 #@   a reverse solidus character \ as the last character of the line; any
10 #@   leading whitespace of follow lines is ignored, trailing whitespace before
11 #@   the escaped newline 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(1): v14.9.0-rc1 / 2017-07-01
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* doesn't 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 # Adjust the standard-imposed default variable settings.
37 # Some of the following variables are not portable and may thus have no effect
38 # with other Mail(1) / mailx(1) programs.
39 # Entries are marked [OPTION] if their availability is compile-time dependent.
41 # If threaded mode is activated, automatically collapse thread
42 set autocollapse
44 # Enter threaded mode automatically
45 #set autosort=thread
47 # Append rather than prepend when writing to mbox automatically.
48 # This has no effect unless *hold* is unset (it is set below)
49 set append
51 # Ask for a message subject.
52 set ask
54 # Uncomment this in order to get coloured output in $PAGER (if possible).
55 #set colour-pager
56 # Btw., if your $PAGER is less(1) or lv(1) you will usually be served, as
57 # documented for $PAGER in the manual, very well by doing, e.g., less(1):
58 #  ? wysh set PAGER=less; environ unset LESS
60 # Assume a CRT-like terminal and invoke a $PAGER if output doesn't fit on a
61 # the screen.  (Set crt=0 to always page; value treated as number of lines)
62 set crt
64 # Startup into $EDITOR (or $VISUAL) in compose mode ("automatic `~e'")
65 #set editalong
67 # When spawning an editor in compose mode (*editalong*, ~e), edit headers
68 set editheaders
70 # Startup into interactive mode even if the (given) mailbox is empty
71 set emptystart
73 # When replying to or forwarding a message the comment and name parts of email
74 # addresses are removed unless this variable is set
75 set fullnames
77 # [OPTION] Add more entries to the history as is done by default.
78 # The latter will cause the built-in editor to save those entries, too
79 set history-gabby history-gabby-persist
81 # Do not move read messages of system mailboxes to MBOX by default since this
82 # is likely to be irritating for most users today; also see *keepsave*
83 set hold
85 # Quote the original message in replies by "> " as usual on the Internet
86 # Historically this was a tabulator, as in "wysh set indentprefix=$'\t'"
87 set indentprefix="> "
89 # Mark messages that have been answered
90 set markanswered
92 # Try to circumvent false or missing MIME Content-Type descriptions.
93 # Do set a value for extended behaviour (see the manual)
94 #set mime-counter-evidence
95 set mime-counter-evidence=0xE
97 # Control loading of mime.types(5) file: the value may be a combination of the
98 # letters "s" and "u": if "u" is seen ~/.mime.types will be loaded if possible;
99 # "s" adds /etc/mime.types, if available; setting this without any value uses
100 # only a set of built-in mimetypes; the default behaviour equals "us".
101 # An extended syntax that allows loading of other, specified files is available
102 # if the value contains an equal sign "=", see the manual for more
103 #set mimetypes-load-control
105 # Do not remove empty (MBOX) system mailboxes (or _no_ empty (MBOX) mailbox
106 # at all if $POSIXLY_CORRECT / *posix* are set!).
107 # This may be relevant for privacy since other users could otherwise create
108 # them with different permissions
109 set keep
111 # Do not move `save'd or `write'n message to mbox by default since this is
112 # likely to be irritating for most users today; also see *hold*
113 set keepsave
115 # When writing mailbox files we strip Content-Length: and Lines: header fields
116 # from edited / changed messages, because S-nail doesn't deal with these
117 # (non-standard) fields -- and since other MUAs may rely on their content, if
118 # present, it seems more useful to strip them than to keep them, now that they
119 # became invalid; set this to include them nonetheless
120 #set keep-content-length
122 # An informational prompt (and see "Gimmicks" below).
123 # Note the _real_ evaluation occurs once used (see *prompt* manual entry)
124 #wysh set prompt='?\${?}!\${!}[\${account-name}#\${mailbox-display}]? '
126 # Automatically quote the text of the message that is responded to
127 set quote
129 # When replying, do not merge From: and To: of the original message
130 # into To:.  Instead old From: -> new To:, old To: -> merge Cc:.
131 set recipients-in-cc
133 # When responding to a message, try to answer in the same character set
134 # (which is subject to `charsetalias' expansion, though)
135 #set reply-in-same-charset
137 # [OPTION] Outgoing messages are sent in UTF-8 if possible, otherwise LATIN1.
138 # Note: it is highly advisable to read the section "Character sets" of the
139 # manual in order to understand all the possibilities that exist to fine-tune
140 # charset usage (variables also of interest: *ttycharset*, *charset-8bit*,
141 # *sendcharsets-else-ttycharset*; and of course we inherit the $LC_CTYPE /
142 # $LC_ALL / $LANG environment variables and react upon them)
143 set sendcharsets=utf-8,iso-8859-1
145 # When sending a message wait until the MTA (including the built-in SMTP one)
146 # exits before accepting further commands.  Only with this variable set errors
147 # reported by the MTA will be recognizable!
148 set sendwait
150 # Display real sender names in header summaries instead of only addresses
151 set showname
153 # Show recipients of messages sent by the user himself in header summaries
154 set showto
156 ## Commands
158 # Most commands are not portable to other Mail(1) / mailx(1) programs, which is
159 # why most commands are commented out.  To remain portable, place anything
160 # specific in its own file, then "set mailx-extra-rc=~/.my-file" in $MAILRC
161 # (usually ~/.mailrc).
163 # Map ISO-8859-1 to LATIN1, and LATIN1 to CP1252.
164 # (These mappings are not applied to character sets specified by other
165 # variables, e.g., sendcharsets).
166 #charsetalias iso-8859-1 latin1  latin1 cp1252
168 # Only include the selected header fields when printing messages
169 # `headerpick' is not portable, so use the standard `retain'
170 retain from_ date from to cc subject message-id mail-followup-to reply-to
171 #headerpick type retain from_ date from to cc subject \
172 #   message-id mail-followup-to reply-to
173 # ...when forwarding messages
174 #headerpick forward retain subject date from to cc
175 # ...and don't include these when saving message, etc.
176 #if [ "$features" =@ +regex ]
177 #  headerpick save ignore '^Original-.*$' '^X-.*$'
178 #end
180 ## Some pipe-TYPE/SUBTYPE entries
182 # HTML as text, inline display via lynx(1)
183 #if [ "$features" !@ +filter-html-tagsoup ]
184 #   set pipe-text/html='lynx -stdin -dump -force_html'
185 #endif
187 # PDF display, asynchronous display
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 #endif
203 # Coloured prompt for the Mailx-Line-Editor (when in interactive mode)
204 #if terminal && [ "$features" =@ +mle ] && [ "$features" =@ +colour ]
205 #   colour 256 mle-position fg=202
206 #   colour 256 mle-prompt fg=red
207 #   colour iso mle-position ft=reverse
208 #   colour iso mle-prompt fg=red
209 #   colour mono mle-position ft=reverse
210 #   colour mono mle-prompt ft=bold
211 #endif
213 # Install file-extension handlers to handle MBOXes in various formats
214 #filetype \
215 #   bz2 'bzip2 -dc' 'bzip2 -zc' \
216 #   gpg 'gpg -d' 'gpg -e' \
217 #   gz 'gzip -dc' 'gzip -c' \
218 #   xz 'xz -dc' 'xz -zc' \
219 #   zst 'zstd -dc' 'zstd -19 -zc' \
220 #   zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
222 # s-it-mode