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