Mess! OpenSSL changed DEFINE_STACK_OF() 3.0 crap once again!! Sorry!
[s-mailx.git] / NEWS
blob3183147689af9769defa8ba9f7fa9cf7b8aeb25e
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.21 ("Tit escapes with a peanut"), 2021-01-21
10 --------------------------------------------------
12 I apologise for the inconvenience of yet another bugfix release.
13 It fixes a possible SMTP buffer overflow triggerable by
14 a malicious server as reported by Olav Mørkrid, and a socket code
15 memory access error that can be seen when using IMAP on at least
16 Solaris, which was reported by Jörg Schilling.
18 Yasuhiro Kimura helped to unconfuse problems that i attributed to
19 BSD make, but which were indeed shell errors, most notably mksh.
20 Excuses are due to the forgiving and friendly Simon Gerraty (BSD
21 make) and Paul Smith (GNU make).
22 (In the end test job reaper code has been rewritten completely.)
24 Credits, in order of commit appearance: Simon Gerraty,
25 Yasuhiro Kimura, Matthias Gerstner, Olav Mørkrid, Jörg Schilling,
26 and Geoff Clare.
28 We welcome Simon Gerraty and Matthias Gerstner in THANKS.
30 We are https://scan.coverity.com/projects/s-nail (project 444).
32 NOTES, ChangeLog (packager-affine)
33 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
35 - The test now can skip individual tests included in $SKIPTEST,
36   for example "# make test SKIPTEST='eval vexpr'.
38 - New option VAL_ERRORS_LIMIT (by default enbaled), and new
39   variable *errors-limit*#415 to configure error ring size.
41 - We become even more portable to SysV/Solaris.  (Jörg Schilling)
43 ChangeLog
44 ^^^^^^^^^
46 - Without termcap/terminfo support the outermost column was always
47   made accessible (since "not not" defining "am" in *termcap* is
48   not possible, bug since v14.9.12), on the other hand the "ch"
49   builtin implementation never reached out to this last column
50   (since ever).
52 - Manual: after rewrite and review i think the manual section
53   "Character sets" is of acceptable quality.  (Jörg Schilling)
55 git(1) shortlog (edited)
56 ^^^^^^^^^^^^^^^^^^^^^^^^
58 Steffen Nurpmeso (56):
59 ee8ba5ed mx-test.sh: allow skipping tests via $SKIPTEST=".."..
60 e7cd3aca mx-test.sh: disable an unset $JOBMON for bmake(1)! (Simon Gerraty)
61 c1299e6c THANKS: Simon Gerraty
62 8e2fa0b6 mx-test.sh: let the jobreaper exit on SIGINT (Simon Gerraty)
63 e3d92fe4 makefile: set SHELL to detach from user environment (Yasuhiro
64         KIMURA)..
65 52287556 mx-test.sh: BSD make not the culprit (Yasuhiro KIMURA)
66 269370b4 makefile: add note for SHELL (Yasuhiro KIMURA)
67 fae211c5 mk/make-config.sh: fix ICONV test to run with OPT_ASAN_ADDRESS=y
68 ededcddf MLE: fix compilation with OPT_KEY_BINDINGS=no
69 9c5f0b96 Test fcntl(2) F_SETFD FD_CLOEXEC return (Matthias Gerstner)
70 fecc0063 THANKS: Matthias Gerstner
71 b578715b mx_termcap_init(): fix: no auto_right_margin except with library
72         support..
73 028aeb3e mx_termcap_cmd(): "ch" fallback implementation: do full width, not -1
74 b1bff334 Fix OPT_AMALGAMATION=y with OPT_GSSAPI=y
75 c2e54ed7 a_netsmtp_read(): fix overflow for malicious server response (Olav
76         Mørkrid)..
77 2053bac2 README: changed from cgit to gitweb
78 a1dbde85 mx_socket_reset_read_buf(): rbufptr=NIL to avoid bad copies (Jörg
79         Schilling)..
80 13a1bee3 NEWS: we now use gitweb not cgit
81 71b050c0 mx_child_in_child_setup(): support for close_range(2) / closefrom(2)
82 d5f3d6c5 a_flthtml_add_data(): even more care for broken entities..
83 13c0ffeb nail.1: clarify *mta-bcc-ok* (Geoff Clare)
84 df8fd858 PRNG: VAL_RANDOM: add getentropy(3) support
85 1e4e02d8 make.rc,mk/make-config.sh: add VAL_ICONV selector (Jörg Schilling)
86 7784bb7e Add VAL_ERRORS_LIMIT and *errors-limit*
87 c0f7bd99 mx_locale_init(): log if interactive and $LC_ALL is a no-go (Jörg
88         Schilling)
89 84908888 mx-test.sh: drop permanent jobreaper, just start a new one, always
90 6950c69b nail.1: Character sets: improve, review (Jörg Schilling)
91 c72f9466 mk/make-config.sh: GNU iconv redirects until forced otherwise (Jörg
92         Schilling)
93 5ddeb6f9 mk/make-config.sh: fix $CC=cc SunOS shorthand (Jörg Schilling)
95 v14.9.20 ("Sombre Tit (Trauermeise)"), 2020-12-12
96 -------------------------------------------------
98 Fixes things like TLS over SOCKS and too many other bugs.
99 We have some new things, too.
101 Credits, in order of commit appearance: Roberto Ricci,
102 Aharon Robbins, Kevin McCarthy, Predrag Punosevac,
103 Paride Legovini, Olav Mørkrid, Ron Varburg, Jürgen Daubert,
104 Russell Bell, and Geoff Clare.
106 It is courtesy to give a special credit to Coverity.com, even
107 though it only found false positives.
108 (https://scan.coverity.com/projects/s-nail, project 444.)
110 We welcome Roberto Ricci, Ron Varburg and Geoff Clare in THANKS.
112 NOTES, ChangeLog (packager-affine)
113 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
115 + FreeBSD, DragonFlyBSD, (NetBSD): there are bugs in BSD make and
116   FreeBSD-derived sh(1)ells regarding sh(1) monitor mode that is
117   now used in mx-test.sh ("make test").
118   Please pass in JOBMON=n on make(1) command line, or use
119   a different shell (and make).
121   (You could also pass in a different JOBWAIT= now.)
123 + Binaries are now installed 0755 not 0555.  (Jürgen Daubert)
125 + On SunOS/Solaris we now use the normal $CC detection algorithm.
126   (No longer forcefully overwrite, prefer open source compilers.)
128 - TLS connections can now be proxied via *socks-proxy*#569.
130 - `echo'#182 no longer performs "Filename transformations"#27.
131   Introduced in BSD Mail in 1988, but bad.
132   Just use `vexpr'#303 file-expand.
134 - `local'#127 now works like `localopts'#218 when used
135   with `set'#269 and `unset'#270.
136   This is true for built-in variables only, of course, using
137   `local' for those was forbidden in the past, i think.
138   Note that `localopts' will be obsoleted in v14.10, we will only
139   use modifiers in the future.
141 ChangeLog
142 ^^^^^^^^^
144 - EXTERNAL authentication over IMAP and POP3 was fixed.
146 - *tls-fingerprint*#596 is now tested case-insensitively.
148 - *quote*#520 gained an "allbodies" keyword.
150 - "The Mailcap files"#37 gained "x-mailx-last-resort" and
151   "x-mailx-ignore" flags.  (Latter: Russell Bell)
153 - `history'#213 "delete" can now delete multiple entries per
154   invocation.
156 git(1) shortlog: Steffen Nurpmeso (110)
158 v14.9.19 ("Tufted titmouse (Indianermeise)"), 2020-04-26
159 --------------------------------------------------------
161 Fixing an unknown-8bit/iconv(1/3) misbehaviour when displaying
162 mails, and making this MUA ready for OpenSSL 3.0.
164 Credits, in order of commit appearance: Anirudh Oppiliappan and
165 Claus Assmann.
167 We welcome Anirudh Oppiliappan and Claus Assmann in THANKS.
169 git(1) shortlog: Steffen Nurpmeso (14)
171 v14.9.18 ("It is spring time, what a bliss"), 2020-04-18
172 --------------------------------------------------------
174 Some bugfixes and tweaks that accumulated over the months.
176 Credits, in order of commit appearance: Jens Schleusener,
177 Noctambule, Kyle Evans.
179 It is courtesy to give a special credit to Coverity.com.
180 (<https://scan.coverity.com/projects/s-nail>, project 444.)
182 We welcome Noctambule and Kyle Evans in THANKS.
184 NOTES, ChangeLog (packager-affine)
185 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
187 - Warning: we _will_ have v15-compat=yes as a default in v14.10!
189 - Fix for `~f'#328, `~m'#334, `~Q'#336, `~U'#342 and `~u'#343:
190   no longer include all MIME parts (bug since at least v14.9.16).
192 - Fix for handling of "The Mailcap files"#37:
193   a single copiousoutput/x-mailx-tmpfile-fill|nametemplate
194   combination was falsely handled, mostly affecting binary file
195   formats (which got broken by applied character set conversion).
197 - Fix for automatic S/MIME encrypted key / certificate password
198   lookup: used $LOGNAME@[no hostname].smime-cert-key as
199   a fallback, instead of using the value of *from*#432.
200   (Noctambule)
202 - `~R'#338 and `~r'#339, as well as all prompts which expect
203   file names and did not yet do so, expect shell-quoted names.
204   (See "Shell-style argument quoting"#24.)
206 ChangeLog
207 ^^^^^^^^^
209 - `~Q'#336 now acts as if *quote*#520 is set.
210   Does not really make sense otherwise.
212 - New environment variable $SOCKS5_PROXY#635 is tight together
213   with *socks-proxy*#569: setting the one affects the other.
214   This $SOCKS5_PROXY is introduced by FreeBSD to affect all
215   programs which are capable to proxy via SOCKS5 (it seems).
216   (Kyle Evans)
218 git(1) shortlog: Steffen Nurpmeso (26)
220 v14.9.17 ("To bind, or not to bind.."), 2020-02-02
221 --------------------------------------------------
223 A shadowed key bindings report on bash-bugs@ made me aware that
224 our `bind' code has never seen a real review, and not only were we
225 incapable too, but the code was a piece of shit, when i looked at
226 it.  So please find here a bugfix release to smoothly end v14.9.
228 Credits, in order of commit appearance: Jens Schleusener,
229 Johannes Schöpfer, Russell Bell, and Koichi Murase.
231 It is courtesy to give a special credit to Coverity.com.
232 (<https://scan.coverity.com/projects/s-nail>, project 444.)
234 We welcome Koichi Murase in THANKS.
236 And now for something completely different.
238 NOTES, ChangeLog (packager-affine)
239 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
241 - "make test" now works when run by root or on read-only
242   file-systems.  (Johannes Schöpfer)
244 - Our `bind'#150 now supports overall key-sequence timeouts,
245   as opposed to inter-byte timeouts.  For this i have obsoleted
246   *bind-timeout* in favour of *bind-inter-byte-timeout*#380
247   and *bind-inter-key-timeout*#381 (not set by default).
249   The bind tree code had two bugs, for one the "shortcut"
250   key-bindings would all have been created in the "base" context,
251   not where they really belong ("default" and "compose").
252   And due to false list relinking shadowed key bindings did not
253   work.  (Koichi Murase)
255   When used with 3x*verbose*#? (aka -v#86) the bind tree
256   is now dumped when it has been build (once used first, and after
257   modifications.  Putting all this together, a resource file
259     cat >/tmp/t.sh <<'__EOT'
260     MAILX=s-nail
261     cat >/tmp/t.rc <<'_EOT'
262     set line-editor-no-defaults
263     bind base $'\n' mle-commit
264     bind base $'\c?' mle-del-bwd
265     bind base $'\cT' echo one
266     bind base $'\cT',$'\cT' echo two
267     bind base abc echo 0
268     bind base ab,c echo 1
269     bind base abc,d echo 2
270     bind base ac,d echo 3
271     bind base a,b,c echo 4
272     bind base a,b,c,d echo 5
273     bind base a,b,cc,d echo 6
274     set quiet noheader
275     set bind-inter-key-timeout=2500
276     set bind-inter-byte-timeout=250
277     bind base a,b,c,d # now works, too!
278     _EOT
279     MAILRC=/tmp/t.rc $MAILX -R:u -Y 'set verbose=3'
280     rm -f /tmp/t.sh /tmp/t.rc
281     __EOT
282     sh /tmp/t.sh
284   will now do the expected.
286 - `Reply'#257: no longer honours *recipients-in-cc*#528
288 ChangeLog
289 ^^^^^^^^^
291 - Manual: after review i think the following sections are of
292   acceptable quality: "On terminal control and line editor"#18,
293   "Coloured display"#19.
295 - *verbose*#607 is no longer a boolean but can be assigned
296   a numeric value.  But "set verbose verbose verbose"
297   also still works.
299 - New variable *reply-to-swap-in*#536 tries to work around
300   the DKIM/DMARC "HUMAN via LIST <LIST@ADDRESS>" ugliness
301   when `reply'#259ing (or `Reply'#257ing) to such a message.
302   It tries to move the HUMAN into responsibility.
304 git(1) shortlog: Steffen Nurpmeso (65)
306 v14.9.16 ("Message of Winter, your hopes shall be crushed"), 2019-12-29
307 -----------------------------------------------------------------------
309 At the end of the v14.9 series we finally deliver the RFC 1524
310 mailcap support, as well as other improvements, and new features.
311 Many bugfixes and tests arrive.
312 A whole bunch of things are backward-incompatible, but i would
313 assume that most use cases are not at all affected.
315 Credits, in order of commit appearance: Brian Evans,
316 Paride Legovini, Yasuhiro KIMURA, John P. Linderman, Leo,
317 Martin Neitzel, Alexander Harm, Ken Hornstein, Martynas Bendorius,
318 Russell Bell, Goesta Smekal, Kevin McCarthy, Ralph Keller,
319 Ralph Corderoy, Viktor Szépe, Jelle van der Waa, Arnout Engelen,
320 Stuart Henderson, elo, and Benjamin A. Wong.
322 We welcome Yasuhiro KIMURA, John P. Linderman, Leo,
323 Martynas Bendorius, Goesta Smekal, Jelle van der Waa,
324 Arnout Engelen, elo, and Benjamin A. Wong in THANKS.
326 NOTES, ChangeLog (packager-affine)
327 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
329 - Renamed *expandaddr*#417 namehostex to nametoaddr.  (Better.)
331 - *tls-features*#595 string now starts and ends with comma.
332   (Just like *features*#420 does.)
334 - -L#72 longname --header-search renamed to --search.
336 - Config option OPT_FORCED_STACKPROT=xy now
337   OPT_AUTOCC_STACKPROT=y, and now auto-enabled for OPT_AUTOCC=y
338   (even though i hate that, protectors in shipout code..).
340 - `account'#141 return value now matters, and can thus be used to
341   abort account switching.
343 - -:#56 has new "x" mode, which executes the directives of the
344   compiled-in resource file.  (The template content is now
345   compiled in too, so the real file does not need to be loaded.)
346   (Brian Evans)
348 - Quote etc. injections (*quote-inject-head*#525) now always
349   happen (if set), regardless of *quote*#520.
351 - We now truly honour POSIX command abbreviations (order).
352   As part of that i finally implemented a simple command lookup
353   speedup, these are now almost alphabetical (unless abbreviations
354   prevent it).
356 - Added *mta-bcc-ok*#482.  Bummer.  It seems exim and courier
357   do not remove Bcc: headers as required by standards unless
358   invoked with a special command line argument.  So we now
359   do not pass Bcc: headers to file-based MTAs unless this
360   variable is set explicitly.  (Kevin McCarthy).
362 - "COMMAND ESCAPES"#29 now have a $ command modifier, which
363   causes a shell-style `eval'#192uation before the command
364   escape is executed.
366   And so `~<'#315, `~R'#338 and `~r'#339 no longer expand $VAR
367   expressions by themselves.
369   And so -a#58, `~@'#318, and "attachment insert" of `~^'#320
370   and `digmsg'#175 only perform ~/-style expansions.
372 - `~^'#320: use shell-style argument expansion.
373   We handled `~^' and `digmsg' differently, but furthermore
374   turned the shell-parsed data of the latter into whitespace
375   separated data, which made it impossible to, for example,
376   use attachments with whitespace in their names.
378   This increases the interaction protocol version number of
379   *on-compose-splice*#492 from "0 0 1" to "0 0 2"!
380   Because, we do also quote the output, since using `read'
381   (or read(1)) causes *ifs*#445 ($IFS) normalization.
382   All that could be done would be (for ourselves):
384       define x {
385         set ifs=
386         read vany
387         unset ifs
388         vpospar set $vany
389         # And now assign the desired real fields
390         set real-var1=$1 real-var2=$2  ...
391       }
393   Sick!  So instead introduce a `readsh'#252 command which works
394   like `read'#251 but splits fields at shell token boundaries,
395   for example from within *on-compose-splice*#492:
397     echo '~^h s subject'; read stat name; readsh sub; read i
399   There would be better examples.  (Ralph Keller)
401 - `~F'#327, `~f'#328, `~M'#333, `~m'#334, `~U'#342 and `~u'#343 now
402   honour *forward-inject-head*#430 and *forward-inject-tail*#431.
404 - New option OPT_MAILCAP, by default enabled.
405   Disable at runtime via *mailcap-disable*#460, all documented
406   in "The Mailcap files"#37.
408 - OpenBSD: really auto-find number of processors in test script.
409   Work around fflush(3) not adapting POSIX behaviour.
411 - Manual: after review i think the following sections are of
412   acceptable quality: "Encrypted network communication"#14,
413   "A starter"#6, "On URL syntax and credential lookup"#13,
414   "The Mailcap files"#37, and
415   "But, how about XOAUTH2 / OAUTHBEARER?"#46.
417   The latter is actually (Stuart Henderson, Benjamin A. Wong),
418   and now provides a copy+paste example of how to keep a
419   OAUTHBEARER token up-to-date with S-nail (with some care).
420   Yes, it is terrible.
422 - Default .rc file: keeps Sender: by default (Ken Hornstein),
423   sets *followup-to-honour*#427 and *reply-to-honour*#535,
424   and gives more *history-gabby*#439ness.
426 ChangeLog
427 ^^^^^^^^^
429 - Add `Lfollowup'#219.  (Russell Bell)
431 - `?'#139: prefix \ (quoted!) to command to avoid
432   `commandalias'#163  matching:
434   ? ? S
435   S -> spamspam: Teach the spam detector that <msglist> is spam
436   ? ? \\S
437   S (Save): Like `save', but derive filename from first sender
439 - `history'#213 has new "delete NUMBER" subcommand.
441 - Add *forward-add-cc*#428 and *quote-add-cc*#521 to Cc: the
442   originator of a forwarded or quoted message, respectively.
443   (Goesta Smekal)
445 - *history-gabby*#439 now has a value to allow for more.
446   This changes second argument of *on-history-addition*#494
447   from boolean to context string.
449 - New command `mtaaliases'#236.  We no longer automatically
450   update the *mta-aliases*#477 cache.  (Maybe much later we will
451   have a path_monitor or something, until then, not.)
453   And `netrc'#237 "load" is now indeed "clear" + "load".
455   `netrc' also gained a "lookup" subcommand.  (Ralph Corderoy)
457 - *headline*#435 %L format will announce possibility that
458   a message could be a list.
460 - `chdir'#158, `rename'#256 and `remove'#255 use shell-style
461   argument quoting.
463 - `tls'#289 gained "certchain" and "certificate" subcommands.
465 - `folder'#201 can open RFC 5322 messages via eml:// protocol,
466   as in "folder eml:///tmp/msg.eml".  Yet primitive and only
467   read-only.  (Viktor Szépe)
469 - `vexpr'#303 gained "date-utc", "date-stamp-utc" and "epoch"
470   subcommands.  (Benjamin A. Wong)
472 - *on-main-loop-tick*#495 now also happens for commands passed
473   via -Y#88.
475 git(1) shortlog: Yasuhiro KIMURA (1), Steffen Nurpmeso (263)
477 v14.9.15 ("Tit family in the trees"), 2019-08-18
478 ------------------------------------------------
480 Plugging a bug regarding copying data out of invalid MBOX mail
481 databases which is present in all BSD Mails and in Unix V10 mail,
482 and bringing in some tweaks, this update hopefully really marks
483 the end of the v14.9.* series.
485 After more than four and a half years i again have a VM testbed,
486 with an increasing number of VM combinations.  (Yet still too few,
487 but nonetheless, a dramatical improvement.)  This includes
488 a GSS-API testbed, with an ArchLinux server and Linux and FreeBSD
489 clients (do not ask why no additional FreeBSD server, i want to
490 use binary packages).  This brought GSSAPI tweaks.
492 Credits, in order of commit appearance: Ralph Corderoy,
493 Chet Ramey, Robert Elz, Jilles Tjoelker, Steve Izma, Viktor Szépe,
494 and Jean-Marc Pigeon.
496 Very special thanks go to Tarqi Kazan and Ivan Vučica, who tested
497 GSS-API in the past until it worked (again), testing against my
498 blind flight patches!  Thank you very much, guys!
500 We welcome Chet Ramey, Jilles Tjoelker and Steve Izma in THANKS.
502 NOTES, ChangeLog (packager-affine)
503 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
505 - *features*#420 and *tls-features*#595 are now prefixed with
506   a comma ",", not with the number sign "#" (which could
507   increasingly `eval'#192uate to a comment).
509 - We now support parallelized tests.  It takes a numeric job
510   number out of $MAKEFLAGS, or tries to fetch the number of
511   processors otherwise (really!).  To go singleprocessor
512   "$ make testnj" has to be called explicitly.
513   With or without, we will terminate tests which take too long.
515   This is truly tremendous, on the unstable9s machine of the
516   OpenCSW.org cluster for example we now need 24 seconds instead
517   of by far more than 300.  What a release!
519   With help of (Chet Ramey, Robert Elz, Jilles Tjoelker and
520   Steve Izma)
522 - EXTERNAL authentication is truly a mess.  It has been fixed for
523   POP3, where it was broken on our side.  But it seems the
524   internet does not like that, or cannot (pass user credentials
525   from a certificate gracefully to the authenticator).
526   Anyway.  I have introduced EXTERNANON in addition for all of
527   IMAP, POP3 and SMTP.  This could now result in a usable
528   combination, regardless of what server(s) are contacted.
530 - The hook *on-account-cleanup*#488 will now be called even
531   upon program exit (i.e., implicitly leaving the account).
533 ChangeLog
534 ^^^^^^^^^
536 - New *followup-to-add-cc*#426 will place the user in the Cc:
537   list if it will place her in the Mail-Followup-To:.
539 - New hook *on-program-exit*#496.
541 - *pop3-auth*#510=gssapi is now supported.
542   For IMAP, SASL-IR will be used for GSSAPI if possible (saving
543   a packet round-trip).
545 - *expandaddr*#417 has the new keyword "namehostex".
546   If set, plain name addressees, like "To: steffen", will be
547   expanded to NAME@HOSTNAME (where the latter could be
548   *hostname*#443) if NAME is a valid user on the current host.
549   (Viktor Szépe, Jean-Marc Pigeon)
551 git(1) shortlog: Steffen Nurpmeso (45)
553 v14.9.14 ("Great tit passed moult"), 2019-07-27
554 -----------------------------------------------
556 This is an unwanted and unplanned but unfortunately necessary
557 bugfix release.  I hope it marks the end of the v14.9.* series.
559 I presume you would be surprised if it would not also bring some
560 features, this time mostly support of MTA-style aliases as
561 inquired by Jean-Marc Pigeon, some authentication work (XOAUTH2/
562 OAUTHBEARER support), and as usual development to the last minute.
564 It fixes IMAP GSSAPI authentication, thanks to Ivan Vučica for
565 reporting and testing this issue (Debian #930691; still have no
566 testbed, but will soon!), and imap-delim, which i broke in July
567 2017, thanks to Ralph Keller for repetitive reporting.
569 For OpenBSD and SunOS 5.9 this release fixes long standing (must
570 be) race conditions regarding child processes and their I/O setup.
572   Never seen before, but my new box (i stepped a decade of
573   hardware improvements, finally) rather regulary has shown them
574   when running the test suite.  (On the OpenCSW cluster my speed
575   varies, but i had a very good day and seen them there once.)
577   This (finally) caused the complete rewrite of the child process
578   (and termios) handling that i (had to) mention in communication
579   with Gavin Troy already back in, i do not know -- 2013?  (Still
580   not event loop based, but near getting good feelings there.)
582   Funnily the problem (child descriptors were closed by the parent
583   before the fork(2)ed childs had the opportunity to dup(2)licate
584   their file descriptors) reminded me of a message of the german
585   computer magazine c't, maybe around 2001/2002, when OpenBSD
586   improved their fork(2) performance in a day or two after having
587   appeared declassified in a comparison with other OSes.
588   (Of course it was nothing but our own fault to not synchronize on
589   the child, but blindly assuming that a fork(2) child gets the
590   opportunity to run immediately.)
592   Dear Predrag: would it now be possible for you to upgrade from
593   v14.8.12?  I really would like to know!
595 Credits, in order of commit appearance: Martin Lucina,
596 Viktor Szépe, Alexander Harm, Anders Magnusson, Thomas Haigh,
597 Martin T, Ivan Vučica, Nicholas Marriott, Alexander Harm,
598 Steven Penny, Jean-Marc Pigeon, Martin Neitzel, Paul Vojta,
599 Russell Bell, Paride Legovini and Ralph Keller.
601 A special credit to Coverity.com once again, it found bugs!
602 (<https://scan.coverity.com/projects/s-nail>, project number 444.)
604 We welcome Martin Lucina, Anders Magnusson, Thomas Haigh,
605 Martin T, Ivan Vučica, Nicholas Marriott, Steven Penny and
606 Ralph Keller in THANKS.
608 NOTES, ChangeLog (packager-affine)
609 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
611 - The (very backward) Debian mawk is now supported directly.
612   (Martin Lucina, Viktor Szépe)
614 - GCC (8.3.0) -Os inlining bug (wmt) is worked around.
615   And GNU awk 5 warnings have been fixed (before CRUX).
617 - "|PIPE RECEIVER" errors seen on SunOS 5.9 and OpenBSD have first
618   been fixed, and then caused a major rewrite of the child and
619   termios handling for a rather "real" fix.
621   The latter has the side effect that *pipe-TYPE/SUBTYPE*#502
622   handlers will now have their standard output go to /dev/null.
624 - IMAP GSSAPI authentication should work again.  (Ivan Vučica)
626 - -C#61 testable can be used more than two times.
628 - The "grappa" mode of mk/make-release.sh can now be used
629   "everywhere".  See INSTALL on interest.  (It now gracefully
630   fails if s-nail is not installed: we need that for hashing.)
632 - New option OPT_MTA, by default enabled.
633   Set *mta-aliases*#477 to a valid path in aliases(5) syntax,
634   and we will expand them.  All Postfix directives but :include:
635   are supported.  Only clear text files are supported, no DBs.
636   (Jean-Marc Pigeon)
638 - `~^'#320 will now verify *expandaddr*#417 right away in
639   "~^ head ins to|cc|bcc", as is already done for `~t'#341,
640   `~c'#324 and `~b'#323.
642 - OPT_AGENT and OPT_SPAM_SPAMD are gone; they were obsoleted on
643   2017-07-16, and it is not expected to become noticed.
645 - *sendwait*#544 is now initially set, and it gained an optional
646   value, a comma-separated list of case-insensitive strings naming
647   specific subsystems for which synchronousness shall be ensured
648   (only).  Possible values are "mta" for *mta*#476 delivery,
649   and "pcc" for command-pipe receivers.
651   P.S.: you can get a list of all initial values plus via
653     $ s-nail -:/ -v -Xset -Xx
655 - Colours may now happen even in quickrun mode (-e#66,
656   -H#69, -L#72)!  I thought it is ok nonetheless, because
657   we i think always documented to enwrap `colour'#161 setting
658   in an according `if'#215, as in
660     \if terminal && [ "$features" =% +colour ]
661       \colo iso view-header fg=red
662     \end
664 - OPT_SOCKETS has been renamed to OPT_NET.
666 - -Y#88 is now well defined under all conditions, with tests:
668     The commands will be evaluated successively in the given
669     order, and as if given on the program's standard input --
670     before interactive prompting begins in interactive mode,
671     after standard input has been consumed otherwise.
673 - XOAUTH2 / OAUTHBEARER (OAuth 2.0 bearer token, RFC 6750)
674   autentication is now supported for all protocols.
675   New FAQ entry "But, how about XOAUTH2 / OAUTHBEARER?"#46
676   For driving the necessary external update tool a new
677   *on-main-loop-tick*#495 hook has been introduced.
678   (I am thinking about adding support for an optional built-in
679   token refresh.)
681 - Support for the EXTERNAL authentication method has been
682   introduced.  This is UNTESTED, though.  (I am still in the
683   process of re-setting up my VM test environment.)
684   We do not verify presence of a client certificate etc., but only
685   that a TLS secured channel is active, when using this method.
686   (We now *verbose*#607 log the used TLS version and cipher, too.)
688 - *imap-delim*#669 works again as advertised!  This was broken in
689   [1b9897a9] ((BWDIC!) Fix *imap-delim* behaviour.., 2017-07-01),
690   and i think i was pretty much irritated by then.  Sorry!!
691   While here, take *imap-delim* into account for `imapcodec'#665.
692   (Ralph Keller).
694 ChangeLog
695 ^^^^^^^^^
697 - Manual section "HISTORY"#52 improved a bit.  (Thomas Haigh)
699 - New variable *line-editor-cpl-word-breaks*#454 (yet a bit
700   restricted).
702 - MLE: add mle-raise-{int,quit,tstp} functions.  Ie., raising
703   those signals via ^C and ^Z is no longer hard-wired (in the
704   MLE), but can be reassigned.  (Nicholas Marriott)
706 - The makefiles no longer contain any awk code, that all has been
707   separated into files under mk/.  (Alexander Harm)
709 - We now have "test" *mta*#476, which dumps to standard output
710   or optionally to a file, and honours *mbox-fcc-and-pcc*#463:
712      $ echo text | s-nail -:/ -Smta=test -s ubject user@exam.ple
713      $ </dev/null s-nail -:/ -Smta=test://./xy -s ub user@exam.ple
715 - -##90 now acts as if variables were set via -S#80, rather than
716   as via `set'#269, meaning that they are "frozen" for a while.
718 - We have a new `colour'#161 mapping, "mle-error".
719   It applies to error note in *prompt*#517, as well as to any
720   other error logged to the terminal.  The latter is temporary
721   until we gain a more fine grained logging facility, which then--
722   likely--introduces an entire mapping family.
724   Btw., for messages not explicitly generated (by, eg.,
725   `echoerr'#183), we now also avoid writing adjacent duplicates,
726   but rather do a syslog-like thing.  That error generator has
727   been rewritten a bit, now more expensive, but looks right.
728   (Martin Neitzel, Paul Vojta)
730 - The value of $COLUMNS#615 seen in child processes is now the
731   real one, rather than the one we use (not necessarily identical,
732   dependent on termcap/terminfo/terminal support).
734 - There are now three -v#86 / *verbose*#607 levels, not two.
736 - The HTML filter knows more HTML 4.0 entities.  (Russell Bell)
738 git(1) shortlog: Steffen Nurpmeso (161)
740 v14.9.13 ("Blue tit's spiral marriage swoop"), 2019-03-08
741 ---------------------------------------------------------
743 Not so much happened as i was busy with other things in the second
744 half of 2018, and could not find a grip: at the source level some
745 efforts to turn this to mailx have taken place, including early
746 work on a code abstraction that will be shared with my (g)roff
747 clone: it was tiring to come back to old ideas that i have already
748 implemented multiple times and in different languages.  To mention
749 it for the curious.
751 So: this is a bugfix release, in fact it fixes a tremendous amount
752 thereof, [master] was ahead by 62 commits from [v14.9.11] (not all
753 bugs though, hrmhrm), but also with, well, a few new features, and
754 of course, development to the last minute. ^_^
756   v14.9.13 replaces v14.9.12 from yesterday which would pick up an
757   ISO C 2011 statement that is impracticable, thanks to Johannes
758   Schöpfer and Jürgen Daubert for reporting this (i should test
759   without OPT_AUTOCC more often.)  I have also fixed -T to match
760   NEWS (manual and code did the opposite).
761   v14.9.12 balls will be removed from the server.
763 Credits, in order of commit appearance: Jörg Schilling,
764 Paride Legovini, Olav Mørkrid, Ralph Corderoy, Rich Felker,
765 Predrag Punosevac, Russell Bell, Dirk-Wilhelm Peters,
766 Jean-Marc Pigeon, Warren Toomey, Cág, Martin Neitzel,
767 Dr. Werner Fink, Dr. Matthias St. Pierre, Kurt Roeckx, Mike Sharov,
768 Joan and Johannes Schöpfer.
770 Very special thanks go to Jean-Marc Pigeon of OSUKISS Linux, who
771 provided me access to a VZGOT container on the most "beefy"
772 machine i have ever had access to!  It is ever so astonishing to
773 have work done in 90 seconds on this supercomputer which requires
774 an hour or more here.  Thank you, Jean-Marc.
776 And thanks to Kimura-san not only my web server became accessible
777 via TLSv1.3 (out-of-line), but we also have landed on FreeBSD!
778 Kimura-san is the one who installed a sympathic cron job that
779 reminds me of cherry petals wafting in a warm spring breeze --
780 in winter!
782 We welcome Russell Bell, Jean-Marc Pigeon, Warren Toomey,
783 Dr. Matthias St. Pierre, Kurt Roeckx, Mike Sharov, Joan and
784 Johannes Schöpfer in THANKS.
786 NOTES, ChangeLog (packager-affine)
787 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
789 - Packagers could follow stable/* via git(1) and the "grappa" mode
790   of the release script (see README); perl(1) is required to be
791   totally en par with an official release.  (Paride Legovini)
793     $ git checkout stable/stable
794     $ sh mk/make-release.sh grappa mybranch
795     ...
796     Program version is [.], packager release addition shall be: xy
797     Is s-nail <v[.]-xy> correct? [y/n] y
798     Switched to branch 'mybranch'
799     $ git commit -S -n -m 'My release [.]-xy'
801 - $MAKEJOBS vanished, just use -j or whatever your make(1) supports.
802   Luckily the tested make(1)s can be persuaded to dig each others
803   .WAIT / .WAIT: / .NOTPARALLEL: targets.. and do the right thing.
805 - $OBJDIR support added, i use it for building / testing on tmpfs.
806   It works in conjunction with make-emerge.sh, too, thus
807   out-of-tree out-of-tree is possible (more or less; see INSTALL).
808     $ make tangerine OBJDIR=/tmp/x/y/z
810 - Option VAL_PRIVSEP_USER has been renamed to VAL_PS_DOTLOCK_USER
811   (to reflect the new "deep tree" directory layout).
813 - Option OPT_QUOTE_FOLD has been renamed to OPT_FILTER_QUOTE_FOLD
814   (to reflect later code changes upwards compatibly).
816 - New options OPT_CMD_VEXPR and OPT_CMD_CSOP, by default enabled.
817   To include the commands `vexpr'#303 and the new `csop'#167,
818   which now provides the byte string functions of the former.
819   (Still available through `vexpr' until v15.)
820   (I hope to be able to later provide a `usop' or `unisop' or so.)
822 - *v15-compat*#606 can now have a value: if it is set, the
823   `wysh'#131 command modifier which chooses shell quoting rules
824   for some commands is implicit.
826 - We have some (more) backward incompatible changes, though it is
827   likely most users will not recognize the differences.
829   o *headline*#435 format %T is obsolete, %L fits better.
831   o `csop'#167 `hash' and `hash32' subcommands (formerly from
832     `vexpr'#303) use a slightly changed hash algorithm.
833     (Which results in an improved distribution for tested sets of
834     words in power-of-two spaced dictionary.)
835     These are affected by the change in the second next item, too.
837   o Changed to use shell quoting rules for arguments:
839     + `mimetype'#225 and `unmimetype'#226.
840       This is affected by the change in the next item, too.
842     + `shortcut'#273 and `unshortcut'#274.
844     + `mlist'#228 and `unmlist'#229 as well as `mlsubscribe'#230
845       and `unmlsubscribe'#231.
847     + `alias'#144, too.
849   o Changed (with legacy compat) the "@[i]" modifier prefix to
850     a question-mark ?[case|..] suffix, as is known from URLs.
851     We head towards direction URL syntax, now here too.
853     + `if'#215 and `elif'#187.
854       E.g., 'wysh if "abc" ==?case "ABC"' is true, as well as is
855       'wysh if 0xFFFFFFFFFFFFFFFF -eq?saturated 36#1Y2P0IJ32E8E7'.
856       "==?" and "-eq?" would have been sufficient, here.
857       (No unsigned mode (yet) for `if'#215.)
859       Yes, `if'#215 and `elif'#187 now support `wysh'#131, and
860       see already expanded arguments, then.  No more "triggers".
861       This finally makes it possible to write things like
862         ? wysh if X;A;wysh elif Y;B;else;C;end
863       Note 'else;C' not 'else C'.
865       New operators: '-n "$VAR"' and '-z "$VAR"' work like in the
866       shell, '-N varname' and '-Z varname' do not test the
867       expansion but the existence of variables instead.
868       Two argument forms require `wysh'#131.
870     + `mimetype'#225 markers have changed likewise; this also
871       affects *pipe-TYPE/SUBTYPE*#502 and *pipe-EXTENSION*#509 (with
872       legacy compatibility and -v/-d obsoletion warnings)!
874         ? mimetype ?t text/x-awk  awk
875         ? wysh set pipe-application/pdf='?=&?\
876             trap "rm -f \"${MAILX_FILENAME_TEMPORARY}\"" EXIT;\
877             trap "trap \"\" INT QUIT TERM; exit 1" INT QUIT TERM;\
878             mupdf "${MAILX_FILENAME_TEMPORARY}"'
880     + `vexpr'#303 (and `csop'#167) modifiers changed likewise.
881       The case-insensitive subcommands "ifind" and "iregex" have
882       been obsoleted, just use the ?[case] modifier to the regular
883       function instead.
885       P.S.: Thanks to Rich Felker the `regex' subcommands now
886       works as desired even with empty intermediate submatches.
888   o Changed address parse mode for command line arguments plus.
889     This modifies decade old tradition, but results in a more
890     predictable behaviour i think.  Most people will possibly even
891     be surprised to see the old behaviour:
893       $ </dev/null s-nail-old -dsubject ' du , de <p@p> , pp , du '
894       -> To: du, de <p@p>, pp
895     new:
896       $ </dev/null s-nail -dsubject ' du , de <p@p> , pp , du '
897       -> To: "du , de , pp , du " <p@p>
899     Of course anything but perfect, our address parser is very
900     complicated yet far from being acceptable.  (Dr. Werner Fink)
901     This affects:
903     + -b#60, -c#62 and To: receivers, as above.
904       (We also have a new -T#82 receiver multiplexer, which is
905       configurable in this regard, please see below for more.)
907     + The -r#79 address.
908       This saw more changes: the content is no longer evaluated
909       via shell expression parser (when *v15-compat* is set)..
910       unless explicitly requested via the *expandaddr*#417
911       flag "shquote".
913     + *sender*#543 variable.
915     + `addrcodec'#143 command, likewise; old:
916         ? addrc e du , e <w@d> , d
917         du , e <w@d> , d
918         #?1!22/INVAL
919       new:
920         ? addrc e du , e <w@d> , d
921         "du , e , d" <w@d>
922         #?0!0/NONE
924     + `digmsg'#175 and `~^'#320 now use this parse mode fix for
925       headers which need a single receiver, which is backward
926       compatible but now safer since it can be fooled less easily
927       (to split into a list what should be a single address, as
928       shown above for `addrcodec'#143).
930       They now can also be forced to use that parse mode for To:,
931       Cc:, Bcc: with a new question mark modifier "?single", here
932       the word "single" is optional.
934        ~^ header insert To?single: exa, <m@ple>
935        ~^ header show to
937 - By established rules and popular demand occurrances of '^From_'
938   (see *mbox-rfc4155*#464) will be MBOXO quoted (prefixed with
939   greater-than sign '>') instead of causing a non-destructive
940   encoding like 'quoted-printable' to be chosen, unless context
941   (e.g., message signing) requires otherwise.
942   Only with *mime-encoding*#473=8bit.
944 - We now support long "Options"#5 -- try --long-help.
946 - Finally, it is possible to force sending out messages with the
947   new *mime-force-sendout*#474 variable.  If this MUA has been
948   compiled with iconv(3) support it can happen that sending
949   otherwise valid text messages fails because of invalid bytes
950   sequences according to the locale; setting this new variable
951   will avoid this; use *mime-counter-evidence*#472 to view such
952   messages nonetheless.  (Dr. Werner Fink)
954 ChangeLog
955 ^^^^^^^^^
957 - `mimeview'#227 works again with binary formats.  (Russell Bell)
959 - IMAP searches via IMAP without matches no longer report a single
960   match.  (Dirk-Wilhelm Peters)
962 - New -Y#88 aka --cmd= option to inject commands to be executed
963   when startup is completed (as opposed to the earlier -X#87 aka
964   --startup-cmd=).
965   These commands appear as if the user had typed them in.
967 - A new *on-history-addition*#494 can be used to filter what
968   enters the `history'#213.
970 - New "fcc" flag for *expandaddr*#417.  (Olav Mørkrid)
972   And "domaincheck" will cause target domain comparison against
973   entries in the new *expandaddr-domaincheck*#418.  (Olav Mørkrid)
975 - New *mbox-fcc-and-pcc*#463 will write out file and pipe addresses
976   as a plain RFC5322 message rather than an MBOX.  (Olav Mørkrid)
978 - The `errors'#191 queue existance and size is announced via
979   *^ERRQUEUE-EXISTS*#355 and *^ERRQUEUE-COUNT*#354.
980   (Russell Bell, Martin Neitzel)
982 - Our MBOX parser is now truly compliant to POSIX.
983   (Dr. Werner Fink)
985 - We follow symbolic links again when writing files.
986   (Russell Bell)
988 - *tls-rand-file*#598 is in fact now necessarily one of the
989   optional *tls-features*#595.  (Mike Sharov)
991 - New command line option -T#82 aka --target='FIELD: BODY'.
992   FIELD can be To:, Cc:, Bcc: or Fcc:.
993   The BODY is parsed as a list (just as if the given FIELD would
994   be part of a template message fed in via -t#83), but the
995   "?single" modifier suffix can be used to avoid this.
996   (Dr. Werner Fink)
998 git(1) shortlog: Steffen Nurpmeso (277 + 9)
1000 v14.9.11 ("Tit family enjoying a bath"), 2018-08-08
1001 ---------------------------------------------------
1003 A hot summer bugfix release, but it surely brings in some new
1004 features, like TLS fingerprinting and `digmsg' message access.
1006 An embarassing number of bugfixes have been seen, to fix IMAP UID
1007 handling on 32-bit hosts, UTF-8, `readall' with empty lines, rare
1008 endless iconv(3) loops, false qsort(3)ing of addressee lists,
1009 crashes due to false user shell quoting, acceptance of "0" port
1010 numbers, and more.  Most of these cases now have tests.
1012 Credits, in order of commit appearance: Paride Legovini,
1013 Andrew Gee, Olav Mørkrid, Kevin McCarthy, Michael Dressel,
1014 Jürgen Bruckner, Robert Elz, Rudolf Sykora, Doug McIlroy,
1015 Gavin Troy and Jörg Schilling.
1016 A special credit to Coverity.com again, it found a bug!
1017 (<https://scan.coverity.com/projects/s-nail>, project number 444.)
1019 We welcome Andrew Gee, Kevin McCarthy, Michael Dressel,
1020 Olav Mørkrid and Jürgen Bruckner in THANKS.
1022 NOTES, ChangeLog (packager-affine)
1023 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1025 - I have discovered that GnuPG can --export-secret-subkey so that
1026   the real/full private key is no longer needed to --sign, and the
1027   excerpts of the private one can have a different password, too.
1028   So i have created a new for-signing subkey: EEC8C2FF.
1030   Unfortunately it is not possible to verify new signatures with
1031   the old public key, an update is necessary.  For example via
1032     https://ftp.sdaoden.eu/steffen.asc
1033   or just update 1883A0DD via normal gpg(1).
1035 - Maildir support is now optional but default via OPT_MAILDIR.
1036   (Paride Legovini)
1038 - I hope for the last time there has been a change to SSL
1039   configuration: i have renamed all ssl* variables to tls*.
1040   The old ssl* ones still exist until v15, though, yet obsoletion
1041   warnings will be produced.
1042   This is so because i expect that in a not too distant future
1043   only the term TLS will be around.
1045   Also the term CipherList was falsely used, it should have been
1046   CipherString.
1048 - Most (if not all) commands which take a message list and a file
1049   target now use shell-style quoting.  (Before that say `copy'#166
1050   scanned backwards over "something possibly quoted", took that
1051   off, then treated the rest as a message list.  Now shell tokens
1052   are parsed starting at the front, the last is taken off, and
1053   anything before that is the message list.)  (Gavin Troy.  2013.)
1055 - `~^#'? "header show" now backward-incompatibly shows the address
1056   type in field 1, but since this _only_ applies to non-network
1057   addresses i made the change.
1059 - We will find ncurses on DragonFly BSD.
1061 - On Solaris tests no longer need GNU cksum(1): the Solaris cksum
1062   is different only for whitespace separators.  (Jörg Schilling)
1064 - All generated files reside in .obj/, and the tests run in there,
1065   too.  A "rm -f .obj" should suffice to clean anything up.
1067 ChangeLog
1068 ^^^^^^^^^
1070 - `~F'#327, `~f'#328, `~M'#333, `~m'#334, `~U'#342 and `~u'#343
1071   now default to the current message (the "dot").  (Andrew Gee)
1073 - *indentprefix*#450 handling has had its pitfalls when quoting
1074   messages.  (Andrew Gee)
1076 - -r#79 will again set *from*#432 even after -S#80 has been used
1077   to set *from*.  (Michael Dressel)
1079 - No longer process From: (*from*#432) content via `alternates'#146
1080   when Sender: (*sender*#543) is set.  (Michael Dressel)
1082 - Because the priority class of headers was not taken into
1083   account, it could happen that addressees in Cc: would remain but
1084   the same in To: were removed.  (Michael Dressel)
1086 - IMAP accounts for RFC 4551 (and 7162) and supports 64-bit
1087   UIDVALIDITY.
1089 - *spamfilter-rate-scanscore*#580 could crash if specification
1090   did not match program output.
1092 - Shims for TLSv1.3 support, e.g., for *tls-config-pairs*#592.
1094 - Obsoleted *dotlock-ignore-error*, added *dotlock-disable*#410.
1095   (Paride Legovini)
1097 - In compose-mode, removing the In-Reply-To: header breaks an old,
1098   and starts a new thread.  (Doug McIlroy)
1100 - Added new *forward-inject-tail*#431, *quote-inject-head*#525
1101   and *quote-inject-tail*#526 variables, and extended the meaning
1102   of *quote*#520.
1104   All of *{forward,quote}-inject-{head,tail}* now support
1105   a compose-mode specific set of formats (see
1106   *quote-inject-head*#525), for now a few only.
1107   (This adds meaning onto the content of *forward-inject-head*#430
1108   as introduced in v14.9.0.)
1110   The generated output honours *quote-fold*#524, which now takes
1111   an optional third argument in order to produce better output.
1113   While here, introduce the new command escape `~Q'#336 which
1114   performs full *quote*#520 cycles on the given message list.
1116 - Fcc: headers are now understood in -t#83 templates or when
1117   placed in compose mode (`~v'#344, *editalong*#411 etc.).
1118   Since each such header only takes one addressee, no quoting
1119   issues apply, the entire header body is the value.
1121 - `~|'#319 will pass the entire message including headers when
1122   used as "~||", e.g., prepend a file-carbon-copy message header:
1124     ~|| echo Fcc: /tmp/test; cat
1126 - New `tls'#289 multiplexer command.  Yet primitive and only
1127   supports a `fingerprint' subcommand.  Supports `vput'#130.
1129   The new *tls-fingerprint*#596 variable chain aids in adding
1130   support for connection verification without an installed CA
1131   certificate pool in conjunction with the new
1132   *tls-fingerprint-digest*#597 chain.
1134   Consequently *smime-sign-message-digest* has been renamed to
1135   *smime-sign-digest*#563 (old version will cease in v15).
1136   The latter now defaults to SHA512 if possible.
1138 - New MLE commands mle-go-screen-bwd and mle-go-screen-fwd to go
1139   backward and forward one screenful.
1140   And a new mle-clear-screen command.  (Todd C. Miller)
1142 - New *expandaddr*#417 setting "shquote" will evaluate addresses
1143   as if specified within $'' shell-quotes for -b#60, -c#62,
1144   and all direct command line receivers.  This allows for, e.g.,
1146     $ s-nail -Sexpandaddr=shquote '\$contact-mail'
1148 - *quote-as-attachment*#522 no longer needs to be set before
1149   compose mode is entered in order to become honoured.
1151 - Even for -H#69 or -L#72 *folder-hook*#423s will now be called.
1152   Possible sorting is also applied.
1154 - `='#138 now optionally supports message list arguments and the
1155   `vput'#130 modifier in order to store the result list.
1157   The new `digmsg'#175 multiplexer adds some message access, just
1158   like `~^'#320 does in compose mode.  In fact the set of commands
1159   is shared, yet only in compose mode `digmsg' can change messages
1160   or access attachments until v15, however.  For example,
1162   #?0[steffen@essex nail.git]$ cat > /tmp/z.rc <<'_EOT'
1163   define one {
1164      if [ "${#}" -gt 0 ]
1165         digmsg create $1 - # no `read'/`readall' overlay but stdout
1166         #digmsg $1 header list
1167         digmsg $1 header show subject
1168         digmsg remove $1
1169         shift
1170         \eval xcall one "$@"
1171      \end
1172   }
1173   define all {
1174      local set all # localize ("localopts yes" would do too)
1175      vput = all *; echo all: $all; eval call one $all
1176   }
1177 _EOT
1178   #?0[steffen@essex nail.git]$ MAILRC=/tmp/z.rc \
1179     .obj/s-nail -:u -Snoheader -Squiet -Rf /tmp/z
1180   ? call all
1181   all: 1 2 3
1182   212 Subject
1183   Re: [S-mailx] FYI: after USB stick loss i have rotated keys, plus
1185   212 Subject
1186   Re: Problem with page?
1188   212 Subject
1189   Re: s-nail Source ...
1191   ? x
1193 git(1) shortlog: Steffen Nurpmeso (203)
1195 v14.9.10 ("(40th Mail anniversary) Blue tit"), 2018-03-25
1196 ---------------------------------------------------------
1198 On this day in 1978 Kurt Shoens placed the following comment in
1199 def.h (now it is in nail.h):
1201   /*
1202    * Mail -- a mail program
1203    *
1204    * Author: Kurt Shoens (UCB) March 25, 1978
1205    */
1207 v14.9.10 is mostly a stability and bugfix release.
1208 It has seen a full test series including Coverity.com scans.
1209 It fixes bugs i have introduced (also a double free in IMAP cache
1210 that i introduced for v14.9.* series to address Coverity CID
1211 1376978..).
1213 In the end i am saying thanks to Gunnar Ritter for the IMAP
1214 module, and absolutely especially his really neat idea of an IMAP
1215 cache including offline work queue.  (IMAP will nonetheless
1216 temporarily go in v15, but these ideas will come back thereafter.)
1217 I have gray hairs now.
1219 Credits, in order of commit appearance: William Yodlowsky,
1220 Stuart Henderson, Jörg Schilling, Viktor SZÉPE, Rich Felker,
1221 Ralph Corderoy and Philipp Gesang.
1223 A special credit to Coverity.com again.  Because:
1224     tcc is 618496 bytes, pcc is 851968+24576 bytes,
1225     but gcc is 73355264 bytes and clang is even
1226     147406848 bytes, i wonder why the latter two never
1227     said a word that would have addressed the pretty
1228     obvious CID 1387053!
1229     [Use of initialized value, the author.]
1231 We welcome Stuart Henderson and Philipp Gesang in THANKS.
1233 NOTES, ChangeLog (packager-affine)
1234 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1236 - The balls are now build with umask 0022 not 0027.
1237   (William Yodlowsky, Stuart Henderson)
1239 - One actual development of this version was the addition of
1240   multiple choice VAL_ues, as documented in make.rc.
1241   For now we have VAL_IDNA (for OPT_IDNA)
1242     VAL_IDNA="idnkit idn2 idn"
1243   and VAL_RANDOM (by itself)
1244     VAL_RANDOM="arc4 ssl libgetrandom sysgetrandom urandom builtin"
1245   (Stuart Henderson)
1247   In brief:
1248     The value is interpreted as a whitespace separated list of
1249     strings, like "idn2 idn idnkit", case is ignored, order is
1250     important.
1251     The special strings "all" and "any" as well as the empty value
1252     are wildcard matches; if any entry in the list is a wildcard
1253     match, the rest of the list is ignored.
1255     The special string "error" will abort configuration once its
1256     list position is reached; this is only supported if
1257     documented, and not with an accompanying OPT_ (which then
1258     offers "require", as below).
1260   Since this VAL_RANDOM approach is so much better i have dropped
1261   OPT_SSL_RANDOM and OPT_NOEXTRANDOM that were recently
1262   introduced again.  They were c..p.
1264 - Support for idnkit 2.3 has been added.
1265   Support for idnkit 1 (especially as idnkitlite) has been fixed.
1267 - For the first time this codebase should be able to handle
1268   invalid MBOX mailboxes (produced by, e.g., dma(1)) gracefully.
1269   I hope i have found all places (sic) where code has to be fixed.
1270   E.g., "? copy * INVALID-MBOX" now works.
1271   (Smalltalk already knew objects which know what they are doing
1272   are for the better...  This is v15, then.)
1274 - P.S.: the two FreeBSD test failures are noted in INSTALL.
1276 ChangeLog
1277 ^^^^^^^^^
1279 - *asksend*#369 will now really allow recomposing.
1281 - `help'#212 now supports recursive `commandalias'#163es, and
1282   command self-recursion detection now works differently, it has
1283   been false for something like
1285       commandalias x q; commandalias q echo au
1287   since q became expanded to `quit'#250 (alias expansion equals
1288   new command word).  New behaviour: we allow equals once:
1290     commandalias q q; commandalias x q; x
1291   ->
1292     x -> q -> q -> quit
1294 - *editalong*#411 can have a value, say "set editalong=v" and it
1295   will startup $VISUAL#640 not $EDITOR#617.
1297 - Path separators are now normalized, thus all places, including
1298   MLE tab-expansion ("On terminal control and line editor"#18),
1299   can expand something like "///t*////t*".
1301 - -E#65 flag will not be obsoleted.
1302   -D#63 flag has been reintroduced (sets *disconnected*#666 right
1303   away, was not reinstantiated with the rest of the IMAP support.)
1305 git(1) shortlog: Steffen Nurpmeso (71)
1307 v14.9.9 ("Marsh tit savours first spring sun, II") 2018-03-06
1308 -------------------------------------------------------------
1310 A bugfix release.
1311 I hope with this the fallout of the Christmas 2016 "address the
1312 Dr. Problem workshop" has been fully resolved and thus MIME for
1313 header address fields, even if iconv(3) is involved, been fully
1314 restored!  We have even more tests for this now.
1316 The release v14.9.8 was broken on big endian machines.
1317 I will remove the v14.9.8 balls from the server by the weekend.
1318 Sorry for the inconvenience!
1320 Credits, in order of commit appearance: Slavko, Matej Mužila,
1321 Rich Felker, Simon McVittie, Paride Legovini, Cág,
1322 Predrag Punosevac.
1324 We welcome Slavko, Matej Mužila, Rich Felker and Simon McVittie in
1325 THANKS.
1327 NOTES, ChangeLog (packager-affine)
1328 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1330 - The v14.9.* series called *pipe-TYPE/SUBTYPE*#502 handlers in
1331   display or quote mode with CR (carriage-return) bytes stripped
1332   because of a missing output file comparison check, which broke
1333   binary formats etc.  (Slavko)
1335 - We now have native support for Libidn2.  (Matej Mužila)
1337 - uname(1) is now hookable by setting the shell variable uname
1338   when calling make ("uname=MY-UNAME make config" etc.).
1339   (Simon McVittie)
1341   We no longer bake the kernel version into the binary, and
1342   `version'#302 includes uname(2) output.
1343   (Simon McVittie, Paride Legovini)
1345 - We now support a fallback P(seudo)R(andomNumber)G(enerator)
1346   initialization even if getrandom(2)/getrandom(3) has been found
1347   by the configuration, just like we do for "/dev/urandom" usage.
1348   This does not affect systems with arc4random(3) or OpenSSL
1349   random usage.  (David Čepelík, Simon McVittie)
1351   A new OPT_SSL_RANDOM make.rc variable, by default initialized to
1352   the value of OPT_SSL.
1354 ChangeLog
1355 ^^^^^^^^^
1357 - `~@'#318 list-edit behaviour in -##90 batch mode was broken.
1359 - Character set names will now undergo generic normalization,
1360   including stripping of iconv(3) //SUFFIXes.
1362 git(1) shortlog: Steffen Nurpmeso (33)
1364 v14.9.7 ("Marsh tit patiently scraping bark") 2018-02-16
1365 --------------------------------------------------------
1367 A maintenance release which fixes bugs and brings in features.
1369 Credits, in order of commit appearance: Alexander Harm,
1370 Viktor SZÉPE, Paul Eggert, Joseph Bisch, Paride Legovini,
1371 and Peter J. Holzer.
1372 A special credit to the disappearing mutt(1) bug tracker.
1373 And to Gmane.org for creating gmane.mail.s-mailx.general!
1375 Thanks Paride Legovini for becoming maintainer of the Debian port.
1377 We welcome Joseph Bisch, Paride Legovini, and Peter J. Holzer in
1378 THANKS.
1380 NOTES, ChangeLog (packager-affine)
1381 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1383 - The USB stick loss reported for v14.9.6 was fake news, so to
1384   say, the stick exists and therefore the old key is not
1385   compromised.
1387 - We are back at Gmane.org!
1388     news.gmane.org/gmane.mail.s-mailx.general
1390 - `history'#213 has learned to be context-sensitive a bit, and
1391   has two new subcommands, `load' and `save'.
1393     This is in parts backward incompatible because it needs a new
1394     *history-file*#438 format; however, the old format can be loaded
1395     yet compose-mode commands will not appear in compose mode no
1396     more.  Iirc you can start with an old format then `save' to
1397     the new, then replace the "d" in the first column with "c" for
1398     compose-mode commands which should appear correctly.
1400 - Obsoletion warnings for variables now happen at `set'#269
1401   time instead of when used.  Running once via -v#86 may
1402   be beneficial.
1404 - The saturation modifier of `vexpr'#303 is henceforth a prefix,
1405   the suffix version is obsolete (but still supported for a while).
1407 - A network address that contains no domain-, but only a valid local
1408   user <name> in angle brackets will be automatically expanded to
1409   a valid address when *hostname*#443 is set to a non-empty value;
1410   setting it to the empty value instructs us that the used *mta*#476
1411   (including builtin SMTP) will perform the necessary expansion.
1412   (Viktor SZÉPE)
1414   Note that *hostname*#443 as well as *smtp-hostname*#566
1415   will now undergo IDNA expansion if IDNA is supported.
1417   And *from*#432 and *sender*#543 are now verified at `set'#269
1418   time, not when used.  (Viktor SZÉPE)
1420 - The commit message in [d503bd82] is wrong, apologies to
1421   Paride Legovini.  The test(1) operator "-n" appeared in Seventh
1422   Edition UNIX, not V8 as falsely claimed.
1424 ChangeLog
1425 ^^^^^^^^^
1427 - Our `addrcodec'#143 parser chokes on lesser constructs.
1429 - Presence of command-line MTA arguments without *expandargv*#419
1430   are now a hard error.  It was my fault that this was not the
1431   default from the very start.  (Viktor SZÉPE)
1433 - Seen on the mutt bug tracker, we also still have had problems
1434   with time settings that cross 32-bit boundaries.  As that is
1435   in parts induced by the C standard, now implement those parts on
1436   our own, and be super careful in general.  (Joseph Bisch)
1438 - The `~@'#318 command escape did not shell-unquote the user input
1439   again and was thus a bit broken; message attachments also work
1440   again.
1442 - Support custom headers from the command line via -C#61.
1443   And *customhdr*#404 is verified upon `set'#269 time.
1445 - The simple builtin HTML viewer now supports <blockquote>
1446   elements, which many web mailers, most notably gmail, use for
1447   citation.  (Peter J. Holzer)
1449 git(1) shortlog: Paride Legovini (1), Steffen Nurpmeso (66)
1451 v14.9.6 ("Marsh tit abiding a snow storm"), 2017-12-05
1452 ------------------------------------------------------
1454 A bugfix release which fixes four serious and three other bugs.
1455 A few new features came in, too.
1457 Many thanks go to Ralph Corderoy who reported an issue that was
1458 caused by a terrible, terrible word reversal that i managed to
1459 produce in December 2016, and which caused the v14.9.x series to
1460 not MIME encode (non-address) content of address header fields!
1462 Credits, in order of commit appearance: Thomas Dickey,
1463 Andreas Baumann, Erich Eckner, Gaetan Bisson, Solar Designer, Cág,
1464 Ivan Tham, Ralph Corderoy and Doug McIlroy.
1466 We welcome Andreas Baumann, Erich Eckner, Solar Designer and Cág
1467 in THANKS.
1469 NOTES, ChangeLog (packager-affine)
1470 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1472 - After USB stick loss the authors OpenPGP key has been switched to
1474     pub   4096R/1883A0DD 2017-11-30 [expires: 2027-11-28]
1475           Key fingerprint =
1476             EE19 E1C1 F2F7 054F 8D39  54D8 3089 64B5 1883 A0DD
1477     uid                  Steffen Nurpmeso <steffen@sdaoden.eu>
1479 - $TMPDIR#638 no longer honoured for root runs.  (Solar Designer)
1481 - *mime-encoding*#473 defaults to quoted-printable again.  (Cág)
1483 - We _can_ MIME encode even header fields which contain addresses.
1484   Thanks to Ralph Corderoy we now also _do_ so again!
1486 ChangeLog
1487 ^^^^^^^^^
1489 - ***#336 now uses *ifs*#445 when splitting.
1491 - Freezing *ttycharset*#602 via -S#80 also survives using or
1492   setting any of $LC_ALL#619, $LC_CTYPE#620 and $LANG#621 during
1493   program startup.
1495 - New `local'#127 command modifier to localize changes.
1496   Yet supported only for `set'#269, i.e., we have gained
1497   macro-local variables.
1499 - `vexpr'#303 now supports a BASE#number notation for integers,
1500   like 16#AFFE as an alternative to 0xAFFE.
1502   Hint: variable settings can most often use several bases, too,
1503   e.g., i have "set mime-counter-evidence=0b1111".
1505 - Very simple form of *quote-chars*#523 to adjust our knowledge of
1506   what actually is to be treated as a quote character.
1508 - *mime-counter-evidence*#472 deep inspection (bit four) has
1509   been improved for the sole cases of quoting or displaying
1510   a message.  So messages with less than 25% of control characters
1511   and such will now be displayed (made printable).  This is yet
1512   not configurable nor do we have a way to easily access a message
1513   with more than that.  (Doug McIlroy)
1515 git(1) shortlog: Steffen Nurpmeso (44)
1517 v14.9.5 ("Marsh tit engaged with a peanut"), 2017-10-21
1518 -------------------------------------------------------
1520 A bugfix release which fixes two bugs which were cast in stone.
1521 A few compatibility improvements (AlpineLinux, Solaris).
1522 And minor features.
1524 Apologies to Jörg Schilling, a git bug i think it was who caused
1525 joining of changesets, losing a credit, and it had been pushed to
1526 [master] before the problem was realized.
1528 Credits, in order of commit appearance: Jörg Schilling,
1529 Doug McIlroy, Random832, Nick Stoughton and Ivan Tham.
1531 We welcome Nick Stoughton and Ivan Tham in THANKS.
1533 NOTES, ChangeLog (packager-affine)
1534 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1536 - New OPT_USE_PKGSYS option can be disabled to not automatically
1537   pick known package system paths (pkg(7), OpenCSW, schily).
1538   (Jörg Schilling)
1540 ChangeLog
1541 ^^^^^^^^^
1543 - The software indeed _never_ dealt with iconv(3) output character
1544   set errors (as opposed to invalid input character set byte
1545   sequences etc.) for the main message body!
1546   And I have missed that when i tweaked our iconv layer a bit!
1548 - Fixed a race condition with sigsuspend(2) that i could only see
1549   on OpenBSD.  config.h offers n_SIGSUSPEND_NOT_WAITPID, by the
1550   way, which saves some systemcalls and did not run races, but
1551   noone adjusts this file.
1553 - Message list specifications gained two new colon modifiers, one
1554   can now "search :Ll" to find "Mailing lists"#11.
1555   The *headline*#435 format %T now also uses L and l rather than
1556   S and L accordingly.
1558   New `addrcodec'#143 subcommand `skinlist' acts like `skin'
1559   but stores in *!*#349 *^ERR*#351-EXIST if the address is
1560   one of the known "Mailing lists"#11.
1562 - `echo'#182 family now supports `vput'#130 and *!*#349 error
1563   storage, offering some kind of printf(1) experience, almost.
1565 git(1) shortlog: Steffen Nurpmeso (35)
1567 v14.9.4 ("(5th anniversary) Marsh tit"), 2017-09-18
1568 ---------------------------------------------------
1570 This is an update feature release but which also ships a furious
1571 number of bug fixes, about six of which were pretty serious.  It
1572 also applies overall trimming, and improves configuration time
1573 compatibility on macOS.
1575 Thanks to Alexander Harm there is now a macOS Homebrew package.
1577 Credits, in order of commit appearance: Paul Vojta, Daniel Lublin,
1578 Alexander Harm, Norman Ramsey, Viktor Szépe, Rich Salz,
1579 David Čepelík, Ralph Corderoy, Stéphane Chazelas, Aharon Robbins,
1580 Ken Hornstein.
1582 We welcome Daniel Lublin, Alexander Harm, David Čepelík and
1583 Stéphane Chazelas in THANKS.
1585 NOTES, ChangeLog (packager-affine)
1586 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1588 - Out-of-tree builds have become possible via the new
1589   make-emerge.sh script:
1591   $ cd /tmp && mkdir build && cd build &&
1592     ~/src/nail.git/make-emerge.sh &&
1593     make tangerine DESTDIR=.ddir
1595   We now have a `citron' make target which is like `tangerine' but
1596   does not run the tests.
1598 - Configuration with OPT_AUTOCC honours $CC=cc. (Norman Ramsey)
1600 - SSL/TLS configuration has been revamped (again) in order to
1601   support new possibilities of OpenSSL (and LibreSSL) without
1602   ending up and introducing more and more variables.
1604   Instead we now have *ssl-config-pairs*, a comma-separated
1605   list of all options.  With e.g. OpenSSL 1.1.xx this will be
1606   directly passed through to SSL_CONF_cmd(), so there _anything_
1607   can be passed, otherwise we use a builtin parser to map.
1608   The new *ssl-features*#? states what is supported.  E.g.:
1610     if [ "$ssl-features" =% +ctx-set-maxmin-proto ]
1611       wysh set ssl-config-pairs='\
1612           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
1613           Curves=P-521:P-384:P-256,\
1614           MinProtocol=TLSv1.1'
1615     else
1616       wysh set ssl-config-pairs='\
1617           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
1618           Curves=P-521:P-384:P-256,\
1619           Protocol=-ALL\,+TLSv1.1 \, +TLSv1.2'
1620     endif
1622   OpenSSL v1.1.xx also introduces an interesting and neat idea to
1623   centralize SSL/TLS configuration of (all) programs in a single
1624   file.  This can be driven via *ssl-config-file* and the new
1625   *ssl-config-module* variables, several entries per program
1626   are allowed, see *ssl-config-module* for an example.
1628   New manual section "Encrypted network communication"#14.
1630 - Variables set or unset via -S#80 are now frozen until program
1631   startup is complete.
1633 ChangeLog
1634 ^^^^^^^^^
1636 - Historical behaviour of *askcc*#367 / *askbcc*#368 has been
1637   reintroduced.  (Norman Ramsey)
1639   A new *asksend*#369 variable will show a final header summary
1640   and allows reentering compose mode.  Set by default.
1642   POSIX mirrors *ask* onto *asksub*#371, so dropped" the former.
1644 - `~^'#320 no longer normalizes header names to titlecase.
1646 - We no longer generate charset=binary MIME parameters.
1647   This was introduced on 2013-01-02 and was i think owed to
1648   file(1)s -i output as i failed to find any other reference.
1649   (Normal Ramsey)
1651 - *mime-alternative-favour-rich*#471 now also works for handlers
1652   installed via *pipe-TYPE/SUBTYPE*#502. (Viktor Szépe)
1654 - v14.9.* series did not generate In-Reply-To: headers!
1656 - `alias'#144 now supports high-bit bytes and semicolon.
1657   Expect that at some later time the input must be valid according
1658   to the locale, though. (Norman Ramsey)
1660 - Combinations of *record*#529 could crash because of an
1661   unterminated variable function argument list. (Norman Ramsey)
1663 - New command `readall'#253 loads an entire file into a variable.
1665   *signature*#550 has been obsoleted.
1667 - `vexpr'#303 now supports negative arguments for the substring
1668   subcommand and adds trim, trim-front and trim-end subcommands.
1670 - `!'#134 can be used in send mode.
1672 - `~A'#321, `~a'#322, `~I'#331 and `~i'#332 will henceforth expand
1673   \t and \n only if *posix*#515 is set.
1674   Please use `set'#269 instead (with `wysh'#131, until v15).
1676 - New "The mime.types files"#36 type marker: @q ("quiet").
1678 git(1) shortlog (edited): Steffen (Daode) Nurpmeso (90)
1680 v14.9.3 ("Crested tit nibbling sunflower seeds"), 2017-08-03
1681 ------------------------------------------------------------
1683 This is a bugfix release but which ships some improvements, too.
1684 It silently replaces both of v14.9.1 v14.9.2 from earlier this
1685 week, which were broken or not entirely fixed.
1687 Credits, in order of commit appearance: Felix Fontein, Paul Vojta,
1688 Ralph Corderoy, Christos Zoulas, Gavin Troy, Gaetan Bisson.
1689 Thanks, Coverity.com.
1691 We welcome Christos Zoulas in THANKS.
1693 Apologies to Viktor Szépe for the false spelling of his name in
1694 the v14.9.0 announcement.
1695 And to Gaetan Bisson for not giving credit for [14fbce97]!
1697 NOTES, ChangeLog (packager-affine)
1698 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1700 - fakeroot support was blindly taken from Debian and broken.
1701   (Gavin Troy, Gaetan Bisson)
1703 - Base64 output was broken for cases which involved iconv(3).
1704   The data is not lost, you can read it with S-nail v14.9.0 and
1705   above, and save it somewhere.  I know of no other base64 decoder
1706   which reads those things correctly, though.  We now have tests.
1707   Along this i fixed an iconv(3) error which likely caused
1708   stateful decoding (like, e.g., for ISO-2022-JP) to fail because
1709   of an unnecessary reset of the iconv(3) state machine.
1710   Thanks to Gaetan Bisson for mentioning this issue!
1712 ChangeLog
1713 ^^^^^^^^^
1715 - In compose mode the MLE allows empty lines again.
1717 - We no longer require a writable $HOME#618.  Due to false code
1718   flow (but but but: with correct comment) a non-writable $HOME
1719   entry in /etc/password (i.e., from getpwuid(3)) would lead to
1720   a crash.  (Felix Fontain; Ralph Corderoy)
1722 - Two faulty string operations slipped into the IMAP code,
1723   resulting in a crash and a "is-same-host" test that would fail
1724   for IMAPS connections like `save'#266 or `copy'#166 because of an
1725   implicit IMAP protocol for the target of those operations (thus
1726   IMAP != IMAPS).  (Paul Vojta)
1728 - The MLE tab-expansion will now automatically append a "/" if
1729   there is only one possible expansion and that is a directory,
1730   saving the user one <TAB>.  (Christos Zoulas)
1732   The shell expression parser had a bug regarding understood
1733   metacharacters (;|&), which in turn could cause an infinite loop
1734   in the MLE tab-expansion for, e.g., "move &9 +<TAB>", because
1735   the "&" would never have been stepped over.
1737 - New `~I'#331 command escape is like `~i'#332 but does not append
1738   a newline.
1740 - `localopts'#218 gained an optional second argument.
1741   It is now possible to specify that any macro `call'#152ed
1742   will have localopts enabled, and it is possible to fixate the
1743   setting so that it cannot be reverted.
1745 - *@*#357 should now act completely compatible to the sh(1)ell,
1746   thus obsoleting my hysteric warnings in the v14.9.0 announcement.
1748 - The `Lreply'#220, `reply'#259, `Reply'#257 series as well as
1749   `mail'#222 now manage the error status *!*#349.
1750   I.e., there are now errors like *^ERR*#351-DESTADDRREQ,
1751   ^ERR-NODATA, ^ERR-PERM and similar.  It is not perfect yet,
1752   because $DEAD#616 may have been written (with *save*#538) or not,
1753   for example.
1755   `Lreply' and `reply' have been rewritten rather completely
1756   indeed.  They join Reply-To: and Mail-Followup-To: dependent on
1757   the context (i.e., *reply-to-honour*#535, *followup-to-honour*#427,
1758   see "Mailing lists"#11 for the picture), and if they did, use
1759   this list as the receivers exclusively.  It now honours
1760   *recipients-in-cc*#528 even for such addressees.  (And now i wonder
1761   whether i should have credited Paul Vojta for that.)
1763   Also `Lreply' would have crashed for mails with Reply-To: but
1764   without *reply-to-honour*#535 set.  We now have a test.
1766   Note *replyto* is obsoleted in favour of *reply-to*#534.
1768 v14.9.0 ("Long-tailed tit"), 2017-07-16
1769 ---------------------------------------
1771 This is a major feature release which took about ~22 months (24
1772 less two) of development to complete, and which imposed massive
1773 changes under the hood, but also quite a lot of user visible
1774 changes, including some **backward incompatibilities**.
1775 As usual, "s-nail -d" will show obsoletion warnings.
1777 We gain noticeable improvements regarding scriptability and its
1778 reliability, but also for interactive use cases, especially
1779 notable to users is our completely new M(ailx)L(ine)E(ditor) that
1780 supports rather real tabulator expansion and program-mode-context-
1781 sensitive key bindings.
1783 We now support macros with arguments, which can be `shift'ed,
1784 a `return' status can be used, and a `vexpr' multiplexer offers
1785 some arithmetic and string operations.  `commandalias'es are
1786 recursive, further command modifier prefixes, like `ignerr', give
1787 a hand that we otherwise could not offer.  In compose-mode the new
1788 `~^' command escape allows some message and attachment access, and
1789 can be used, e.g., to implement things like custom headers, and
1790 has been especially designed for scripted access via the new
1791 *on-compose-splice* and *on-compose-splice-shell* hooks.
1793 S-nail will move (more or less) backward-incompatibly to sh(1)ell
1794 compatible argument quoting (documented in "COMMANDS"), and an
1795 increasing number of commands do support this already: new ones
1796 exclusively, some old ones have either been switched (like
1797 `localopts'), others -- noticeably `set' -- can be switched to the
1798 new syntax with a `wysh' command modifier prefix.  E.g.:
1800   ? define __xv {
1801     # Be careful to choose sh(1)ell-style on _entire_ line!
1802      localopts yes; wysh set verbose; ignerr eval "${@}"; return $?
1803     }
1804   ? commandalias call echo boo-boo
1805   ? commandalias xv call __xv
1806   ? xv list
1807   ? commandalias xv '\'call __xv
1808   ? xv list
1810 Calling the latter `xv' for `list' will give more detailed command
1811 information, including which kind of argument is used.
1813 I have not managed to implement the three features i have started
1814 this development cycle for, these are thus subject to further
1815 development, just like wysh for message-list argument commands to
1816 support, e.g., negation, wysh for `if' and consorts, the --
1817 terminator to finally overcome the ridiculous requirement to quote
1818 entire shell commands filenames for commands like `pipe.
1819 And and and.
1821 Credits, in order of commit appearance: Antonio Radici,
1822 Aharon Robbins, Mike Frysinger, Predrag Punosevac, Michael Convey,
1823 Hariskar, Rudolf Sykora, Martin Neitzel, Gavin Troy,
1824 Salvatore Bonaccorso, Todd C. Miller, Sergey Matveev, Robert Elz,
1825 Mantas Mikulėnas, Respiranto, Jens Schleusener, Walter Alejandro
1826 Iglesias, Ralph Corderoy, David Levine, Lyndon Nerenberg,
1827 Thomas Dickey, Afan, Justin Ellingwood, Ingo Schwarze,
1828 Viktor Szépe, Gaetan Bisson, Juan RP, William Yodlowsky,
1829 Hilko Bengen, Matthew Dillon, Colin Watson, Donald Mugnai,
1830 Stephen Isard, Jürgen Daubert, Sven Neuhaus, trondd, Ismael Bouya,
1831 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
1832 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
1833 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, Xin LI.
1835 We welcome Antonio Radici, Mike Frysinger, Predrag Punosevac,
1836 Michael Convey, Rudolf Sykora, Todd C. Miller, Robert Elz,
1837 Jens Schleusener, Walter Alejandro Iglesias, Thomas Dickey, Afan,
1838 Justin Ellingwood, Viktor Szépe, Juan RP, Matthew Dillon,
1839 Colin Watson, Donald Mugnai, Sven Neuhaus, Ismael Bouya,
1840 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
1841 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
1842 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, and
1843 Xin LI in THANKS.
1845 Apologies: Sergey Matveev.
1846 Members of the Roff community which await progress.
1848 NOTES, ChangeLog (packager-affine)
1849 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1851 * This release brings some backward incompatibilities, outlined
1852   in the following.  Most users will not be affected, and we have
1853   added a lot of compatibility cruft, but that will vanish in v15.
1854   "$ s-nail -v"!
1856 * The configuration and build system has changed.
1857   Packagers have received updated package files.
1859   o Anything which was WANT_xy before is now OPT_xy, and
1860     compiled-in paths and values, like PREFIX or PAGER, have
1861     gained a VAL_ prefix (thus VAL_PREFIX and VAL_PAGER).
1863     This is _not_ true for non-persistent or environmental values,
1864     e.g., DESTDIR, CC, etc., and also not for the overwritable
1865     program variables during configuration, e.g., $awk.
1867   o SENDMAIL -> VAL_MTA, SENDMAIL_PROGNAME -> VAL_MTA_ARGV0,
1868     MAILSPOOL -> VAL_MAIL.
1869     And NAIL -> VAL_MAILX, though this is still a lie.
1871   o The make system now needs config..build..install or
1872     all..install or tangerine (config..build..test..install).
1873     Some constants which some experts may want to fine-tune have
1874     been moved to config.h.  Usual adjustments+doc via make.rc.
1876   o The `build' phase can be parallelized by setting the $MAKEJOBS
1877     environment variable, e.g., "make MAKEJOBS=-j4 build".
1878     Note this variable is not tracked in the configuration.
1879     (Gaetan Bisson)
1881   o Unless DESTDIR is set an uninstallation script will be
1882     installed along with the rest (see INSTALL file for more).
1884   o Set the new OPT_CROSS_BUILD to avoid feature runtime tests,
1885     only compile- and link-availability will be tested.  (Juan RP)
1887   o VERBOSE is implemented straight, but must be given at
1888     configuration time in order to become honoured.
1889     (William Yodlowsky)
1891   o ADDCFLAGS / ADDLDFLAGS -> EXTRA_CFLAGS / EXTRA_LDFLAGS.
1893   o The LD_LIBRARY_PATH etc. building processes will skip any path
1894     which contains the string "fakeroot".  (Hilko Bengen)
1896   o We honour a set $SOURCE_DATE_EPOCH#636 environment variable to
1897     an extend that allows reproducible tests, which is why the
1898     repository gained a [test-out] branch with some expected plain
1899     text outputs.  (reproducible-builds.org; Colin Watson)
1901     The new *log-prefix*#457 variable aids in improving the
1902     reproducibility of error messages.
1904   o These are upward compatible changes.
1906 * "make OPENSSL_API_COMPAT=0x10100000 all" should work.
1908 * Internal and environment variables are now explicitly _defined_
1909   and _tracked_ after variable handling has been rewritten
1910   completely.  Notes:
1912   o This means that, e.g., "$ password=NOT_SECRET s-nail" will
1913     **NOT** work no more, since *password*#500 is an internal
1914     variable!
1916   o But if you do, e.g., "? set TMPDIR=~/tmp", then this will
1917     also be reflected in the program environment (it is an
1918     environment variable) and thus affect child processes.
1920   o Therefore we no longer have `setenv' and `unsetenv'.
1922   o To integrate any other environment variable transparently
1923     into our variable management, the new command `environ'#190
1924     needs to be used, e.g., "? environ set NEWVAR=value" or
1925     "? environ link EXISTINGVAR".
1927 - -H#69 and -L#72 have been decoupled:
1928    it used to be -e#66 -L#72 instead!
1930 - *NAIL_{HEAD,TAIL}* have been obsoleted in favour of
1931   *message-inject-head*#467 and *message-inject-tail*#468.
1933   *NAIL_HIST{FILE,SIZE}* have been obsoleted in favour of
1934   *history-file*#438 and *history-size*#441.
1936   *NAIL_EXTRA_RC* has been obsoleted in favour of
1937   *mailx-extra-rc*#461.
1939   *batch-exit-on-error* has been obsoleted by *errexit*#414, which
1940   works just like the POSIX sh(1)ell "set -e" construct; the
1941   `ignerr'#126 command modifier (`-' for command escapes in compose
1942   mode, and see below) can be used to ignore command errors even
1943   then.  (This will remain even if we at some later time will
1944   support at least some of the sh(1) constructs which "swallow"
1945   failures with set -e.)
1947   *bsdannounce* is obsolete, the feature is integrated in
1948   *header*#434 as this is much more useful.  (This is however also
1949   dependent upon the also new but well-known $POSIXLY_CORRECT#633
1950   <> *posix*#515, but that is just how it is; these affect more
1951   behaviour, and increasing.)
1953 - Colour support has been changed backward in- and upward (from
1954   user interface side) compatibly, see the manual section
1955   "Coloured display"#19.
1957   + New commands: `colour'#161 and `uncolour'#162.
1958     You can define context-sensitive, terminal-capability-
1959     sensitive settings, e.g.:
1961       if terminal && [ "$features" =% +colour ]
1962         colour iso  view-header ft=bold,fg=magenta,bg=cyan
1963         colour 256  view-header ft=bold,fg=208,bg=230 subject,from
1964         colour mono view-header ft=bold
1965         colour mono view-header ft=bold,ft=reverse subject,from
1966       endif
1968   + The variable *colour-pager*#396 defines whether colour and font
1969     attribute sequences should be generated when viewing something
1970     in $PAGER#631.
1972   + Set the variable *colour-disable*#395 to turn colour off
1973     without affecting established settings.
1975   + It is deduced via termcap(5) (see below) whether the terminal
1976     supports colors, e.g., "$ s-nail -Stermcap=Co#256".
1977     This is also true if we don't have termcap support.
1979   + Support for 256-colour terminals. (Gavin Troy)
1981 - `source'#281 series support shell pipes if the last character
1982    of the "filename" ends with a vertical bar |, e.g.,
1984       ? source 'gpg -qd ~/.s-nailrc-private.gpg |'
1986 - Shell pipes are also supported as targets for `move'#233,
1987   `copy'#166 etc., yet unfortunately not with via a sh(1)ell token
1988   parser, so that the target still has to be a single argument.
1990       ? copy . '| cat; echo huhu'
1992 - Support for custom headers via the new `~^'#320 compose-mode
1993   command escape and in addition, or alternatively, with the
1994   internal variable *customhdr*#404, which also can be covered by
1995   `localopts'#218.  (Sergey Matveev)
1997   + Support of $ORGANIZATION has been dropped.
1999   + Command escape `~e'#326 supports _any_ header.
2001   + Command escape `~^'#320 supports _any_ header.
2003 - New -:#56 command line option can be used to more easily select
2004   which startup files should be loaded, e.g., -:/ loads none.
2005   (Robert Elz)
2007 - `account'#141s and *folder-hook*#423s now have `localopts'#218
2008    enabled by default.
2010 - A first simple form of compose-mode hooks has been implemented:
2011   *on-compose-enter*#490, *on-compose-leave*#491 and
2012   *on-compose-cleanup*#489 can be set to macros which get invoked
2013   at appropriate times.
2014   For the `resend'#262 series there is *on-resend-enter*#498 and
2015   *on-resend-cleanup*#497: this is very likely to change once
2016   true message access is possible even in this mode.
2018   An even more powerful mechanism is available via the also new
2019   *on-compose-splice*#492 and *on-compose-splice-shell*#493 hooks.
2020   These are executed in child processes and communicate with the
2021   parent via their standard input and output, and therefore can
2022   do anything and act as if they were the user.
2024   `localopts'#218 are enabled and cannot be disabled (and extend
2025   until the message is sent).
2026   (Jens Schleusener, Rudolf Sykora)
2028     ? set on-compose-splice=ocs
2029     ? define ocs {
2030       read ver
2031       echo Splice protocol version is $ver
2032       echo '~^header list'
2033       read hl; vput vexpr es substring "${hl}" 0 1
2034       if [ "$es" != 2 ]
2035         echoerr 'Failed to read header list, bailing out'
2036         echo '~x'
2037       elif [ "$hl" @i!% ' cc' ]
2038         echo '~^header insert cc Diet is your <mirr.or>'
2039         read es; vput vexpr es substr "${es}" 0 1
2040         if [ "$es" != 2 ]
2041           echoerr 'Failed to insert Cc:, bailing out'; echo '~x'
2042         end
2043       end
2044     }
2046 - "The .netrc file"#38
2048   + gained support for comments.
2049     (Walter Alejandro Iglesias, Ralph Corderoy)
2051   + `netrc'#237 now has a "load" subcommand.
2053   + the new *netrc-pipe*#484 obsoletes OPT_AGENT and
2054     *agent-shell-lookup*, and can be used to load an encrypted
2055     .netrc file, e.g.:
2057       ? set netrc-lookup netrc-pipe='gpg -qd ~/.netrc.gpg'
2059     I.e., this is in usual .netrc syntax and thus possibly much
2060     nicer than saying "? source 'gpg -qd ~/.credentials.gpg |'".
2062 - termcap(5) / terminfo(5) support has been changed backward in-
2063   and upward (from user interface side) compatibly, please read
2064   "On terminal control and line editor"#18.
2066   + OPT_TERMCAP is by default enabled.
2067     The new, by default enabled, configuration option
2068     OPT_TERMCAP_VIA_TERMINFO can be used to (try to) use
2069     terminfo(5) instead.
2071   + The variable *termcap*#583 can be used to freely define or
2072     override terminal capabilities, and *termcap-disable*#585 will
2073     disable interaction with the chosen library, leaving only
2074     *termcap* in charge.
2076     To use the so-called ca-mode on supporting terminals,
2077     effectively turning S-nail into a fullscreen application,
2078     *termcap-ca-mode*#584 must be set.
2080   + The built-in line editor has been rather completely rewritten
2081     to be the Mailx-Line-Editor (OPT_MLE, default yes), and
2082     supports wide glyphs (if possible), infinite line lengths
2083     (2 GB) and more.  Tabulator expansion is no longer an option
2084     (but needs fnmatch(3)).
2086   + Optionally (OPT_KEY_BINDINGS, default yes) it has become
2087     possible to freely define key bindings for the MLE via the new
2088     `bind'#150 and `unbind'#151 commands.  These key bindings can
2089     make use of termcap(5) and/or terminfo(5) names.  The MLE will
2090     install a set of default bindings (unless there is a set
2091     *line-editor-no-defaults*#456), more so with OPT_TERMCAP,
2092     i.e., try "? bind*".
2094     Sufficient support provided, one can now, e.g., type "p " and
2095     then collect the message numbers to type, scrolling forward
2096     and backward via key-bindings, without losing the line
2097     content, then commit the final line.
2099   + OPT_EDITLINE and OPT_READLINE support have been dropped.
2100     The new MLE should not miss anything.  Does it?
2101     Tip: in an UTF-8 locale try "? !touch /tmp/hall{,öchen}" and
2102     then autocomplete that: once, then ^Q, and again.
2104 - `source'#281 can be used in `call'#152ed macros.
2105   What sounds so innocent replaced an entire machinery and got rid
2106   of a brilliant idea of Kurt Shoens from the 70s, but which never
2107   worked with Nail/Heirloom extensions, namely macros, and in the
2108   right order.
2109   Accompanying this -X#87 can (dig multiline arguments and can) be
2110   used to define macros and run them etc.  Should work:
2112     $ s-nail -X'define x {' -Xversion -Xx -X'}' -X'call x'
2113     $ s-nail -X'source \' -X'"echo version|"' -Xx
2115   Macros can be `undefine'#172d from within themselves, and re-
2116   `define'#171d.  It is still not possible to define macros
2117   from within macros, and/or have inner macros, not to talk
2118   about local scoping or anything more sophisticated such.
2120 - -u#84 / $LOGNAME#624 ($USER) handling has been redefined,
2121   and "-u USER" is now exactly the same as "-f %USER", and
2122   $LOGNAME (and $USER) is actively set to the active user.  (Afan)
2124   $LOGNAME#624 is POSIX standardized and henceforth used and
2125   preferred over $USER, which came from BSD.  (Todd C. Miller)
2127 - In the future (at least non-message-list) argument handling will
2128   be changed backward-incompatibly to be sh(1)ell compatible (and
2129   thus POSIX standardized), see "Shell-style argument quoting"#24.
2130   New commands use it already today (`bind'#150, `colour'#161,
2131   `headerpick'#209), some others (most importantly, `set'#269) can
2132   be forced to do so via the new `wysh'#131 command prefix, as in:
2134     ? wysh set message-inject-tail=$'\n--steffen'
2135     ? bind base $'\cA,\x61' 'echo control-A and small a'
2137 - We now actively manage *umask*#604: 0077 by default, but an
2138   empty string will use the setting that is active upon startup.
2139   Just like changes to (known) environment variables, this setting
2140   will also be inherited by any child process.
2141   (Walter Alejandro Iglesias)
2143 - Anything SENDMAIL / *sendmail*-ish has been renamed to *mta*#476,
2144   *mta-arguments*#478, *mta-no-default-arguments*#479 and
2145   *mta-argv0*#481.
2147   The reason is that in v15 we won't even have *smtp*: it is just
2148   another form of MTA, and thus obsolete by itself.
2149   Note that *mta-arguments* is now parsed via the shell-token
2150   parser, so the following ends up exactly as desired.
2152     ? set mta-arguments='-t -X "/tmp/my log"'
2154   For now we support a hack that understands a file:// URL in
2155   *mta*, too, but that is also the default if there is no protocol.
2156   E.g.: "? set mta=smtp://a:b@xy.z"
2158 - The "spamd" *spam-interface*#570 is obsolete.  I haven't tested
2159   it since my main machine died, it is error prone since it assumes
2160   internals of the spamassassin wire protocol, and there never was
2161   a speed improvement over "spamc".  (However it could react upon
2162   the "is-spam" state of a message, which "spamc" doesn't allow.)
2164 - The new *inbox*#449 variable will henceforth be looked up when
2165   searching for a primary system mailbox (as in "? File %"),
2166   followed by the usual $MAIL#625 and compile-time defined local
2167   mailspool search.  (Stephen Isard, Jürgen Daubert)
2169 - The semantic of -a#58 and `~@'#318 have been changed, and both
2170   commands now use the same syntax:
2172     -a file[=input-charset[#output-charset]]
2174 - New "failinvaddr" keyword for *expandaddr*#417.
2176 - We finally "can" the so-called (by myself) "Dr. Problem" (a bit):
2177   (Dr. Werner Fink)
2179     $ </dev/null s-nail -d:/ -sTrödler 'Dr. D. Iet <z@a.k>' 2>&1 |\
2180       grep To:
2181     s-nail: >>> To: "Dr. D. Iet" <z@a.k>
2183   This can be done via the new `addrcodec'#143, too, note this
2184   supports multiple modes (and the `vput'#130 command modifier):
2186     $ echo 'addrcodec e Dr. Diet <to@fu.soj> Curd' | s-nail -#:/
2187     "Dr. Diet Curd" <to@fu.soj>
2189 - All commands with the string "codec" in their name use different
2190   argument quoting, namely none at all, please read
2191   "Raw data arguments for codec commands"#26.
2192   This means that `urlcodec'#299 (and `imapcodec'#665) has
2193   slightly changed semantics.
2194   And, while here: there is a new `shcodec'#271, too.
2196 - We gained "Command modifiers"#22: `\'#125 (avoid expansion of
2197   `commandalias'#163es), `vput'#130 (store result in variable),
2198   `ignerr'#126  (ignore an error of the following command, even
2199   if the new *errexit*#414 is set), `wysh'#131 (use shell-style
2200   arguments).
2202     $ echo 'vput cwd resvar;echo $resvar' | s-nail -#:/
2203     /home/steffen/src/nail.git
2205   And the usual sh(1) stuff: `return'#264, `shift'#275, `eval'#192,
2206   plus a `xcall'#307 stack-avoidance optimization (to be used in
2207   place of a `call'#152 which would be the last called command).
2208   And an "expr(1) like thing", yet simple, `vexpr'#303.
2210     $ echo 'vexpr + 1 2' | s-nail -#:/
2211     00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000011
2212     03 | 0x3 | 3
2213     $ echo 'vput vexpr resvar + 1 2;echo $resvar' | s-nail -#:/
2214     3
2216   We actually start walking (*?*#348, *^*#350).
2218     ? vput vexpr res regex 'bananarama' 'Bana(.+)' '\$1\$0'
2219     ? echo $?/$^ERRNAME :$res:
2220     1/NODATA ::
2221     ? vput vexpr res iregex 'bananarama' '(.+)rama' '\$1\$0'
2222     ? echo $?/$^ERRNAME :$res:
2223     0/NONE :bananabananarama:
2225   The command `vpospar'#304 can be used to manage the stack of
2226   positional parameters, i.e., much like "set --".
2227   It also offers the possibility to save and restore the stack to
2228   and from variables.  Etc.
2230   Btw., to contact the maintainer (make.rc variables
2231   VAL_CONTACT_WEB and VAL_CONTACT_MAIL):
2233     ? echo $contact-web; eval mail $contact-mail
2235 - `if'#215 no longer performs automatic number conversion, we
2236   use the explicit -lt, -gt etc. syntax of the sh(1).
2237   Note: `if' will change to be almost identical to sh(1) if(1),
2238   so please ensure proper test bracketing, even if it is less
2239   convenient.
2241   Moreover, the default string comparison mode has changed to
2242   case-sensitive, just like in the shell.  This is because in the
2243   future this crux with trigger characters will vanish and `if'
2244   etc. will simply slurp in already expanded shell tokens, it will
2245   act like the shell in that respect.  We have modifiers, though,
2246   yet only "@i" for case-insensitivity, also for regex matches:
2248     LC_ALL=C
2249     i=`LC_ALL=C.utf8 s-nail -:/ -# -X '
2250        \define cset_test {
2251           \if [ "${ttycharset}" @i=% utf ]
2252              \echo $LC_ALL
2253              \xit 0
2254           \end
2255           \if [ "${#}" -gt 0 ]
2256              \wysh set LC_ALL=${1}
2257              \shift
2258              \eval xcall cset_test "${@}"
2259           \end
2260           \xit 1
2261        }
2262        \call cset_test C.UTF-8 POSIX.utf8 POSIX.UTF-8 \
2263           en_EN.utf8 en_EN.UTF-8 en_US.utf8 en_US.UTF-8
2264    '`
2265    [ $? -eq 0 ] && UTF8_LOCALE=$i
2267   Please note the `eval' in 'eval xcall cset_test "${@}".  This is
2268   a difference of S-nail/mailx and the sh(1)ell that will remain,
2269   as documented in "COMMANDS"#21: whereas the shell implements
2270   a language and performs standardized expansions on the line
2271   until finally the command is called, S-nail will decide the type
2272   of command line parsing dependent on the seen command, and will
2273   then perform a single expansion.  Therefore "${@}" will expand
2274   to multiple arguments if $# is greater 0, but it will expand to
2275   the empty string otherwise, which is not furtherly expanded away
2276   since it is meaningless like it is in the shell: therefore $#
2277   will be 1 (the empty string) not 0.
2279 - Using an explicit proto:// prefix should get you the desired
2280   thing apart of *newfolders*#485, e.g.:
2282     ? File maildir:///tmp/x.mdir
2283     ? copy * file:///tmp/x.mbox
2285 - New variable *record-files*#530 can be set to extend the meaning
2286   of *record*#529.  *record-resent*#531 was there already.
2288 - New variable *ifs*#445 acts a bit like the sh(1)ell's $IFS for,
2289   e.g., the new `read'#251 command.
2291   There is a `readctl'#254 command which can be used to manage
2292   the active channel used by `read'#251.
2294 - The `~' alias for `call'#152 is gone.
2296 - `mimetype'#225 only allows specification of a single type per
2297   call, on the other hand no need to quote that.
2299 - `mimeview'#227 must now be used explicitly to look at any
2300   non-text MIME part, for normal display etc. purposes we only
2301   support "copiousoutput"#651 MIME handlers.
2303 - New *socks-proxy*#569 can be used to proxy all network traffic
2304   over a SOCKS5 proxy.  (Gaetan Bisson)
2306 ChangeLog
2307 ^^^^^^^^^
2309 - The manual has seen another major overhaul, all the variables
2310   are now documented in a single, sorted list, and many
2311   clarifications should have been added.  I hope it has become
2312   a better read.
2313   (Predrag Punosevac, Michael Convey, Hariskar, Rudolf Sykora,
2314   Respiranto, Thomas Dickey, Donald Mugnai)
2316 - To support RFC 1524 a.k.a. .mailcap files (see below) many
2317   "trigger"-characters have been added for *pipe-TYPE/SUBTYPE*#502,
2318   which may (rarely) affect existing values.
2319   The .mailcap support itself is not yet implemented.
2321 - *mime-counter-evidence*#472 gained bit 4 (perform proper in-depth
2322   content inspection as necessary; set to 0xE for all bits).
2323   (Aharon Robbins)
2325 - Maildir paths are now created recursively as necessary.
2326   (Justin Ellingwood)
2328 - -M#73 and -m#74 options have been added to enforce a special
2329   send mode that will flag standard input / the given file with
2330   the specified / detected MIME 'Content-Type:'.  This can be used
2331   to directly send, e.g., HTML log output.
2332   (Viktor Szépe, Ralph Corderoy)
2334 - Disallow symlinks on writable files.  Note this requires
2335   O_NOFOLLOW support for the operating-system-call open(2), but
2336   which has been standardized a long time ago.
2337   (Matthew Dillon)
2339 - `retain'#263, `ignore'#216 etc. now differentiate in between
2340   From (the From: header) and From_ (the MBOX ident).
2342   In fact we now have a new `headerpick'#209 command which
2343   is a multiplexer for all retain and ignore lists used, call it
2344   without arguments to see the current setting(s).
2345   In v15 only `headerpick' and the standard-imposed wrappers
2346   `retain' and `ignore' will remain, all other wrappers will
2347   vanish.  Regular expressions can now be used if available:
2349     ? headerpick
2350       headerpick type retain blahblahblah cc date from \
2351         mail-followup-to message-id openpgp reply-to subject to \
2352         user-agent
2353       #headerpick type ignore currently covers no fields
2354       #headerpick save retain currently covers no fields
2355       headerpick save ignore '^Original-.*$' '^X-.*$' '^DKIM.*$'
2356       headerpick forward retain cc date from list-id \
2357         mail-followup-to openpgp reply-to subject to
2358       #headerpick forward ignore currently covers no fields
2360 - `top'#291 has been rewritten completely, `Top'#290 is new.
2361   It uses a built-in set of retain/ignore headers, but it is
2362   possible to register a custom set via `headerpick'#209.
2363   Also, *toplines*#600 has been extended a bit and the new
2364   *topsqueeze*#601 variable may pimp your `top' experience.
2366     ? headerpick top retain add subject
2367     ? top
2368     [-- Message  1 -- 87 lines, 4791 bytes --]:
2369     Subject: Re: I can't dist to myself
2371     I wrote:
2372         3.22. bounce_delivered
2374 - `features' has been dropped, `version'#302 extended.
2376 - The *prompt*#517 handling has changed: we lost the capability to
2377   expand \?, \@ and \$, instead new "private" variables *?*#348,
2378   *account*#361, *mailbox-resolved*#459 and
2379   *mailbox-display*#458 have been introduced, and the prompt
2380   is completely shell expanded (thus twice with `wysh' or in v15),
2381   as if dollar-single-quote quoted.  We do support the reverse-
2382   solidus escaped bracket notation for embedding characters which
2383   should not be counted when calculating the width of the prompt.
2384   The `colour'#161 command has a slot for the prompt colour.
2385   We gained *prompt2*#518 as a second level prompt.
2387     ? var prompt
2388     wysh set \
2389       prompt='?\${?}!\${!}[\${account}#\${mailbox-display}]? '
2391 - The filename "-" can be used as a receiver, e.g.,
2393     $ echo Hey,\ you | s-nail -:/ -Sexpandaddr -sUB -
2395 - The -s#81 command line option, the `~s'#340 command escape
2396   as well as the corresponding slots of `~^'#320 will actively
2397   strip [\r\n] from their value (Debian #419840).
2399 - New `read'#251 and `echoerr'#183 commands, mostly for
2400   *on-compose-splice*#492.
2401   But also `echon'#184 and `echoerrn'#185, which do not write
2402   a trailing newline.
2404 - New variable *r-option-implicit*#527 may be helpful to those
2405   who regulary need the functionality of the -r#79 command
2406   line option.  (Felipe Gasper, Martin Neitzel)
2408 - By using new "pseudo-URLs" one can automatize the use of S/MIME
2409   keys / (certificates / intermediate include certificates) with
2410   passwords.  E.g., to drive bob@exam.ple, set
2411   *smime-sign-cert-bob@exam.ple* to the private key / certificate
2412   pair as usual, the password lookup will then be performed for
2413   bob@exam.ple.smime-cert-key, bob@exam.ple.smime-cert-cert and
2414   bob@exam.ple.smime-include-certs.
2415   Like this the password can be stored in an encrypted .netrc file
2416   when *netrc-lookup*#483 and *netrc-pipe*#484 are set, or it may
2417   be stored in an encrypted resource file that has been loaded via
2418   `source'#281 as a simple *password*#500 variable.
2420   Note that the prompting that happens as a last resort of
2421   password lookup will still interfere with a possibly running
2422   $PAGER#631 instance, dependent on the setting of *crt*#403, of
2423   course.  Proper job control handling and recognizing that we are
2424   running $PAGER when doing that prompt is a TODO for v15.  Sorry.
2426 - Some commands, like `set'#269, `help'#212, `list'#217,
2427   `mlist'#228 etc., now react upon the setting of *verbose*#607
2428   and(/or) *debug*#407.
2430 - `write'#306 uses iconv(3) as appropriate.
2432 - *mbox-rfc4155*#464 has first been dropped, and was then
2433   reintroduced with different semantics.  Because, it can be
2434   helpful if a messed up MBOX is read, in which case we henceforth
2435   will warn you and point you to this:
2437     ? define mboxfix {
2438       \localopts yes; \wysh set mbox-rfc4155;\
2439         \wysh File "${1}"; \eval copy * "${2}"
2440     }
2441     ? call mboxfix /tmp/bad.mbox /tmp/good.mbox
2443   P.S.  Here you see how weird the current thing still is, in v15:
2445     ? define mboxfix {
2446       localopts yes; set mbox-rfc4155; File "${1}"; copy * -- "${2}"
2447     }
2449   And also in v15 we will not apply (proper) so-called MBOXO
2450   quoting, but instead (simply MIME) re-encode mail messages.
2452 - `call_if'#153 is new and, different to "? ignerr call", silent
2453   and not messing with the return status.
2455 - The new *smime-ca-flags*#554 and *ssl-ca-flags*#? can be used
2456   to fine-tune X509_STORE_set_flags(3) a.k.a the X509 CA
2457   certificate verification.
2459     ? set ssl-ca-flags=partial-chain
2460     ? wysh set smime-ca-flags="${ssl-ca-flags}"
2462   Also, *ssl-curves*#? for TLSv1.3.
2464 - Socket connections use TLS S(erver)N(ame)I(ndication) as
2465   appropriate (RFC 7817).
2467 - `alternates'#146 checks arguments and supports `vput'#130.
2468   It by default no longer replaces but appends alternates, unless
2469   *posix*#515 mode is active.  There is a new `unalternates'#147
2470   command to remove alternates.
2472 - A new `charsetalias'#156 command.  (Pietro Cerutti, mutt#3925)
2474 - New commands `filetype'#196 and `unfiletype'#197: in the future
2475   we will no longer know any builtin filetypes, in fact we already
2476   simulate .gz etc. via the new mechanism as necessary:
2478     ? filetype \
2479        bz2 'bzip2 -dc' 'bzip2 -zc' \
2480        gpg 'gpg -d' 'gpg -e' \
2481        gz 'gzip -dc' 'gzip -c' \
2482        xz 'xz -dc' 'xz -zc' \
2483        zst 'zstd -dc' 'zstd -19 -zc' \
2484        zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
2486 - `~<'#315 now offers a "- [HERE-delimiter]" mode for pasting etc.
2487   (Ralph Corderoy)
2489 - `exit'#193 and `quit'#250 take an optional exit status.
2490   (That is not fixated yet, though.)
2492 - We have a useful -h / --help output.  (Doug McIlroy)
2494 - *encoding* obsoleted in favour of new *mime-encoding*#473, which
2495   now defaults to base64.
2497 - *allnet*#363 now works (broken since nail 10.00, 2002-09-29).
2499 Appendix
2500 ^^^^^^^^
2502 The complete changelog of commits in between two versions OLD and
2503 NEW can be inspected by using the git(1) `log' command:
2505   $ git log --reverse --topo-order --abbrev-commit OLD..NEW
2506   # Only topic branch headers (--no-merges for content commits only):
2507   $ git log --oneline --reverse --topo-order --merges OLD..NEW
2508   # Same, but truly accessible:
2509   $ git log --oneline --reverse --topo-order --merges --parents OLD..NEW |
2510     while read c1 c2 c3 c4 c5 c6; do
2511       printf "%-24s: \$ git log --oneline --no-merges %s ^%s\n" \
2512         "${c6}" "${c1}" "${c2}";
2513     done
2515 Entries for releases before v14.9.0 have been cut off and can be
2516 found in the git(1) repository:
2518   v14.8.0 - v14.8.16: $ git show v14.8.16:NEWS
2519   v13     - v14.8.5 : $ git show v14.8.5:NEWS
2520   9.0     - 12.5    : $ git show heirloom:ChangeLog
2522 Also accessible via HTTPS?, just replace X.Y.Z accordingly:
2524   \https?://git.sdaoden.eu/browse?p=s-nail.git;a=blob_plain;f=NEWS;hb=refs/heads/release/vX.Y.Z
2526 For even older releases you need to look into the [timeline]
2527 branch, but no changelog has been administrated for them.
2529 # s-tm-mode