1 S - n a i l / S - m a i l x N e w s
2 ====================================
4 mdocmx(7) anchors are denoted by a number-sign #: typing
5 "^A ANCHOR" while reading the man(1)ual in a capable less(1)
6 will scroll to the manual's Point-Of-Interest, and pointing
7 a web- browser to the "#ANCHOR" of the online manual works.
9 v14.9.2 ("Crested tit"), 2017-08-01
10 -----------------------------------
12 This is a bugfix release but which ships some improvements, too.
13 It silently replaces v14.9.1 from yesterday, which was broken.
15 Credits, in order of commit appearance: Felix Fontein, Paul Vojta,
16 Ralph Corderoy, Christos Zoulas, Gavin Troy, Gaetan Bisson.
18 We welcome Christos Zoulas in THANKS.
20 Apologies to Viktor Szépe for the false spelling of his name in
21 the v14.9.0 announcement.
23 NOTES, ChangeLog (packager-affine)
24 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
26 - fakeroot support was blindly taken from Debian and broken.
27 (Gavin Troy, Gaetan Bisson)
32 - In compose mode the MLE allows empty lines again.
34 - We no longer require a writable $HOME#561. Due to false code
35 flow (but but but: with correct comment) a non-writable $HOME
36 entry in /etc/password (i.e., from getpwuid(3)) would lead to
37 a crash. (Felix Fontain; Ralph Corderoy)
39 - Two faulty string operations slipped into the IMAP code,
40 resulting in a crash and a "is-same-host" test that would fail
41 for IMAPS connections like `save'#244 or `copy'#147 because of an
42 implicit IMAP protocol for the target of those operations (thus
43 IMAP != IMAPS). (Paul Vojta)
45 - The MLE tab-expansion will now automatically append a "/" if
46 there is only one possible expansion and that is a directory,
47 saving the user one <TAB>. (Christos Zoulas)
49 - New `~I'#307 command escape is like `~i'#308 but does not append
52 - `localopts'#197 gained an optional second argument.
53 It is now possible to specify that any macro `call'#133ed
54 will have localopts enabled, and it is possible to fixate the
55 setting so that it cannot be reverted.
57 - *@*#331 should now act completely compatible to the sh(1)ell,
58 thus obsoleting my hysteric warnings in the v14.9.0 announcement.
60 - The `Lreply'#198, `reply'#232, `Reply'#231 series as well as
61 `mail'#200 now manage the error status *!*#325.
62 I.e., there are now errors like *^ERR*#327-DESTADDRREQ,
63 ^ERR-NODATA, ^ERR-PERM and similar. It is not perfect yet,
64 because $DEAD#559 may have been written (with *save*#483) or not,
67 `Lreply' and `reply' have been rewritten rather completely
68 indeed. They join Reply-To: and Mail-Followup-To: dependent on
69 the context (i.e., *reply-to-honour*#481, *followup-to-honour*#391,
70 see "Mailing lists"#10 for the picture), and if they did, use
71 this list as the receivers exclusively. It now honours
72 *recipients-in-cc*#474 even for such addressees. (And now i wonder
73 whether i should have credited Paul Vojta for that.)
75 Also `Lreply' would have crashed for mails with Reply-To: but
76 without *reply-to-honour*#481 set. We now have a test.
78 git(1) shortlog (edited)
79 ^^^^^^^^^^^^^^^^^^^^^^^^
81 670aabb6 a_amv_var_check_vips(): FIX code to match comment (Felix Fontein)..
82 3dcdaa83 THANKS: Felix Fontein
83 3745e002 FIX [81d7f4d8] (IMAP: try (hard) to reinstantiate..) (Paul Vojta)
84 33b2834f FIX [81d7f4d8] (IMAP: try (hard) to reinstantiate..) (Paul Vojta)..
85 1cc0d3de Allow non-writable $HOME (Felix Fontain, Ralph Corderoy)
86 32e5c7c2 MLE: KHT: auto-append / for directories at once (Christos Zoulas)
87 e2bb54b7 THANKS: Christos Zoulas
88 f593fc18 make-config.sh: do NOT skip fakeroot paths
89 (Gavin Troy, Gaetan Bisson)
90 4fe971ea FIX [4047a432] possible bound excess in memset()!
92 v14.9.0 ("Long-tailed tit"), 2017-07-16
93 ---------------------------------------
95 This is a major feature release which took about ~22 months (24
96 less two) of development to complete, and which imposed massive
97 changes under the hood, but also quite a lot of user visible
98 changes, including some **backward incompatibilities**.
99 As usual, "s-nail -d" will show obsoletion warnings.
101 We gain noticeable improvements regarding scriptability and its
102 reliability, but also for interactive use cases, especially
103 notable to users is our completely new M(ailx)L(ine)E(ditor) that
104 supports rather real tabulator expansion and program-mode-context-
105 sensitive key bindings.
107 We now support macros with arguments, which can be `shift'ed,
108 a `return' status can be used, and a `vexpr' multiplexer offers
109 some arithmetic and string operations. `commandalias'es are
110 recursive, further command modifier prefixes, like `ignerr', give
111 a hand that we otherwise could not offer. In compose-mode the new
112 `~^' command escape allows some message and attachment access, and
113 can be used, e.g., to implement things like custom headers, and
114 has been especially designed for scripted access via the new
115 *on-compose-splice* and *on-compose-splice-shell* hooks.
117 S-nail will move (more or less) backward-incompatibly to sh(1)ell
118 compatible argument quoting (documented in "COMMANDS"), and an
119 increasing number of commands do support this already: new ones
120 exclusively, some old ones have either been switched (like
121 `localopts'), others -- noticeably `set' -- can be switched to the
122 new syntax with a `wysh' command modifier prefix. E.g.:
125 # Be careful to choose sh(1)ell-style on _entire_ line!
126 localopts yes; wysh set verbose; ignerr eval "${@}"; return $?
128 ? commandalias call echo boo-boo
129 ? commandalias xv call __xv
131 ? commandalias xv '\'call __xv
134 Calling the latter `xv' for `list' will give more detailed command
135 information, including which kind of argument is used.
137 I have not managed to implement the three features i have started
138 this development cycle for, these are thus subject to further
139 development, just like wysh for message-list argument commands to
140 support, e.g., negation, wysh for `if' and consorts, the --
141 terminator to finally overcome the ridiculous requirement to quote
142 entire shell commands filenames for commands like `pipe.
145 Credits, in order of commit appearance: Antonio Radici,
146 Aharon Robbins, Mike Frysinger, Predrag Punosevac, Michael Convey,
147 Hariskar, Rudolf Sykora, Martin Neitzel, Gavin Troy,
148 Salvatore Bonaccorso, Todd C. Miller, Sergey Matveev, Robert Elz,
149 Mantas Mikulėnas, Respiranto, Jens Schleusener, Walter Alejandro
150 Iglesias, Ralph Corderoy, David Levine, Lyndon Nerenberg,
151 Thomas Dickey, Afan, Justin Ellingwood, Ingo Schwarze,
152 Viktor Szépe, Gaetan Bisson, Juan RP, William Yodlowsky,
153 Hilko Bengen, Matthew Dillon, Colin Watson, Donald Mugnai,
154 Stephen Isard, Jürgen Daubert, Sven Neuhaus, trondd, Ismael Bouya,
155 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
156 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
157 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, Xin LI.
159 We welcome Antonio Radici, Mike Frysinger, Predrag Punosevac,
160 Michael Convey, Rudolf Sykora, Todd C. Miller, Robert Elz,
161 Jens Schleusener, Walter Alejandro Iglesias, Thomas Dickey, Afan,
162 Justin Ellingwood, Viktor Szépe, Juan RP, Matthew Dillon,
163 Colin Watson, Donald Mugnai, Sven Neuhaus, Ismael Bouya,
164 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
165 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
166 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, and
169 Apologies: Sergey Matveev.
170 Members of the Roff community which await progress.
172 NOTES, ChangeLog (packager-affine)
173 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
175 * This release brings some backward incompatibilities, outlined
176 in the following. Most users will not be affected, and we have
177 added a lot of compatibility cruft, but that will vanish in v15.
180 * The configuration and build system has changed.
181 Packagers have received updated package files.
183 o Anything which was WANT_xy before is now OPT_xy, and
184 compiled-in paths and values, like PREFIX or PAGER, have
185 gained a VAL_ prefix (thus VAL_PREFIX and VAL_PAGER).
187 This is _not_ true for non-persistent or environmental values,
188 e.g., DESTDIR, CC, etc., and also not for the overwritable
189 program variables during configuration, e.g., $awk.
191 o SENDMAIL -> VAL_MTA, SENDMAIL_PROGNAME -> VAL_MTA_ARGV0,
192 MAILSPOOL -> VAL_MAIL.
193 And NAIL -> VAL_MAILX, though this is still a lie.
195 o The make system now needs config..build..install or
196 all..install or tangerine (config..build..test..install).
197 Some constants which some experts may want to fine-tune have
198 been moved to config.h. Usual adjustments+doc via make.rc.
200 o The `build' phase can be parallelized by setting the $MAKEJOBS
201 environment variable, e.g., "make MAKEJOBS=-j4 build".
202 Note this variable is not tracked in the configuration.
205 o Unless DESTDIR is set an uninstallation script will be
206 installed along with the rest (see INSTALL file for more).
208 o Set the new OPT_CROSS_BUILD to avoid feature runtime tests,
209 only compile- and link-availability will be tested. (Juan RP)
211 o VERBOSE is implemented straight, but must be given at
212 configuration time in order to become honoured.
215 o ADDCFLAGS / ADDLDFLAGS -> EXTRA_CFLAGS / EXTRA_LDFLAGS.
217 o The LD_LIBRARY_PATH etc. building processes will skip any path
218 which contains the string "fakeroot". (Hilko Bengen)
220 o We honour a set $SOURCE_DATE_EPOCH#578 environment variable to
221 an extend that allows reproducible tests, which is why the
222 repository gained a [test-out] branch with some expected plain
223 text outputs. (reproducible-builds.org; Colin Watson)
225 The new *log-prefix*#417 variable aids in improving the
226 reproducibility of error messages.
228 o These are upward compatible changes.
230 * "make OPENSSL_API_COMPAT=0x10100000 all" should work.
232 * Internal and environment variables are now explicitly _defined_
233 and _tracked_ after variable handling has been rewritten
236 o This means that, e.g., "$ password=NOT_SECRET s-nail" will
237 **NOT** work no more, since *password*#450 is an internal
240 o But if you do, e.g., "? set TMPDIR=~/tmp", then this will
241 also be reflected in the program environment (it is an
242 environment variable) and thus affect child processes.
244 o Therefore we no longer have `setenv' and `unsetenv'.
246 o To integrate any other environment variable transparently
247 into our variable management, the new command `environ'#169
248 needs to be used, e.g., "? environ set NEWVAR=value" or
249 "? environ link EXISTINGVAR".
251 - -H#62 and -L#65 have been decoupled:
252 it used to be -e#59 -L#65 instead!
254 - *NAIL_{HEAD,TAIL}* have been obsoleted in favour of
255 *message-inject-head*#425 and *message-inject-tail*#426.
257 *NAIL_HIST{FILE,SIZE}* have been obsoleted in favour of
258 *history-file*#399 and *history-size*#402.
260 *NAIL_EXTRA_RC* has been obsoleted in favour of
261 *mailx-extra-rc*#420.
263 *batch-exit-on-error* has been obsoleted by *errexit*#380, which
264 works just like the POSIX sh(1)ell "set -e" construct; the
265 `ignerr'#110 command modifier (`-' for command escapes in compose
266 mode, and see below) can be used to ignore command errors even
267 then. (This will remain even if we at some later time will
268 support at least some of the sh(1) constructs which "swallow"
269 failures with set -e.)
271 *bsdannounce* is obsolete, the feature is integrated in
272 *header*#396 as this is much more useful. (This is however also
273 dependent upon the also new but well-known $POSIXLY_CORRECT#576
274 <> *posix*#465, but that is just how it is; these affect more
275 behaviour, and increasing.)
277 - Colour support has been changed backward in- and upward (from
278 user interface side) compatibly, see the manual section
279 "Coloured display"#17.
281 + New commands: `colour'#142 and `uncolour'#143.
282 You can define context-sensitive, terminal-capability-
283 sensitive settings, e.g.:
285 if terminal && [ "$features" =% +colour ]
286 colour iso view-header ft=bold,fg=magenta,bg=cyan
287 colour 256 view-header ft=bold,fg=208,bg=230 subject,from
288 colour mono view-header ft=bold
289 colour mono view-header ft=bold,ft=reverse subject,from
292 + The variable *colour-pager*#366 defines whether colour and font
293 attribute sequences should be generated when viewing something
296 + Set the variable *colour-disable*#365 to turn colour off
297 without affecting established settings.
299 + It is deduced via termcap(5) (see below) whether the terminal
300 supports colors, e.g., "$ s-nail -Stermcap=Co#256".
301 This is also true if we don't have termcap support.
303 + Support for 256-colour terminals. (Gavin Troy)
305 - `source'#259 series support shell pipes if the last character
306 of the "filename" ends with a vertical bar |, e.g.,
308 ? source 'gpg -qd ~/.s-nailrc-private.gpg |'
310 - Shell pipes are also supported as targets for `move'#210,
311 `copy'#147 etc., yet unfortunately not with via a sh(1)ell token
312 parser, so that the target still has to be a single argument.
314 ? copy . '| cat; echo huhu'
316 - Support for custom headers via the new `~^'#323 compose-mode
317 command escape and in addition, or alternatively, with the
318 internal variable *customhdr*#370, which also can be covered by
319 `localopts'#197. (Sergey Matveev)
321 + Support of $ORGANIZATION has been dropped.
323 + Command escape `~e'#302 supports _any_ header.
325 + Command escape `~^'#323 supports _any_ header.
327 - New -:#51 command line option can be used to more easily select
328 which startup files should be loaded, e.g., -:/ loads none.
331 - `account'#122s and *folder-hook*#387s now have `localopts'#197
334 - A first simple form of compose-mode hooks has been implemented:
335 *on-compose-enter*#443, *on-compose-leave*#444 and
336 *on-compose-cleanup*#442 can be set to macros which get invoked
337 at appropriate times.
338 For the `resend'#236 series there is *on-resend-enter*#448 and
339 *on-resend-cleanup*#447: this is very likely to change once
340 true message access is possible even in this mode.
342 An even more powerful mechanism is available via the also new
343 *on-compose-splice*#445 and *on-compose-splice-shell*#446 hooks.
344 These are executed in child processes and communicate with the
345 parent via their standard input and output, and therefore can
346 do anything and act as if they were the user.
348 `localopts'#197 are enabled and cannot be disabled (and extend
349 until the message is sent).
350 (Jens Schleusener, Rudolf Sykora)
352 ? set on-compose-splice=ocs
355 echo Splice protocol version is $ver
357 read hl; vput vexpr es substring "${hl}" 0 1
359 echoerr 'Failed to read header list, bailing out'
361 elif [ "$hl" @i!% ' cc' ]
362 echo '~^header insert cc Diet is your <mirr.or>'
363 read es; vput vexpr es substr "${es}" 0 1
365 echoerr 'Failed to insert Cc:, bailing out'; echo '~x'
370 - "The .netrc file"#36
372 + gained support for comments.
373 (Walter Alejandro Iglesias, Ralph Corderoy)
375 + `netrc'#213 now has a "load" subcommand.
377 + the new *netrc-pipe*#438 obsoletes OPT_AGENT and
378 *agent-shell-lookup*, and can be used to load an encrypted
381 ? set netrc-lookup netrc-pipe='gpg -qd ~/.netrc.gpg'
383 I.e., this is in usual .netrc syntax and thus possibly much
384 nicer than saying "? source 'gpg -qd ~/.credentials.gpg |'".
386 - termcap(5) / terminfo(5) support has been changed backward in-
387 and upward (from user interface side) compatibly, please read
388 "On terminal control and line editor"#16.
390 + OPT_TERMCAP is by default enabled.
391 The new, by default enabled, configuration option
392 OPT_TERMCAP_VIA_TERMINFO can be used to (try to) use
395 + The variable *termcap*#541 can be used to freely define or
396 override terminal capabilities, and *termcap-disable*#543 will
397 disable interaction with the chosen library, leaving only
400 To use the so-called ca-mode on supporting terminals,
401 effectively turning S-nail into a fullscreen application,
402 *termcap-ca-mode*#542 must be set.
404 + The built-in line editor has been rather completely rewritten
405 to be the Mailx-Line-Editor (OPT_MLE, default yes), and
406 supports wide glyphs (if possible), infinite line lengths
407 (2 GB) and more. Tabulator expansion is no longer an option
408 (but needs fnmatch(3)).
410 + Optionally (OPT_KEY_BINDINGS, default yes) it has become
411 possible to freely define key bindings for the MLE via the new
412 `bind'#131 and `unbind'#132 commands. These key bindings can
413 make use of termcap(5) and/or terminfo(5) names. The MLE will
414 install a set of default bindings (unless there is a set
415 *line-editor-no-defaults*#416), more so with OPT_TERMCAP,
418 Sufficient support provided, one can now, e.g., type "p " and
419 then collect the message numbers to type, scrolling forward
420 and backward via key-bindings, without loosing the line
421 content, then commit the final line.
423 + OPT_EDITLINE and OPT_READLINE support have been dropped.
424 The new MLE should not miss anything. Does it?
425 Tip: in an UTF-8 locale try "? !touch /tmp/hall{,öchen}" and
426 then autocomplete that: once, then ^Q, and again.
428 - `source'#259 can be used in `call'#133ed macros.
429 What sounds so innocent replaced an entire machinery and got rid
430 of a brilliant idea of Kurt Shoens from the 70s, but which never
431 worked with Nail/Heirloom extensions, namely macros, and in the
433 Accompanying this -X#79 can (dig multiline arguments and can) be
434 used to define macros and run them etc. Should work:
436 $ s-nail -X'define x {' -Xversion -Xx -X'}' -X'call x'
437 $ s-nail -X'source \' -X'"echo version|"' -Xx
439 Macros can be `undefine'#152d from within themselves, and re-
440 `define'#151d. It is still not possible to define macros
441 from within macros, and/or have inner macros, not to talk
442 about local scoping or anything more sophisticated such.
444 - -u#76 / $LOGNAME#567 ($USER) handling has been redefined,
445 and "-u USER" is now exactly the same as "-f %USER", and
446 $LOGNAME (and $USER) is actively set to the active user. (Afan)
448 $LOGNAME#567 is POSIX standardized and henceforth used and
449 preferred over $USER, which came from BSD. (Todd C. Miller)
451 - In the future (at least non-message-list) argument handling will
452 be changed backward-incompatibly to be sh(1)ell compatible (and
453 thus POSIX standardized), see "Shell-style argument quoting"#23.
454 New commands use it already today (`bind'#131, `colour'#142,
455 `headerpick'#188), some others (most importantly, `set'#247) can
456 be forced to do so via the new `wysh'#112 command prefix, as in:
458 ? wysh set message-inject-tail=$'\n--steffen'
459 ? bind base $'\cA,\x61' 'echo control-A and small a'
461 - We now actively manage *umask*#548: 0077 by default, but an
462 empty string will use the setting that is active upon startup.
463 Just like changes to (known) environment variables, this setting
464 will also be inherited by any child process.
465 (Walter Alejandro Iglesias)
467 - Anything SENDMAIL / *sendmail*-ish has been renamed to *mta*#433,
468 *mta-arguments*#434, *mta-no-default-arguments*#435 and
471 The reason is that in v15 we won't even have *smtp*: it is just
472 another form of MTA, and thus obsolete by itself.
473 Note that *mta-arguments* is now parsed via the shell-token
474 parser, so the following ends up exactly as desired.
476 ? set mta-arguments='-t -X "/tmp/my log"'
478 For now we support a hack that understands a file:// URL in
479 *mta*, too, but that is also the default if there is no protocol.
480 E.g.: "? set mta=smtp://a:b@xy.z"
482 - The "spamd" *spam-interface*#514 is obsolete. I haven't tested
483 it since my main machine died, it is error prone since it assumes
484 internals of the spamassassin wire protocol, and there never was
485 a speed improvement over "spamc". (However it could react upon
486 the "is-spam" state of a message, which "spamc" doesn't allow.)
488 - The new *inbox*#410 variable will henceforth be looked up when
489 searching for a primary system mailbox (as in "? File %"),
490 followed by the usual $MAIL#568 and compile-time defined local
491 mailspool search. (Stephen Isard, Jürgen Daubert)
493 - The semantic of -a#53 and `~@'#296 have been changed, and both
494 commands now use the same syntax:
496 -a file[=input-charset[#output-charset]]
498 - New "failinvaddr" keyword for *expandaddr*#382.
500 - We finally "can" the so-called (by myself) "Dr. Problem" (a bit):
503 $ </dev/null s-nail -d:/ -sTrödler 'Dr. D. Iet <z@a.k>' 2>&1 |\
505 s-nail: >>> To: "Dr. D. Iet" <z@a.k>
507 This can be done via the new `addrcodec'#124, too, note this
508 supports multiple modes (and the `vput'#111 command modifier):
510 $ echo 'addrcodec e Dr. Diet <to@fu.soj> Curd' | s-nail -#:/
511 "Dr. Diet Curd" <to@fu.soj>
513 - All commands with the string "codec" in their name use different
514 argument quoting, namely none at all, please read
515 "Raw data arguments for codec commands"#24.
516 This means that `urlcodec'#276 (and `imapcodec'#606) has
517 slightly changed semantics.
518 And, while here: there is a new `shcodec'#249, too.
520 - We gained "Command modifiers"#20: `\'#109 (avoid expansion of
521 `commandalias'#144es), `vput'#111 (store result in variable),
522 `ignerr'#110 (ignore an error of the following command, even
523 if the new *errexit*#380 is set), `wysh'#112 (use shell-style
526 $ echo 'vput cwd resvar;echo $resvar' | s-nail -#:/
527 /home/steffen/src/nail.git
529 And the usual sh(1) stuff: `return'#242, `shift'#253, `eval'#171,
530 plus a `xcall'#285 stack-avoidance optimization (to be used in
531 place of a `call'#133 which would be the last called command).
532 And an "expr(1) like thing", yet simple, `vexpr'#281.
534 $ echo 'vexpr + 1 2' | s-nail -#:/
535 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000011
537 $ echo 'vput vexpr resvar + 1 2;echo $resvar' | s-nail -#:/
540 We actually start walking (*?*#324, *^*#326).
542 ? vput vexpr res regex 'bananarama' 'Bana(.+)' '\$1\$0'
543 ? echo $?/$^ERRNAME :$res:
545 ? vput vexpr res iregex 'bananarama' '(.+)rama' '\$1\$0'
546 ? echo $?/$^ERRNAME :$res:
547 0/NONE :bananabananarama:
549 The command `vpospar'#282 can be used to manage the stack of
550 positional parameters, i.e., much like "set --".
551 It also offers the possibility to save and restore the stack to
552 and from variables. Etc.
554 Btw., to contact the maintainer (make.rc variables
555 VAL_CONTACT_WEB and VAL_CONTACT_MAIL):
557 ? echo $contact-web; eval mail $contact-mail
559 - `if'#194 no longer performs automatic number conversion, we
560 use the explicit -lt, -gt etc. syntax of the sh(1).
561 Note: `if' will change to be almost identical to sh(1) if(1),
562 so please ensure proper test bracketing, even if it is less
565 Moreover, the default string comparison mode has changed to
566 case-sensitive, just like in the shell. This is because in the
567 future this crux with trigger characters will vanish and `if'
568 etc. will simply slurp in already expanded shell tokens, it will
569 act like the shell in that respect. We have modifiers, though,
570 yet only "@i" for case-insensitivity, also for regex matches:
573 i=`LC_ALL=C.utf8 s-nail -:/ -# -X '
575 \if [ "${ttycharset}" @i=% utf ]
580 \wysh set LC_ALL=${1}
582 \eval xcall cset_test "${@}"
586 \call cset_test C.UTF-8 POSIX.utf8 POSIX.UTF-8 \
587 en_EN.utf8 en_EN.UTF-8 en_US.utf8 en_US.UTF-8
589 [ $? -eq 0 ] && UTF8_LOCALE=$i
591 Please note the `eval' in 'eval xcall cset_test "${@}". This is
592 a difference of S-nail/mailx and the sh(1)ell that will remain,
593 as documented in "COMMANDS"#19: whereas the shell implements
594 a language and performs standardized expansions on the line
595 until finally the command is called, S-nail will decide the type
596 of command line parsing dependent on the seen command, and will
597 then perform a single expansion. Therefore "${@}" will expand
598 to multiple arguments if $# is greater 0, but it will expand to
599 the empty string otherwise, which is not furtherly expanded away
600 since it is meaningless like it is in the shell: therefore $#
601 will be 1 (the empty string) not 0.
603 - Using an explicit proto:// prefix should get you the desired
604 thing apart of *newfolders*#439, e.g.:
606 ? File maildir:///tmp/x.mdir
607 ? copy * file:///tmp/x.mbox
609 - New variable *record-files*#476 can be set to extend the meaning
610 of *record*#475. *record-resent*#477 was there already.
612 - New variable *ifs*#406 acts a bit like the sh(1)ell's $IFS for,
613 e.g., the new `read'#227 command.
615 There is a `readctl'#228 command which can be used to manage
616 the active channel used by `read'#227.
618 - The `~' alias for `call'#133 is gone.
620 - `mimetype'#202 only allows specification of a single type per
621 call, on the other hand no need to quote that.
623 - `mimeview'#206 must now be used explicitly to look at any
624 non-text MIME part, for normal display etc. purposes we only
625 support "copiousoutput"#593 MIME handlers.
627 - New *socks-proxy*#513 can be used to proxy all network traffic
628 over a SOCKS5 proxy. (Gaetan Bisson)
633 - The manual has seen another major overhaul, all the variables
634 are now documented in a single, sorted list, and many
635 clarifications should have been added. I hope it has become
637 (Predrag Punosevac, Michael Convey, Hariskar, Rudolf Sykora,
638 Respiranto, Thomas Dickey, Donald Mugnai)
640 - To support RFC 1524 a.k.a. .mailcap files (see below) many
641 "trigger"-characters have been added for *pipe-TYPE/SUBTYPE*#452,
642 which may (rarely) affect existing values.
643 The .mailcap support itself is not yet implemented.
645 - *mime-counter-evidence*#430 gained bit 4 (perform proper in-depth
646 content inspection as necessary; set to 0xE for all bits).
649 - Maildir paths are now created recursively as necessary.
652 - -M#66 and -m#67 options have been added to enforce a special
653 send mode that will flag standard input / the given file with
654 the specified / detected MIME 'Content-Type:'. This can be used
655 to directly send, e.g., HTML log output.
656 (Viktor Szépe, Ralph Corderoy)
658 - Disallow symlinks on writable files. Note this requires
659 O_NOFOLLOW support for the operating-system-call open(2), but
660 which has been standardized a long time ago.
663 - `retain'#241, `ignore'#195 etc. now differentiate in between
664 From (the From: header) and From_ (the MBOX ident).
666 In fact we now have a new `headerpick'#188 command which
667 is a multiplexer for all retain and ignore lists used, call it
668 without arguments to see the current setting(s).
669 In v15 only `headerpick' and the standard-imposed wrappers
670 `retain' and `ignore' will remain, all other wrappers will
671 vanish. Regular expressions can now be used if available:
674 headerpick type retain blahblahblah cc date from \
675 mail-followup-to message-id openpgp reply-to subject to \
677 #headerpick type ignore currently covers no fields
678 #headerpick save retain currently covers no fields
679 headerpick save ignore '^Original-.*$' '^X-.*$' '^DKIM.*$'
680 headerpick forward retain cc date from list-id \
681 mail-followup-to openpgp reply-to subject to
682 #headerpick forward ignore currently covers no fields
684 - `top'#268 has been rewritten completely, `Top'#267 is new.
685 It uses a built-in set of retain/ignore headers, but it is
686 possible to register a custom set via `headerpick'#188.
687 Also, *toplines*#544 has been extended a bit and the new
688 *topsqueeze*#545 variable may pimp your `top' experience.
690 ? headerpick top retain add subject
692 [-- Message 1 -- 87 lines, 4791 bytes --]:
693 Subject: Re: I can't dist to myself
696 3.22. bounce_delivered
698 - `features' has been dropped, `version'#280 extended.
700 - The *prompt*#467 handling has changed: we lost the capability to
701 expand \?, \@ and \$, instead new "private" variables *?*#324,
702 *account*#335, *mailbox-resolved*#419 and
703 *mailbox-display*#418 have been introduced, and the prompt
704 is completely shell expanded (thus twice with `wysh' or in v15),
705 as if dollar-single-quote quoted. We do support the reverse-
706 solidus escaped bracket notation for embedding characters which
707 should not be counted when calculating the width of the prompt.
708 The `colour'#142 command has a slot for the prompt colour.
709 We gained *prompt2*#468 as a second level prompt.
713 prompt='?\${?}!\${!}[\${account}#\${mailbox-display}]? '
715 - The filename "-" can be used as a receiver, e.g.,
717 $ echo Hey,\ you | s-nail -:/ -Sexpandaddr -sUB -
719 - The -s#74 command line option, the `~s'#315 command escape
720 as well as the corresponding slots of `~^'#323 will actively
721 strip [\r\n] from their value (Debian #419840).
723 - New `read'#227 and `echoerr'#162 commands, mostly for
724 *on-compose-splice*#445.
725 But also `echon'#163 and `echoerrn'#164, which do not write
728 - New variable *r-option-implicit*#473 may be helpful to those
729 who regulary need the functionality of the -r#72 command
730 line option. (Felipe Gasper, Martin Neitzel)
732 - By using new "pseudo-URLs" one can automatize the use of S/MIME
733 keys / (certificates / intermediate include certificates) with
734 passwords. E.g., to drive bob@exam.ple, set
735 *smime-sign-cert-bob@exam.ple* to the private key / certificate
736 pair as usual, the password lookup will then be performed for
737 bob@exam.ple.smime-cert-key, bob@exam.ple.smime-cert-cert and
738 bob@exam.ple.smime-include-certs.
739 Like this the password can be stored in an encrypted .netrc file
740 when *netrc-lookup*#437 and *netrc-pipe*#438 are set, or it may
741 be stored in an encrypted resource file that has been loaded via
742 `source'#259 as a simple *password*#450 variable.
744 Note that the prompting that happens as a last resort of
745 password lookup will still interfere with a possibly running
746 $PAGER#574 instance, dependent on the setting of *crt*#369, of
747 course. Proper job control handling and recognizing that we are
748 running $PAGER when doing that prompt is a TODO for v15. Sorry.
750 - Some commands, like `set'#247, `help'#191, `list'#196,
751 `mlist'#204 etc., now react upon the setting of *verbose*#551
752 and(/or) *debug*#373.
754 - `write'#284 uses iconv(3) as appropriate.
756 - *mbox-rfc4155*#422 has first been dropped, and was then
757 reintroduced with different semantics. Because, it can be
758 helpful if a messed up MBOX is read, in which case we henceforth
759 will warn you and point you to this:
762 \localopts yes; \wysh set mbox-rfc4155;\
763 \wysh File "${1}"; \eval copy * "${2}"
765 ? call mboxfix /tmp/bad.mbox /tmp/good.mbox
767 P.S. Here you see how weird the current thing still is, in v15:
770 localopts yes; set mbox-rfc4155; File "${1}"; copy * -- "${2}"
773 And also in v15 we will not apply (proper) so-called MBOXO
774 quoting, but instead (simply MIME) re-encode mail messages.
776 - `call_if'#134 is new and, different to "? ignerr call", silent
777 and not messing with the return status.
779 - The new *smime-ca-flags*#499 and *ssl-ca-flags*#527 can be used
780 to fine-tune X509_STORE_set_flags(3) a.k.a the X509 CA
781 certificate verification.
783 ? set ssl-ca-flags=partial-chain
784 ? wysh set smime-ca-flags="${ssl-ca-flags}"
786 Also, *ssl-curves*#532 for TLSv1.3.
788 - Socket connections use TLS S(erver)N(ame)I(ndication) as
789 appropriate (RFC 7817).
791 - `alternates'#127 checks arguments and supports `vput'#111.
792 It by default no longer replaces but appends alternates, unless
793 *posix*#465 mode is active. There is a new `unalternates'#128
794 command to remove alternates.
796 - A new `charsetalias'#137 command. (Pietro Cerutti, mutt#3925)
798 - New commands `filetype'#175 and `unfiletype'#176: in the future
799 we will no longer know any builtin filetypes, in fact we already
800 simulate .gz etc. via the new mechanism as necessary:
803 bz2 'bzip2 -dc' 'bzip2 -zc' \
804 gpg 'gpg -d' 'gpg -e' \
805 gz 'gzip -dc' 'gzip -c' \
806 xz 'xz -dc' 'xz -zc' \
807 zst 'zstd -dc' 'zstd -19 -zc' \
808 zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
810 - `~<'#294 now offers a "- [HERE-delimiter]" mode for pasting etc.
813 - `exit'#172 and `quit'#226 take an optional exit status.
814 (That is not fixated yet, though.)
816 - We have a useful -h / --help output. (Doug McIlroy)
818 - *encoding* obsoleted in favour of new *mime-encoding*#431, which
819 now defaults to base64.
821 - *allnet*#337 now works (broken since nail 10.00, 2002-09-29).
823 git(1) shortlog (abbreviated)
824 '''''''''''''''''''''''''''''
826 f01291d extract_date_from_from_(): dig more invalid MBOXes (Antonio Radici)..
827 df8768b Add *mime-counter-evidence* bit 4 (Aharon Robbins)..
828 d3fe980 Ftmp(): drop "mode" argument (not wrong: Mike Frysinger)..
829 86159db nail.1: we support searching, really (Predrag Punosevac)
830 5b61a08 nail.1: talk about address lists (again) (Michael Convey)..
831 0eeffc4 nail.1: try improve states / MBOX etc. relation (Michael Convey)
832 43ea039 nail.1: what is an environment variable (Michael Convey)
833 13e0804 nail.1: fix typo (Hariskar (archlinux Wiki))
834 03d6af5 nail.1: more on sortability (Rudolf Sykora)..
835 4da9043 Not "binary", but "boolean" variables! (Predrag Punosevac)..
836 c85f56d Support :d specifier for at least `from' (Martin Neitzel)..
837 b12e1ed Be more friendly when composing mails (Martin Neitzel)..
838 b50eac0 nail.1: use display/show not type/print (Michael Convey)..
839 6feafaf Add `search' alias for `from' (Predrag Punosevac)
840 a4e2612 Support 256-colour terminals (Gavin Troy)
841 8655aff Error framework: print UAGENT prefix (ident in pipes; Salvatore
843 e96baaa Introduce $LOGNAME, the POSIX equivalent of $USER (Todd C. Miller)
844 76e6364 Add `customhdr' (Sergey Matveev)..
845 ad58c91 Support *customhdr*, too (Sergey Matveev)..
846 6322e0a Support _any_ user header via ~e (Sergey Matveev)..
847 5d52578 Add -: command line option (Robert Elz)..
848 53b5f07 README: use git(1) --single-branch (Mantas Mikulėnas)
849 420131f Fix mispelling: can|to be send->sent (Respiranto (archlinux Wiki))
850 d6902e1 Add *on-compose-{enter,leave}* hooks (Jens Schleusener, Rudolf
852 abf2e5d .netrc: support comments (Walter Alejandro Iglesias, Ralph Corderoy)..
853 37e0c26 nail.1: .netrc comma separator was in original Berknet parser! (Ralph
855 40522c3 nail.1: use -v option to cat(1) if available (Thomas Dickey)
856 d8f7cd7 (BWDIC!) Redefine -u / $LOGNAME / $USER (Afan)..
857 e337e00 Support expansions in $MAIL!; more on `account's (Afan)..
858 d596d74 Compare *newfolders* case-insensitively (Justin Ellingwood)..
859 57744f9 Redefine *folder* / getfold->folder_query() / *HOME* (Justin
861 3c57c83 n_path_mkdir(): create recursively as necessary (Justin Ellingwood)
862 0bbe981 nail.1: fix spelling errors as by igor(1) (Ingo Schwarze)
863 f1a775b Add -M and -m options (Viktor Szépe, Ralph Corderoy)..
864 1bd8e48 Add *umask*, and set actively (Walter Alejandro Iglesias)..
865 6b1cd93 Now with *umask*, just drop fchmod(2)++ calls (Walter Alejandro
867 ba22166 Change make targets; add $MAILJOBS; don't track $DESTDIR (Gaetan
869 cd244b1 Add WANT_CROSS_BUILD make.rc option (Juan RP)..
870 95141f6 Tweak VERBOSE handling (William Yodlowsky)..
871 d74a18a mk-conf.sh:path_check(): skip any "fakeroot" path (Hilko Bengen)
872 10990e4 Add n_O_NOFOLLOW, disallow symlinks for writable files (Matthew
874 df4954c Add $SOURCE_DATE_EPOCH (reproducible-builds.org; Colin Watson)
875 dc92f2c savedeadletter()->sendout.c; tweak POSIX compliance (Ralph Corderoy)
876 20f3cd2 nail.1: more explicit `set' references instead of saying 'Set' (Donald
878 2d53b46 url_parse(): better take better care for path parts (Stephen Isard)..
879 21f0eaa mk-conf.sh: find terminfo on Sun (Thomas Dickey)..
880 e4ddaa8 Change n_iconv*() protos, add enum n_iconv_flags (Ralph Corderoy)..
881 1587069 FIX [44cec1f] (Fix "address" message specifications (John Dodson))..
882 e40e181 nail.1, nail.rc: set *sendwait* by default (Ralph Corderoy)
883 7adcf99 `write'++: !interactive: urlxenc() attachment paths (Ralph Corderoy)..
884 b14aae7 `write'++: !interactive:.. But now, really (Lyndon Nerenberg, David
886 5270bf1 Simplify *folder* (implicit trail solidus) (Stephen Isard, Ralph
888 a638bcf Add *typescript-mode*, set it for -# (Ralph Corderoy, Martin
890 053e19f Add *inbox* (Stephen Isard, and Jürgen Daubert)..
891 20e3240 Add OPT_ALWAYS_UNICODE_LOCALE (Predrag Punosevac)..
892 14b5a3a Make combinetime() overflow safe (Vincent Lefevre)..
893 7a657d9c cc-test.sh: add S/MIME disproofs via smime(1) (Sven Neuhaus)..
894 ae86c884 cmd1.c:__hprf(): compensate for add. bytes of UTF-8 seq.(s) (Martin
896 975e6869 (BWDIC!) Only rm sysboxes, unless *posix* (Walter A. Iglesias,
898 81e33751 Throw away file_expand() (Ismael Bouya)..
899 5ae556f8 Add *r-option-implicit* (Felipe Gasper, Martin Neitzel)..
900 33709163 nail.1: some more words for *inbox*, and such sort (Stephen Isard)
901 88c19049 mk-release.inc: place OpenPGP signatures last (learned from Paul
903 0ede309c Rudely fix the RFC 5322 dot-atom, the "Dr. Problem" (Dr. Werner Fink)
904 f797c27e FIX privsep.c, yes, vulnerability (wapiflapi)..
905 f2699449 FIX privsep.c vulnerability, II (forgot hostname!) (wapiflapi)
906 303d46cd FIX [3d7835fc] aka `~^' attachments, especially Content-ID: (Ralph
908 4ce4eb55 privsep.c: and just verify the box is also in CWD (wapiflapi)
909 25d9e6e2 Generate Content-ID: as applic. (Ralph Corderoy, Ken Hornstein, David
911 6409c886 nail.1: clarify/FIX doc. of \cX (Noel Chiappa, Random832)..
912 5a1c023c nail.1: furtherly clarify doc. of \cX (Doug McIlroy)..
913 d33294c2 mk-release.inc: use %B for $DATE_MAN (Baptiste Daroussin)..
914 eafa9411 (BWDIC!) Defaults for *datefield{-markout-older}* (Debian #855582;
916 5ab93627 MLE: set FEXP_NOPROTO for mle-complete expansions (Ralph Corderoy)
917 ada72661 ~<: add "- [HERE-delimiter]" for pasting etc. (Ralph Corderoy)
918 d4d46c42 Add `charsetalias', and use it (Pietro Cerutti, mutt#3925)
919 65e2b75f Redefine VIP handling of variables (Ralph Corderoy)..
920 162cafb7 *mime-counter-evidence*, bit 4: allow "soft" controls (Jörg
922 90861930 Readd removed fflush()/fseek() in between read and write..
923 [That should credit Jörg Schilling indeed]
924 aae47707 Tweak previous, and include O_CREAT in "a+" (Jörg Schilling)..
925 3e4441f8 a_main_usage(): new synopsis (Doug McIlroy)
926 8f61025b FIX icase hmaps (`charsetalias', `filetype', `mlist') (rain1)
927 2e6a811d a_termcap_init_var(): numerics not necessarily decimal (Thomas
929 9d58267f config.h+: add n_PATH_DEVNULL, use it instead of hardcoding (Xin LI)
930 8075cf00 Support *socks-proxy* (SOCKS5) (Gaetan Bisson)
935 The complete changelog of commits in between two versions OLD and
936 NEW can be inspected by using the git(1) `log' command:
938 $ git log --reverse --topo-order --abbrev-commit OLD..NEW
939 # Only topic branch headers (--no-merges for content commits only):
940 $ git log --oneline --reverse --topo-order --merges OLD..NEW
941 # Same, but truly accessible:
942 $ git log --oneline --reverse --topo-order --merges --parents OLD..NEW |
943 while read c1 c2 c3 c4 c5 c6; do
944 printf "%-24s: \$ git log --oneline --no-merges %s ^%s\n" \
945 "${c6}" "${c1}" "${c2}";
948 Entries for releases before v14.9.0 have been cut off and can be
949 found in the git(1) repository:
951 v14.8.0 - v14.8.16: $ git show v14.8.16:NEWS
952 v13 - v14.8.5 : $ git show v14.8.5:NEWS
953 9.0 - 12.5 : $ git show heirloom:ChangeLog
955 Also accessible via HTTPS?, just replace X.Y.Z accordingly:
957 \https?://git.sdaoden.eu/cgit/s-nail.git/tree/NEWS?h=vX.Y.Y
959 For even older releases you need to look into the [timeline]
960 branch, but no changelog has been administrated for them.