make-config.in: complete path (leftover of [807f64e2], 2015-12-26!)
[s-mailx.git] / NEWS
blob4e8eeac9ac8e49458c3c14facfa06313579309fd
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.11 ("Tit family enjoying a bath"), 2018-08-08
10 ---------------------------------------------------
12 A hot summer bugfix release, but it surely brings in some new
13 features, like TLS fingerprinting and `digmsg' message access.
15 An embarassing number of bugfixes have been seen, to fix IMAP UID
16 handling on 32-bit hosts, UTF-8, `readall' with empty lines, rare
17 endless iconv(3) loops, false qsort(3)ing of addressee lists,
18 crashes due to false user shell quoting, acceptance of "0" port
19 numbers, and more.  Most of these cases now have tests.
21 Credits, in order of commit appearance: Paride Legovini,
22 Andrew Gee, Olav Mørkrid, Kevin McCarthy, Michael Dressel,
23 Jürgen Bruckner, Robert Elz, Rudolf Sykora, Doug McIlroy,
24 Gavin Troy and Jörg Schilling.
25 A special credit to Coverity.com again, it found a bug!
26 (<https://scan.coverity.com/projects/s-nail>, project number 444.)
28 We welcome Andrew Gee, Kevin McCarthy, Michael Dressel,
29 Olav Mørkrid and Jürgen Bruckner in THANKS.
31 NOTES, ChangeLog (packager-affine)
32 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
34 - I have discovered that GnuPG can --export-secret-subkey so that
35   the real/full private key is no longer needed to --sign, and the
36   excerpts of the private one can have a different password, too.
37   So i have created a new for-signing subkey: EEC8C2FF.
39   Unfortunately it is not possible to verify new signatures with
40   the old public key, an update is necessary.  For example via
41     https://ftp.sdaoden.eu/steffen.asc
42   or just update 1883A0DD via normal gpg(1).
44 - Maildir support is now optional but default via OPT_MAILDIR.
45   (Paride Legovini)
47 - I hope for the last time there has been a change to SSL
48   configuration: i have renamed all ssl* variables to tls*.
49   The old ssl* ones still exist until v15, though, yet obsoletion
50   warnings will be produced.
51   This is so because i expect that in a not too distant future
52   only the term TLS will be around.
54   Also the term CipherList was falsely used, it should have been
55   CipherString.
57 - Most (if not all) commands which take a message list and a file
58   target now use shell-style quoting.  (Before that say `copy'#157
59   scanned backwards over "something possibly quoted", took that
60   off, then treated the rest as a message list.  Now shell tokens
61   are parsed starting at the front, the last is taken off, and
62   anything before that is the message list.)  (Gavin Troy.  2013.)
64 - `~^#'? "header show" now backward-incompatibly shows the address
65   type in field 1, but since this _only_ applies to non-network
66   addresses i made the change.
68 - We will find ncurses on DragonFly BSD.
70 - On Solaris tests no longer need GNU cksum(1): the Solaris cksum
71   is different only for whitespace separators.  (Jörg Schilling)
73 - All generated files reside in .obj/, and the tests run in there,
74   too.  A "rm -f .obj" should suffice to clean anything up.
76 ChangeLog
77 ^^^^^^^^^
79 - `~F'#318, `~f'#319, `~M'#324, `~m'#325, `~U'#333 and `~u'#334
80   now default to the current message (the "dot").  (Andrew Gee)
82 - *indentprefix*#428 handling has had its pitfalls when quoting
83   messages.  (Andrew Gee)
85 - -r#76 will again set *from*#410 even after -S#77 has been used
86   to set *from*.  (Michael Dressel)
88 - No longer process From: (*from*#410) content via `alternates'#?
89   when Sender: (*sender*#510) is set.  (Michael Dressel)
91 - Because the priority class of headers was not taken into
92   account, it could happen that addressees in Cc: would remain but
93   the same in To: were removed.  (Michael Dressel)
95 - IMAP accounts for RFC 4551 (and 7162) and supports 64-bit
96   UIDVALIDITY.
98 - *spamfilter-rate-scanscore*#546 could crash if specification
99   did not match program output.
101 - Shims for TLSv1.3 support, e.g., for *tls-config-pairs*#558.
103 - Obsoleted *dotlock-ignore-error*, added *dotlock-disable*#392.
104   (Paride Legovini)
106 - In compose-mode, removing the In-Reply-To: header breaks an old,
107   and starts a new thread.  (Doug McIlroy)
109 - Added new *forward-inject-tail*#409, *quote-inject-head*#493
110   and *quote-inject-tail*#? variables, and extended the meaning
111   of *quote*#489.
113   All of *{forward,quote}-inject-{head,tail}* now support
114   a compose-mode specific set of formats (see
115   *quote-inject-head*#493), for now a few only.
116   (This adds meaning onto the content of *forward-inject-head*#408
117   as introduced in v14.9.0.)
119   The generated output honours *quote-fold*#492, which now takes
120   an optional third argument in order to produce better output.
122   While here, introduce the new command escape `~Q'#327 which
123   performs full *quote*#489 cycles on the given message list.
125 - Fcc: headers are now understood in -t#79 templates or when
126   placed in compose mode (`~v'#335, *editalong*#393 etc.).
127   Since each such header only takes one addressee, no quoting
128   issues apply, the entire header body is the value.
130 - `~|'#310 will pass the entire message including headers when
131   used as "~||", e.g., prepend a file-carbon-copy message header:
133     ~|| echo Fcc: /tmp/test; cat
135 - New `tls'#280 multiplexer command.  Yet primitive and only
136   supports a `fingerprint' subcommand.  Supports `vput'#121.
138   The new *tls-fingerprint*#562 variable chain aids in adding
139   support for connection verification without an installed CA
140   certificate pool in conjunction with the new
141   *tls-fingerprint-digest*#563 chain.
143   Consequently *smime-sign-message-digest* has been renamed to
144   *smime-sign-digest*#530 (old version will cease in v15).
145   The latter now defaults to SHA512 if possible.
147 - New MLE commands mle-go-screen-bwd and mle-go-screen-fwd to go
148   backward and forward one screenful.
149   And a new mle-clear-screen command.  (Todd C. Miller)
151 - New *expandaddr*#398 setting "shquote" will evaluate addresses
152   as if specified within $'' shell-quotes for -b#57, -c#59,
153   and all direct command line receivers.  This allows for, e.g.,
155     $ s-nail -Sexpandaddr=shquote '\$contact-mail'
157 - *quote-as-attachment*#490 no longer needs to be set before
158   compose mode is entered in order to become honoured.
160 - Even for -H#66 or -L#69 *folder-hook*#403s will now be called.
161   Possible sorting is also applied.
163 - `='#129 now optionally supports message list arguments and the
164   `vput'#121 modifier in order to store the result list.
166   The new `digmsg'#165 multiplexer adds some message access, just
167   like `~^'#311 does in compose mode.  In fact the set of commands
168   is shared, yet only in compose mode `digmsg' can change messages
169   or access attachments until v15, however.  For example,
171   ?0[steffen@essex nail.git]$ cat > /tmp/z.rc <<'_EOT'
172   define one {
173      if [ "${#}" -gt 0 ]
174         digmsg create $1 - # no `read'/`readall' overlay but stdout
175         #digmsg $1 header list
176         digmsg $1 header show subject
177         digmsg remove $1
178         shift
179         \eval xcall one "$@"
180      \end
181   }
182   define all {
183      local set all # localize ("localopts yes" would do too)
184      vput = all *; echo all: $all; eval call one $all
185   }
186 _EOT
187   ?0[steffen@essex nail.git]$ MAILRC=/tmp/z.rc \
188     .obj/s-nail -:u -Snoheader -Squiet -Rf /tmp/z
189   ? call all
190   all: 1 2 3
191   212 Subject
192   Re: [S-mailx] FYI: after USB stick loss i have rotated keys, plus
194   212 Subject
195   Re: Problem with page?
197   212 Subject
198   Re: s-nail Source ...
200   ? x
202 git(1) shortlog (edited)
203 ^^^^^^^^^^^^^^^^^^^^^^^^
205 Steffen Nurpmeso (203):
206 81e5960e nail.1, nail.rc: fix spelling (Paride Legovini)
207 bde9329f FIX hasty [ab7aab0e] (Account for drafted 64-bit IMAP UIDs..)..
208 5169d3ba collect(): ~[FfMmUu]: should default to the "dot" (Andrew Gee)
209 068d202d THANKS: Andrew Gee
210 662d9762 send.c:sendpart(): fix *indentprefix* handling for SEND_QUOTE (Andrew
211         Gee)
212 ca61f59a Elder groff mdoc do not have str-Lb-libterminfo (Olav Mørkrid)
213 a234b4ec GSSAPI: fix gss_buffer_desc usage (since EVER!) (Kevin McCarthy)..
214 89fc94e7 THANKS: Kevin McCarthy
215 4c67719c makefile: do not "exit 1" in __prestop, exit 0 instead (Paride
216         Legovini)
217 2978064a nail.1: clarify MBOX locking strategy (Paride Legovini)
218 0994c919 n_utf8_to_utf32(): FIX extending cast, broken in [5f951f7b] (on
219         2018-01-09!)
220 92c49370 n_iconv_str(): FIX possible endless loop due to insufficient growth
221 12216988 Fix: allow -r to set from after -Sfrom= (Michael Dressel)..
222 8a5a123c THANKS: Michael Dressel
223 c1737baf Do not process From: alternates if Sender: is set (Michael Dressel)..
224 9e101e33 a_nag_elide_qsort(): FIX false sorting (Michael Dressel)..
225 b6bc7c4e THANKS: Olav Mørkrid
226 094689b0 quoteflt_dummy() usage: FIX usage without preceeding _reset() (Jürgen
227         Bruckner)
228 79717b95 THANKS: Jürgen Bruckner
229 bfca0fae IMAP: account for RFC 4551 (and 7162): support 64-bit UIDVALIDITY
230 4ed7448b resend_msg(): FIX: actually honour delayed errors!
231 9408d084 _spamfilter_interact(): FIX: *spamfilter-rate-scanscore* could cause
232         crashes..
233 a94e7323 a_cmisc_echo(): for `echoerr', ensure *log-prefix* is placed
234 8412796a n_cmd_arg_parse(): FIX token error -> crash, e.g. "-RX 'bind;echo $?'
235         -Xx"..
236 b4c80a76 c_readall(): FIX handling of empty lines (with test)
237 12969c7a Add shims to support TLSv1.3 via OpenSSL
238 a6bd8490 Add notes on (yet) impossible fullfillment of user glob desires
239         (Robert Elz)
240 bbc1b6b2 Now with `wysh set', obsolete `varedit'
241 f4c83d11 Truly support timeout on connect(2)s (Olav Mørkrid)
242 dbdf875c nail.1: *ssl-ca-dir* requires special preparation (Olav Mørkrid)
243 7fde1386 cc-test.sh: add t_behave_quote_a_cmd_escapes() (Andrew Gee)
244 7f32bdc4 make.rc,make-config.sh: add OPT_USAN (UndefinedBehaviorSanitizer)
245 ea358268 ok_b_ssl_no_default_ca: forgot to make that obsolete! (Olav Mørkrid)
246 2748ee6a a_main_getopt(): treat --version as -V
247 bf3185a7 Drop $OSENV; instead stuff for *verbose* `version' (Paride Legovini)
248 0f48cacd cc-test.sh: --check-only: keep files on err if in a repo (Paride
249         Legovini)
250 165f6c10 Some: fix loosing->losing typo (Paride Legovini)
251 d363bd86 nail.1: (re)add doc. on PKCS#12 Cert/Key bundles (Rudolf Sykora)
252 4602b425 nail.1: (re)add s_client certificate fetch (Olav Mørkrid)
253 f1b42535 Obsolete *dotlock-ignore-error*, add *dotlock-disable* (Paride
254         Legovini)
255 083306aa Add OPT_MAILDIR, by default enabled (Paride Legovini)
256 d4696774 In compose-mode, removing In-Reply-To: starts thread (Doug McIlroy)..
257 7869c1c4 Support "#." message attachment <> the "dot"
258 a0bce049 Add *forward-inject-tail*, *quote-inject-{head,tail}*, `~Q'..
259 d7ec16ec *quote-fold*: add optional third argument to improve break algo
260 e4a8ad28 make-release.txt: new signing OpenPGP subkey
261 0065d878 Fix: allow -r to set from after -Sfrom=, II. (Michael Dressel)..
262 6aa3e44a Do not process From: alternates if Sender: is set, II (Michael
263         Dressel)
264 10cdea44 a_nag_elide_qsort(): FIX false sorting, II (Michael Dressel)[..]
265 3e0fa398 Fix (BWDIC!) `~^ header show': optionally show address type in field
266         1..
267 83f0ebaa Support Fcc: headers in -t'emplates and editor..
268 8961182f `edit',`visual': do allow multiple edits in non-interactive mode
269 5651b570 Add header editing for new `~||' (`~|' + |)
270 3a68df5a a_sendout_attach_msg(): MIME for Content-Description:!
271 3f85801e ([BWDIC!]) Big notational warp of SSL to TLS; drop rand EGD support
272 bc2e369d Add `tls' command..
273 059e5541 Add *tls-fingerprint-digest*;
274         *smime-sign-message-digest*->*smime-sign-digest*
275 a0efe35a MLE: add mle-go-screen-bwd and mle-go-screen-fwd
276 23c1adaa Add *tls-fingerprint* chain for CA-less connection verifications
277 7369013a MLE: add mle-clear-screen command (Todd C. Miller)..
278 c065b8c6 (BWDIC!) Add support for BLAKE2* and SHA3-* MDigests..
279 c00022e6 -b,-c,to-addr: support "as-if $''" via *expandaddr*=shquote
280 c1ae14f0 (BWDIC!) n_msglist(): warp to shell quoting rules!
281 f0e3b59e (BWDIC!) For -H and -L: call folder hook, (sort)++
282 aaf632a5 Drop laststring()! (Gavin Troy; in December 2013!)
283 6301c5f2 *quote-as-attachment*: handle in compose-mode, very last..
284 52dfe017 With *posix* honour `alternates' only for replies/aliases (Michael
285         Dressel)
286 dee9c247 Solaris: native cksum(1) works with WS strip via sed(1) (Jörg
287         Schilling)!
288 ab0313ff `=': support `vput' and an optional <msglist> argument
289 e92385e3 Add `digmsg', a yet primitive "message info digger"
291 v14.9.10 ("(40th Mail anniversary) Blue tit"), 2018-03-25
292 ---------------------------------------------------------
294 On this day in 1978 Kurt Shoens placed the following comment in
295 def.h (now it is in nail.h):
297   /*
298    * Mail -- a mail program
299    *
300    * Author: Kurt Shoens (UCB) March 25, 1978
301    */
303 v14.9.10 is mostly a stability and bugfix release.
304 It has seen a full test series including Coverity.com scans.
305 It fixes bugs i have introduced (also a double free in IMAP cache
306 that i introduced for v14.9.* series to address Coverity CID
307 1376978..).
309 In the end i am saying thanks to Gunnar Ritter for the IMAP
310 module, and absolutely especially his really neat idea of an IMAP
311 cache including offline work queue.  (IMAP will nonetheless
312 temporarily go in v15, but these ideas will come back thereafter.)
313 I have gray hairs now.
315 Credits, in order of commit appearance: William Yodlowsky,
316 Stuart Henderson, Jörg Schilling, Viktor SZÉPE, Rich Felker,
317 Ralph Corderoy and Philipp Gesang.
319 A special credit to Coverity.com again.  Because:
320     tcc is 618496 bytes, pcc is 851968+24576 bytes,
321     but gcc is 73355264 bytes and clang is even
322     147406848 bytes, i wonder why the latter two never
323     said a word that would have addressed the pretty
324     obvious CID 1387053!
325     [Use of initialized value, the author.]
327 We welcome Stuart Henderson and Philipp Gesang in THANKS.
329 NOTES, ChangeLog (packager-affine)
330 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
332 - The balls are now build with umask 0022 not 0027.
333   (William Yodlowsky, Stuart Henderson)
335 - One actual development of this version was the addition of
336   multiple choice VAL_ues, as documented in make.rc.
337   For now we have VAL_IDNA (for OPT_IDNA)
338     VAL_IDNA="idnkit idn2 idn"
339   and VAL_RANDOM (by itself)
340     VAL_RANDOM="arc4 ssl libgetrandom sysgetrandom urandom builtin"
341   (Stuart Henderson)
343   In brief:
344     The value is interpreted as a whitespace separated list of
345     strings, like "idn2 idn idnkit", case is ignored, order is
346     important.
347     The special strings "all" and "any" as well as the empty value
348     are wildcard matches; if any entry in the list is a wildcard
349     match, the rest of the list is ignored.
351     The special string "error" will abort configuration once its
352     list position is reached; this is only supported if
353     documented, and not with an accompanying OPT_ (which then
354     offers "require", as below).
356   Since this VAL_RANDOM approach is so much better i have dropped
357   OPT_SSL_RANDOM and OPT_NOEXTRANDOM that were recently
358   introduced again.  They were c..p.
360 - Support for idnkit 2.3 has been added.
361   Support for idnkit 1 (especially as idnkitlite) has been fixed.
363 - For the first time this codebase should be able to handle
364   invalid MBOX mailboxes (produced by, e.g., dma(1)) gracefully.
365   I hope i have found all places (sic) where code has to be fixed.
366   E.g., "? copy * INVALID-MBOX" now works.
367   (Smalltalk already knew objects which know what they are doing
368   are for the better...  This is v15, then.)
370 - P.S.: the two FreeBSD test failures are noted in INSTALL.
372 ChangeLog
373 ^^^^^^^^^
375 - *asksend*#357 will now really allow recomposing.
377 - `help'#203 now supports recursive `commandalias'#154es, and
378   command self-recursion detection now works differently, it has
379   been false for something like
381       commandalias x q; commandalias q echo au
383   since q became expanded to `quit'#238 (alias expansion equals
384   new command word).  New behaviour: we allow equals once:
386     commandalias q q; commandalias x q; x
387   ->
388     x -> q -> q -> quit
390 - *editalong*#393 can have a value, say "set editalong=v" and it
391   will startup $VISUAL#604 not $EDITOR#582.
393 - Path separators are now normalized, thus all places, including
394   MLE tab-expansion ("On terminal control and line editor"#17),
395   can expand something like "///t*////t*".
397 - -E#62 flag will not be obsoleted.
398   -D#60 flag has been reintroduced (sets *disconnected*#629 right
399   away, was not reinstantiated with the rest of the IMAP support.)
401 git(1) shortlog: Steffen Nurpmeso (71)
403 v14.9.9 ("Marsh tit savours first spring sun, II") 2018-03-06
404 -------------------------------------------------------------
406 A bugfix release.
407 I hope with this the fallout of the Christmas 2016 "address the
408 Dr. Problem workshop" has been fully resolved and thus MIME for
409 header address fields, even if iconv(3) is involved, been fully
410 restored!  We have even more tests for this now.
412 The release v14.9.8 was broken on big endian machines.
413 I will remove the v14.9.8 balls from the server by the weekend.
414 Sorry for the inconvenience!
416 Credits, in order of commit appearance: Slavko, Matej Mužila,
417 Rich Felker, Simon McVittie, Paride Legovini, Cág,
418 Predrag Punosevac.
420 We welcome Slavko, Matej Mužila, Rich Felker and Simon McVittie in
421 THANKS.
423 NOTES, ChangeLog (packager-affine)
424 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
426 - The v14.9.* series called *pipe-TYPE/SUBTYPE*#471 handlers in
427   display or quote mode with CR (carriage-return) bytes stripped
428   because of a missing output file comparison check, which broke
429   binary formats etc.  (Slavko)
431 - We now have native support for Libidn2.  (Matej Mužila)
433 - uname(1) is now hookable by setting the shell variable uname
434   when calling make ("uname=MY-UNAME make config" etc.).
435   (Simon McVittie)
437   We no longer bake the kernel version into the binary, and
438   `version'#293 includes uname(2) output.
439   (Simon McVittie, Paride Legovini)
441 - We now support a fallback P(seudo)R(andomNumber)G(enerator)
442   initialization even if getrandom(2)/getrandom(3) has been found
443   by the configuration, just like we do for "/dev/urandom" usage.
444   This does not affect systems with arc4random(3) or OpenSSL
445   random usage.  (David Čepelík, Simon McVittie)
447   A new OPT_SSL_RANDOM make.rc variable, by default initialized to
448   the value of OPT_SSL.
450 ChangeLog
451 ^^^^^^^^^
453 - `~@'#309 list-edit behaviour in -##85 batch mode was broken.
455 - Character set names will now undergo generic normalization,
456   including stripping of iconv(3) //SUFFIXes.
458 git(1) shortlog: Steffen Nurpmeso (33)
460 v14.9.7 ("Marsh tit patiently scraping bark") 2018-02-16
461 --------------------------------------------------------
463 A maintenance release which fixes bugs and brings in features.
465 Credits, in order of commit appearance: Alexander Harm,
466 Viktor SZÉPE, Paul Eggert, Joseph Bisch, Paride Legovini,
467 and Peter J. Holzer.
468 A special credit to the disappearing mutt(1) bug tracker.
469 And to Gmane.org for creating gmane.mail.s-mailx.general!
471 Thanks Paride Legovini for becoming maintainer of the Debian port.
473 We welcome Joseph Bisch, Paride Legovini, and Peter J. Holzer in
474 THANKS.
476 NOTES, ChangeLog (packager-affine)
477 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
479 - The USB stick loss reported for v14.9.6 was fake news, so to
480   say, the stick exists and therefore the old key is not
481   compromised.
483 - We are back at Gmane.org!
484     news.gmane.org/gmane.mail.s-mailx.general
486 - `history'#204 has learned to be context-sensitive a bit, and
487   has two new subcommands, `load' and `save'.
489     This is in parts backward incompatible because it needs a new
490     *history-file*#416 format; however, the old format can be loaded
491     yet compose-mode commands will not appear in compose mode no
492     more.  Iirc you can start with an old format then `save' to
493     the new, then replace the "d" in the first column with "c" for
494     compose-mode commands which should appear correctly.
496 - Obsoletion warnings for variables now happen at `set'#260
497   time instead of when used.  Running once via -v#82 may
498   be beneficial.
500 - The saturation modifier of `vexpr'#294 is henceforth a prefix,
501   the suffix version is obsolete (but still supported for a while).
503 - A network address that contains no domain-, but only a valid local
504   user <name> in angle brackets will be automatically expanded to
505   a valid address when *hostname*#421 is set to a non-empty value;
506   setting it to the empty value instructs us that the used *mta*#450
507   (including builtin SMTP) will perform the necessary expansion.
508   (Viktor SZÉPE)
510   Note that *hostname*#421 as well as *smtp-hostname*#533
511   will now undergo IDNA expansion if IDNA is supported.
513   And *from*#410 and *sender*#510 are now verified at `set'#260
514   time, not when used.  (Viktor SZÉPE)
516 - The commit message in [d503bd82] is wrong, apologies to
517   Paride Legovini.  The test(1) operator "-n" appeared in Seventh
518   Edition UNIX, not V8 as falsely claimed.
520 ChangeLog
521 ^^^^^^^^^
523 - Our `addrcodec'#134 parser chokes on lesser constructs.
525 - Presence of command-line MTA arguments without *expandargv*#399
526   are now a hard error.  It was my fault that this was not the
527   default from the very start.  (Viktor SZÉPE)
529 - Seen on the mutt bug tracker, we also still have had problems
530   with time settings that cross 32-bit boundaries.  As that is
531   in parts induced by the C standard, now implement those parts on
532   our own, and be super careful in general.  (Joseph Bisch)
534 - The `~@'#309 command escape did not shell-unquote the user input
535   again and was thus a bit broken; message attachments also work
536   again.
538 - Support custom headers from the command line via -C#58.
539   And *customhdr*#386 is verified upon `set'#260 time.
541 - The simple builtin HTML viewer now supports <blockquote>
542   elements, which many web mailers, most notably gmail, use for
543   citation.  (Peter J. Holzer)
545 git(1) shortlog: Paride Legovini (1), Steffen Nurpmeso (66)
547 v14.9.6 ("Marsh tit abiding a snow storm"), 2017-12-05
548 ------------------------------------------------------
550 A bugfix release which fixes four serious and three other bugs.
551 A few new features came in, too.
553 Many thanks go to Ralph Corderoy who reported an issue that was
554 caused by a terrible, terrible word reversal that i managed to
555 produce in December 2016, and which caused the v14.9.x series to
556 not MIME encode (non-address) content of address header fields!
558 Credits, in order of commit appearance: Thomas Dickey,
559 Andreas Baumann, Erich Eckner, Gaetan Bisson, Solar Designer, Cág,
560 Ivan Tham, Ralph Corderoy and Doug McIlroy.
562 We welcome Andreas Baumann, Erich Eckner, Solar Designer and Cág
563 in THANKS.
565 NOTES, ChangeLog (packager-affine)
566 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
568 - After USB stick loss the authors OpenPGP key has been switched to
570     pub   4096R/1883A0DD 2017-11-30 [expires: 2027-11-28]
571           Key fingerprint =
572             EE19 E1C1 F2F7 054F 8D39  54D8 3089 64B5 1883 A0DD
573     uid                  Steffen Nurpmeso <steffen@sdaoden.eu>
575 - $TMPDIR#602 no longer honoured for root runs.  (Solar Designer)
577 - *mime-encoding*#448 defaults to quoted-printable again.  (Cág)
579 - We _can_ MIME encode even header fields which contain addresses.
580   Thanks to Ralph Corderoy we now also _do_ so again!
582 ChangeLog
583 ^^^^^^^^^
585 - ***#336 now uses *ifs*#423 when splitting.
587 - Freezing *ttycharset*#568 via -S#77 also survives using or
588   setting any of $LC_ALL#584, $LC_CTYPE#585 and $LANG#586 during
589   program startup.
591 - New `local'#118 command modifier to localize changes.
592   Yet supported only for `set'#260, i.e., we have gained
593   macro-local variables.
595 - `vexpr'#294 now supports a BASE#number notation for integers,
596   like 16#AFFE as an alternative to 0xAFFE.
598   Hint: variable settings can most often use several bases, too,
599   e.g., i have "set mime-counter-evidence=0b1111".
601 - Very simple form of *quote-chars*#491 to adjust our knowledge of
602   what actually is to be treated as a quote character.
604 - *mime-counter-evidence*#447 deep inspection (bit four) has
605   been improved for the sole cases of quoting or displaying
606   a message.  So messages with less than 25% of control characters
607   and such will now be displayed (made printable).  This is yet
608   not configurable nor do we have a way to easily access a message
609   with more than that.  (Doug McIlroy)
611 git(1) shortlog: Steffen Nurpmeso (44)
613 v14.9.5 ("Marsh tit engaged with a peanut"), 2017-10-21
614 -------------------------------------------------------
616 A bugfix release which fixes two bugs which were cast in stone.
617 A few compatibility improvements (AlpineLinux, Solaris).
618 And minor features.
620 Apologies to Jörg Schilling, a git bug i think it was who caused
621 joining of changesets, losing a credit, and it had been pushed to
622 [master] before the problem was realized.
624 Credits, in order of commit appearance: Jörg Schilling,
625 Doug McIlroy, Random832, Nick Stoughton and Ivan Tham.
627 We welcome Nick Stoughton and Ivan Tham in THANKS.
629 NOTES, ChangeLog (packager-affine)
630 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
632 - New OPT_USE_PKGSYS option can be disabled to not automatically
633   pick known package system paths (pkg(7), OpenCSW, schily).
634   (Jörg Schilling)
636 ChangeLog
637 ^^^^^^^^^
639 - The software indeed _never_ dealt with iconv(3) output character
640   set errors (as opposed to invalid input character set byte
641   sequences etc.) for the main message body!
642   And I have missed that when i tweaked our iconv layer a bit!
644 - Fixed a race condition with sigsuspend(2) that i could only see
645   on OpenBSD.  config.h offers n_SIGSUSPEND_NOT_WAITPID, by the
646   way, which saves some systemcalls and did not run races, but
647   noone adjusts this file.
649 - Message list specifications gained two new colon modifiers, one
650   can now "search :Ll" to find "Mailing lists"#10.
651   The *headline*#413 format %T now also uses L and l rather than
652   S and L accordingly.
654   New `addrcodec'#134 subcommand `skinlist' acts like `skin'
655   but stores in *!*#339 *^ERR*#341-EXIST if the address is
656   one of the known "Mailing lists"#10.
658 - `echo'#172 family now supports `vput'#121 and *!*#339 error
659   storage, offering some kind of printf(1) experience, almost.
661 git(1) shortlog: Steffen Nurpmeso (35)
663 v14.9.4 ("(5th anniversary) Marsh tit"), 2017-09-18
664 ---------------------------------------------------
666 This is an update feature release but which also ships a furious
667 number of bug fixes, about six of which were pretty serious.  It
668 also applies overall trimming, and improves configuration time
669 compatibility on macOS.
671 Thanks to Alexander Harm there is now a macOS Homebrew package.
673 Credits, in order of commit appearance: Paul Vojta, Daniel Lublin,
674 Alexander Harm, Norman Ramsey, Viktor Szépe, Rich Salz,
675 David Čepelík, Ralph Corderoy, Stéphane Chazelas, Aharon Robbins,
676 Ken Hornstein.
678 We welcome Daniel Lublin, Alexander Harm, David Čepelík and
679 Stéphane Chazelas in THANKS.
681 NOTES, ChangeLog (packager-affine)
682 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
684 - Out-of-tree builds have become possible via the new
685   make-emerge.sh script:
687   $ cd /tmp && mkdir build && cd build &&
688     ~/src/nail.git/make-emerge.sh &&
689     make tangerine DESTDIR=.ddir
691   We now have a `citron' make target which is like `tangerine' but
692   does not run the tests.
694 - Configuration with OPT_AUTOCC honours $CC=cc. (Norman Ramsey)
696 - SSL/TLS configuration has been revamped (again) in order to
697   support new possibilities of OpenSSL (and LibreSSL) without
698   ending up and introducing more and more variables.
700   Instead we now have *ssl-config-pairs*#?, a comma-separated
701   list of all options.  With e.g. OpenSSL 1.1.xx this will be
702   directly passed through to SSL_CONF_cmd(), so there _anything_
703   can be passed, otherwise we use a builtin parser to map.
704   The new *ssl-features*#? states what is supported.  E.g.:
706     if [ "$ssl-features" =% +ctx-set-maxmin-proto ]
707       wysh set ssl-config-pairs='\
708           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
709           Curves=P-521:P-384:P-256,\
710           MinProtocol=TLSv1.1'
711     else
712       wysh set ssl-config-pairs='\
713           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
714           Curves=P-521:P-384:P-256,\
715           Protocol=-ALL\,+TLSv1.1 \, +TLSv1.2'
716     endif
718   OpenSSL v1.1.xx also introduces an interesting and neat idea to
719   centralize SSL/TLS configuration of (all) programs in a single
720   file.  This can be driven via *ssl-config-file*#? and the new
721   *ssl-config-module*#? variables, several entries per program
722   are allowed, see *ssl-config-module*#? for an example.
724   New manual section "Encrypted network communication"#13.
726 - Variables set or unset via -S#77 are now frozen until program
727   startup is complete.
729 ChangeLog
730 ^^^^^^^^^
732 - Historical behaviour of *askcc*#355 / *askbcc*#356 has been
733   reintroduced.  (Norman Ramsey)
735   A new *asksend*#357 variable will show a final header summary
736   and allows reentering compose mode.  Set by default.
738   POSIX mirrors *ask* onto *asksub*#359, so dropped" the former.
740 - `~^'#311 no longer normalizes header names to titlecase.
742 - We no longer generate charset=binary MIME parameters.
743   This was introduced on 2013-01-02 and was i think owed to
744   file(1)s -i output as i failed to find any other reference.
745   (Normal Ramsey)
747 - *mime-alternative-favour-rich*#446 now also works for handlers
748   installed via *pipe-TYPE/SUBTYPE*#471. (Viktor Szépe)
750 - v14.9.* series did not generate In-Reply-To: headers!
752 - `alias'#135 now supports high-bit bytes and semicolon.
753   Expect that at some later time the input must be valid according
754   to the locale, though. (Norman Ramsey)
756 - Combinations of *record*#497 could crash because of an
757   unterminated variable function argument list. (Norman Ramsey)
759 - New command `readall'#240 loads an entire file into a variable.
761   *signature*#517 has been obsoleted.
763 - `vexpr'#294 now supports negative arguments for the substring
764   subcommand and adds trim, trim-front and trim-end subcommands.
766 - `!'#125 can be used in send mode.
768 - `~A'#312, `~a'#313, `~I'#322 and `~i'#323 will henceforth expand
769   \t and \n only if *posix*#484 is set.
770   Please use `set'#260 instead (with `wysh'#122, until v15).
772 - New "The mime.types files"#35 type marker: @q ("quiet").
774 git(1) shortlog (edited): Steffen (Daode) Nurpmeso (90)
776 v14.9.3 ("Crested tit nibbling sunflower seeds"), 2017-08-03
777 ------------------------------------------------------------
779 This is a bugfix release but which ships some improvements, too.
780 It silently replaces both of v14.9.1 v14.9.2 from earlier this
781 week, which were broken or not entirely fixed.
783 Credits, in order of commit appearance: Felix Fontein, Paul Vojta,
784 Ralph Corderoy, Christos Zoulas, Gavin Troy, Gaetan Bisson.
785 Thanks, Coverity.com.
787 We welcome Christos Zoulas in THANKS.
789 Apologies to Viktor Szépe for the false spelling of his name in
790 the v14.9.0 announcement.
791 And to Gaetan Bisson for not giving credit for [14fbce97]!
793 NOTES, ChangeLog (packager-affine)
794 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
796 - fakeroot support was blindly taken from Debian and broken.
797   (Gavin Troy, Gaetan Bisson)
799 - Base64 output was broken for cases which involved iconv(3).
800   The data is not lost, you can read it with S-nail v14.9.0 and
801   above, and save it somewhere.  I know of no other base64 decoder
802   which reads those things correctly, though.  We now have tests.
803   Along this i fixed an iconv(3) error which likely caused
804   stateful decoding (like, e.g., for ISO-2022-JP) to fail because
805   of an unnecessary reset of the iconv(3) state machine.
806   Thanks to Gaetan Bisson for mentioning this issue!
808 ChangeLog
809 ^^^^^^^^^
811 - In compose mode the MLE allows empty lines again.
813 - We no longer require a writable $HOME#583.  Due to false code
814   flow (but but but: with correct comment) a non-writable $HOME
815   entry in /etc/password (i.e., from getpwuid(3)) would lead to
816   a crash.  (Felix Fontain; Ralph Corderoy)
818 - Two faulty string operations slipped into the IMAP code,
819   resulting in a crash and a "is-same-host" test that would fail
820   for IMAPS connections like `save'#257 or `copy'#157 because of an
821   implicit IMAP protocol for the target of those operations (thus
822   IMAP != IMAPS).  (Paul Vojta)
824 - The MLE tab-expansion will now automatically append a "/" if
825   there is only one possible expansion and that is a directory,
826   saving the user one <TAB>.  (Christos Zoulas)
828   The shell expression parser had a bug regarding understood
829   metacharacters (;|&), which in turn could cause an infinite loop
830   in the MLE tab-expansion for, e.g., "move &9 +<TAB>", because
831   the "&" would never have been stepped over.
833 - New `~I'#322 command escape is like `~i'#323 but does not append
834   a newline.
836 - `localopts'#209 gained an optional second argument.
837   It is now possible to specify that any macro `call'#143ed
838   will have localopts enabled, and it is possible to fixate the
839   setting so that it cannot be reverted.
841 - *@*#345 should now act completely compatible to the sh(1)ell,
842   thus obsoleting my hysteric warnings in the v14.9.0 announcement.
844 - The `Lreply'#210, `reply'#245, `Reply'#244 series as well as
845   `mail'#212 now manage the error status *!*#339.
846   I.e., there are now errors like *^ERR*#341-DESTADDRREQ,
847   ^ERR-NODATA, ^ERR-PERM and similar.  It is not perfect yet,
848   because $DEAD#581 may have been written (with *save*#505) or not,
849   for example.
851   `Lreply' and `reply' have been rewritten rather completely
852   indeed.  They join Reply-To: and Mail-Followup-To: dependent on
853   the context (i.e., *reply-to-honour*#503, *followup-to-honour*#406,
854   see "Mailing lists"#10 for the picture), and if they did, use
855   this list as the receivers exclusively.  It now honours
856   *recipients-in-cc*#496 even for such addressees.  (And now i wonder
857   whether i should have credited Paul Vojta for that.)
859   Also `Lreply' would have crashed for mails with Reply-To: but
860   without *reply-to-honour*#503 set.  We now have a test.
862   Note *replyto* is obsoleted in favour of *reply-to*#502.
864 v14.9.0 ("Long-tailed tit"), 2017-07-16
865 ---------------------------------------
867 This is a major feature release which took about ~22 months (24
868 less two) of development to complete, and which imposed massive
869 changes under the hood, but also quite a lot of user visible
870 changes, including some **backward incompatibilities**.
871 As usual, "s-nail -d" will show obsoletion warnings.
873 We gain noticeable improvements regarding scriptability and its
874 reliability, but also for interactive use cases, especially
875 notable to users is our completely new M(ailx)L(ine)E(ditor) that
876 supports rather real tabulator expansion and program-mode-context-
877 sensitive key bindings.
879 We now support macros with arguments, which can be `shift'ed,
880 a `return' status can be used, and a `vexpr' multiplexer offers
881 some arithmetic and string operations.  `commandalias'es are
882 recursive, further command modifier prefixes, like `ignerr', give
883 a hand that we otherwise could not offer.  In compose-mode the new
884 `~^' command escape allows some message and attachment access, and
885 can be used, e.g., to implement things like custom headers, and
886 has been especially designed for scripted access via the new
887 *on-compose-splice* and *on-compose-splice-shell* hooks.
889 S-nail will move (more or less) backward-incompatibly to sh(1)ell
890 compatible argument quoting (documented in "COMMANDS"), and an
891 increasing number of commands do support this already: new ones
892 exclusively, some old ones have either been switched (like
893 `localopts'), others -- noticeably `set' -- can be switched to the
894 new syntax with a `wysh' command modifier prefix.  E.g.:
896   ? define __xv {
897     # Be careful to choose sh(1)ell-style on _entire_ line!
898      localopts yes; wysh set verbose; ignerr eval "${@}"; return $?
899     }
900   ? commandalias call echo boo-boo
901   ? commandalias xv call __xv
902   ? xv list
903   ? commandalias xv '\'call __xv
904   ? xv list
906 Calling the latter `xv' for `list' will give more detailed command
907 information, including which kind of argument is used.
909 I have not managed to implement the three features i have started
910 this development cycle for, these are thus subject to further
911 development, just like wysh for message-list argument commands to
912 support, e.g., negation, wysh for `if' and consorts, the --
913 terminator to finally overcome the ridiculous requirement to quote
914 entire shell commands filenames for commands like `pipe.
915 And and and.
917 Credits, in order of commit appearance: Antonio Radici,
918 Aharon Robbins, Mike Frysinger, Predrag Punosevac, Michael Convey,
919 Hariskar, Rudolf Sykora, Martin Neitzel, Gavin Troy,
920 Salvatore Bonaccorso, Todd C. Miller, Sergey Matveev, Robert Elz,
921 Mantas Mikulėnas, Respiranto, Jens Schleusener, Walter Alejandro
922 Iglesias, Ralph Corderoy, David Levine, Lyndon Nerenberg,
923 Thomas Dickey, Afan, Justin Ellingwood, Ingo Schwarze,
924 Viktor Szépe, Gaetan Bisson, Juan RP, William Yodlowsky,
925 Hilko Bengen, Matthew Dillon, Colin Watson, Donald Mugnai,
926 Stephen Isard, Jürgen Daubert, Sven Neuhaus, trondd, Ismael Bouya,
927 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
928 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
929 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, Xin LI.
931 We welcome Antonio Radici, Mike Frysinger, Predrag Punosevac,
932 Michael Convey, Rudolf Sykora, Todd C. Miller, Robert Elz,
933 Jens Schleusener, Walter Alejandro Iglesias, Thomas Dickey, Afan,
934 Justin Ellingwood, Viktor Szépe, Juan RP, Matthew Dillon,
935 Colin Watson, Donald Mugnai, Sven Neuhaus, Ismael Bouya,
936 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
937 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
938 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, and
939 Xin LI in THANKS.
941 Apologies: Sergey Matveev.
942 Members of the Roff community which await progress.
944 NOTES, ChangeLog (packager-affine)
945 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
947 * This release brings some backward incompatibilities, outlined
948   in the following.  Most users will not be affected, and we have
949   added a lot of compatibility cruft, but that will vanish in v15.
950   "$ s-nail -v"!
952 * The configuration and build system has changed.
953   Packagers have received updated package files.
955   o Anything which was WANT_xy before is now OPT_xy, and
956     compiled-in paths and values, like PREFIX or PAGER, have
957     gained a VAL_ prefix (thus VAL_PREFIX and VAL_PAGER).
959     This is _not_ true for non-persistent or environmental values,
960     e.g., DESTDIR, CC, etc., and also not for the overwritable
961     program variables during configuration, e.g., $awk.
963   o SENDMAIL -> VAL_MTA, SENDMAIL_PROGNAME -> VAL_MTA_ARGV0,
964     MAILSPOOL -> VAL_MAIL.
965     And NAIL -> VAL_MAILX, though this is still a lie.
967   o The make system now needs config..build..install or
968     all..install or tangerine (config..build..test..install).
969     Some constants which some experts may want to fine-tune have
970     been moved to config.h.  Usual adjustments+doc via make.rc.
972   o The `build' phase can be parallelized by setting the $MAKEJOBS
973     environment variable, e.g., "make MAKEJOBS=-j4 build".
974     Note this variable is not tracked in the configuration.
975     (Gaetan Bisson)
977   o Unless DESTDIR is set an uninstallation script will be
978     installed along with the rest (see INSTALL file for more).
980   o Set the new OPT_CROSS_BUILD to avoid feature runtime tests,
981     only compile- and link-availability will be tested.  (Juan RP)
983   o VERBOSE is implemented straight, but must be given at
984     configuration time in order to become honoured.
985     (William Yodlowsky)
987   o ADDCFLAGS / ADDLDFLAGS -> EXTRA_CFLAGS / EXTRA_LDFLAGS.
989   o The LD_LIBRARY_PATH etc. building processes will skip any path
990     which contains the string "fakeroot".  (Hilko Bengen)
992   o We honour a set $SOURCE_DATE_EPOCH#600 environment variable to
993     an extend that allows reproducible tests, which is why the
994     repository gained a [test-out] branch with some expected plain
995     text outputs.  (reproducible-builds.org; Colin Watson)
997     The new *log-prefix*#434 variable aids in improving the
998     reproducibility of error messages.
1000   o These are upward compatible changes.
1002 * "make OPENSSL_API_COMPAT=0x10100000 all" should work.
1004 * Internal and environment variables are now explicitly _defined_
1005   and _tracked_ after variable handling has been rewritten
1006   completely.  Notes:
1008   o This means that, e.g., "$ password=NOT_SECRET s-nail" will
1009     **NOT** work no more, since *password*#469 is an internal
1010     variable!
1012   o But if you do, e.g., "? set TMPDIR=~/tmp", then this will
1013     also be reflected in the program environment (it is an
1014     environment variable) and thus affect child processes.
1016   o Therefore we no longer have `setenv' and `unsetenv'.
1018   o To integrate any other environment variable transparently
1019     into our variable management, the new command `environ'#180
1020     needs to be used, e.g., "? environ set NEWVAR=value" or
1021     "? environ link EXISTINGVAR".
1023 - -H#66 and -L#69 have been decoupled:
1024    it used to be -e#63 -L#69 instead!
1026 - *NAIL_{HEAD,TAIL}* have been obsoleted in favour of
1027   *message-inject-head*#442 and *message-inject-tail*#443.
1029   *NAIL_HIST{FILE,SIZE}* have been obsoleted in favour of
1030   *history-file*#416 and *history-size*#419.
1032   *NAIL_EXTRA_RC* has been obsoleted in favour of
1033   *mailx-extra-rc*#437.
1035   *batch-exit-on-error* has been obsoleted by *errexit*#396, which
1036   works just like the POSIX sh(1)ell "set -e" construct; the
1037   `ignerr'#117 command modifier (`-' for command escapes in compose
1038   mode, and see below) can be used to ignore command errors even
1039   then.  (This will remain even if we at some later time will
1040   support at least some of the sh(1) constructs which "swallow"
1041   failures with set -e.)
1043   *bsdannounce* is obsolete, the feature is integrated in
1044   *header*#412 as this is much more useful.  (This is however also
1045   dependent upon the also new but well-known $POSIXLY_CORRECT#598
1046   <> *posix*#484, but that is just how it is; these affect more
1047   behaviour, and increasing.)
1049 - Colour support has been changed backward in- and upward (from
1050   user interface side) compatibly, see the manual section
1051   "Coloured display"#18.
1053   + New commands: `colour'#152 and `uncolour'#153.
1054     You can define context-sensitive, terminal-capability-
1055     sensitive settings, e.g.:
1057       if terminal && [ "$features" =% +colour ]
1058         colour iso  view-header ft=bold,fg=magenta,bg=cyan
1059         colour 256  view-header ft=bold,fg=208,bg=230 subject,from
1060         colour mono view-header ft=bold
1061         colour mono view-header ft=bold,ft=reverse subject,from
1062       endif
1064   + The variable *colour-pager*#382 defines whether colour and font
1065     attribute sequences should be generated when viewing something
1066     in $PAGER#596.
1068   + Set the variable *colour-disable*#381 to turn colour off
1069     without affecting established settings.
1071   + It is deduced via termcap(5) (see below) whether the terminal
1072     supports colors, e.g., "$ s-nail -Stermcap=Co#256".
1073     This is also true if we don't have termcap support.
1075   + Support for 256-colour terminals. (Gavin Troy)
1077 - `source'#272 series support shell pipes if the last character
1078    of the "filename" ends with a vertical bar |, e.g.,
1080       ? source 'gpg -qd ~/.s-nailrc-private.gpg |'
1082 - Shell pipes are also supported as targets for `move'#222,
1083   `copy'#157 etc., yet unfortunately not with via a sh(1)ell token
1084   parser, so that the target still has to be a single argument.
1086       ? copy . '| cat; echo huhu'
1088 - Support for custom headers via the new `~^'#311 compose-mode
1089   command escape and in addition, or alternatively, with the
1090   internal variable *customhdr*#386, which also can be covered by
1091   `localopts'#209.  (Sergey Matveev)
1093   + Support of $ORGANIZATION has been dropped.
1095   + Command escape `~e'#317 supports _any_ header.
1097   + Command escape `~^'#311 supports _any_ header.
1099 - New -:#53 command line option can be used to more easily select
1100   which startup files should be loaded, e.g., -:/ loads none.
1101   (Robert Elz)
1103 - `account'#132s and *folder-hook*#403s now have `localopts'#209
1104    enabled by default.
1106 - A first simple form of compose-mode hooks has been implemented:
1107   *on-compose-enter*#462, *on-compose-leave*#463 and
1108   *on-compose-cleanup*#461 can be set to macros which get invoked
1109   at appropriate times.
1110   For the `resend'#249 series there is *on-resend-enter*#467 and
1111   *on-resend-cleanup*#466: this is very likely to change once
1112   true message access is possible even in this mode.
1114   An even more powerful mechanism is available via the also new
1115   *on-compose-splice*#464 and *on-compose-splice-shell*#465 hooks.
1116   These are executed in child processes and communicate with the
1117   parent via their standard input and output, and therefore can
1118   do anything and act as if they were the user.
1120   `localopts'#209 are enabled and cannot be disabled (and extend
1121   until the message is sent).
1122   (Jens Schleusener, Rudolf Sykora)
1124     ? set on-compose-splice=ocs
1125     ? define ocs {
1126       read ver
1127       echo Splice protocol version is $ver
1128       echo '~^header list'
1129       read hl; vput vexpr es substring "${hl}" 0 1
1130       if [ "$es" != 2 ]
1131         echoerr 'Failed to read header list, bailing out'
1132         echo '~x'
1133       elif [ "$hl" @i!% ' cc' ]
1134         echo '~^header insert cc Diet is your <mirr.or>'
1135         read es; vput vexpr es substr "${es}" 0 1
1136         if [ "$es" != 2 ]
1137           echoerr 'Failed to insert Cc:, bailing out'; echo '~x'
1138         end
1139       end
1140     }
1142 - "The .netrc file"#37
1144   + gained support for comments.
1145     (Walter Alejandro Iglesias, Ralph Corderoy)
1147   + `netrc'#225 now has a "load" subcommand.
1149   + the new *netrc-pipe*#456 obsoletes OPT_AGENT and
1150     *agent-shell-lookup*, and can be used to load an encrypted
1151     .netrc file, e.g.:
1153       ? set netrc-lookup netrc-pipe='gpg -qd ~/.netrc.gpg'
1155     I.e., this is in usual .netrc syntax and thus possibly much
1156     nicer than saying "? source 'gpg -qd ~/.credentials.gpg |'".
1158 - termcap(5) / terminfo(5) support has been changed backward in-
1159   and upward (from user interface side) compatibly, please read
1160   "On terminal control and line editor"#17.
1162   + OPT_TERMCAP is by default enabled.
1163     The new, by default enabled, configuration option
1164     OPT_TERMCAP_VIA_TERMINFO can be used to (try to) use
1165     terminfo(5) instead.
1167   + The variable *termcap*#549 can be used to freely define or
1168     override terminal capabilities, and *termcap-disable*#551 will
1169     disable interaction with the chosen library, leaving only
1170     *termcap* in charge.
1172     To use the so-called ca-mode on supporting terminals,
1173     effectively turning S-nail into a fullscreen application,
1174     *termcap-ca-mode*#550 must be set.
1176   + The built-in line editor has been rather completely rewritten
1177     to be the Mailx-Line-Editor (OPT_MLE, default yes), and
1178     supports wide glyphs (if possible), infinite line lengths
1179     (2 GB) and more.  Tabulator expansion is no longer an option
1180     (but needs fnmatch(3)).
1182   + Optionally (OPT_KEY_BINDINGS, default yes) it has become
1183     possible to freely define key bindings for the MLE via the new
1184     `bind'#141 and `unbind'#142 commands.  These key bindings can
1185     make use of termcap(5) and/or terminfo(5) names.  The MLE will
1186     install a set of default bindings (unless there is a set
1187     *line-editor-no-defaults*#433), more so with OPT_TERMCAP,
1188     i.e., try "? bind*".
1190     Sufficient support provided, one can now, e.g., type "p " and
1191     then collect the message numbers to type, scrolling forward
1192     and backward via key-bindings, without losing the line
1193     content, then commit the final line.
1195   + OPT_EDITLINE and OPT_READLINE support have been dropped.
1196     The new MLE should not miss anything.  Does it?
1197     Tip: in an UTF-8 locale try "? !touch /tmp/hall{,öchen}" and
1198     then autocomplete that: once, then ^Q, and again.
1200 - `source'#272 can be used in `call'#143ed macros.
1201   What sounds so innocent replaced an entire machinery and got rid
1202   of a brilliant idea of Kurt Shoens from the 70s, but which never
1203   worked with Nail/Heirloom extensions, namely macros, and in the
1204   right order.
1205   Accompanying this -X#83 can (dig multiline arguments and can) be
1206   used to define macros and run them etc.  Should work:
1208     $ s-nail -X'define x {' -Xversion -Xx -X'}' -X'call x'
1209     $ s-nail -X'source \' -X'"echo version|"' -Xx
1211   Macros can be `undefine'#162d from within themselves, and re-
1212   `define'#161d.  It is still not possible to define macros
1213   from within macros, and/or have inner macros, not to talk
1214   about local scoping or anything more sophisticated such.
1216 - -u#80 / $LOGNAME#589 ($USER) handling has been redefined,
1217   and "-u USER" is now exactly the same as "-f %USER", and
1218   $LOGNAME (and $USER) is actively set to the active user.  (Afan)
1220   $LOGNAME#589 is POSIX standardized and henceforth used and
1221   preferred over $USER, which came from BSD.  (Todd C. Miller)
1223 - In the future (at least non-message-list) argument handling will
1224   be changed backward-incompatibly to be sh(1)ell compatible (and
1225   thus POSIX standardized), see "Shell-style argument quoting"#23.
1226   New commands use it already today (`bind'#141, `colour'#152,
1227   `headerpick'#200), some others (most importantly, `set'#260) can
1228   be forced to do so via the new `wysh'#122 command prefix, as in:
1230     ? wysh set message-inject-tail=$'\n--steffen'
1231     ? bind base $'\cA,\x61' 'echo control-A and small a'
1233 - We now actively manage *umask*#570: 0077 by default, but an
1234   empty string will use the setting that is active upon startup.
1235   Just like changes to (known) environment variables, this setting
1236   will also be inherited by any child process.
1237   (Walter Alejandro Iglesias)
1239 - Anything SENDMAIL / *sendmail*-ish has been renamed to *mta*#450,
1240   *mta-arguments*#451, *mta-no-default-arguments*#452 and
1241   *mta-argv0*#454.
1243   The reason is that in v15 we won't even have *smtp*: it is just
1244   another form of MTA, and thus obsolete by itself.
1245   Note that *mta-arguments* is now parsed via the shell-token
1246   parser, so the following ends up exactly as desired.
1248     ? set mta-arguments='-t -X "/tmp/my log"'
1250   For now we support a hack that understands a file:// URL in
1251   *mta*, too, but that is also the default if there is no protocol.
1252   E.g.: "? set mta=smtp://a:b@xy.z"
1254 - The "spamd" *spam-interface*#536 is obsolete.  I haven't tested
1255   it since my main machine died, it is error prone since it assumes
1256   internals of the spamassassin wire protocol, and there never was
1257   a speed improvement over "spamc".  (However it could react upon
1258   the "is-spam" state of a message, which "spamc" doesn't allow.)
1260 - The new *inbox*#427 variable will henceforth be looked up when
1261   searching for a primary system mailbox (as in "? File %"),
1262   followed by the usual $MAIL#590 and compile-time defined local
1263   mailspool search.  (Stephen Isard, Jürgen Daubert)
1265 - The semantic of -a#55 and `~@'#309 have been changed, and both
1266   commands now use the same syntax:
1268     -a file[=input-charset[#output-charset]]
1270 - New "failinvaddr" keyword for *expandaddr*#398.
1272 - We finally "can" the so-called (by myself) "Dr. Problem" (a bit):
1273   (Dr. Werner Fink)
1275     $ </dev/null s-nail -d:/ -sTrödler 'Dr. D. Iet <z@a.k>' 2>&1 |\
1276       grep To:
1277     s-nail: >>> To: "Dr. D. Iet" <z@a.k>
1279   This can be done via the new `addrcodec'#134, too, note this
1280   supports multiple modes (and the `vput'#121 command modifier):
1282     $ echo 'addrcodec e Dr. Diet <to@fu.soj> Curd' | s-nail -#:/
1283     "Dr. Diet Curd" <to@fu.soj>
1285 - All commands with the string "codec" in their name use different
1286   argument quoting, namely none at all, please read
1287   "Raw data arguments for codec commands"#25.
1288   This means that `urlcodec'#290 (and `imapcodec'#628) has
1289   slightly changed semantics.
1290   And, while here: there is a new `shcodec'#262, too.
1292 - We gained "Command modifiers"#21: `\'#116 (avoid expansion of
1293   `commandalias'#154es), `vput'#121 (store result in variable),
1294   `ignerr'#117  (ignore an error of the following command, even
1295   if the new *errexit*#396 is set), `wysh'#122 (use shell-style
1296   arguments).
1298     $ echo 'vput cwd resvar;echo $resvar' | s-nail -#:/
1299     /home/steffen/src/nail.git
1301   And the usual sh(1) stuff: `return'#255, `shift'#266, `eval'#182,
1302   plus a `xcall'#298 stack-avoidance optimization (to be used in
1303   place of a `call'#143 which would be the last called command).
1304   And an "expr(1) like thing", yet simple, `vexpr'#294.
1306     $ echo 'vexpr + 1 2' | s-nail -#:/
1307     00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000011
1308     03 | 0x3 | 3
1309     $ echo 'vput vexpr resvar + 1 2;echo $resvar' | s-nail -#:/
1310     3
1312   We actually start walking (*?*#338, *^*#340).
1314     ? vput vexpr res regex 'bananarama' 'Bana(.+)' '\$1\$0'
1315     ? echo $?/$^ERRNAME :$res:
1316     1/NODATA ::
1317     ? vput vexpr res iregex 'bananarama' '(.+)rama' '\$1\$0'
1318     ? echo $?/$^ERRNAME :$res:
1319     0/NONE :bananabananarama:
1321   The command `vpospar'#295 can be used to manage the stack of
1322   positional parameters, i.e., much like "set --".
1323   It also offers the possibility to save and restore the stack to
1324   and from variables.  Etc.
1326   Btw., to contact the maintainer (make.rc variables
1327   VAL_CONTACT_WEB and VAL_CONTACT_MAIL):
1329     ? echo $contact-web; eval mail $contact-mail
1331 - `if'#206 no longer performs automatic number conversion, we
1332   use the explicit -lt, -gt etc. syntax of the sh(1).
1333   Note: `if' will change to be almost identical to sh(1) if(1),
1334   so please ensure proper test bracketing, even if it is less
1335   convenient.
1337   Moreover, the default string comparison mode has changed to
1338   case-sensitive, just like in the shell.  This is because in the
1339   future this crux with trigger characters will vanish and `if'
1340   etc. will simply slurp in already expanded shell tokens, it will
1341   act like the shell in that respect.  We have modifiers, though,
1342   yet only "@i" for case-insensitivity, also for regex matches:
1344     LC_ALL=C
1345     i=`LC_ALL=C.utf8 s-nail -:/ -# -X '
1346        \define cset_test {
1347           \if [ "${ttycharset}" @i=% utf ]
1348              \echo $LC_ALL
1349              \xit 0
1350           \end
1351           \if [ "${#}" -gt 0 ]
1352              \wysh set LC_ALL=${1}
1353              \shift
1354              \eval xcall cset_test "${@}"
1355           \end
1356           \xit 1
1357        }
1358        \call cset_test C.UTF-8 POSIX.utf8 POSIX.UTF-8 \
1359           en_EN.utf8 en_EN.UTF-8 en_US.utf8 en_US.UTF-8
1360    '`
1361    [ $? -eq 0 ] && UTF8_LOCALE=$i
1363   Please note the `eval' in 'eval xcall cset_test "${@}".  This is
1364   a difference of S-nail/mailx and the sh(1)ell that will remain,
1365   as documented in "COMMANDS"#20: whereas the shell implements
1366   a language and performs standardized expansions on the line
1367   until finally the command is called, S-nail will decide the type
1368   of command line parsing dependent on the seen command, and will
1369   then perform a single expansion.  Therefore "${@}" will expand
1370   to multiple arguments if $# is greater 0, but it will expand to
1371   the empty string otherwise, which is not furtherly expanded away
1372   since it is meaningless like it is in the shell: therefore $#
1373   will be 1 (the empty string) not 0.
1375 - Using an explicit proto:// prefix should get you the desired
1376   thing apart of *newfolders*#457, e.g.:
1378     ? File maildir:///tmp/x.mdir
1379     ? copy * file:///tmp/x.mbox
1381 - New variable *record-files*#498 can be set to extend the meaning
1382   of *record*#497.  *record-resent*#499 was there already.
1384 - New variable *ifs*#423 acts a bit like the sh(1)ell's $IFS for,
1385   e.g., the new `read'#239 command.
1387   There is a `readctl'#241 command which can be used to manage
1388   the active channel used by `read'#239.
1390 - The `~' alias for `call'#143 is gone.
1392 - `mimetype'#214 only allows specification of a single type per
1393   call, on the other hand no need to quote that.
1395 - `mimeview'#218 must now be used explicitly to look at any
1396   non-text MIME part, for normal display etc. purposes we only
1397   support "copiousoutput"#615 MIME handlers.
1399 - New *socks-proxy*#535 can be used to proxy all network traffic
1400   over a SOCKS5 proxy.  (Gaetan Bisson)
1402 ChangeLog
1403 ^^^^^^^^^
1405 - The manual has seen another major overhaul, all the variables
1406   are now documented in a single, sorted list, and many
1407   clarifications should have been added.  I hope it has become
1408   a better read.
1409   (Predrag Punosevac, Michael Convey, Hariskar, Rudolf Sykora,
1410   Respiranto, Thomas Dickey, Donald Mugnai)
1412 - To support RFC 1524 a.k.a. .mailcap files (see below) many
1413   "trigger"-characters have been added for *pipe-TYPE/SUBTYPE*#471,
1414   which may (rarely) affect existing values.
1415   The .mailcap support itself is not yet implemented.
1417 - *mime-counter-evidence*#447 gained bit 4 (perform proper in-depth
1418   content inspection as necessary; set to 0xE for all bits).
1419   (Aharon Robbins)
1421 - Maildir paths are now created recursively as necessary.
1422   (Justin Ellingwood)
1424 - -M#70 and -m#71 options have been added to enforce a special
1425   send mode that will flag standard input / the given file with
1426   the specified / detected MIME 'Content-Type:'.  This can be used
1427   to directly send, e.g., HTML log output.
1428   (Viktor Szépe, Ralph Corderoy)
1430 - Disallow symlinks on writable files.  Note this requires
1431   O_NOFOLLOW support for the operating-system-call open(2), but
1432   which has been standardized a long time ago.
1433   (Matthew Dillon)
1435 - `retain'#254, `ignore'#207 etc. now differentiate in between
1436   From (the From: header) and From_ (the MBOX ident).
1438   In fact we now have a new `headerpick'#200 command which
1439   is a multiplexer for all retain and ignore lists used, call it
1440   without arguments to see the current setting(s).
1441   In v15 only `headerpick' and the standard-imposed wrappers
1442   `retain' and `ignore' will remain, all other wrappers will
1443   vanish.  Regular expressions can now be used if available:
1445     ? headerpick
1446       headerpick type retain blahblahblah cc date from \
1447         mail-followup-to message-id openpgp reply-to subject to \
1448         user-agent
1449       #headerpick type ignore currently covers no fields
1450       #headerpick save retain currently covers no fields
1451       headerpick save ignore '^Original-.*$' '^X-.*$' '^DKIM.*$'
1452       headerpick forward retain cc date from list-id \
1453         mail-followup-to openpgp reply-to subject to
1454       #headerpick forward ignore currently covers no fields
1456 - `top'#282 has been rewritten completely, `Top'#281 is new.
1457   It uses a built-in set of retain/ignore headers, but it is
1458   possible to register a custom set via `headerpick'#200.
1459   Also, *toplines*#566 has been extended a bit and the new
1460   *topsqueeze*#567 variable may pimp your `top' experience.
1462     ? headerpick top retain add subject
1463     ? top
1464     [-- Message  1 -- 87 lines, 4791 bytes --]:
1465     Subject: Re: I can't dist to myself
1467     I wrote:
1468         3.22. bounce_delivered
1470 - `features' has been dropped, `version'#293 extended.
1472 - The *prompt*#486 handling has changed: we lost the capability to
1473   expand \?, \@ and \$, instead new "private" variables *?*#338,
1474   *account*#349, *mailbox-resolved*#436 and
1475   *mailbox-display*#435 have been introduced, and the prompt
1476   is completely shell expanded (thus twice with `wysh' or in v15),
1477   as if dollar-single-quote quoted.  We do support the reverse-
1478   solidus escaped bracket notation for embedding characters which
1479   should not be counted when calculating the width of the prompt.
1480   The `colour'#152 command has a slot for the prompt colour.
1481   We gained *prompt2*#487 as a second level prompt.
1483     ? var prompt
1484     wysh set \
1485       prompt='?\${?}!\${!}[\${account}#\${mailbox-display}]? '
1487 - The filename "-" can be used as a receiver, e.g.,
1489     $ echo Hey,\ you | s-nail -:/ -Sexpandaddr -sUB -
1491 - The -s#78 command line option, the `~s'#331 command escape
1492   as well as the corresponding slots of `~^'#311 will actively
1493   strip [\r\n] from their value (Debian #419840).
1495 - New `read'#239 and `echoerr'#173 commands, mostly for
1496   *on-compose-splice*#464.
1497   But also `echon'#174 and `echoerrn'#175, which do not write
1498   a trailing newline.
1500 - New variable *r-option-implicit*#495 may be helpful to those
1501   who regulary need the functionality of the -r#76 command
1502   line option.  (Felipe Gasper, Martin Neitzel)
1504 - By using new "pseudo-URLs" one can automatize the use of S/MIME
1505   keys / (certificates / intermediate include certificates) with
1506   passwords.  E.g., to drive bob@exam.ple, set
1507   *smime-sign-cert-bob@exam.ple* to the private key / certificate
1508   pair as usual, the password lookup will then be performed for
1509   bob@exam.ple.smime-cert-key, bob@exam.ple.smime-cert-cert and
1510   bob@exam.ple.smime-include-certs.
1511   Like this the password can be stored in an encrypted .netrc file
1512   when *netrc-lookup*#455 and *netrc-pipe*#456 are set, or it may
1513   be stored in an encrypted resource file that has been loaded via
1514   `source'#272 as a simple *password*#469 variable.
1516   Note that the prompting that happens as a last resort of
1517   password lookup will still interfere with a possibly running
1518   $PAGER#596 instance, dependent on the setting of *crt*#385, of
1519   course.  Proper job control handling and recognizing that we are
1520   running $PAGER when doing that prompt is a TODO for v15.  Sorry.
1522 - Some commands, like `set'#260, `help'#203, `list'#208,
1523   `mlist'#216 etc., now react upon the setting of *verbose*#573
1524   and(/or) *debug*#389.
1526 - `write'#297 uses iconv(3) as appropriate.
1528 - *mbox-rfc4155*#439 has first been dropped, and was then
1529   reintroduced with different semantics.  Because, it can be
1530   helpful if a messed up MBOX is read, in which case we henceforth
1531   will warn you and point you to this:
1533     ? define mboxfix {
1534       \localopts yes; \wysh set mbox-rfc4155;\
1535         \wysh File "${1}"; \eval copy * "${2}"
1536     }
1537     ? call mboxfix /tmp/bad.mbox /tmp/good.mbox
1539   P.S.  Here you see how weird the current thing still is, in v15:
1541     ? define mboxfix {
1542       localopts yes; set mbox-rfc4155; File "${1}"; copy * -- "${2}"
1543     }
1545   And also in v15 we will not apply (proper) so-called MBOXO
1546   quoting, but instead (simply MIME) re-encode mail messages.
1548 - `call_if'#144 is new and, different to "? ignerr call", silent
1549   and not messing with the return status.
1551 - The new *smime-ca-flags*#521 and *ssl-ca-flags*#? can be used
1552   to fine-tune X509_STORE_set_flags(3) a.k.a the X509 CA
1553   certificate verification.
1555     ? set ssl-ca-flags=partial-chain
1556     ? wysh set smime-ca-flags="${ssl-ca-flags}"
1558   Also, *ssl-curves*#? for TLSv1.3.
1560 - Socket connections use TLS S(erver)N(ame)I(ndication) as
1561   appropriate (RFC 7817).
1563 - `alternates'#137 checks arguments and supports `vput'#121.
1564   It by default no longer replaces but appends alternates, unless
1565   *posix*#484 mode is active.  There is a new `unalternates'#138
1566   command to remove alternates.
1568 - A new `charsetalias'#147 command.  (Pietro Cerutti, mutt#3925)
1570 - New commands `filetype'#187 and `unfiletype'#188: in the future
1571   we will no longer know any builtin filetypes, in fact we already
1572   simulate .gz etc. via the new mechanism as necessary:
1574     ? filetype \
1575        bz2 'bzip2 -dc' 'bzip2 -zc' \
1576        gpg 'gpg -d' 'gpg -e' \
1577        gz 'gzip -dc' 'gzip -c' \
1578        xz 'xz -dc' 'xz -zc' \
1579        zst 'zstd -dc' 'zstd -19 -zc' \
1580        zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
1582 - `~<'#306 now offers a "- [HERE-delimiter]" mode for pasting etc.
1583   (Ralph Corderoy)
1585 - `exit'#183 and `quit'#238 take an optional exit status.
1586   (That is not fixated yet, though.)
1588 - We have a useful -h / --help output.  (Doug McIlroy)
1590 - *encoding* obsoleted in favour of new *mime-encoding*#448, which
1591   now defaults to base64.
1593 - *allnet*#351 now works (broken since nail 10.00, 2002-09-29).
1595 Appendix
1596 ^^^^^^^^
1598 The complete changelog of commits in between two versions OLD and
1599 NEW can be inspected by using the git(1) `log' command:
1601   $ git log --reverse --topo-order --abbrev-commit OLD..NEW
1602   # Only topic branch headers (--no-merges for content commits only):
1603   $ git log --oneline --reverse --topo-order --merges OLD..NEW
1604   # Same, but truly accessible:
1605   $ git log --oneline --reverse --topo-order --merges --parents OLD..NEW |
1606     while read c1 c2 c3 c4 c5 c6; do
1607       printf "%-24s: \$ git log --oneline --no-merges %s ^%s\n" \
1608         "${c6}" "${c1}" "${c2}";
1609     done
1611 Entries for releases before v14.9.0 have been cut off and can be
1612 found in the git(1) repository:
1614   v14.8.0 - v14.8.16: $ git show v14.8.16:NEWS
1615   v13     - v14.8.5 : $ git show v14.8.5:NEWS
1616   9.0     - 12.5    : $ git show heirloom:ChangeLog
1618 Also accessible via HTTPS?, just replace X.Y.Z accordingly:
1620   \https?://git.sdaoden.eu/cgit/s-nail.git/tree/NEWS?h=vX.Y.Y
1622 For even older releases you need to look into the [timeline]
1623 branch, but no changelog has been administrated for them.
1625 # s-tm-mode