Bump S-nail v14.9.7.ar ("Marsh tit patiently scraping bark"), 2018-02-16
[s-mailx.git] / NEWS
blobb7dae26196f46e06fbda72fda9dec48b8723865d
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.7 ("Marsh tit patiently scraping bark") 2018-02-16
10 --------------------------------------------------------
12 A maintenance release which fixes bugs and brings in features.
14 Credits, in order of commit appearance: Alexander Harm,
15 Viktor SZÉPE, Paul Eggert, Joseph Bisch, Paride Legovini,
16 and Peter J. Holzer.
17 A special credit to the disappearing mutt(1) bug tracker.
18 And to Gmane.org for creating gmane.mail.s-mailx.general!
20 Thanks Paride Legovini for becoming maintainer of the Debian port.
22 We welcome Joseph Bisch, Paride Legovini, and Peter J. Holzer in
23 THANKS.
25 NOTES, ChangeLog (packager-affine)
26 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
28 - The USB stick loss reported for v14.9.6 was fake news, so to
29   say, the stick exists and therefore the old key is not
30   compromised.
32 - We are back at Gmane.org!
33     news.gmane.org/gmane.mail.s-mailx.general
35 - `history'#? has learned to be context-sensitive a bit, and
36   has two new subcommands, `load' and `save'.
38     This is in parts backward incompatible because it needs a new
39     *history-file*#? format; however, the old format can be loaded
40     yet compose-mode commands will not appear in compose mode no
41     more.  Iirc you can start with an old format then `save' to
42     the new, then replace the "d" in the first column with "c" for
43     compose-mode commands which should appear correctly.
45 - Obsoletion warnings for variables now happen at `set'#?
46   time instead of when used.  Running once via -v#? may
47   be beneficial.
49 - The saturation modifier of `vexpr'#? is henceforth a prefix,
50   the suffix version is obsolete (but still supported for a while).
52 - A network address that contains no domain-, but only a valid local
53   user <name> in angle brackets will be automatically expanded to
54   a valid address when *hostname*#? is set to a non-empty value;
55   setting it to the empty value instructs us that the used *mta*#?
56   (including builtin SMTP) will perform the necessary expansion.
57   (Viktor SZÉPE)
59   Note that *hostname*#? as well as *smtp-hostname*#?
60   will now undergo IDNA expansion if IDNA is supported.
62   And *from*#? and *sender*#? are now verified at `set'#?
63   time, not when used.  (Viktor SZÉPE)
65 - The commit message in [d503bd82] is wrong, apologies to
66   Paride Legovini.  The test(1) operator "-n" appeared in Seventh
67   Edition UNIX, not V8 as falsely claimed.
69 ChangeLog
70 ^^^^^^^^^
72 - Our `addrcodec'#? parser chokes on lesser constructs.
74 - Presence of command-line MTA arguments without *expandargv*#?
75   are now a hard error.  It was my fault that this was not the
76   default from the very start.  (Viktor SZÉPE)
78 - Seen on the mutt bug tracker, we also still have had problems
79   with time settings that cross 32-bit boundaries.  As that is
80   in parts induced by the C standard, now implement those parts on
81   our own, and be super careful in general.  (Joseph Bisch)
83 - The `~@'#? command escape did not shell-unquote the user input
84   again and was thus a bit broken; message attachments also work
85   again.
87 - Support custom headers from the command line via -C#?.
88   And *customhdr*#? is verified upon `set'#? time.
90 - The simple builtin HTML viewer now supports <blockquote>
91   elements, which many web mailers, most notably gmail, use for
92   citation.  (Peter J. Holzer)
94 git(1) shortlog (edited)
95 ^^^^^^^^^^^^^^^^^^^^^^^^
97 Paride Legovini (1):
98 d503bd82 Patch configure script to not override build variables..
100 Steffen Nurpmeso (66):
101 437a103d mail1(): tweak "failed encoding" error message (Alexander Harm)
102 5f951f7b n_utf8_to_utf32(): FIX: implement compliant to Unicode 9.0, 3.9,
103         UTF-8
104 6ac954a4 mime_fromhdr(): normalize \0 and \n in encoded-words (mailspoof)
105 c59a20ff myaddrs(): Fix: do not return invalid *from* (Viktor SZÉPE)..
106 efc59473 *expandargv*: hard error if unset (Viktor SZÉPE)..
107 ef94b2d6 README: we are back at Gmane.org!
108 a832ef40 Yay!  We have submissions:// at port 465 (too)! (RFC 8314)
109 cac4decc config.h: resort; fallback for S_ISDIR() (Paul Eggert)
110 1e43647b unixtime(): check mktime(3)+localtime(3) returns (Joseph Bisch)..
111 068fe5d3 fakedate(): implement ourselfs (Joseph Bisch)..
112 f430e3cc THANKS: Joseph Bisch
113 94ec5975 nail.1: fix spelling errors (Paride Legovini)
114 3311b6b9 THANKS: Paride Legovini
115 74d64ec7 cmd-headers.c,cmd-tab.h: fix spelling errors (Paride Legovini)
116 8477ea6f nail.1: yet another fix (Paride Legovini)
117 efe354ea More ISO C time and date checks etc. (Joseph Bisch)
118 f5409738 a_attachment_is_msg(): fix #NO message attachments (since
119         2017-01-22)!
120 65ff0741 a_amv_var_check_num(): fix: variables need 32-bit not 64-bit limit!
121 fd2daba5 n_attachment_list_edit(): FIX: unquote user input again (!!!)
122 75917c30 ([BWDIC]) `history': support context-sensitive history (a bit)..
123 ff8b2ba1 Add -C (create custom header), change *customhdr*
124 2e67ac32 `vexpr': obsolete @ as suffix, it must henceforth be prefix..
125 b882c9b9 `vexpr': numeric ops: support [UuSs] number prefixes
126 2f356cd2 `vexpr': add `pbase' subcommand
127 9e652437 HTML filter: support <blockquote> quotes (Peter J. Holzer)
128 90e708e7 THANKS: Peter J. Holzer
129 9c7ea9cb Try to avoid tracing and attaching to privsep program
130 a4e21888 -S: as if within $'' if *v15-compat* (Alexander Harm)
131 333ecee1 *from*, *sender*: verify upon `set' time (Viktor SZÉPE)
132 ccaa7401 Optionally append *hostname* in "valid <user>" address (Viktor SZÉPE)
134 v14.9.6 ("Marsh tit abiding a snow storm"), 2017-12-05
135 ------------------------------------------------------
137 A bugfix release which fixes four serious and three other bugs.
138 A few new features came in, too.
140 Many thanks go to Ralph Corderoy who reported an issue that was
141 caused by a terrible, terrible word reversal that i managed to
142 produce in December 2016, and which caused the v14.9.x series to
143 not MIME encode (non-address) content of address header fields!
145 Credits, in order of commit appearance: Thomas Dickey,
146 Andreas Baumann, Erich Eckner, Gaetan Bisson, Solar Designer, Cág,
147 Ivan Tham, Ralph Corderoy and Doug McIlroy.
149 We welcome Andreas Baumann, Erich Eckner, Solar Designer and Cág
150 in THANKS.
152 NOTES, ChangeLog (packager-affine)
153 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
155 - After USB stick loss the authors OpenPGP key has been switched to
157     pub   4096R/1883A0DD 2017-11-30 [expires: 2027-11-28]
158           Key fingerprint =
159             EE19 E1C1 F2F7 054F 8D39  54D8 3089 64B5 1883 A0DD
160     uid                  Steffen Nurpmeso <steffen@sdaoden.eu>
162 - $TMPDIR#591 no longer honoured for root runs.  (Solar Designer)
164 - *mime-encoding*#436 defaults to quoted-printable again.  (Cág)
166 - We _can_ MIME encode even header fields which contain addresses.
167   Thanks to Ralph Corderoy we now also _do_ so again!
169 ChangeLog
170 ^^^^^^^^^
172 - ***#336 now uses *ifs*#411 when splitting.
174 - Freezing *ttycharset*#557 via -S#75 also survives using or
175   setting any of $LC_ALL#573, $LC_CTYPE#574 and $LANG#575 during
176   program startup.
178 - New `local'#113 command modifier to localize changes.
179   Yet supported only for `set'#253, i.e., we have gained
180   macro-local variables.
182 - `vexpr'#287 now supports a BASE#number notation for integers,
183   like 16#AFFE as an alternative to 0xAFFE.
185   Hint: variable settings can most often use several bases, too,
186   e.g., i have "set mime-counter-evidence=0b1111".
188 - Very simple form of *quote-chars*#479 to adjust our knowledge of
189   what actually is to be treated as a quote character.
191 - *mime-counter-evidence*#435 deep inspection (bit four) has
192   been improved for the sole cases of quoting or displaying
193   a message.  So messages with less than 25% of control characters
194   and such will now be displayed (made printable).  This is yet
195   not configurable nor do we have a way to easily access a message
196   with more than that.  (Doug McIlroy)
198 git(1) shortlog (edited)
199 ^^^^^^^^^^^^^^^^^^^^^^^^
201 Steffen Nurpmeso (44):
202 9bdfeba2 Introduce *mta-no-receiver-arguments* to bypass OpenSMTPD behaviour..
203 4ce4f80d mail1(): fix: unroll compose-mode `localopts' even on compose
204         failure!
205 3dc1d4ee FIX debug assertion (Thomas Dickey)..
206 b039b309 a_main_startup(): isatty() yay fdopen(,"w") nay (A. B., E. E., G.
207         B.)..
208 e6ec2b06 THANKS: Andreas Baumann
209 5e808dc1 THANKS: Erich Eckner
210 7cc7fd0a Invent n_O_NOXY_BITS for more O_NO* etc. (Solar Designer)
211 409c5df7 THANKS: Solar Designer
212 62d5947a config.h: no, change [f64eb665], use MIMEE_QP again (Cág)
213 43449982 THANKS: Cág
214 cd212599 Do not honour $TMPDIR if run by root (Solar Designer)
215 3e283d18 Fix semantics of $* to go for *ifs*
216 6d437ab6 FIX i_strdup(), broken since [354fc47e] as of 2017-07-16..
217 c20b6b7c nail.1: WHEN is a mlist a regex (Ivan Tham)
218 bd72268c nail.1: FAQ: Can S-nail git-send-email? (Cág)
219 ffd29558 FIX [0ede309c] as of 2016-12-26! (Ralph Corderoy)..
220 fce7d5ca FIX: LC_ALL/LC_CTYPE/LANG: do not _force_ overwrite of *ttycharset*..
221 16fb7bf7 `environ' unset: report errors (remove respective TODO)..
222 8eb67f95 Add `local' command modifier: alter command to work on block-scope
223 23327af7 n_idec*(), `vexpr': support BASE#number (2 <= x <= 36) notation
224 78727768 "[@fields]@" spec.: support regex in fields, empty body: header
225         exists
226 ca35643c Add *quote-chars* (simple)
227 429a294d Improve *mime-counter-evidence* deep inspection (Doug McIlroy)..
228 c0fcb67c Introduce *version-hexnum*
229 090819a2 Fix [ab0cd3b8]..
230 8c72989b cc-test.sh: fix test of [ffd29558]..
232 v14.9.5 ("Marsh tit engaged with a peanut"), 2017-10-21
233 -------------------------------------------------------
235 A bugfix release which fixes two bugs which were cast in stone.
236 A few compatibility improvements (AlpineLinux, Solaris).
237 And minor features.
239 Apologies to Jörg Schilling, a git bug i think it was who caused
240 joining of changesets, loosing a credit, and it had been pushed to
241 [master] before the problem was realized.
243 Credits, in order of commit appearance: Jörg Schilling,
244 Doug McIlroy, Random832, Nick Stoughton and Ivan Tham.
246 We welcome Nick Stoughton and Ivan Tham in THANKS.
248 NOTES, ChangeLog (packager-affine)
249 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
251 - New OPT_USE_PKGSYS option can be disabled to not automatically
252   pick known package system paths (pkg(7), OpenCSW, schily).
253   (Jörg Schilling)
255 ChangeLog
256 ^^^^^^^^^
258 - The software indeed _never_ dealt with iconv(3) output character
259   set errors (as opposed to invalid input character set byte
260   sequences etc.) for the main message body!
261   And I have missed that when i tweaked our iconv layer a bit!
263 - Fixed a race condition with sigsuspend(2) that i could only see
264   on OpenBSD.  config.h offers n_SIGSUSPEND_NOT_WAITPID, by the
265   way, which saves some systemcalls and did not run races, but
266   noone adjusts this file.
268 - Message list specifications gained two new colon modifiers, one
269   can now "search :Ll" to find "Mailing lists"#10.
270   The *headline*#402 format %T now also uses L and l rather than
271   S and L accordingly.
273   New `addrcodec'#129 subcommand `skinlist' acts like `skin'
274   but stores in *!*#331 *^ERR*#333-EXIST if the address is
275   one of the known "Mailing lists"#10.
277 - `echo'#166 family now supports `vput'#116 and *!*#331 error
278   storage, offering some kind of printf(1) experience, almost.
280 git(1) shortlog (edited)
281 ^^^^^^^^^^^^^^^^^^^^^^^^
283 Steffen Nurpmeso (35):
284 d76fd200 Fully support putenv(3) fallback (Jörg Schilling)
285 ab0cd3b8 FIX iconv for main body part (since EVER!) (Doug McIlroy,
286         Random832)..
287 8d472b37 FIX sigsuspend(2) race condition (since EVER! Only seen on OpenBSD)..
288 ca045d7d Add is_mlist_mp() and :Ll colon modifiers, and use "Ll" for
289         *headline*'s %T
290 88a69abf Set termsize after SIGCONT; n_signal(): use sigfillset (Nick
291         Stoughton)..
292 f169483d THANKS: Nick Stoughton
293 2f1e46ee `echo' family: support `vput' and *!* error storage
294 22ac50c7 make.rc, make-config.sh: add OPT_USE_PKGSYS (Jörg Schilling)
295 09a8b2ef Even less shell globbing (Ivan Tham)
296 b35ccc6d THANKS: Ivan Tham
297 820d02b4 obs-imap.c: drop dopr(), pr(1) often not available
298 2a05fcd9 main.c, make-config.sh: preparate for tcgetwinsize(3)
299 9feaf8ae `addrcodec': add skinlist subcommand, skin+check whether mlist
301 v14.9.4 ("(5th anniversary) Marsh tit"), 2017-09-18
302 ---------------------------------------------------
304 This is an update feature release but which also ships a furious
305 number of bug fixes, about six of which were pretty serious.  It
306 also applies overall trimming, and improves configuration time
307 compatibility on macOS.
309 Thanks to Alexander Harm there is now a macOS Homebrew package.
311 Credits, in order of commit appearance: Paul Vojta, Daniel Lublin,
312 Alexander Harm, Norman Ramsey, Viktor Szépe, Rich Salz,
313 David Čepelík, Ralph Corderoy, Stéphane Chazelas, Aharon Robbins,
314 Ken Hornstein.
316 We welcome Daniel Lublin, Alexander Harm, David Čepelík and
317 Stéphane Chazelas in THANKS.
319 NOTES, ChangeLog (packager-affine)
320 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
322 - Out-of-tree builds have become possible via the new
323   make-emerge.sh script:
325   $ cd /tmp && mkdir build && cd build &&
326     ~/src/nail.git/make-emerge.sh &&
327     make tangerine DESTDIR=.ddir
329   We now have a `citron' make target which is like `tangerine' but
330   does not run the tests.
332 - Configuration with OPT_AUTOCC honours $CC=cc. (Norman Ramsey)
334 - SSL/TLS configuration has been revamped (again) in order to
335   support new possibilities of OpenSSL (and LibreSSL) without
336   ending up and introducing more and more variables.
338   Instead we now have *ssl-config-pairs*#540, a comma-separated
339   list of all options.  With e.g. OpenSSL 1.1.xx this will be
340   directly passed through to SSL_CONF_cmd(), so there _anything_
341   can be passed, otherwise we use a builtin parser to map.
342   The new *ssl-features*#544 states what is supported.  E.g.:
344     if [ "$ssl-features" =% +ctx-set-maxmin-proto ]
345       wysh set ssl-config-pairs='\
346           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
347           Curves=P-521:P-384:P-256,\
348           MinProtocol=TLSv1.1'
349     else
350       wysh set ssl-config-pairs='\
351           CipherList=TLSv1.2:!aNULL:!eNULL:@STRENGTH,\
352           Curves=P-521:P-384:P-256,\
353           Protocol=-ALL\,+TLSv1.1 \, +TLSv1.2'
354     endif
356   OpenSSL v1.1.xx also introduces an interesting and neat idea to
357   centralize SSL/TLS configuration of (all) programs in a single
358   file.  This can be driven via *ssl-config-file*#538 and the new
359   *ssl-config-module*#539 variables, several entries per program
360   are allowed, see *ssl-config-module*#539 for an example.
362   New manual section "Encrypted network communication"#13.
364 - Variables set or unset via -S#75 are now frozen until program
365   startup is complete.
367 ChangeLog
368 ^^^^^^^^^
370 - Historical behaviour of *askcc*#347 / *askbcc*#348 has been
371   reintroduced.  (Norman Ramsey)
373   A new *asksend*#349 variable will show a final header summary
374   and allows reentering compose mode.  Set by default.
376   POSIX mirrors *ask* onto *asksub*#351, so dropped" the former.
378 - `~^'#304 no longer normalizes header names to titlecase.
380 - We no longer generate charset=binary MIME parameters.
381   This was introduced on 2013-01-02 and was i think owed to
382   file(1)s -i output as i failed to find any other reference.
383   (Normal Ramsey)
385 - *mime-alternative-favour-rich*#434 now also works for handlers
386   installed via *pipe-TYPE/SUBTYPE*#459. (Viktor Szépe)
388 - v14.9.* series did not generate In-Reply-To: headers!
390 - `alias'#130 now supports high-bit bytes and semicolon.
391   Expect that at some later time the input must be valid according
392   to the locale, though. (Norman Ramsey)
394 - Combinations of *record*#483 could crash because of an
395   unterminated variable function argument list. (Norman Ramsey)
397 - New command `readall'#233 loads an entire file into a variable.
399   *signature*#503 has been obsoleted.
401 - `vexpr'#287 now supports negative arguments for the substring
402   subcommand and adds trim, trim-front and trim-end subcommands.
404 - `!'#120 can be used in send mode.
406 - `~A'#305, `~a'#306, `~I'#315 and `~i'#316 will henceforth expand
407   \t and \n only if *posix*#472 is set.
408   Please use `set'#253 instead (with `wysh'#117, until v15).
410 - New "The mime.types files"#35 type marker: @q ("quiet").
412 git(1) shortlog (edited)
413 ^^^^^^^^^^^^^^^^^^^^^^^^
415 Steffen (Daode) Nurpmeso (90):
416 9becdd01 Fix [32e5c7c2] (MLE: KHT: auto-append / for directories at once..)
417 cc54681e $PAGER: always set (non-existent) $LESS=RXi (Paul Vojta)..
418 49124f13 nail.1: use `~.' in "On sending mail.." (Daniel Lublin)
419 7cd29917 THANKS: Daniel Lublin
420 62f5957f nail.h: unconditionally include inttypes.h (Alexander Harm)..
421 c121f519 THANKS: Alexander Harm
422 f0aeef8d Adjust OpenCSW & pkgsrc paths, drop CONFIG=MEDIUM (Alexander Harm)..
423 19fdc151 INSTALL: tweak INCS and LIBS (Alexander Harm)
424 24199743 make-config.sh: integrate DYLD_LIBRARY_PATH in LD_.. (Alexander Harm)
425 64026f7b make-config.in: also needs .PHONY for MacOS (Alexander Harm)
426 52ddd687 make-config.sh: OPT_{NOMEMDBG,ASAN_*}: reduce cc_maxopt=1 (Alexander
427         Harm)..
428 f3087a5c Fix **-honour* <-> *recipients-in-cc* for original To: ones
429 2205dc27 Fix: ask for `write' targets of message/rfc822 attachments (again)
430 5cd0f50d Restore historical behaviour of *askb?cc* (Norman Ramsey)
431 80038311 Fix: do not generate charset=binary parameter (Norman Ramsey)..
432 05427cea send.c:sendpart(): extend *mime-alternative-favour-rich* support
433         (SZÉPE Viktor)..
434 226c1f26 FIX In-Reply-To: generation, broken since [c13e1205], 2017-06-04!
435 135cbebe makefile: add missing reverse solidus (Norman Ramsey)
436 8a4237d2 `alias': support high-bit bytes and semicolon (Norman Ramsey)
437 22c48009 a_nag_group_lookup(): FIX used case-i?sensitive hash function!
438 1bc65e1b a_amv_var_lookup(): error log on empty environment variable (Norman
439         Ramsey)
440 179b39f3 sendout.c:mightrecord(): FIX: terminate starg list! (Norman Ramsey)
441 c2635714 Add `readall' command
442 999a9dbf `vexpr': substring: support negative offset / length
443 58474b55 `vexpr': add trim, trim-front and trim-end subcommands
444 7ab345ae Allow `!' in send mode?!
445 08305026 Obsolete *signature* (quite some better and more generic ways now!)
446 cd03ec01 Glue ~A,~a,~I,~i \t and \n expansion to *posix*; while here: resort
447 c5a223d8 Introduce @q MIME type marker
448 93a4e38a Rework (usage of) *SSL random handling (Rich Salz)..
449 f2cc9b83 Work around possible Linux getrandom() bugs (David Čepelík)
450 35879445 THANKS: David Čepelík
451 dddff6ef Extend the meanings of *fullnames*..
452 884983a3 Diversify n_PSO_STARTED_ states, gain more cmds via -X
453 ba103b71 Reserve command modifier prefixes "local" and "u"
454 4ff9c046 {make-{config,emerge},cc-test}.sh: no command -v (Norman, Ralph,
455         Stéphane)..
456 2a2895f1 THANKS: Stéphane Chazelas
457 24615d82 make-config.sh: accept CC=cc (Norman Ramsey)
458 d6f18b52 Add more support surrounding OpenSSL config stuff++..
459 94bafbc6 Temporarily freeze variables set via -S..
460 bb0d0bf2 Port to SunOS 5.9 (Aharon Robbins)
461 788faabe Support *pipe-message/external-body* access-type=url handlers (Ken
462         Hornstein)
463 02407c15 FIX maildir "yet-exists" hashmap!..
465 v14.9.3 ("Crested tit nibbling sunflower seeds"), 2017-08-03
466 ------------------------------------------------------------
468 This is a bugfix release but which ships some improvements, too.
469 It silently replaces both of v14.9.1 v14.9.2 from earlier this
470 week, which were broken or not entirely fixed.
472 Credits, in order of commit appearance: Felix Fontein, Paul Vojta,
473 Ralph Corderoy, Christos Zoulas, Gavin Troy, Gaetan Bisson.
474 Thanks, Coverity.com.
476 We welcome Christos Zoulas in THANKS.
478 Apologies to Viktor Szépe for the false spelling of his name in
479 the v14.9.0 announcement.
480 And to Gaetan Bisson for not giving credit for [14fbce97]!
482 NOTES, ChangeLog (packager-affine)
483 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
485 - fakeroot support was blindly taken from Debian and broken.
486   (Gavin Troy, Gaetan Bisson)
488 - Base64 output was broken for cases which involved iconv(3).
489   The data is not lost, you can read it with S-nail v14.9.0 and
490   above, and save it somewhere.  I know of no other base64 decoder
491   which reads those things correctly, though.  We now have tests.
492   Along this i fixed an iconv(3) error which likely caused
493   stateful decoding (like, e.g., for ISO-2022-JP) to fail because
494   of an unnecessary reset of the iconv(3) state machine.
495   Thanks to Gaetan Bisson for mentioning this issue!
497 ChangeLog
498 ^^^^^^^^^
500 - In compose mode the MLE allows empty lines again.
502 - We no longer require a writable $HOME#572.  Due to false code
503   flow (but but but: with correct comment) a non-writable $HOME
504   entry in /etc/password (i.e., from getpwuid(3)) would lead to
505   a crash.  (Felix Fontain; Ralph Corderoy)
507 - Two faulty string operations slipped into the IMAP code,
508   resulting in a crash and a "is-same-host" test that would fail
509   for IMAPS connections like `save'#250 or `copy'#152 because of an
510   implicit IMAP protocol for the target of those operations (thus
511   IMAP != IMAPS).  (Paul Vojta)
513 - The MLE tab-expansion will now automatically append a "/" if
514   there is only one possible expansion and that is a directory,
515   saving the user one <TAB>.  (Christos Zoulas)
517   The shell expression parser had a bug regarding understood
518   metacharacters (;|&), which in turn could cause an infinite loop
519   in the MLE tab-expansion for, e.g., "move &9 +<TAB>", because
520   the "&" would never have been stepped over.
522 - New `~I'#315 command escape is like `~i'#316 but does not append
523   a newline.
525 - `localopts'#202 gained an optional second argument.
526   It is now possible to specify that any macro `call'#138ed
527   will have localopts enabled, and it is possible to fixate the
528   setting so that it cannot be reverted.
530 - *@*#337 should now act completely compatible to the sh(1)ell,
531   thus obsoleting my hysteric warnings in the v14.9.0 announcement.
533 - The `Lreply'#203, `reply'#238, `Reply'#237 series as well as
534   `mail'#205 now manage the error status *!*#331.
535   I.e., there are now errors like *^ERR*#333-DESTADDRREQ,
536   ^ERR-NODATA, ^ERR-PERM and similar.  It is not perfect yet,
537   because $DEAD#570 may have been written (with *save*#491) or not,
538   for example.
540   `Lreply' and `reply' have been rewritten rather completely
541   indeed.  They join Reply-To: and Mail-Followup-To: dependent on
542   the context (i.e., *reply-to-honour*#489, *followup-to-honour*#396,
543   see "Mailing lists"#10 for the picture), and if they did, use
544   this list as the receivers exclusively.  It now honours
545   *recipients-in-cc*#482 even for such addressees.  (And now i wonder
546   whether i should have credited Paul Vojta for that.)
548   Also `Lreply' would have crashed for mails with Reply-To: but
549   without *reply-to-honour*#489 set.  We now have a test.
551   Note *replyto* is obsoleted in favour of *reply-to*#488.
553 git(1) shortlog (edited)
554 ^^^^^^^^^^^^^^^^^^^^^^^^
556 670aabb6 a_amv_var_check_vips(): FIX code to match comment (Felix Fontein)..
557 3dcdaa83 THANKS: Felix Fontein
558 3745e002 FIX [81d7f4d8] (IMAP: try (hard) to reinstantiate..) (Paul Vojta)
559 33b2834f FIX [81d7f4d8] (IMAP: try (hard) to reinstantiate..) (Paul Vojta)..
560 1cc0d3de Allow non-writable $HOME (Felix Fontain, Ralph Corderoy)
561 32e5c7c2 MLE: KHT: auto-append / for directories at once (Christos Zoulas)
562 e2bb54b7 THANKS: Christos Zoulas
563 f593fc18 make-config.sh: do NOT skip fakeroot paths
564         (Gavin Troy, Gaetan Bisson)
565 4fe971ea FIX [4047a432] possible bound excess in memset()!
566 84efbcab FIX shexp parser regarding metachars (and poss. endless <TAB> loop)
567 14fbce97 FIX: OH!  The codebase NEVER supported *mime-encoding*=base64!
569 v14.9.0 ("Long-tailed tit"), 2017-07-16
570 ---------------------------------------
572 This is a major feature release which took about ~22 months (24
573 less two) of development to complete, and which imposed massive
574 changes under the hood, but also quite a lot of user visible
575 changes, including some **backward incompatibilities**.
576 As usual, "s-nail -d" will show obsoletion warnings.
578 We gain noticeable improvements regarding scriptability and its
579 reliability, but also for interactive use cases, especially
580 notable to users is our completely new M(ailx)L(ine)E(ditor) that
581 supports rather real tabulator expansion and program-mode-context-
582 sensitive key bindings.
584 We now support macros with arguments, which can be `shift'ed,
585 a `return' status can be used, and a `vexpr' multiplexer offers
586 some arithmetic and string operations.  `commandalias'es are
587 recursive, further command modifier prefixes, like `ignerr', give
588 a hand that we otherwise could not offer.  In compose-mode the new
589 `~^' command escape allows some message and attachment access, and
590 can be used, e.g., to implement things like custom headers, and
591 has been especially designed for scripted access via the new
592 *on-compose-splice* and *on-compose-splice-shell* hooks.
594 S-nail will move (more or less) backward-incompatibly to sh(1)ell
595 compatible argument quoting (documented in "COMMANDS"), and an
596 increasing number of commands do support this already: new ones
597 exclusively, some old ones have either been switched (like
598 `localopts'), others -- noticeably `set' -- can be switched to the
599 new syntax with a `wysh' command modifier prefix.  E.g.:
601   ? define __xv {
602     # Be careful to choose sh(1)ell-style on _entire_ line!
603      localopts yes; wysh set verbose; ignerr eval "${@}"; return $?
604     }
605   ? commandalias call echo boo-boo
606   ? commandalias xv call __xv
607   ? xv list
608   ? commandalias xv '\'call __xv
609   ? xv list
611 Calling the latter `xv' for `list' will give more detailed command
612 information, including which kind of argument is used.
614 I have not managed to implement the three features i have started
615 this development cycle for, these are thus subject to further
616 development, just like wysh for message-list argument commands to
617 support, e.g., negation, wysh for `if' and consorts, the --
618 terminator to finally overcome the ridiculous requirement to quote
619 entire shell commands filenames for commands like `pipe.
620 And and and.
622 Credits, in order of commit appearance: Antonio Radici,
623 Aharon Robbins, Mike Frysinger, Predrag Punosevac, Michael Convey,
624 Hariskar, Rudolf Sykora, Martin Neitzel, Gavin Troy,
625 Salvatore Bonaccorso, Todd C. Miller, Sergey Matveev, Robert Elz,
626 Mantas Mikulėnas, Respiranto, Jens Schleusener, Walter Alejandro
627 Iglesias, Ralph Corderoy, David Levine, Lyndon Nerenberg,
628 Thomas Dickey, Afan, Justin Ellingwood, Ingo Schwarze,
629 Viktor Szépe, Gaetan Bisson, Juan RP, William Yodlowsky,
630 Hilko Bengen, Matthew Dillon, Colin Watson, Donald Mugnai,
631 Stephen Isard, Jürgen Daubert, Sven Neuhaus, trondd, Ismael Bouya,
632 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
633 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
634 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, Xin LI.
636 We welcome Antonio Radici, Mike Frysinger, Predrag Punosevac,
637 Michael Convey, Rudolf Sykora, Todd C. Miller, Robert Elz,
638 Jens Schleusener, Walter Alejandro Iglesias, Thomas Dickey, Afan,
639 Justin Ellingwood, Viktor Szépe, Juan RP, Matthew Dillon,
640 Colin Watson, Donald Mugnai, Sven Neuhaus, Ismael Bouya,
641 Felipe Gasper, Paul Eggert, Dr. Werner Fink, Ken Hornstein,
642 Noel Chiappa, Random832, Doug McIlroy, Baptiste Daroussin,
643 Riccardo Ductor, Pietro Cerutti, Jörg Schilling, rain1, and
644 Xin LI in THANKS.
646 Apologies: Sergey Matveev.
647 Members of the Roff community which await progress.
649 NOTES, ChangeLog (packager-affine)
650 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
652 * This release brings some backward incompatibilities, outlined
653   in the following.  Most users will not be affected, and we have
654   added a lot of compatibility cruft, but that will vanish in v15.
655   "$ s-nail -v"!
657 * The configuration and build system has changed.
658   Packagers have received updated package files.
660   o Anything which was WANT_xy before is now OPT_xy, and
661     compiled-in paths and values, like PREFIX or PAGER, have
662     gained a VAL_ prefix (thus VAL_PREFIX and VAL_PAGER).
664     This is _not_ true for non-persistent or environmental values,
665     e.g., DESTDIR, CC, etc., and also not for the overwritable
666     program variables during configuration, e.g., $awk.
668   o SENDMAIL -> VAL_MTA, SENDMAIL_PROGNAME -> VAL_MTA_ARGV0,
669     MAILSPOOL -> VAL_MAIL.
670     And NAIL -> VAL_MAILX, though this is still a lie.
672   o The make system now needs config..build..install or
673     all..install or tangerine (config..build..test..install).
674     Some constants which some experts may want to fine-tune have
675     been moved to config.h.  Usual adjustments+doc via make.rc.
677   o The `build' phase can be parallelized by setting the $MAKEJOBS
678     environment variable, e.g., "make MAKEJOBS=-j4 build".
679     Note this variable is not tracked in the configuration.
680     (Gaetan Bisson)
682   o Unless DESTDIR is set an uninstallation script will be
683     installed along with the rest (see INSTALL file for more).
685   o Set the new OPT_CROSS_BUILD to avoid feature runtime tests,
686     only compile- and link-availability will be tested.  (Juan RP)
688   o VERBOSE is implemented straight, but must be given at
689     configuration time in order to become honoured.
690     (William Yodlowsky)
692   o ADDCFLAGS / ADDLDFLAGS -> EXTRA_CFLAGS / EXTRA_LDFLAGS.
694   o The LD_LIBRARY_PATH etc. building processes will skip any path
695     which contains the string "fakeroot".  (Hilko Bengen)
697   o We honour a set $SOURCE_DATE_EPOCH#589 environment variable to
698     an extend that allows reproducible tests, which is why the
699     repository gained a [test-out] branch with some expected plain
700     text outputs.  (reproducible-builds.org; Colin Watson)
702     The new *log-prefix*#422 variable aids in improving the
703     reproducibility of error messages.
705   o These are upward compatible changes.
707 * "make OPENSSL_API_COMPAT=0x10100000 all" should work.
709 * Internal and environment variables are now explicitly _defined_
710   and _tracked_ after variable handling has been rewritten
711   completely.  Notes:
713   o This means that, e.g., "$ password=NOT_SECRET s-nail" will
714     **NOT** work no more, since *password*#457 is an internal
715     variable!
717   o But if you do, e.g., "? set TMPDIR=~/tmp", then this will
718     also be reflected in the program environment (it is an
719     environment variable) and thus affect child processes.
721   o Therefore we no longer have `setenv' and `unsetenv'.
723   o To integrate any other environment variable transparently
724     into our variable management, the new command `environ'#174
725     needs to be used, e.g., "? environ set NEWVAR=value" or
726     "? environ link EXISTINGVAR".
728 - -H#64 and -L#67 have been decoupled:
729    it used to be -e#61 -L#67 instead!
731 - *NAIL_{HEAD,TAIL}* have been obsoleted in favour of
732   *message-inject-head*#430 and *message-inject-tail*#431.
734   *NAIL_HIST{FILE,SIZE}* have been obsoleted in favour of
735   *history-file*#404 and *history-size*#407.
737   *NAIL_EXTRA_RC* has been obsoleted in favour of
738   *mailx-extra-rc*#425.
740   *batch-exit-on-error* has been obsoleted by *errexit*#386, which
741   works just like the POSIX sh(1)ell "set -e" construct; the
742   `ignerr'#112 command modifier (`-' for command escapes in compose
743   mode, and see below) can be used to ignore command errors even
744   then.  (This will remain even if we at some later time will
745   support at least some of the sh(1) constructs which "swallow"
746   failures with set -e.)
748   *bsdannounce* is obsolete, the feature is integrated in
749   *header*#401 as this is much more useful.  (This is however also
750   dependent upon the also new but well-known $POSIXLY_CORRECT#587
751   <> *posix*#472, but that is just how it is; these affect more
752   behaviour, and increasing.)
754 - Colour support has been changed backward in- and upward (from
755   user interface side) compatibly, see the manual section
756   "Coloured display"#18.
758   + New commands: `colour'#147 and `uncolour'#148.
759     You can define context-sensitive, terminal-capability-
760     sensitive settings, e.g.:
762       if terminal && [ "$features" =% +colour ]
763         colour iso  view-header ft=bold,fg=magenta,bg=cyan
764         colour 256  view-header ft=bold,fg=208,bg=230 subject,from
765         colour mono view-header ft=bold
766         colour mono view-header ft=bold,ft=reverse subject,from
767       endif
769   + The variable *colour-pager*#372 defines whether colour and font
770     attribute sequences should be generated when viewing something
771     in $PAGER#585.
773   + Set the variable *colour-disable*#371 to turn colour off
774     without affecting established settings.
776   + It is deduced via termcap(5) (see below) whether the terminal
777     supports colors, e.g., "$ s-nail -Stermcap=Co#256".
778     This is also true if we don't have termcap support.
780   + Support for 256-colour terminals. (Gavin Troy)
782 - `source'#265 series support shell pipes if the last character
783    of the "filename" ends with a vertical bar |, e.g.,
785       ? source 'gpg -qd ~/.s-nailrc-private.gpg |'
787 - Shell pipes are also supported as targets for `move'#215,
788   `copy'#152 etc., yet unfortunately not with via a sh(1)ell token
789   parser, so that the target still has to be a single argument.
791       ? copy . '| cat; echo huhu'
793 - Support for custom headers via the new `~^'#304 compose-mode
794   command escape and in addition, or alternatively, with the
795   internal variable *customhdr*#376, which also can be covered by
796   `localopts'#202.  (Sergey Matveev)
798   + Support of $ORGANIZATION has been dropped.
800   + Command escape `~e'#310 supports _any_ header.
802   + Command escape `~^'#304 supports _any_ header.
804 - New -:#53 command line option can be used to more easily select
805   which startup files should be loaded, e.g., -:/ loads none.
806   (Robert Elz)
808 - `account'#127s and *folder-hook*#393s now have `localopts'#202
809    enabled by default.
811 - A first simple form of compose-mode hooks has been implemented:
812   *on-compose-enter*#450, *on-compose-leave*#451 and
813   *on-compose-cleanup*#449 can be set to macros which get invoked
814   at appropriate times.
815   For the `resend'#242 series there is *on-resend-enter*#455 and
816   *on-resend-cleanup*#454: this is very likely to change once
817   true message access is possible even in this mode.
819   An even more powerful mechanism is available via the also new
820   *on-compose-splice*#452 and *on-compose-splice-shell*#453 hooks.
821   These are executed in child processes and communicate with the
822   parent via their standard input and output, and therefore can
823   do anything and act as if they were the user.
825   `localopts'#202 are enabled and cannot be disabled (and extend
826   until the message is sent).
827   (Jens Schleusener, Rudolf Sykora)
829     ? set on-compose-splice=ocs
830     ? define ocs {
831       read ver
832       echo Splice protocol version is $ver
833       echo '~^header list'
834       read hl; vput vexpr es substring "${hl}" 0 1
835       if [ "$es" != 2 ]
836         echoerr 'Failed to read header list, bailing out'
837         echo '~x'
838       elif [ "$hl" @i!% ' cc' ]
839         echo '~^header insert cc Diet is your <mirr.or>'
840         read es; vput vexpr es substr "${es}" 0 1
841         if [ "$es" != 2 ]
842           echoerr 'Failed to insert Cc:, bailing out'; echo '~x'
843         end
844       end
845     }
847 - "The .netrc file"#37
849   + gained support for comments.
850     (Walter Alejandro Iglesias, Ralph Corderoy)
852   + `netrc'#218 now has a "load" subcommand.
854   + the new *netrc-pipe*#444 obsoletes OPT_AGENT and
855     *agent-shell-lookup*, and can be used to load an encrypted
856     .netrc file, e.g.:
858       ? set netrc-lookup netrc-pipe='gpg -qd ~/.netrc.gpg'
860     I.e., this is in usual .netrc syntax and thus possibly much
861     nicer than saying "? source 'gpg -qd ~/.credentials.gpg |'".
863 - termcap(5) / terminfo(5) support has been changed backward in-
864   and upward (from user interface side) compatibly, please read
865   "On terminal control and line editor"#17.
867   + OPT_TERMCAP is by default enabled.
868     The new, by default enabled, configuration option
869     OPT_TERMCAP_VIA_TERMINFO can be used to (try to) use
870     terminfo(5) instead.
872   + The variable *termcap*#552 can be used to freely define or
873     override terminal capabilities, and *termcap-disable*#554 will
874     disable interaction with the chosen library, leaving only
875     *termcap* in charge.
877     To use the so-called ca-mode on supporting terminals,
878     effectively turning S-nail into a fullscreen application,
879     *termcap-ca-mode*#553 must be set.
881   + The built-in line editor has been rather completely rewritten
882     to be the Mailx-Line-Editor (OPT_MLE, default yes), and
883     supports wide glyphs (if possible), infinite line lengths
884     (2 GB) and more.  Tabulator expansion is no longer an option
885     (but needs fnmatch(3)).
887   + Optionally (OPT_KEY_BINDINGS, default yes) it has become
888     possible to freely define key bindings for the MLE via the new
889     `bind'#136 and `unbind'#137 commands.  These key bindings can
890     make use of termcap(5) and/or terminfo(5) names.  The MLE will
891     install a set of default bindings (unless there is a set
892     *line-editor-no-defaults*#421), more so with OPT_TERMCAP,
893     i.e., try "? bind*".
895     Sufficient support provided, one can now, e.g., type "p " and
896     then collect the message numbers to type, scrolling forward
897     and backward via key-bindings, without loosing the line
898     content, then commit the final line.
900   + OPT_EDITLINE and OPT_READLINE support have been dropped.
901     The new MLE should not miss anything.  Does it?
902     Tip: in an UTF-8 locale try "? !touch /tmp/hall{,öchen}" and
903     then autocomplete that: once, then ^Q, and again.
905 - `source'#265 can be used in `call'#138ed macros.
906   What sounds so innocent replaced an entire machinery and got rid
907   of a brilliant idea of Kurt Shoens from the 70s, but which never
908   worked with Nail/Heirloom extensions, namely macros, and in the
909   right order.
910   Accompanying this -X#81 can (dig multiline arguments and can) be
911   used to define macros and run them etc.  Should work:
913     $ s-nail -X'define x {' -Xversion -Xx -X'}' -X'call x'
914     $ s-nail -X'source \' -X'"echo version|"' -Xx
916   Macros can be `undefine'#157d from within themselves, and re-
917   `define'#156d.  It is still not possible to define macros
918   from within macros, and/or have inner macros, not to talk
919   about local scoping or anything more sophisticated such.
921 - -u#78 / $LOGNAME#578 ($USER) handling has been redefined,
922   and "-u USER" is now exactly the same as "-f %USER", and
923   $LOGNAME (and $USER) is actively set to the active user.  (Afan)
925   $LOGNAME#578 is POSIX standardized and henceforth used and
926   preferred over $USER, which came from BSD.  (Todd C. Miller)
928 - In the future (at least non-message-list) argument handling will
929   be changed backward-incompatibly to be sh(1)ell compatible (and
930   thus POSIX standardized), see "Shell-style argument quoting"#24.
931   New commands use it already today (`bind'#136, `colour'#147,
932   `headerpick'#193), some others (most importantly, `set'#253) can
933   be forced to do so via the new `wysh'#117 command prefix, as in:
935     ? wysh set message-inject-tail=$'\n--steffen'
936     ? bind base $'\cA,\x61' 'echo control-A and small a'
938 - We now actively manage *umask*#559: 0077 by default, but an
939   empty string will use the setting that is active upon startup.
940   Just like changes to (known) environment variables, this setting
941   will also be inherited by any child process.
942   (Walter Alejandro Iglesias)
944 - Anything SENDMAIL / *sendmail*-ish has been renamed to *mta*#438,
945   *mta-arguments*#439, *mta-no-default-arguments*#440 and
946   *mta-argv0*#442.
948   The reason is that in v15 we won't even have *smtp*: it is just
949   another form of MTA, and thus obsolete by itself.
950   Note that *mta-arguments* is now parsed via the shell-token
951   parser, so the following ends up exactly as desired.
953     ? set mta-arguments='-t -X "/tmp/my log"'
955   For now we support a hack that understands a file:// URL in
956   *mta*, too, but that is also the default if there is no protocol.
957   E.g.: "? set mta=smtp://a:b@xy.z"
959 - The "spamd" *spam-interface*#522 is obsolete.  I haven't tested
960   it since my main machine died, it is error prone since it assumes
961   internals of the spamassassin wire protocol, and there never was
962   a speed improvement over "spamc".  (However it could react upon
963   the "is-spam" state of a message, which "spamc" doesn't allow.)
965 - The new *inbox*#415 variable will henceforth be looked up when
966   searching for a primary system mailbox (as in "? File %"),
967   followed by the usual $MAIL#579 and compile-time defined local
968   mailspool search.  (Stephen Isard, Jürgen Daubert)
970 - The semantic of -a#55 and `~@'#302 have been changed, and both
971   commands now use the same syntax:
973     -a file[=input-charset[#output-charset]]
975 - New "failinvaddr" keyword for *expandaddr*#388.
977 - We finally "can" the so-called (by myself) "Dr. Problem" (a bit):
978   (Dr. Werner Fink)
980     $ </dev/null s-nail -d:/ -sTrödler 'Dr. D. Iet <z@a.k>' 2>&1 |\
981       grep To:
982     s-nail: >>> To: "Dr. D. Iet" <z@a.k>
984   This can be done via the new `addrcodec'#129, too, note this
985   supports multiple modes (and the `vput'#116 command modifier):
987     $ echo 'addrcodec e Dr. Diet <to@fu.soj> Curd' | s-nail -#:/
988     "Dr. Diet Curd" <to@fu.soj>
990 - All commands with the string "codec" in their name use different
991   argument quoting, namely none at all, please read
992   "Raw data arguments for codec commands"#25.
993   This means that `urlcodec'#282 (and `imapcodec'#617) has
994   slightly changed semantics.
995   And, while here: there is a new `shcodec'#255, too.
997 - We gained "Command modifiers"#21: `\'#111 (avoid expansion of
998   `commandalias'#149es), `vput'#116 (store result in variable),
999   `ignerr'#112  (ignore an error of the following command, even
1000   if the new *errexit*#386 is set), `wysh'#117 (use shell-style
1001   arguments).
1003     $ echo 'vput cwd resvar;echo $resvar' | s-nail -#:/
1004     /home/steffen/src/nail.git
1006   And the usual sh(1) stuff: `return'#248, `shift'#259, `eval'#176,
1007   plus a `xcall'#291 stack-avoidance optimization (to be used in
1008   place of a `call'#138 which would be the last called command).
1009   And an "expr(1) like thing", yet simple, `vexpr'#287.
1011     $ echo 'vexpr + 1 2' | s-nail -#:/
1012     00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000011
1013     03 | 0x3 | 3
1014     $ echo 'vput vexpr resvar + 1 2;echo $resvar' | s-nail -#:/
1015     3
1017   We actually start walking (*?*#330, *^*#332).
1019     ? vput vexpr res regex 'bananarama' 'Bana(.+)' '\$1\$0'
1020     ? echo $?/$^ERRNAME :$res:
1021     1/NODATA ::
1022     ? vput vexpr res iregex 'bananarama' '(.+)rama' '\$1\$0'
1023     ? echo $?/$^ERRNAME :$res:
1024     0/NONE :bananabananarama:
1026   The command `vpospar'#288 can be used to manage the stack of
1027   positional parameters, i.e., much like "set --".
1028   It also offers the possibility to save and restore the stack to
1029   and from variables.  Etc.
1031   Btw., to contact the maintainer (make.rc variables
1032   VAL_CONTACT_WEB and VAL_CONTACT_MAIL):
1034     ? echo $contact-web; eval mail $contact-mail
1036 - `if'#199 no longer performs automatic number conversion, we
1037   use the explicit -lt, -gt etc. syntax of the sh(1).
1038   Note: `if' will change to be almost identical to sh(1) if(1),
1039   so please ensure proper test bracketing, even if it is less
1040   convenient.
1042   Moreover, the default string comparison mode has changed to
1043   case-sensitive, just like in the shell.  This is because in the
1044   future this crux with trigger characters will vanish and `if'
1045   etc. will simply slurp in already expanded shell tokens, it will
1046   act like the shell in that respect.  We have modifiers, though,
1047   yet only "@i" for case-insensitivity, also for regex matches:
1049     LC_ALL=C
1050     i=`LC_ALL=C.utf8 s-nail -:/ -# -X '
1051        \define cset_test {
1052           \if [ "${ttycharset}" @i=% utf ]
1053              \echo $LC_ALL
1054              \xit 0
1055           \end
1056           \if [ "${#}" -gt 0 ]
1057              \wysh set LC_ALL=${1}
1058              \shift
1059              \eval xcall cset_test "${@}"
1060           \end
1061           \xit 1
1062        }
1063        \call cset_test C.UTF-8 POSIX.utf8 POSIX.UTF-8 \
1064           en_EN.utf8 en_EN.UTF-8 en_US.utf8 en_US.UTF-8
1065    '`
1066    [ $? -eq 0 ] && UTF8_LOCALE=$i
1068   Please note the `eval' in 'eval xcall cset_test "${@}".  This is
1069   a difference of S-nail/mailx and the sh(1)ell that will remain,
1070   as documented in "COMMANDS"#20: whereas the shell implements
1071   a language and performs standardized expansions on the line
1072   until finally the command is called, S-nail will decide the type
1073   of command line parsing dependent on the seen command, and will
1074   then perform a single expansion.  Therefore "${@}" will expand
1075   to multiple arguments if $# is greater 0, but it will expand to
1076   the empty string otherwise, which is not furtherly expanded away
1077   since it is meaningless like it is in the shell: therefore $#
1078   will be 1 (the empty string) not 0.
1080 - Using an explicit proto:// prefix should get you the desired
1081   thing apart of *newfolders*#445, e.g.:
1083     ? File maildir:///tmp/x.mdir
1084     ? copy * file:///tmp/x.mbox
1086 - New variable *record-files*#484 can be set to extend the meaning
1087   of *record*#483.  *record-resent*#485 was there already.
1089 - New variable *ifs*#411 acts a bit like the sh(1)ell's $IFS for,
1090   e.g., the new `read'#232 command.
1092   There is a `readctl'#234 command which can be used to manage
1093   the active channel used by `read'#232.
1095 - The `~' alias for `call'#138 is gone.
1097 - `mimetype'#207 only allows specification of a single type per
1098   call, on the other hand no need to quote that.
1100 - `mimeview'#211 must now be used explicitly to look at any
1101   non-text MIME part, for normal display etc. purposes we only
1102   support "copiousoutput"#604 MIME handlers.
1104 - New *socks-proxy*#521 can be used to proxy all network traffic
1105   over a SOCKS5 proxy.  (Gaetan Bisson)
1107 ChangeLog
1108 ^^^^^^^^^
1110 - The manual has seen another major overhaul, all the variables
1111   are now documented in a single, sorted list, and many
1112   clarifications should have been added.  I hope it has become
1113   a better read.
1114   (Predrag Punosevac, Michael Convey, Hariskar, Rudolf Sykora,
1115   Respiranto, Thomas Dickey, Donald Mugnai)
1117 - To support RFC 1524 a.k.a. .mailcap files (see below) many
1118   "trigger"-characters have been added for *pipe-TYPE/SUBTYPE*#459,
1119   which may (rarely) affect existing values.
1120   The .mailcap support itself is not yet implemented.
1122 - *mime-counter-evidence*#435 gained bit 4 (perform proper in-depth
1123   content inspection as necessary; set to 0xE for all bits).
1124   (Aharon Robbins)
1126 - Maildir paths are now created recursively as necessary.
1127   (Justin Ellingwood)
1129 - -M#68 and -m#69 options have been added to enforce a special
1130   send mode that will flag standard input / the given file with
1131   the specified / detected MIME 'Content-Type:'.  This can be used
1132   to directly send, e.g., HTML log output.
1133   (Viktor Szépe, Ralph Corderoy)
1135 - Disallow symlinks on writable files.  Note this requires
1136   O_NOFOLLOW support for the operating-system-call open(2), but
1137   which has been standardized a long time ago.
1138   (Matthew Dillon)
1140 - `retain'#247, `ignore'#200 etc. now differentiate in between
1141   From (the From: header) and From_ (the MBOX ident).
1143   In fact we now have a new `headerpick'#193 command which
1144   is a multiplexer for all retain and ignore lists used, call it
1145   without arguments to see the current setting(s).
1146   In v15 only `headerpick' and the standard-imposed wrappers
1147   `retain' and `ignore' will remain, all other wrappers will
1148   vanish.  Regular expressions can now be used if available:
1150     ? headerpick
1151       headerpick type retain blahblahblah cc date from \
1152         mail-followup-to message-id openpgp reply-to subject to \
1153         user-agent
1154       #headerpick type ignore currently covers no fields
1155       #headerpick save retain currently covers no fields
1156       headerpick save ignore '^Original-.*$' '^X-.*$' '^DKIM.*$'
1157       headerpick forward retain cc date from list-id \
1158         mail-followup-to openpgp reply-to subject to
1159       #headerpick forward ignore currently covers no fields
1161 - `top'#274 has been rewritten completely, `Top'#273 is new.
1162   It uses a built-in set of retain/ignore headers, but it is
1163   possible to register a custom set via `headerpick'#193.
1164   Also, *toplines*#555 has been extended a bit and the new
1165   *topsqueeze*#556 variable may pimp your `top' experience.
1167     ? headerpick top retain add subject
1168     ? top
1169     [-- Message  1 -- 87 lines, 4791 bytes --]:
1170     Subject: Re: I can't dist to myself
1172     I wrote:
1173         3.22. bounce_delivered
1175 - `features' has been dropped, `version'#286 extended.
1177 - The *prompt*#474 handling has changed: we lost the capability to
1178   expand \?, \@ and \$, instead new "private" variables *?*#330,
1179   *account*#341, *mailbox-resolved*#424 and
1180   *mailbox-display*#423 have been introduced, and the prompt
1181   is completely shell expanded (thus twice with `wysh' or in v15),
1182   as if dollar-single-quote quoted.  We do support the reverse-
1183   solidus escaped bracket notation for embedding characters which
1184   should not be counted when calculating the width of the prompt.
1185   The `colour'#147 command has a slot for the prompt colour.
1186   We gained *prompt2*#475 as a second level prompt.
1188     ? var prompt
1189     wysh set \
1190       prompt='?\${?}!\${!}[\${account}#\${mailbox-display}]? '
1192 - The filename "-" can be used as a receiver, e.g.,
1194     $ echo Hey,\ you | s-nail -:/ -Sexpandaddr -sUB -
1196 - The -s#76 command line option, the `~s'#323 command escape
1197   as well as the corresponding slots of `~^'#304 will actively
1198   strip [\r\n] from their value (Debian #419840).
1200 - New `read'#232 and `echoerr'#167 commands, mostly for
1201   *on-compose-splice*#452.
1202   But also `echon'#168 and `echoerrn'#169, which do not write
1203   a trailing newline.
1205 - New variable *r-option-implicit*#481 may be helpful to those
1206   who regulary need the functionality of the -r#74 command
1207   line option.  (Felipe Gasper, Martin Neitzel)
1209 - By using new "pseudo-URLs" one can automatize the use of S/MIME
1210   keys / (certificates / intermediate include certificates) with
1211   passwords.  E.g., to drive bob@exam.ple, set
1212   *smime-sign-cert-bob@exam.ple* to the private key / certificate
1213   pair as usual, the password lookup will then be performed for
1214   bob@exam.ple.smime-cert-key, bob@exam.ple.smime-cert-cert and
1215   bob@exam.ple.smime-include-certs.
1216   Like this the password can be stored in an encrypted .netrc file
1217   when *netrc-lookup*#443 and *netrc-pipe*#444 are set, or it may
1218   be stored in an encrypted resource file that has been loaded via
1219   `source'#265 as a simple *password*#457 variable.
1221   Note that the prompting that happens as a last resort of
1222   password lookup will still interfere with a possibly running
1223   $PAGER#585 instance, dependent on the setting of *crt*#375, of
1224   course.  Proper job control handling and recognizing that we are
1225   running $PAGER when doing that prompt is a TODO for v15.  Sorry.
1227 - Some commands, like `set'#253, `help'#196, `list'#201,
1228   `mlist'#209 etc., now react upon the setting of *verbose*#562
1229   and(/or) *debug*#379.
1231 - `write'#290 uses iconv(3) as appropriate.
1233 - *mbox-rfc4155*#427 has first been dropped, and was then
1234   reintroduced with different semantics.  Because, it can be
1235   helpful if a messed up MBOX is read, in which case we henceforth
1236   will warn you and point you to this:
1238     ? define mboxfix {
1239       \localopts yes; \wysh set mbox-rfc4155;\
1240         \wysh File "${1}"; \eval copy * "${2}"
1241     }
1242     ? call mboxfix /tmp/bad.mbox /tmp/good.mbox
1244   P.S.  Here you see how weird the current thing still is, in v15:
1246     ? define mboxfix {
1247       localopts yes; set mbox-rfc4155; File "${1}"; copy * -- "${2}"
1248     }
1250   And also in v15 we will not apply (proper) so-called MBOXO
1251   quoting, but instead (simply MIME) re-encode mail messages.
1253 - `call_if'#139 is new and, different to "? ignerr call", silent
1254   and not messing with the return status.
1256 - The new *smime-ca-flags*#507 and *ssl-ca-flags*#534 can be used
1257   to fine-tune X509_STORE_set_flags(3) a.k.a the X509 CA
1258   certificate verification.
1260     ? set ssl-ca-flags=partial-chain
1261     ? wysh set smime-ca-flags="${ssl-ca-flags}"
1263   Also, *ssl-curves*#543 for TLSv1.3.
1265 - Socket connections use TLS S(erver)N(ame)I(ndication) as
1266   appropriate (RFC 7817).
1268 - `alternates'#132 checks arguments and supports `vput'#116.
1269   It by default no longer replaces but appends alternates, unless
1270   *posix*#472 mode is active.  There is a new `unalternates'#133
1271   command to remove alternates.
1273 - A new `charsetalias'#142 command.  (Pietro Cerutti, mutt#3925)
1275 - New commands `filetype'#180 and `unfiletype'#181: in the future
1276   we will no longer know any builtin filetypes, in fact we already
1277   simulate .gz etc. via the new mechanism as necessary:
1279     ? filetype \
1280        bz2 'bzip2 -dc' 'bzip2 -zc' \
1281        gpg 'gpg -d' 'gpg -e' \
1282        gz 'gzip -dc' 'gzip -c' \
1283        xz 'xz -dc' 'xz -zc' \
1284        zst 'zstd -dc' 'zstd -19 -zc' \
1285        zst.pgp 'gpg -d | zstd -dc' 'zstd -19 -zc | gpg -e'
1287 - `~<'#299 now offers a "- [HERE-delimiter]" mode for pasting etc.
1288   (Ralph Corderoy)
1290 - `exit'#177 and `quit'#231 take an optional exit status.
1291   (That is not fixated yet, though.)
1293 - We have a useful -h / --help output.  (Doug McIlroy)
1295 - *encoding* obsoleted in favour of new *mime-encoding*#436, which
1296   now defaults to base64.
1298 - *allnet*#343 now works (broken since nail 10.00, 2002-09-29).
1300 git(1) shortlog (abbreviated)
1301 '''''''''''''''''''''''''''''
1303 f01291d extract_date_from_from_(): dig more invalid MBOXes (Antonio Radici)..
1304 df8768b Add *mime-counter-evidence* bit 4 (Aharon Robbins)..
1305 d3fe980 Ftmp(): drop "mode" argument (not wrong: Mike Frysinger)..
1306 86159db nail.1: we support searching, really (Predrag Punosevac)
1307 5b61a08 nail.1: talk about address lists (again) (Michael Convey)..
1308 0eeffc4 nail.1: try improve states / MBOX etc. relation (Michael Convey)
1309 43ea039 nail.1: what is an environment variable (Michael Convey)
1310 13e0804 nail.1: fix typo (Hariskar (archlinux Wiki))
1311 03d6af5 nail.1: more on sortability (Rudolf Sykora)..
1312 4da9043 Not "binary", but "boolean" variables! (Predrag Punosevac)..
1313 c85f56d Support :d specifier for at least `from' (Martin Neitzel)..
1314 b12e1ed Be more friendly when composing mails (Martin Neitzel)..
1315 b50eac0 nail.1: use display/show not type/print (Michael Convey)..
1316 6feafaf Add `search' alias for `from' (Predrag Punosevac)
1317 a4e2612 Support 256-colour terminals (Gavin Troy)
1318 8655aff Error framework: print UAGENT prefix (ident in pipes; Salvatore
1319         Bonaccorso)
1320 e96baaa Introduce $LOGNAME, the POSIX equivalent of $USER (Todd C. Miller)
1321 76e6364 Add `customhdr' (Sergey Matveev)..
1322 ad58c91 Support *customhdr*, too (Sergey Matveev)..
1323 6322e0a Support _any_ user header via ~e (Sergey Matveev)..
1324 5d52578 Add -: command line option (Robert Elz)..
1325 53b5f07 README: use git(1) --single-branch (Mantas Mikulėnas)
1326 420131f Fix mispelling: can|to be send->sent (Respiranto (archlinux Wiki))
1327 d6902e1 Add *on-compose-{enter,leave}* hooks (Jens Schleusener, Rudolf
1328         Sykora)..
1329 abf2e5d .netrc: support comments (Walter Alejandro Iglesias, Ralph Corderoy)..
1330 37e0c26 nail.1: .netrc comma separator was in original Berknet parser! (Ralph
1331         Corderoy)
1332 40522c3 nail.1: use -v option to cat(1) if available (Thomas Dickey)
1333 d8f7cd7 (BWDIC!) Redefine -u / $LOGNAME / $USER (Afan)..
1334 e337e00 Support expansions in $MAIL!; more on `account's (Afan)..
1335 d596d74 Compare *newfolders* case-insensitively (Justin Ellingwood)..
1336 57744f9 Redefine *folder* / getfold->folder_query() / *HOME* (Justin
1337         Ellingwood)..
1338 3c57c83 n_path_mkdir(): create recursively as necessary (Justin Ellingwood)
1339 0bbe981 nail.1: fix spelling errors as by igor(1) (Ingo Schwarze)
1340 f1a775b Add -M and -m options (Viktor Szépe, Ralph Corderoy)..
1341 1bd8e48 Add *umask*, and set actively (Walter Alejandro Iglesias)..
1342 6b1cd93 Now with *umask*, just drop fchmod(2)++ calls (Walter Alejandro
1343         Iglesias)
1344 ba22166 Change make targets; add $MAILJOBS; don't track $DESTDIR (Gaetan
1345         Bisson)..
1346 cd244b1 Add WANT_CROSS_BUILD make.rc option (Juan RP)..
1347 95141f6 Tweak VERBOSE handling (William Yodlowsky)..
1348 d74a18a mk-conf.sh:path_check(): skip any "fakeroot" path (Hilko Bengen)
1349 10990e4 Add n_O_NOFOLLOW, disallow symlinks for writable files (Matthew
1350         Dillon)..
1351 df4954c Add $SOURCE_DATE_EPOCH (reproducible-builds.org; Colin Watson)
1352 dc92f2c savedeadletter()->sendout.c; tweak POSIX compliance (Ralph Corderoy)
1353 20f3cd2 nail.1: more explicit `set' references instead of saying 'Set' (Donald
1354         Mugnai)..
1355 2d53b46 url_parse(): better take better care for path parts (Stephen Isard)..
1356 21f0eaa mk-conf.sh: find terminfo on Sun (Thomas Dickey)..
1357 e4ddaa8 Change n_iconv*() protos, add enum n_iconv_flags (Ralph Corderoy)..
1358 1587069 FIX [44cec1f] (Fix "address" message specifications (John Dodson))..
1359 e40e181 nail.1, nail.rc: set *sendwait* by default (Ralph Corderoy)
1360 7adcf99 `write'++: !interactive: urlxenc() attachment paths (Ralph Corderoy)..
1361 b14aae7 `write'++: !interactive:.. But now, really (Lyndon Nerenberg, David
1362         Levine)..
1363 5270bf1 Simplify *folder* (implicit trail solidus) (Stephen Isard, Ralph
1364         Corderoy)
1365 a638bcf Add *typescript-mode*, set it for -# (Ralph Corderoy, Martin
1366         Neitzel)..
1367 053e19f Add *inbox* (Stephen Isard, and Jürgen Daubert)..
1368 20e3240 Add OPT_ALWAYS_UNICODE_LOCALE (Predrag Punosevac)..
1369 14b5a3a Make combinetime() overflow safe (Vincent Lefevre)..
1370 7a657d9c cc-test.sh: add S/MIME disproofs via smime(1) (Sven Neuhaus)..
1371 ae86c884 cmd1.c:__hprf(): compensate for add. bytes of UTF-8 seq.(s) (Martin
1372         Neitzel)
1373 975e6869 (BWDIC!) Only rm sysboxes, unless *posix* (Walter A. Iglesias,
1374         trondd)..
1375 81e33751 Throw away file_expand() (Ismael Bouya)..
1376 5ae556f8 Add *r-option-implicit* (Felipe Gasper, Martin Neitzel)..
1377 33709163 nail.1: some more words for *inbox*, and such sort (Stephen Isard)
1378 88c19049 mk-release.inc: place OpenPGP signatures last (learned from Paul
1379         Eggert)
1380 0ede309c Rudely fix the RFC 5322 dot-atom, the "Dr. Problem" (Dr. Werner Fink)
1381 f797c27e FIX privsep.c, yes, vulnerability (wapiflapi)..
1382 f2699449 FIX privsep.c vulnerability, II (forgot hostname!) (wapiflapi)
1383 303d46cd FIX [3d7835fc] aka `~^' attachments, especially Content-ID: (Ralph
1384         Corderoy)
1385 4ce4eb55 privsep.c: and just verify the box is also in CWD (wapiflapi)
1386 25d9e6e2 Generate Content-ID: as applic. (Ralph Corderoy, Ken Hornstein, David
1387         Levine)
1388 6409c886 nail.1: clarify/FIX doc. of \cX (Noel Chiappa, Random832)..
1389 5a1c023c nail.1: furtherly clarify doc. of \cX (Doug McIlroy)..
1390 d33294c2 mk-release.inc: use %B for $DATE_MAN (Baptiste Daroussin)..
1391 eafa9411 (BWDIC!) Defaults for *datefield{-markout-older}* (Debian #855582;
1392         r.ductor)..
1393 5ab93627 MLE: set FEXP_NOPROTO for mle-complete expansions (Ralph Corderoy)
1394 ada72661 ~<: add "- [HERE-delimiter]" for pasting etc. (Ralph Corderoy)
1395 d4d46c42 Add `charsetalias', and use it (Pietro Cerutti, mutt#3925)
1396 65e2b75f Redefine VIP handling of variables (Ralph Corderoy)..
1397 162cafb7 *mime-counter-evidence*, bit 4: allow "soft" controls (Jörg
1398         Schilling)..
1399 90861930 Readd removed fflush()/fseek() in between read and write..
1400   [That should credit Jörg Schilling indeed]
1401 aae47707 Tweak previous, and include O_CREAT in "a+" (Jörg Schilling)..
1402 3e4441f8 a_main_usage(): new synopsis (Doug McIlroy)
1403 8f61025b FIX icase hmaps (`charsetalias', `filetype', `mlist') (rain1)
1404 2e6a811d a_termcap_init_var(): numerics not necessarily decimal (Thomas
1405         Dickey)..
1406 9d58267f config.h+: add n_PATH_DEVNULL, use it instead of hardcoding (Xin LI)
1407 8075cf00 Support *socks-proxy* (SOCKS5) (Gaetan Bisson)
1409 Appendix
1410 ^^^^^^^^
1412 The complete changelog of commits in between two versions OLD and
1413 NEW can be inspected by using the git(1) `log' command:
1415   $ git log --reverse --topo-order --abbrev-commit OLD..NEW
1416   # Only topic branch headers (--no-merges for content commits only):
1417   $ git log --oneline --reverse --topo-order --merges OLD..NEW
1418   # Same, but truly accessible:
1419   $ git log --oneline --reverse --topo-order --merges --parents OLD..NEW |
1420     while read c1 c2 c3 c4 c5 c6; do
1421       printf "%-24s: \$ git log --oneline --no-merges %s ^%s\n" \
1422         "${c6}" "${c1}" "${c2}";
1423     done
1425 Entries for releases before v14.9.0 have been cut off and can be
1426 found in the git(1) repository:
1428   v14.8.0 - v14.8.16: $ git show v14.8.16:NEWS
1429   v13     - v14.8.5 : $ git show v14.8.5:NEWS
1430   9.0     - 12.5    : $ git show heirloom:ChangeLog
1432 Also accessible via HTTPS?, just replace X.Y.Z accordingly:
1434   \https?://git.sdaoden.eu/cgit/s-nail.git/tree/NEWS?h=vX.Y.Y
1436 For even older releases you need to look into the [timeline]
1437 branch, but no changelog has been administrated for them.
1439 # s-tm-mode