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