cc-test.sh: do a simple \`Resend' test
[s-mailx.git] / NEWS
blob3c7f2cb9fd2caf5be92d2365d89be8355ee76f65
1 S - n a i l  N e w s
2 ====================
4 In the following numbers in [] reference either the commit SHA1 hash or
5 the name of a topic branch which relate to the NEWS entry;
6 Likewise, numbers after an at-sign @ are mdocmx(7) manual anchor
7 references which allow directly jumping to the given anchor.
9 The complete changelog of commits in between two versions can be
10 inspected by using the git(1) `log' command as shown below, where "OLD"
11 and "NEW" are the two versions to be compared.
13   # All commits:
14   $ git log --reverse --topo-order --abbrev-commit OLD..NEW
15   # Only topic branch headers (--no-merges for content commits only):
16   $ git log --oneline --reverse --topo-order --merges OLD..NEW
17   # Same, but truly accessible:
18   $ git log --oneline --reverse --topo-order --merges --parents OLD..NEW |
19     while read c1 c2 c3 c4 c5 c6; do
20       printf "%-24s: \$ git log --oneline --no-merges ${c1} ^${c2}\n" "${c6}";
21     done
23 v14.8.4 ("Nameless bird (shot by Hemingway)", 2015-08-04
24 --------------------------------------------------------
26 Thanks for Jérémie Courrèges-Anglas for beating me to it.
28 NOTES, ChangeLog (packager-affine)
29 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
31 - Added support for the (BSD-licensed) idnkit[1] IDNA library which is
32   now in the base system of DragonFly BSD.  We still only support
33   encoding, though.  (And assume the hostname is in locale encoding.)
34   [cbded82,22ac479]
36     [1] <https://www.nic.ad.jp/ja/idn/idnkit/download/>
38 - I have rewritten the privilege-separated dotlock helper program,
39   because among others a SETGID one is of no use in todays world.
40   So it is now SETUID to the new PRIVSEP_USER.
42   . WANT_PRIVSEP and PRIVSEP_GROUP have been dropped.
44   . New option: WANT_DOTLOCK, by default enabled.
45     It is henceforth possible to strip any dotlock code off S-nail.
46     So either S-nail has complete dotlock support, including the
47     privilege-separated dotlock helper, or none at all.
49   . New variable: PRIVSEP_USER, by default "root".
50     It must be a privileged user that can be used to implement the new
51     strategy: we create the dotlock file and then fchown(2) it to the
52     UID and GID of the mailbox that we created it for.  Like this the
53     owner of the mailbox (remember %USER, $USER, -u USER ..) will be
54     capable to remove the lock file herself.  Or himself.
56   . No dotlocking was performed for reading, only for writing.  I've
57     changed this.  We also didn't perform any (file) locking at all when
58     updating non system-mailboxes, which i have changed, too.
60   . Fixed horrific bug: on systems without realpath(3), e.g., Solaris 9,
61     S-nail would not resolve symbolic links on the mailbox to lock,
62     potentially creating the lock file in the wrong directory.
64   . We now compare the inode/device/etc. of the mailbox file with the
65     information we collected a lot earlier from the open mailbox file
66     descriptor, and bail if they are not identical, to reduce attach
67     surface.
69   . The privsep helper now re-checks that it is capable to read (or
70     read/write) the mailbox it is creating a dotlock for, to reduce the
71     chance of being misused (by itself).  I.e., it does so before
72     raising its privileges, say.
74   [d5ec3cb]
76 - The predefined CONFIG=urations have been changed a bit and now
77   "require" more options than they did before.
79 - Renamed WANT_ALL_SSL_ALGORITHMS to WANT_SSL_ALL_ALGORITHMS.
80   That was a no-brainer, default of "yes" remains, but it now can also
81   be "require"d. [910849e]
83 - The GitLab project repository URL has been changed and now is
84   <https://gitlab.com/sdaoden/s-nail.git> (leave off ".git" for browsing
85   purposes).
87 ChangeLog
88 ^^^^^^^^^
90 - It has become possible to fixate the input character set of
91   attachments from the command line (without going over ~@):
92   when the -a @39 option cannot access(2) the file to be attached it
93   searches the filename for an equals-sign "=" and splits into filename
94   and character set shall it find one.  A character set defined like
95   this is "fixated" and therefore no character set conversion occurs.
97     $ echo body |
98     ./s-nail -d -s subject du@auch \
99       -aversion.h -aversion.h=KoI8-r -aversion.h=LaTin1 -aversion.h
101   >>> Content-Type: text/x-chdr; charset=US-ASCII
102   >>> Content-Type: text/x-chdr; charset=KoI8-r
103   >>> Content-Type: text/x-chdr; charset=LaTin1
104   >>> Content-Type: text/x-chdr; charset=US-ASCII
106   [1f07d9e,804e561]
108 - In *debug* mode the content of the message that would have been sent
109   is printed on standard error not only in *smtp*, but also MTA mode.
110   E.g., as in the example above. [c106f35]
112 - S/MIME oops: S-nail yet didn't test for the "application/pkcs7-mime"
113   MIME type at all, but only for "/x-pkcs7-mime" (pre-standardized
114   variant), so that S/MIME messages generated by more modern MUAs (e.g.
115   Alpine) wouldn't have been understood!
116   And we do now use that MIME type ourself, as standardized by RFC
117   5751.  However, we are still stupid and don't handle a signed message
118   inside a multipart/mixed message, neither do we support fully
119   encrypted messages (nothing but rfc822 member) etc. [10c2b16]
121 - *smime-cipher-USER@HOST* @431 values changed to versions without
122   hyphen, as that is what OpenSSL uses: e.g., AES256 not AES-256; the
123   latter versions are no longer documented and will be dropped with
124   v15.0. [f2c6eec]
126 - New variable *smime-sign-message-digest* [-USER@HOST] @437 can be used
127   to define the message digest for S/MIME signing.  RFC 5751 mandates
128   a default of SHA1, by default available are also SHA256, SHA512,
129   SHA384 and SHA224, MD5 may be available, dependent on OpenSSL.
130   With WANT_SSL_ALL_ALGORITHMS more digests may be available. [2f6dac3]
132 - Using NAIL_FILENAME_GENERATED was prevented since some time since it
133   ended up longer than NAME_MAX (ENAMETOOLONG). [3bcbbfc,f632b5b]
135 - Heavily rewritten manual section "Signed and encrypted messages with
136   S/MIME" @35, giving a ready-to-go example for CAcert.org.
138 - Nicer output for `help' @126 / `?' @74 when given an argument:
139   if that is a command ghost we search for the expansion and do print
140   the (further expansion and) help for that if possible [cea8c20]:
142     ?0[]? ?save
143     save: Append <message-list> to <file>
144     ?0[]? ?s
145     s (save): Append <message-list> to <file>
146     ?0[]? gh s s
147     ?0[]? ?s
148     s -> s (save): Append <message-list> to <file>
150 - No longer allowing recursive commands in macros to avoid that the
151   following can crash us (check can be bypassed):
153       ? define ouch {
154         echo ouch
155         reply 2
156       }
157       ? reply
158       ~:call ouch
160   This is a pity because "? call ouch" does no longer cause a reply,
161   but the real healing will take time.
162   Also the `source' command is now actively disabled during macro
163   evaluation -- this only works(/ed) by accidence and anyway non-
164   synchronously (the `source'd file will be loaded after the macro
165   evaluation has finished).  The real healing for this is heavy stuff
166   and will remove a smart and fantastic idea from before 1979, but it
167   won't work out with macro support (see commit message for more upon
168   interest). [5461a30]
170 - And `source' will be actively forbidden in compose mode, too.  It
171   never worked the way it should. [abd388c]
173 - Did -t @60 ever work for real?  Now it does.
174   Even better it now "supports" some more header fields (References:,
175   In-Reply-To:, Message-ID:, and Mail-Followup-To:, but the latter will
176   be subject of a nice followup content massage) -- S-nail can
177   henceforth be used for git(1)s send-email command.
178   We also improved the interdependency of -t (with[out] From:, Sender:),
179   -r, *from* and *sender*, but i don't say it is perfect yet.
180   [6842f12,631d402,a86ca2d]
182 - Completely reworked *expandaddr* @373 handling, and you can now define
183   *exactly* what you want, e.g., "fail,-all,+addr,+file" will only allow
184   mail address or file recipients and hard error out otherwise.
185   Note that in order to make that work "restrict" has been changed to be
186   effectively "restrict,-all,+name,+addr", which matters in, e.g.,
187   "fail,-all,+file,restrict" which therefore truly is "restrict,fail"!
189   Even in conjunction with -t you should now see proper (-d / *debug*,
190   -v / *verbose*) messages for *expandaddr* caused address stripping,
191   or, with "fail", hard errors. [8668be3]
193 ChangeLog (purely technical)
194 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
196 - We again allow Message-Id:s to start with a leading slash, as in
197   "/p/forge/site-support/10.../...". [143372a]
199 - We now support multiline values in make.rc: to do so, escape the
200   newlines with a backslash "\", e.g. [621cbed,9cf4e7b]
202     MAILSPOOL=`\
203        if [ -d /var/spool/mail ]; then \
204           echo /var/spool/mail;\
205        else \
206           echo /var/mail;\
207        fi`
209 - Lowered the memory pressure caused by malicious spam messages that
210   place hundreds of references into the References: header body.
211   And we don't use alloca(3) no more for such things, in order to lower
212   stack usage. [1c4b8c9,47a1a5c]
214 v14.8.3 ("Startled chicken"), 2015-07-05
215 ----------------------------------------
217 Credits go to Martin Neitzel!
219 NOTES, ChangeLog (packager-affine)
220 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
222 - Prefilling INCS and LIBS is finally honoured by the build system, just
223   as documented. [9a34822]
225 - In place of "packager-install" "doinstall" will also do.
227 - New `make.rc' option: WANT_ERRORS, by default enabled.
228   Will enable the new command `errors' @105 (#_105) and an error message
229   queue ring: error messages will no longer get lost but duplicated into
230   the queue, to be displayed in interactive mode via `errors'.  This is
231   a finite ring which rotates oldest messages if it full.
232   [topic/errors]
234 - S-nail no longer offers hooks for group identity switching: it no
235   longer makes sense to install it SETGID to a mail group (shall anyone
236   has done so). [ac42d24]
238 - New `make.rc' option: WANT_PRIVSEP, by default enabled.
239   The dotlock'ing has been completely rewritten (see `make.rc' for
240   a longer explanation of traditional Unix mailspool locking, please).
242   In order to be able to create lock files in *any* SETGID mailspool
243   directory in which user system mailboxes may reside S-nail now ships
244   with a privilege-separated mini dotlock program (source in
245   `privsep.c'), which will be installed in the new also LIBEXECDIR (as
246   YOUR_MUA_NAME-privsep) SETGID to the group given by the also new
247   PRIVSEP_GROUP (default "mail").
249   This dotlock program will be used whenever a mailbox has to be
250   dotlocked which is owned by group that is not the group of the user
251   who is running S-nail, assuming that the file in question resides in
252   a SETGID mailspool directory.
254   The new variable *dotlock-ignore-error* @294 (#_294) now controls
255   wether it is a failure if creation of a dotlock file is not possible.
256   This variable is by default enabled if WANT_PRIVSEP is false.
257   [topic/dotlock]
259 ChangeLog
260 ^^^^^^^^^
262 - Fix file locking, which was broken since v14.8. [7f8ebc0]
263   (Martin Neitzel)
265 - -e now works with given boxes; -e is mutual exclusive with -H and -L;
266   and then any of -e, -H and -L causes the mailbox opened in readonly
267   mode. [3bb05a2, 2cf15c1]
269 - In *debug* mode no process will be started for a set *smtp*, but
270   instead the message will be directly generated (on the error channel).
271   Also GSS-API authentication will no longer be performed even with
272   enabled debug, oops. [3333d71]
274 ChangeLog (purely technical)
275 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
277 - A readonly IMAP box is opened via EXAMINE not SELECT. [2d5259c]
279 - snprintf(3) and vsnprintf(3) are now required preconditions. [c58c7e9]
281 v14.8.2 ("Wandering albatross"), 2015-06-17
282 -------------------------------------------
284 Many thanks Bob Tennent, for reporting and testing!
286 NOTES, ChangeLog (packager-affine)
287 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
289 - Configuration will now find clock_gettime(2) in -lrt and
290   gettimeofday(2) as such on Linux. [47c9ea7,5e248d2,df7d77f]
291   (Bob Tennent)
293 - MANDIR now defaults to ${PREFIX}/share/man (not ${PREFIX}/man)
294   [6371740]
296 ChangeLog
297 ^^^^^^^^^
299 -  Added missing condition clause in `if' expression parsing
300    [74c7cac,5da6d4d]:
302     ?0[ +mbox]? if $du @@ hey
303     ?0[ +mbox]? endif
304     -->
305     ?0[ +mbox]? if $du @@ hey
306     `if' conditional: unrecognized condition -- near "du"
307        Expression: $du @@ hey
308        Left to parse: $du @@ hey
309     ?1[ +mbox]? endif
311 - Ooops, fix pipe-TYPE/SUBTYPE @403 with value "@" (a.k.a. treat as
312   plain text and display "as is"): i've broken that once i've introduced
313   the extended type markers for the `mimetype' command.  Must have been
314   a Freudian error, sorry! [ea655de]
316 - Fix a bug introduced in nail 9.29, 2001-12-10: a temporary buffer is
317   closed with fclose() even though it is a registered file that instead
318   needs to be closed via Fclose().  This effectively results in
319   a double-fclose(3) of the underlaying file descriptor once the
320   registered files are cleaned up next, which happens either after
321   signal interruption and, since [65e0510] as of 2015-05-21, whenever
322   the command loop ticks. [97fcb97]  (Bob Tennent)
324 v14.8.1 ("Tristan albatross"), 2015-06-11
325 -----------------------------------------
327 Kudos!
328 Ypnose, Tarqi Kazan, Dagobert Michelsen and OpenCSW.org, Gianluca
329 Ramunno, Bob Tennent.
331 We welcome Dagobert Michelsen in THANKS.
333 NOTES, ChangeLog (packager-affine)
334 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
336 $ In all the following noticable changes to the release candidate are
337 $ marked with a $ in the first column
339 - We have been ported to Sun Solaris!
340   Thanks to Dagobert Michelsen for giving me an account on OpenCSW.org!
342 - The build system will now really find strip(1). [54e91c4]
344 - WANT_TERMCAP fix: we simply passed tputs(3) a pointer to putchar(3)
345   though that may be a macro etc. [cc65bc3]
347 - The following variables can be used to overwrite utilities needed
348   during configuration and build:
350     MAKE=, STRIP=, awk=, cat=, chmod=, cp=, cmp=, cksum=, grep=, mkdir=,
351     mv=, tee=, rm=, sed=, tr=
353   Note that rm(1), sed(1) and tr(1) are needed before `make.rc' is read.
354   Fix: these will now also affect "make test".
356 - WANT_AUTOCC now no longer sets compiler flags as of experience, but
357   compiles a test program to actually detect wether the compiler will
358   swallow the flag.  This increases configuration time quite a bit.
359   Users who really did use "make devel" possibly want to use "make
360   CONFIG=DEVEL" followed by "make build" now.
361   Note we now also test for -fPIE as well as relro,now,noexecstack.
363 - WANT_SPAM_SPAMD is now decoupled from WANT_SOCKETS. [d247d86]
365 - The configuration now also detects any changes on PATH, C_INCLUDE_PATH
366   and LD_LIBRARY. [1038028]
368 ChangeLog
369 ^^^^^^^^^
371 - Fixed importing of SHELL/LISTER/PAGER variables from the program
372   environment. [940c7f1]  (Ypnose)
374 - Moved -X @64 command line option handling before attachment
375   evaluation, so that, e.g., `mimetype's registered via it will already
376   be seen when classifying attachments. [5d9742f]
378 - Honour *asksign* @274 again, even if *askatend* @270 or *bsdcompat* @281
379   are not set.  This also changes *askattach* @271 as we'll only ask for
380   addition of attachments if there are none yet. [e054d6a]  (Tarqi Kazan)
382 - Support OpenSSL 1.1.0 and above: it obsoletes the more-than-a-decade
383   old SSLv23_client_method() in favour of a new TLS_client_method()
384   (instead of using some "magical" constant like, say, "SSL_METHOD_ANY",
385   but who am i). [c35b567]
387 - Generic file (mailbox) load and save hooks have been introduced:
388   *file-hook-(load|save)-EXTENSION* @374,@375, e.g.:
390     set file-hook-load-xy='echo >&2 XY-LOAD; gzip -cd' \
391         file-hook-save-xy='echo >&2 XY-SAVE; gzip -c' \
392         record=+null-sent.xy
394   One could think about using all-encrypted mailboxes, or the like.
395   Note that before v15.0 these variables may not be changed while
396   a mailbox handled by these hooks is open. [b4c2c37]  (Tarqi Kazan)
398 - When DNS resolving fails we now print error messages.
399   And then, if it fails because of an unknown service (protocol), we
400   check for the protocol and retry shall we have a well-known port
401   number builtin (smtp, submission, smtps, pop3, pop3s, imap, imaps).
402   [5f52370, (3f189f9)]  It is not wrong to credit (Gianluca Ramunno)
404 - One may now force treatment of addresses as files with the new "./"
405   or "/" prefixes -- until now it wasn't possible to address files if
406   the addressee includes an at sign, now "./me@here.com" will do, just
407   as will "/me@here.com". [2cf5890,0da473f]  (Bob Tennent)
409 - Fix *record-resent* @329, which never made it to *record* @414 since
410   [a11935b], but instead save the message in a file named after the
411   addressee! [a82af9f]  (Bob Tennent)
413 - Fixed signal handler uninstallation in sopen() (DNS lookup and socket
414   creation): v14.8.0 could be forced in endless loop after failed DNS
415   lookups due to this. [3cca23b]
417 - Fixed possible double-free (causing a crash) after failed SSL
418   certificate verification (*ssl-verify*=strict etc.) with OpenSSL
419   versions that support SSL_CONF_CTX (1.0.2+). [c691726]
421 - Assorted changes:
423   . The builtin HTML filter will now silently discard carriage-return
424     characters (looks better in e.g. less(1)). [cf4d800]
425   . When reopening the same box we now recognize if changes had been
426     written, forcing a reread of the box in order to display the actual
427     real content. [7dfbd38,0835212,a15dfed]
428   . `netrc' output changed, so that the output could (in theory) be fed
429     back into S-nail again in order to gain the same settings. [a9a2722]
430   . *pop3-keepalive* @410 gained (@USER)?-HOST forms [69cae68]
431   . *imap-keepalive* @387 gained (@USER)?-HOST forms [9a8c929]
432   . Do not use the builtin random generator if we find a suitable one in
433     the host environment. [0e01aeb,6bcb430,fc846c6]  (Bob Tennent)
434   . The builtin HTML filter will now also expand entities in parameter
435     names. [8d16dc0]
436 $ . *crt* will now only be checked when attached to a terminal device;
437 $   and no*crt* will now be honoured. [2508c32]
439 ChangeLog (purely technical)
440 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
442 - Solaris port resulted in a lot of changesets for the build system.
443 - I didn't use git(1) rebasing and the [crawl] branch but only [master].
444   And see where that ended: S-nail would have 10000 fossil commits!
445 - Plugged some memory leaks.
447 v14.8.0 ("Albatros"), 2015-04-30
448 --------------------------------
450 Puuuh!
451 I'm glad and happy to announce "Albatros" after about seven months of
452 development.  Development that brought many new features, bugfixes,
453 technical overhauling and behaviour tweaking.  Shall you ever have been
454 interested in BSD Mail or its deriviatives you might want to give it
455 a try.
457 "Albatros" is indeed the first version of the codebase as such that
458 should allow IMAP->Maildir->MBOX->Maildir->IMAP message roundtripping
459 without causing possible message splitting due to faulty From_
460 detection / encoding.  It also generates compliant MIME parameters.
462 Note there are incompatible changes, documented below.  And it is also
463 advisable to try out existing configurations with enabled *debug* and/or
464 *verbose* (-d, -vv) in order to check for "obsoletion" warnings.
465 (Here "obsolete" would refer to v15, of course.)
467 Credits and Thanks go to Ypnose, Jérémie Courrèges-Anglas, Josef Jurek,
468 Gavin Troy, Rich Salz, Martin Brandenburg, Bob Tennent, Dominic Meskys
469 and Peter Bray.
471 We welcome Jérémie Courrèges-Anglas, Josef Jurek, Rich Salz,
472 Dominic Meskys, Peter Bray, Dirk-Wilhelm Peters and Martin Brandenburg
473 in THANKS.
474 Apologies to Dirk-Wilhelm Peters and Martin Brandenburg whom i had
475 forgotten to add to THANKS at first glance once i've added this file; it
476 was nothing but an oversight.
478 I also say «Thank you» to GitLab.com – i've mirrored the S-nail git(1)
479 repository (alongside others) to this free service.
481 Credits finally also have to go to Coverity.com [1] which helped to find
482 some bugs; the claim of a 0.00 defect density after a Friday 13th test
483 must have been an error from their side, though, as well as that the
484 page [1] still remains at a test with a defect density of 0.01, since
485 i've posted yet another run that must have ended with 0.00.  (Note the
486 codebase was tested without IMAP code, i.e. my _next_ developer branch.)
488   [1] https://scan.coverity.com/projects/444
490 NOTES, ChangeLog (packager-affine)
491 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
493 $ In all the following noticable changes to the release candidate are
494 $ marked with a $ in the first column
496 + Crawling along the path of CVE [topic/cve-2014-7844.2]: to enable MTA
497   arguments after -- the new *expandargv* @372 must be set.  More below.
499 + Even more crawling along the path of the CVE i decided to replace the
500   wordexp(3) based shell word expansion mechanism with an entirely new,
501   internally implemented restricted one, but complete mitigation will
502   take time.  This has consequences in respect to backslash escaping in
503   file names (shall you ever have used such a filename with S-nail and
504   its predecessors, of course, and only ...).
505   Please see [topic/fexpand.2] below.
507 + A new member for the *attrlist* @351 variable (for unsure spam status).
508   Since a user setting with a false length will be ignored yet causes an
509   error message this is a backward incompatible change. [topic/spam.2]
511 - New make.rc option: WANT_ALL_SSL_ALGORITHMS (enabled).
512   See make.rc and *smime-cipher-USER@host* @427 below. [topic/ssl.1]
514 - The make.rc option WANT_IPV6 is gone; we use the respective standard
515   library facilities automatically whenever possible. [999e79a]
517 - New make.rc option: WANT_TERMCAP (disabled).
518   See *term-ca-mode* @345 below.  [topic/termcap]
520 - The make.rc option WANT_SPAM has been dropped.  Instead we have (see
521   [topic/spam.2] below for more):
523   . WANT_SPAM_SPAMC (default off):
524     Rather identical to the former WANT_SPAM (interaction with spamc(1)
525     from spamassassin(1)), but internally improved.
526   . WANT_SPAM_SPAMD (default off):
527     Direct interaction with spamd(1) from spamassassin(1) via a local
528     unix(4) domain socket.
529   . WANT_SPAM_FILTER (default on):
530     Freely configurable hook programs, e.g., bogofilter(1).
532 - It turned out that the manual wasn't mandb(1) compatible. [f5ab838]
534 - New make.rc option: WANT_FILTER_HTML_TAGSOUP (enabled).
535   S-nail now ships with a very primitive HTML-to-text converter.
536   It'll be used for HTML parts automatically if no pipe handler is
537   installed (and the builtin mime.types haven't been changed).
538   This works because of the new TYPEMARKER extension to mime.types(5) as
539   documented for [topic/mime.types.2] below.
540   (It is quite experimental but i think it rocks except it can be fooled
541   since it doesn't know about double quoted strings, e.g., <a href=""
542   onmouseover='javascript:alert("> This is plain text you see, oops");'>.
543 $ Yet it is ment for displaying HTML mails, and it works really well.
544 $ It doesn't support non-standard type="quote" attributes nor even-more
545 $ non-standard CSS classes "gmail_quote" or whatever it's name was --
546 $ these are used in the wild to generate automatic mail quoting, which
547 $ has resulted in an immense amount of top-posting; but maybe there will
548 $ be a S-nail v14.8.1 which will implement those, to ease the pain.
549   [topic/html-tagsoup]
551 $- List output of `alias' @78, `ghost' @123 and `shortcut' @181
552 $ uses a new syntax that should (in theory) make it possible to feed
553 $ the output back into S-nail. [2913df3]
554 $ Ditto `set' @178 unless *bsdcompat* or *bsdset* are set. [373cc8a]
556 $- *keep* @308 will also affect secondary mailboxes (because *emptybox*
557 $ has been obsoleted, see below). [5fa5f8b]
559 $- New make.rc option: WANT_FORCED_STACKPROT (enabled with WANT_DEVEL or
560 $ WANT_DEBUG).
561 $ In conjunction with WANT_AUTOCC this will trigger stack protectors
562 $ if the detected compiler does support them.  (Before they were only
563 $ enabled if WANT_DEBUG was set, automatically.)
565 + v14.8 is the last release with IMAP support, which has been removed
566   from the developer's [crawl] branch for quite some time already.
567   He really hopes he can affort to readd support sometime after v15.0.
569 ChangeLog
570 ^^^^^^^^^
572 - S-nail now knows about named booleans (e.g., `localopts' @133 or
573   interactive approval prompts can now be given any of 1/yes/true/on or
574   0/no/false/off, case-insensitively; note this is true for the make.rc
575 $ system, too) and so-called "quad" options (either normal boolean or
576 $ "ask-BOOLEAN", which, in interactive context, will be prompted with
577 $ default values; the default value is chosen in non-interactive mode).
578 $ (on/off support not in the RC.)
579   [topic/xify]
581 - The `if' @128 combo:
583   . gained <, >, <= and >= tests;
584     ==, !=, <, <=, >=, > will try to convert their arguments to numbers
585     and perform their test numerically, if possible, [143d409]
586   . `if' supports boolean (as above) arguments, [topic/ifpimp]
587   . `if 1'+ return value fixed, [topic/ifpimp]
588   . `if'+: on syntax error, NOOP anything 'till `endif', [topic/ifpimp]
589   . `if'+ now support bracket groups, AND-OR lists and unary ! (not),
590     note that the separating spaces are required: [topic/ifpimp]
592       if [ [ true ] && [ [ $debug ] || [ $verbose ] ] ]
593         echo Noisy, noisy
594       endif
595       if true && $debug || $verbose
596         echo Left associativity, as is known from the shell
597       endif
598       if ! ! true && ! [ ! $debug && ! $verbose ]
599         echo Unary operator support
600       endif
602   . `if'+ now support new case-insensitive (ASCII) substring operators
603     =@ and !@: [topic/ifpimp]
605       if $features =@ "regex"
606         if $TERM =~ "^xterm.*"
607           echo ..in an X terminal
608         endif
609       endif
611 $ . `if'+: the three argument forms can now be given variables also on
612 $   the right hand side: [topic/ifpimp]
614 $     set xtest='^xterm.*'
615 $     if $TERM =~ $xtest
616 $       echo Variables as right hand value
617 $     endif
619 - `unalias' @198 learned that * means "all aliases".
620   Fixed: faulty list-head relinking caused "dead" aliases (since ever)
621   [topic/names]
623 - `unshortcut' @219 learned that * means "all shortcuts".
624   `shortcut' @181 in turn can now define multiple shortcuts in one go
625   [topic/names]:
627     ?0[ /var/mail/steffen]? sho you 'any one' me 'no "one"'
628     ?0[ /var/mail/steffen]? sho
629     shortcut me "no \"one\""
630     shortcut you "any one"
631     ?0[ /var/mail/steffen]? unsho*
632     ?0[ /var/mail/steffen]? sho
633     ?0[ /var/mail/steffen]?
635 - S-nail learned how to deal with mailing-lists in respect to
636   Mail-Followup-To headers etc. (manual: "Mailing lists" @21):
638   . new commands `(un)?ml(list|subscribe)' to let S-nail decide which
639     addresses are mailing-lists, [topic/names]
640   . *headline* learned %T format to display message recipient flags:
641     "L" for a mailing-list, "S" for a subscribed one, [topic/names]
642   . new variable *followup-to-honour*, [topic/mft]
643   . new variable *reply-to-honour*, [topic/mft]
644   . new command `Lreply', forcing a list-only `reply' if possible.
645     When `Lreply'ing to messages which seem to originate from
646     mailing-lists (contain a "List-Post:" header), then S-nail will
647     treat the list address as a known mailing list (as via `mlist').
649     (It is advisable to try out several different combinations of non-/
650     subscribed mailing-lists in conjunction with `reply', `Reply' and
651     `Lreply' with *debug* set in order to get used to how S-nail will
652     modify the address lists; the results should be quite logical
653     though.) [topic/mft]
654   . For convenience `reply' and `Lreply' can now be used to reply to
655     multiple messages in one go (each message will still be handled by
656     itself, we simply start over internally). [topic/mft]
658 - `unset' @217 no longer "fails" for unset variables, but only prints
659   a message in *debug* or *verbose* mode.  This changes traditional,
660   decade-old behaviour, but shells don't even say something in (*debug*
661   or) *verbose* mode, and it really simplifies things. [topic/okeys-attr]
663 - SSL/TLS changes: [topic/ssl.1]
665   . new variables: *ssl-cert-HOST* @451, *ssl-key-HOST* @456,
666     *ssl-method-HOST* @457, *ssl-verify-HOST* @461,
667   . *ssl-v2-allow* has been dropped,
668   . *ssl-verify* @461 and *smime-cipher-USER@HOST* @427 use
669     case-insensitive matching for value checks,
670   . new variable-chain: *ssl-protocol* @458 (the introduction of which
671     obsoletes *ssl-method* @457, see below),
672   . new variants of *ssl-cipher-list* @452: *ssl-cipher-list-USER@HOST*,
673     *ssl-cipher-list-HOST*,
674   . new variable: *ssl-config-file* @453,
675   . *smime-cipher-USER@HOST* @427 dropped builtin support for the
676     obsolete RC2-40 and RC2-64 ciphers -- use the make.rc option
677     WANT_ALL_SSL_ALGORITHMS to readd support,
678   . with SSL_CONF_CTX support (OpenSSL v1.0.2+) the values of the
679     following variables (and variants) will be parsed by OpenSSL instead
680     of S-nail, offering more user and packager flexibility:
681     *ssl-cert* @451, *ssl-cipher-list* @452, *ssl-key* @456,
682     *ssl-protocol* @458.
684     E.g., shall a new OpenSSL ship with TLS v1.3 S-nail doesn't need to
685     be adjusted in order to support TLS v1.3, all there is to do is that
686     the user has to adjust her *ssl-protocol* setting.
687     This is at least the theory. :)
688     And maybe OpenSSL (will) offer(s) symbolic constants like "NEWEST"
689     or "SAFEST".
691 - Folder hooks have been extended:
693   . if there was no *folder-hook-FULLNAME* @376 we'll try
694     *folder-hook-+NAME* if the mailbox NAME resides in *folder*, e.g.,
695     the author has "folder-hook-+sent=MACRO" and all his *record*
696     variables are "record=+sent", therefore MACRO can be shared in
697     between all accounts with a single hook definition. [a5a4d89]
698   . `localopts' @133 can now be used in folder hooks: the covered
699     settings will be reverted once the folder is left again.
700 $   (I know for sure someone asked for this long ago, directly after
701 $   `localopts' came up first, but i couldn't find the corresponding
702 $   message.  Sorry!) [2c67091]
704 - More security control à la CVE 2014-7844, possibly for the first time
705   enabling safe usage of S-nail via CGI: [topic/cve-2014-7844.2]
707   . fixed *sendmail-arguments* @420 parsing:
708     *sendmail-arguments*='-F "Dubi Da"' will now result in <"-F" "Dubi
709     Da"> not <"-F" ""Dubi Da"">,
710   . new command line argument "-." @67 forcefully terminates options
711     and enters send mode.  I.e., using this option avoids possible
712     misinterpretation of the following arguments.
714     This operation is usually reserved for --, but since S-nail passes
715     anything after -- to the MTA (but read on) i had to invent something
716 $   else.  Also, -. forcefully enters send mode, which -- couldn't have
717 $   been overloaded to do.
718   . New variable: *expandargv* @372: in equal spirit to *expandaddr* @371
719     this one is required in order to pass arguments after -- to the MTA.
720     If set to "fail" existence of such arguments is a hard error,
721     "restrict" likewise except in interactive mode or in conjunction
722     with the -~ or -# options.
723   . *expandaddr* @371: new special value "fail" causes presence of
724     extended recipient addresses to be treated as a hard error.
725 $   In fact this is now interpreted as a comma separated list and may
726 $   also include the string "noalias", disallowing non-network-addresses
727 $   in the remaining (non-"extended") recipient addresses -- note this
728 $   applies to system global aliases only, not to those of `alias'
729 $   (except for their content, of course); "noalias" is a hard error in
730 $   combination with "fail".
732 - `unaccount' @197 and `undefine' @201 learned that * means "all
733   accounts" and "all macros", respectively. [4c09114]
735 - Spam handling has been rewritten completely, revealing a very old
736   misbehaviour in nail's subprocess handling (malloc in signal handler).
737   Please reread the manual section "Handling spam" @37 for more.
738   The motivation was also that bogofilter(1), sylfilter(1) etc. can
739   export their databases, so should the author ever find time to
740   implement spam handling in C like his predecessor it will be possible
741   to continue to use those databases: [topic/spam.2]
743   . *headline* @380 format %$ has been fixed,
744   . when working on multiple messages the operation is cancelled if an
745     error occurs,
746   . new variables: *spam-interface* @436 chooses the, well, ...
747     This one has extensive documentation.  Plus the interface dependent
748     *spamc-command* @438, *spamc-arguments* @439, *spamc-user* @440,
749     *spamd-socket* @441, *spamd-user* @442,
750     *spamfilter-ham* @443, *spamfilter-noham* @444,
751     *spamfilter-nospam* @445, *spamfilter-rate* @446,
752     *spamfilter-spam* @447 and *spamfilter-rate-spamscore* @448.
753   . The *attrlist* @351 variable gained a new slot for an unsure-spam
754     status (default character is ~).
755     Messages with that flag can be specified via the :S colon modifier.
757 - Fix: even though -# @66 implies *sendwait* @335 a user should have the
758   option to turn *sendwait* off again. [4274bed]
760 - Completely reworked mime.types(5) handling, note the backward
761   incompatible drop of `mimetypes': [topic/mime.types.2]
763   . dropped the `mimetypes' command,
764   . new commands: `mimetype' @138 and `unmimetype' @209,
765   . *encoding* @369 is now parsed case-insensitively,
766   . *mime-counter-evidence* @390 gained new bit 3 to indicate the desire
767     to forcefully overwrite MIME types if we think we know it better,
768   . *mimetypes-load-control* @391 gained an extension that can be used to
769     load more and specific files, which in addition may make use of
770     a new non-portable S-nail-specific TYPEMARKER extension.  The manual
771     section "The mime.types files" @32 has been rewritten accordingly.
772     (In short: mime.types(5) lines can be prefixed by @, @h@ or @H@, for
773     plain text, builtin HTML filter (plain text fallback), ditto
774     (without fallback).)
775 $ . The builtin MIME types now make a lot of use of the @ and @h@
776 $   TYPEMARKER extensions, so that you possibly can get rid of a lot of
777 $   pipe-TYPE/SUBTYPE=@ plain-text type hooks, shall you have used them.
779 - Support for RFC 2231 has been added.  This means that S-nail generates
780   truly MIME compliant messages and no longer requires help from other
781   MUAs!  In fact MIME parameter handling has been rewritten completely.
782   [topic/rfc2231]
784 - On the long run shell word expansion (via wordexp(3)) will be replaced
785   by a new, restricted (and thus (hopefully) safer), internally
786   implemented path expansion mechanism that only supports ~/ -> HOMEDIR
787   and $SHELLVAR / ${SHELLVAR}.
788   Since the original expansion is *so* hardwired that'll take time, for
789   now it is used for attachments only, but here all through the way.
791   But where it is used already it has consequences regarding backslash
792   escaping; to improve user experience a bit `~@' @239 will display the
793   escaped filename so that users only have to hit ENTER to accept paths:
794   e.g., "diet\ is \curd.txt" will show up as "diet\\ is \\curd.txt".
795   And, e.g., the test script does the following for RFC 2231 (excerpt):
797     MAILRC=/dev/null "${SNAIL}" ${ARGS} -Snodot \
798       -a "ma'ger.txt" -a "mä'ger.txt" \
799       -a 'diet\\\ is\ \\curd.txt' -a diet \"is\" curd.txt \
800                                          ^      ^ NOTE: 0x00A0, NBSP
801       -a ✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆✆.txt
803   The introduction of the manual section "COMMANDS" @5 has been updated
804   accordingly.  Also see -a @39.  [topic/fexpand.2]
806 - Assorted changes:
808   . Multiple crash-causing bugs regarding `source' @185, also if used
809     via `~:source', have been fixed. [aafb688,6979c73,4c6dfc2]
810   . The NAILRC environment variable is no longer supported. [104c254]
811   . The *Replyall* variable has been dropped as it was only an alias
812     for the POSIX standard *flipr* @296 variable. [topic/mft]
813   . New variables: *version*, *version-(major|minor|update)*,
814     *features*. [topic/okeys-attr]
815   . `varedit' @224 can be used to create variables. [topic/okeys-attr]
816   . New variable: *charset-unknown-8bit* @357. [9b672f6]
817   . *smtp-auth* @434 now defaults to "plain" (if *v15-compat* is set).
818     (Josef Jurek, Gavin Troy) [dcbb31a]
819   . All obsoleted: *autothread*, `thread' and `unthread'.
820     Use *autosort*=thread, `sort thread' etc. instead. [ef16f43]
821   . *showlast* @336 should have gained meaning. [4213d52]  (Gavin Troy)
822   . If the -r @57 option is given a full name specification (rather
823     than only an address), pass the MTA the respective address parts
824     via -F and -f. [dd90c14]
825 $   Also try to pass -F _and_ -f if an empty argument was given to -r
826 $   but *from* @378 (or, say, "From:") includes a full name. [5f68921]
827   . New variable: *term-ca-mode* @345 (for WANT_TERMCAP).  In
828     interactive mode S-nail can now be forced to use ti and te termcap
829     entries; in conjunction with a PAGER that does too ... [topic/termcap]
830   . `ghost' @123 gained a new mode and tweaks (see manual). [8a49b12]
831   . -r @57 option: fixed -h output and manual. [9a1a303]
832     (Martin Brandenburg)
833   . With *debug* or 2x *verbose* command lines (including those read
834     from files) are now traced. [06042c4]  (Bob Tennent)
835   . NAIL_TMPDIR (new) and TMPDIR environment variables are now
836     (guaranteed to be) set in pipe hooks. [a1cfb02]
837   . "Subject:" Re: trimming: MIME decoding is now performed. [ede7c7d]
838   . New variants of *pop3-bulk-load* @320: *-[USER@]HOST*. [5f5ae10]
839   . *crt*=0 @366 now really works. [22f1477]
840   . Maildir code now uses string relaxation which drastically reduced
841     memory usage for large mailboxes. [d1c945f]
842     And for the first time it performs real memory cleanup. [e549110]
843   . Improved error message on MTA exec failure.  (Dominic Meskys)
844   . Fix: "setenv noVAR" would have set noVAR. [3c1f886]
845   . When `setenv' is used to set any of HOME, USER, TMPDIR it'll be
846     reflected by our internal variables.  (Still hacky as special code
847     is needed to do so; also "set HOME=x" shadows HOME for "varshow
848     HOME" instead of being rejected.  Future cleanup work.) [3f03b80]
849   . Colon modifiers can now be joined, as in "f :uas". [8b6c259]
850 $ . Maildir code did faulty From_ line detection, resulting in any
851 $   non-quoted "From " line to start a new message (e.g., when doing
852 $   things like "copy * MAILDIR" we could have f...ed up completely).
853 $   Seems to have been added with Heirloom mailx 11.6 ([faf4b65],
854 $   2004-09-07).  Neither goes credit to Jacob Gelbman nor to Robin
855 $   Stjerndorff for messages to nail-devel@ on 2015-01-21 and
856 $   2015-02-20, respectively.  :-)) [ae539c9]
857 $ . *emptybox* has been obsoleted.  *keep* @308 will also affect
858 $   secondary mailboxes, and then both only deal with local regular
859 $   MBOXes anyway, not to e.g., maildir files nor IMAP boxes. [d747c0a]
860 $ . `unghost' @207 learned that * has to drop all ghosts. [34a92a5]
861 $ . NAIL_TMPDIR (new) and TMPDIR environment variables are now
862 $   (guaranteed to be) set for *agent-shell-lookup* @350. [5c3d7b5]
863 $ . Things like "copy * MAILDIR" from within an IMAP (or POP3?) mailbox
864 $   to a Maildir mailbox should now work again. [d747c0a]
865 $ . IMAP code did faulty From_ line detection, resulting in some
866 $   non-quoted "From " line to start a new message (e.g., when doing
867 $   things like "copy * MAILDIR" we could have f...ed up completely).
868 $   Present in Heirloom mailx since ever ([^b4ad9f2]). [66e3c93]
869 $ . New variable: *mbox-rfc4155* @312: because of all the bugs in From_
870 $   quoting etc., err, no.  "Albatros" will last.  I've just touched
871 $   a lot of stuff regarding MBOX writing: From_ quoting (which may
872 $   happen whenever we save already existent data in a MBOX, shall
873 $   the original generator not have taken appropriate steps to ensure
874 $   "false" From_ lines can't happen (S-nail does)) is now definitely
875 $   POSIX compliant, meaning that we may quote much too much lines.
876 $   So set *mbox-rfc4155* and we generate RFC 4155 compliant MBOX files,
877 $   possibly leaving behind backward POSIX-only software. [70ba3ef]
878 $ . New command line option: "-X cmd" @64 will execute "cmd" right
879 $   before normal operation starts.  The only option to execute commands
880 $   in non-interactive mode when reading of resource files has been
881 $   actively suppressed.  This is an experimental feature. [d202869]
883 ChangeLog (purely technical)
884 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
886 . Improved output flushing, avoidance of printing of useless
887   output (especially smoothens *editalong*). [topic/stdout-fflush]
888 . String relaxation is now everywhere (but IMAP), the builtin buffer
889   sizes were reduced to 1/3.
890 . Again a manual review.  The manual now supports mdocmx(7).
891 . Using builtin ARC4 pseudo-random for random generation.
892 . Better signal handling here and there.
893 . Fixed most "unpluggable memory leaks" by plugging them via chains of
894   signal handlers and longjmps.  Terrible.  But no more leaks.
895 . A lot of this and that.  (Really.)
896 $. Slightly more tolerance for faulty Base64 encoding in message text
897 $ parts.  No real healing possible today, but requires v15.0 environment.
898 $ This, however, only affects invalid data that, e.g., OpenSSL doesn't
899 $ even give any output for! [54137fd,4d59cca]
901 I didn't make it to improved message selection.
902 And i also can't seem to find the necessary peace of mind to do a real
903 review with this codebase, it's always that i start off doing something
904 non-reviewish; but i'll see the day (what i hope).
906 v14.7.11, 2015-01-04
907 --------------------
909 A cumulative bugfix update release.
911 Credits to Marius Nestor, Tim and Johannes Löthberg.
912 Apologies to Ypnose, Mantas Mikulėnas for not really listening.  Thanks!
913 Special apologies to Mantas: i forgot to credit him in commit [fda7acd].
914 We welcome Marius Nestor and Tim in THANKS.
916 NOTES, ChangeLog (packager-affine)
917 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
919 - Our nail.rc now sets *keepsave* by default. [38fdacb]
921 ChangeLog
922 ^^^^^^^^^
924 - ~t will no longer loop infinitely.
925   Bug introduced nail "[9.27] released 5/13/01". [a105121]
927 - We now support -h and --help command line options. [7409040]
928   (Marius Nestor)
930 - Fix autosort crash in non-thread mode.
931   Bug introduced together with threaded display in
932   nail "[11.2] released 8/15/04". [4064771]
934 - Two fixes for IMAP credential lookup without a set *v15-compat*:
935   1. Faulty password reuse. [fda7acd]
936   2. Missing duplication of a string could crash S-nail. [21c05f8]
937   3. The latter was not detected during my (anyway too shallow) testing
938      because a long time back i didn't implement memory trashing for our
939      HAVE_DEBUG memory wrapper: caught up. [6ef2c13]
940   (Tim, Ypnose, Mantas Mikulėnas)
942 v14.7.10, 2014-12-18
943 --------------------
945 A bugfix release of v14.7.9 which fixes `ghost' processing
946 and reenables further command line arguments of ghosts, as in
948   ? gh ll !ls -Flar
949   ? ll | grep nail
951 In v14.7.9 the " | grep nail" part would not be recognized since
952 a terminating NUL character would be placed before it (which in
953 the C programming language means "end of string").
954 It is a one line patch, commit [f86f7aa].
956 v14.7.9, 2014-12-17
957 -------------------
959 This is a subminor release to address CVEs 2004-2771 and 2014-7844 [1].
961 These CVEs address decade old documented behaviour that was supposed to
962 be classifieable under "feature" rather than "bug": it is possible to
963 use file and pipe addresses, as in "./out.mbox" or "|cat > out.mbox" and
964 have the mail delivered accordingly.
965 They enforce a new option *expandaddr*, unset by default, which
966 specifies wether such special addresses shall be supported or not.
968 Thanks to Jürgen Daubert and Peter Hofmann.
970   [1] http://seclists.org/oss-sec/2014/q4/1066
972 ChangeLog
973 ^^^^^^^^^
975 - In -v / *verbose* mode SSL/TLS certificate date and time information
976   will be printed; until now we only supported UTC times which could
977   result in false messages stating that the datetime is bogus. [16ef155]
979 - *netrc-lookup* could have matched ambiguous entries. [debbf98]
981 - *sendmail-arguments* works without "allocating" more destination space
982   by adding space characters to the string. [1c7daaf]
984 - Always terminate MTA option processing with "--".
985   Part of addressing the CVEs as above: prevent system-wide aliases that
986   start with a hyphen to be interpreted as arguments to the MTA. [597249b]
988 - New value: *expandaddr*, as above.
989   Extending the CVE S-nail's *expandaddr* can be set to the value
990   "restrict" in which case even a set *expandaddr* doesn't enable file
991   and pipe addresses in non-interactive mode unless -~ or -# command
992   line options were given. [ba8c596]
994 - fio.c:_globname(): use WRDE_NOCMD if available.
995   Part of addressing the CVEs as above: prevent command substitutions
996   when expand() strings (mailbox names). [7c7134b]
998 - Drop the "line" statistics counter that could be seen when `copy'ing
999   or `save'ing messages, only keep the "byte" counter.  The former was
1000   a lie since it counted the lines of the source- rather than of the
1001   destination message.  Bug introduced on 2007-07-16 (in [670ea1c]).
1002   We'll reintroduce correct statistics once we can generate them.
1003   Could crash S-nail because it assumed false (readonly) buffer sizes.
1005   I give the credit to Peter Hofmann since i think this is why he
1006   insisted on very long, soft-newline continued quoted-printable lines
1007   back in the day.  Wasn't seen since the stdio buffer sizes on
1008   practically all operating systems are pretty large, and the access in
1009   the buffers was read-only (so no canary cheep). [effb676]
1011 - Until now blocks inside of `if' etc. were evaluated (as noops) even if
1012   the conditional block was as such a noop.  Therefore non-existing
1013   commands etc. would have been recognized as errors.  From now on this
1014   is no longer true. [c41d564, dc15be6]
1016 - `ghost's can now defined without quoting. [f183818] E.g.:
1018     -? ghost ls '!ls -latro'
1019     +? ghost ls !ls -Flatr
1021 v14.7.8, 2014-09-29
1022 -------------------
1024 I would like to give prominence to Gaetan Bisson.
1026 - Fix: "make test" works when no "s-nail" binary is produced, as via
1027   "make SID= NAIL=mail all".  (Gaetan Bisson) [d704599]
1029 - Fix: on NetBSD and FreeBSD snprintf(3) follows POSIX and fails to work
1030   if the "size_t n" argument is larger than INT_MAX.  Linux systems
1031   don't have this problem (presumably the function fails if buffer runs
1032   out, but who knows, this is GNU software ;), and OpenBSD reduces any
1033   "n" >INT_MAX to INT_MAX.
1034   But anyhow, what S-nail did is not standard conforming, and since this
1035   version is hopefully used for many months i think this -- actually
1036   a bug -- is worth fixing with a subminor release. [3b19639, cb674bd]
1038 v14.7.7, 2014-09-27
1039 -------------------
1041 Thanks to Jan Chaloupka, Frantisek Holop, Matthias Kilian and
1042 Peter Hofmann.  We welcome Frantisek, Matthias and Peter in THANKS.
1044 NOTES, ChangeLog (packager-affine)
1045 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1047 - 1. No need to change anything.
1049   2.1. The build system has been reworked a bit, `conf.rc' has been
1050        renamed to `make.rc'.
1051   2.2. It is now possible to say 1/yes/true 0/no/false,
1052        case-insensitive, e.g., "WANT_ICONV=yes".
1053   2.3. Some options can be "require"d: a failure to fulfill the request
1054        causes the configuration step to fail, e.g.,
1056         $ make WANT_ICONV=require WANT_SMTP=require WANT_SSL=require all
1058        Should fail unless all of iconv(3), BSD sockets and OpenSSL
1059        are available.
1060   2.4. This can be improved.  (E.g., there should be warnings if an
1061        option is required that doesn't support this mode.  Or -- all
1062        options should be requireable.  Hm.)
1063   [topic/mandconf]
1065 - The build system should now correctly auto-detect $MAILSPOOL and
1066   $SENDMAIL!?! [c1a51bb]
1068   P.S.: why are you guys setting those explicitly?
1069   It is a BUG if that doesn't work automatically!
1071   P.P.S.: Packager heroes! Packager heroes!! Packager heroes!!!
1073   P.P.P.S.: .. and a nice weekend ;)
1075 - "make test" will now regulary test S/MIME when available.
1076   (A few tests have been added, to test the QP issue and to test the RFC
1077   2047 MIME rewrite; which is still intermediate though.)
1079 - 2014-09-27: add-on:
1080   you may see more warnings for format strings which use the
1081   "size_t" integer type, and in the future even more of these will
1082   happen -- please read `INSTALL' again for more on that, but be
1083   ensured that we still compile-time-assert that the format
1084   strings fits the type size.  (Enable ISO C99 mode for your
1085   compiler will cause any warnings to vanish.)
1087 ChangeLog
1088 ^^^^^^^^^
1090 - FIXES: Maildir folders will now display correct content even after
1091   `newmail'.  (Matthias Kilian; Frantisek Holop for nudging!) [158cfb6]
1093   Also *newmail* was somewhat broken since introduction of `File'
1094   command (missed updating a function argument back then). [58017a8]
1096   And unfortunately the readonly state of a folder could be forgotten
1097   after `newmail', too. [0cd5c9e, 0679ee4]
1099 - *quote-fold*: fix faulty line length calculation when a line started
1100   with a lot of leading whitespace. [731b8c9]
1102 - Fix: calculation of required memory for quoted-printable encoding was
1103   faulty for very long input that forces soft newline insertions.
1104   (Peter Hofmann) [c299c45, b043cfc, d105d80]
1106 - `headers' was falsely documented. (Jan Chaloupka) [ee76a42]
1108 - Complete rewrite of RFC 2047 header encoding.
1109   (Credit to Peter Hofmann because he peeked shitty MIME handling)
1110   [0add96e]
1112   Remark:
1113   S-nail doesn't yet support RFC 2231 and thus our RFC 2047 support is
1114   incomplete; also stateful character encodings, like ISO-2022-JP, are
1115   still not supported and thus we're in fact non-compliant.
1116   The same that it ever was.
1117   Well, we're not alone, and e.g. mutt(1) offers
1118   a "rfc2047_parameters=yes" option to deal..., also with us.
1119   I really hate to say that.
1120   But of course we all know that the mail standards are inherently
1121   braindead anyway, right?  O-ho, yes, they are like that.
1122   I hope S-nail isn't part of the problem no more in 2016.
1124 - Oh, the [topic/retrim] in v14.7.6 actually missed a single occurance
1125   of fixed Re: checking! [ed1c865]
1127 - Allow $USER to be set to the empty string and no longer abort(3) if
1128   the user is not known, but instead exit(3) with value 67 (BSD
1129   EX_NOUSER constant from /usr/include/sysexits.h).
1131     $ USER= LC_ALL=C s-nail ...
1133   [a846fdb]
1135 v14.7.6, 2014-08-15
1136 -------------------
1138 Thanks to Georg Schlisio.
1140 Several bugfixes: it's definitely more than enough now, v14.7.8 in mid
1141 2015 will have to and will definetely ship with a test series.
1143 NOTES, ChangeLog (packager-affine)
1144 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1146 - The global default nail.rc file now sets *sendcharsets* to
1147   'utf-8,iso-8859-1', i.e., the order has been reversed.
1148   (Georg Schlisio)
1150   Also *bsdflags* is no longer set by default. [e39679b]
1152 ChangeLog
1153 ^^^^^^^^^
1155 - Fix: in some configurations a `resend' message would end up with two
1156   'Resend-Date:', instead of one such and a 'Resend-Message-Id:' field.
1157   [21b9218]
1159 - The internal exit status of a `mail' command will now be 0 upon
1160   success and 1 on failure, not vice versa. [1112375]
1162 - FIX: dependend on the set of retained / ignored etc. headers a MIME
1163   part with a *pipe-CONTENT/SUBTYPE* set to the special '@' plain-text
1164   command would try to execute a command equal to the name of the last
1165   header of the MIME part, most often 'Content-Disposition:'.
1166   [dee1fed,686a383]
1168 - Detected that the `fwd' / `forward' command(s) used the false (imho)
1169   mode to strip the address from the command line, now it's possible to:
1171     ? fwd MSG-SPEC "my friend <his@addr>"
1172   [1c4e164]
1174 - New variable *reply-strings*.  It's more unlikely now to end up with
1175   threads which read 'Re: Aw: Re: Aw:' etc. [topic/retrim]
1177 - Because of user inconvenience, introduce a temporary hack not to mince
1178   user input lines in history entries, even if this means that each and
1179   every line is first duplicated before it is used.  So now the `fwd'
1180   command as above will enter history in the given form. [f1ded4c]
1182 ChangeLog (purely technical)
1183 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1185 - Fixed one missing IMAP / IMAP-cache string relaxation restore.  (In
1186   about six weeks or so this condition hit me once). [66ef04f]
1188 P.S.: I still see an occasional IMAP-cache crash that occasionally
1189   happens after several connects and diconnects without intervening
1190   folder changes; after being bitten once by that even after commit
1191   [cf7f63d] it seems this is a deeper structural problem, but i'll try
1192   to track that down for v14.8.
1194 v14.7.5, 2014-08-01
1195 -------------------
1197 Jan Chaloupka (jchaloup AT redhat DOT com) reported on nail-devel@ that
1198 Heirloom mailx can be crashed by setting *smtp* in combination with with
1199 *from* effectively set to a NULL string.  I first was optimistic, but it
1200 turns out S-nail can, too.
1202 v14.7.4, 2014-07-15
1203 -------------------
1205 Fixes maildir code which was broken in May (too).
1206 Readds auto-detection of compressed boxes (i.e., if `$ Fi mybox' is
1207 executed and `mybox' doesn't exist, but `mybox.bz2' does, then the name
1208 is automatically expanded and `mybox.bz2' is used instead).
1209 Sorry for the inconvience.
1211 v14.7.3, 2014-07-14
1212 -------------------
1214 Thanks to Mantas Mikulėnas (grawity AT gmail DOT com).
1216 This is a bugfix release which fixes a regression in the handling of
1217 user credentials when *v15-compat* is not set, introduced in v14.7.1,
1218 quoting Mantas:
1220   In other words, $folder *requires* the @ to be percent-encoded, but
1221   $password requires the *opposite*.
1223 And that is not valid when *v15-compat* is not set.
1225 v14.7.2, 2014-07-12
1226 -------------------
1228 Thank you: Gavin Troy, Bob Tennent (rdt AT cs DOT queensu DOT ca),
1229 Tarqi Kazan.
1231 NOTES:
1232 ^^^^^^
1234 v14.7.2 brings incompatible credential lookup changes when *v15-compat*
1235 is set; the lookup order now is:
1237 - *user-HOST*, *user*, [.netrc] ...
1239 - *password-USER@HOST*, *password-HOST*, *password*, [.netrc] ..
1241 Changelog in reverse order, oldest first.
1243 ChangeLog (packager-affine)
1244 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
1246 - New configuration option WANT_AGENT to support *agent-shell-lookup*
1247   (, -HOST, -USER@HOST) lookups of potentially encrypted password
1248   storage (inspired by Gavin Troy) [b2d41d3,516a7f0]
1250 - MAILSPOOL is now automatically set to /var/spool/mail if that
1251   directory exists, only otherwise we use /var/mail [4a83018]
1253 - WANT_GSSAPI is again enabled by default - Tarqi Kazan has correctly
1254   pointed out that the system environment at compilation time is likely
1255   to reflect the politics and/or preferred configuration of packagers,
1256   and self-compilers have always the chance to configure themselves
1257   (Tarqi Kazan) [398eb29]
1259 ChangeLog
1260 ^^^^^^^^^
1262 - `un{,save,fwd}{ignore,retain}': let '*' mean 'all fields' [a1f1da9]
1264 - Bugfix: `setenv' takes 1-1000 arguments, not exactly 2 [daf2ea8]
1266 - New command: `varedit' edits the value of an existing variable in
1267   $EDITOR [93070d2]
1269 - New commands: `File' (and `Folder') explicitly open a mailbox in
1270   readonly mode, thus finally offering the possibility to avoid flag
1271   updates etc. whenever so desired [b1f5f2d]
1273 - Bugfix: since May the header display would display tabulators in an
1274   UTF-8 environment as replacement characters [870b314]
1276 - *mime-counter-evidence* now is a valued option.  Set bit two (value
1277   two) and the detected real MIME type is carried along with the MIME
1278   part so that it is used instead of `application/octet-stream' to
1279   lookup possibly registered *pipe-CONTENT/SUBCONTENT* handlers.
1280   (Bob Tennent) [81473f8]
1282   Also pipe handlers will now be passed several MIME informations via
1283   environment variables, please see the manual for more.
1284   (inspired by Bob Tennent)
1286 - Resource file loading now prints a diagnostic when loading was stopped
1287   due to a processing error.  This behaviour is also required by POSIX.
1288   (Bob Tennent) [fd42684]
1290 - Incompatible changes in credential handling, as above.
1291   [25d7735,3cdb6a3]
1293 - *netrc-lookup* is now a real chain and has -HOST and -USER@HOST
1294   variants (though the latter only for password lookups) [59fc226]
1296 - .netrc machine names are now lowercased before use [28c6fee]
1298 - The manual has seen some reorderings, a TOC will be shown if you
1299   '-dWANT_TOC=1' when using *roff(1) (as has been done for the online
1300   manual)
1302 - There is a new file `THANKS' [6b5cb3e]
1304 ChangeLog (purely technical)
1305 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1307 - IMAP and IMAP cache now use string relaxation which *drastically*
1308   reduces memory usage on large mailboxes [e5598ce]
1310 - Fixed compilation on old OpenBSD installations without wordexp(3) as
1311   well as with GSS-API and WANT_AMALGAMATION and now using #pragma's to
1312   get rid of some warnings [topic/ccstuff]
1314 v14.7.1, 2014-06-24
1315 -------------------
1317 Thanks to Georg Schlisio (g DOT schlisio AT dukun DOT de),
1318 Wiesław Magusiak (wiemag AT poczta DOT onet DOT pl), Tarqi Kazan and
1319 Karol Blazewicz.
1321 Very special thanks: Gavin ".. .. Speeding kills. .." Troy from Ireland
1322 and Ypnose "Gloria?? C'est une mouton!" from France.
1324 Changelog in reverse order, oldest first.
1326 ChangeLog (packager-affine)
1327 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
1329 - WANT_NOGETOPT is gone. [73f0605]
1331 - WANT_NETRC: new option (on by default; see below). [topic/netrc]
1333 ChangeLog
1334 ^^^^^^^^^
1336 - Manual slightly improved in respect to LC_ALL etc. settings.
1337   The knowledge treshold value is much too high for a normal user;
1338   i hope that at some later time we can offer much more (at least
1339   optional) automation on the protocol level (e.g., timeout values,
1340   protocol features supported by servers etc.), at which time we will be
1341   able to make the manual more user friendly. (Georg Schlisio)
1342   [56fab16,bd1e11f; ArchLinux Wiki]
1344 - The `@' search command has new "header" keyword, which searches in all
1345   headers.  Shortcuts: "<" = "header", ">" = "body", "=" = "text".
1346   ("body" and "text" still perform full text searches _including_ MIME
1347   part header content.)
1348   [b0138a7]
1350 - The -O command line option is legacy and will vanish in v15.0.
1351   Arguments to the MTA can henceforth be passed after a `--' separator
1352   on the command line, as in
1353     echo bla|s-nail -vvd -s sub some@where -- MTA ARGS MADE EASIER
1354   [topic/mtaarg]
1356 - New *sendmail-arguments* option; content will be (converted to list
1357   and) joined onto other MTA command line arguments (Wiesław Magusiak)
1358   [topic/mtaarg]
1360 - *colour-pagers* is gone -- instead we have *colour-pager*, which is
1361   a boolean and off by default.  We again set LESS (and LV) environment
1362   variable(s) to automatic turn on colour support in $PAGERs, but only
1363   if the variable in question is not yet set.  (That is -- in order to
1364   get coloured $PAGER you at least have to set *colour-pager* now.)
1365   (Tarqi Kazan) [b794f5e]
1367 - Terminals no longer need to be added to *colour-terms* if their name
1368   (in $TERM) includes the string "color". (Gavin Troy) [ce2c7f6]
1370 - Karol Blazewicz opened a discussion in the ArchLinux Forum (s-nail
1371   14.7-1 doesn't work [1]) but i didn't realize his actual problem --
1372   luckily Gavin Troy wrapped his head around the real problem, and that
1373   finally opened my eyes against a whole can of worms in the new URL
1374   and credential handling!
1376   Then Ypnose also came along and reported an issue with IMAP handling
1377   that was related to the compatibility credential handling of the new
1378   URL and credential layer.
1380   (Gavin Troy, Ypnose, Karol Blazewicz) [a5c40ba]
1381   [1] <https://bbs.archlinux.org/viewtopic.php?id=182653>
1383 - We now also have -HOST and -USER@HOST *smtp-use-starttls*. [bfb186a]
1385 - Gabby history entries will now be saved and restored as such, in case
1386   *history-gabby-persists* is set.  (For this to work properly
1387   a possibly existing history file needs to be reset.) [b5502cc]
1389 - We now have optional .netrc support (*v15-compat* set).
1390   Set *netrc-lookup* and we'll look in $NETRC / ~/.netrc for user
1391   credentials.  The `netrc' command will show or clear the entry cache.
1392   E.g., this is my new account macro:
1394    set v15-compat ssl-method=auto
1395    set netrc-lookup
1396    set smtp=smtps://smtp.yandex.ru:466 smtp-auth=plain smtp-hostname= \
1397          hostname=yandex.com
1398    ghost xp 'fi %:pop3s://pop.yandex.ru'
1399    ghost xi 'fi %:imaps://imap.yandex.ru'
1401   As an extension to the .netrc syntax we support a single
1402   introductional subdomain wildcard, e.g., my relevant ~/.netrc entry:
1404     machine *.yandex.ru login NAME password PASS
1406   Following a suggestion of Gavin Troy we have multi account support,
1407   i'm not quite sure wether this is portable across .netrc using
1408   applications, e.g., i could have written the above like
1410     machine *.yandex.ru login NAME
1411     machine *.yandex.ru password PASS
1412     machine *.yandex.ru login NAME2
1414   (I hope i don't lie and this really works.)
1415   (Suggested by Gavin Troy and Ypnose, testing and feedback Gavin Troy)
1416   [topic/netrc]
1418 - Add primitive support for RFC 3798 via the new
1419   *disposition-notification-send* variable.  This is not yet
1420   a truly conforming implementation (it simply injects the necessary
1421   header) and it requires the *from* variable to be set.
1422   More in the far future, sorry. (Wiesław Magusiak) [ca31d32]
1424 ChangeLog (purely technical)
1425 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1427 - Interrupt protection during (recursive) macro calls with `localopts'
1428   on should now no longer be crashable at all.  Quote [a4e85c0]
1429     It is of course all pretty intermediate until we have a signal
1430     manager and we can actually poll signal states at those places where
1431     we are capable of and desire to handle them.  But it should work
1432     today and look nicer than it did.
1433   [25caeb9,592499f,a4e85c0]
1435 - `ghost' handling performs more strict name checking on ghost names in
1436   order not to allow names which would later not be parsed as a whole.
1437   [1523a6d]
1439 - Dropped catopen(3) support (we never really had it)!  We will have
1440   a new S-nail-specific gettext(3)-alike thing in v14.8.
1441   [topic/i-wanna-have-a-dog]
1443 v14.7, 2014-06-07
1444 -----------------
1446 Thanks go to Tarqi Kazan (tarqi AT cfs DOT or DOT gs) and Johannes
1447 Löthberg (johannes AT kyriasis DOT com), as well as Martin Neitzel.
1448 (And the winner is... Gavin Troy for his role in "Silence from Ireland".
1449 Yay!)
1451 Notes
1452 ^^^^^
1454 - Since S-nail now performs more-or-less proper percent-encoding as per
1455   RFC 3986 users of *imap-cache* have to (either throw away and recreate
1456   or) adjust their local cache, e.g. as follows (adjust CACHEDIR and
1457   echo(1) to mv(1) as necessary; won't work with paths with whitespace):
1459   $ CACHEDIR=${HOME}/traffic/.mail-cache; \
1460   find ${CACHEDIR}/ -depth -type d |
1461   while read d; do
1462     b=`basename ${d}`
1463     r=`echo ${b} | sed -e s/:/%3A/g -e s/@/%40/g`
1464     if [ ${b} != ${r} ]; then
1465       d=`dirname ${d}`
1466       echo ${d}/${b} ${d}/${r}
1467     fi
1468   done
1470 ChangeLog
1471 ^^^^^^^^^
1473 - New variable *history-gabby* can be set to add much, much entries into
1474   the history than is done normally.
1475   For the NCL only, setting *history-gabby-persist* will cause those
1476   entries to be saved into *NAIL_HISTFILE*, too, which they are not by
1477   default with it (the other command line editors should always save).
1478   [6026507]
1480 - The `online' alias for `connect' has been obsoleted. [d5cfde4]
1482 - New CONFIG=MAXIMAL make option. [c0d4087]
1484 - Support compilation on new OpenBSD with their reduced OpenSSL clone.
1485   This topic also includes the real solution for getting rid of
1486   a strcat(3) warning that i reintroduced with s-nail-14_5_2-smime.patch.
1487   [topic/obsd56]
1489 - Our -r command line option is now mapped to a `-f' MTA option -- the
1490   sendmail(1)-compatible `-r' is long obsoleted! (Johannes Löthberg)
1491   [d0ead39]
1493 - New `elif' command so that we now have if..elif..else..endif.
1494   If the optional regular expression support is available the new
1495   conditions `=~' and `!~' can be used to perform (case-insensitive)
1496   regex matching with `if' and `elif'. [topic/condsplus]
1498 - New `~R' tilde escape (like `~r', but indent lines). [fae1f29]
1500 - Improved multibyte-safety (e.g. for *prompt*) and a bit of
1501   compatibility ("support" would be a wording much too strong) for
1502   bidirectional text via the new *headline-bidi* variable.
1503   [topic/unibidi, topic/mbbidi]
1505 - Diversified behaviour of -v command line option as well as *verbose*
1506   to support multiple levels of verbosity; the latter is now ternary
1507   when set and boolean when unset.
1508   This was the ground on which SSL certificate validition verbosity was
1509   implemented (*verbose* level 1: certificates, level 2: network
1510   communication et cetera), though much is left to do.
1511   This has been suggested long ago by (Martin Neitzel). [topic/smverb]
1513 - ^C in compose mode with *ignore* set acts now POSIX compatible
1514   [0275d09]
1516 - If *encoding* is set to base64 then we don't ignore that user
1517   wish and use quoted-printable (when 7bit doesn't suffice) [2ca201f]
1519 - New `urldec' and `urlenc' commands. [63e869e, fbd95e8, 0af5b1b]
1521 - New `setenv' and `unsetenv' commands. [5e2ed79]
1523 - Support for GSS-API authentification has been added (request and
1524   testing by Tarqi Kazan).
1526   Note that the following implicit relation is gone:
1527     *smtp-auth*
1528       If set to `login', or if unset and smtp-auth-user is set, `AUTH
1529       LOGIN' is used
1531   This topic branch also added support for the SUBMISSION protocol of
1532   RFC 6409, so re-reading the *smtp* manual may bring benefits.
1533   [topic/smtp]
1535 - A new, backward-incompatible URL syntax and credential lookup scheme
1536   has been introduced that is accessible when the new *v15-compat*
1537   variable is set.  If used, credential lookup occurs before a network
1538   connection is made.
1540   The new manual section "URL syntax" describes the new credential
1541   variable chains, and documentation of *from* should be read again, as
1542   i now also refers to the new *smtp-hostname* variable.
1544   Note that the generated `Message-Id' has also changed.
1546   (Messy old way pointed out by Tarqi Kazan)
1547   [topic/url, topic/cred]
1549 - `resend' should be truly fixed and (fwiw) can also resend to pipe and
1550   file addressees. [topic/resend]
1552 - Support for empty lines in macro and account definition blocks (as
1553   required by POSIX for startup files in general) [43cdf92]
1555 - The nail command line editor gained the possibility to use PgUp /
1556   PgDown / Home / End instead of z[-+0$] commands on xterm-compatible
1557   terminals; and ^O equals a `dp' there, too. [8c57be2, 7c30e61, 95e672f]
1559 v14.6.4, 2014-04-07
1560 -------------------
1562 Many thanks to Gaetan Bisson.
1564 ChangeLog
1565 ^^^^^^^^^
1567 - Avoid segmentation faults with -L option if s-nail is opened on
1568   non-existent mailboxes, e.g. '$ MAIL= s-nail -Lx'.  (Gaetan Bisson)
1569   [e6c86da]
1571 v14.6.3, 2014-04-05
1572 -------------------
1574 Thanks and greetings to Gavin Troy, Gaetan Bisson and Tarqi Kazan (tarqi
1575 AT cfs DOT dyndns DOT biz).
1577 ChangeLog (packager-affine)
1578 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
1580 - WANT_AUTOCC knows that clang(1) version 1 can dig -Wstrict-overflow=5.
1581   [2f77640]
1583 - '$ make test' should work even if you are not steffen.
1584   (Gaetan Bisson, Gaetan Bisson, Gaetan Bisson, Gaetan Bisson,
1585   Gavin Troy, Gavin Troy) [8b796ba]
1587 ChangeLog
1588 ^^^^^^^^^
1590 - *autoinc* is gone -- this is *newmail*. [07a8462]
1592 - Working with large(r) IMAP boxes should work again without causing
1593   segmentation violations. (Gavin Troy) [761dd87, b0ce180]
1595 - With our builtin getopt a.k.a. WANT_NOGETOPT=1 usage of the -L option
1596   caused segmentation violations. (Tarqi Kazan, Gaetan Bisson) [f2c2646]
1598 - The decision wether we need $PAGER or not now also incorporates the
1599   informational lines we inject for messages. [316b4cd]
1601 - Drop `defines', add `unaccount', rename `undefine'..
1602   The `defines' command has been united with `define' -- just like
1603   `account' will list all defined accounts when used without arguments
1604   `define' will now do so for macros.  And `undefine' is the new name of
1605   `undef'.  The new command `unaccount' can be used to delete all given
1606   accounts, in equal spirit to `undefine' and macros.
1607   All of this is still vulnerable against recursivity, e.g., deleting
1608   an executing macro still works, but don't that. [b0b3275]
1610 - Rename `var-inspect' to `varshow'; silly oversight that `var-inspect'
1611   will try to lookup a variable "-inspect".  Ouch. [afffd30]
1613 - Without HAVE_ICONV the character set iterator sofar used
1614   *charset-8bit* as the last resort, whereas it should have used
1615   *ttycharset*.  Fixed.
1616   P.S.: All this still preliminary, we await the MIME and send layer
1617   rewrite to calm down the stuff for real. [edc3226, df9aefd]
1619 - During `~@' editing it is possible to leave the possibly endless
1620   character set selection loop by interrupting via ^C.
1621   In the meanwhile this effectively drops the currently edited
1622   attachment and leaves the entire attachment selection session; it
1623   doesn't make sense to make it any better until we have our signal
1624   manager and stop jumping around.
1626   This changeset should also fix dangling Content-Xy MIME information of
1627   attachments which were in the same slot before, e.g., if #1 was
1628   a message attachment and that was changed on-the-fly to be a real file
1629   attachment then the Content-Description would still have stated that
1630   it is a message attachment.
1631   [07a8462]
1633 ChangeLog (purely technical)
1634 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1636 - Since it has been decided to remain compatible to ISO C89 we cannot
1637   use the ISO C99 `z' format string modifier (printf(3)).
1638   Since quite some time we make efforts to provide our own `ZFMT' macro
1639   (in `nail.h') which provides somethint compatible, but on 32-bit
1640   platforms compilers often complain nonetheless.
1641   Therefore we now also have a compile-time assertion that proves that
1642   our `ZFMT' macro is really correct. [397e4d1]
1644 v14.6.2, 2014-03-01
1645 -------------------
1647 Many thanks to the perpetual Gavin Troy.
1649 - Faulty notational change of system call return values from `<0' to
1650   `==-1' caused endless waitpid(2) loop. [d6f316a; test(!): 79fd761]
1651   (Gavin Troy)
1653 - (GLibC) STD I/O overoptimizes rewind(3) so that underlaying file
1654   descriptor offset is not reset to 0.  Generalize the already
1655   used `really_rewind()' hack and use it not only in
1656   `savedeadletter()' but also in `page_or_print()'.  It is likely
1657   that this not also fixes `history' listing but also some other
1658   things which go through the pager, dependend on the setting of
1659   *crt* etc., and on at least GNU/Linux systems. [463660f]
1661   Note: standard I/O does NOT offer a possibility to do this in
1662   a non-hackish way.  It is thus likely that S-nail will gain
1663   a completely new I/O layer in the future.  That'll also be faster.
1665   P.S., 2014-03-04:
1666   This note is false: POSIX Issue 7 overloaded the meaning of
1667   fflush(3): when used on readable streams the file offset of the
1668   underlaying file descriptor is adjusted to that of the stream.
1669   (nail.h: adjust really_rewind(): POSIX Issue 7 defined a way..)
1670   uses this official approach instead if _POSIX_VERSION>=200809L.
1672 - Old shells will now correctly execute an error-condition
1673   execution path in `mk-conf.sh'. [afef55f]
1675 v14.6.1, 2014-02-22
1676 -------------------
1678 Thanks to Andy Switala (andy DOT switala AT gmail DOT com).
1679 And thanks to all package maintainers for their stamina.
1681 At the first workday after the release i've run into a bug that was
1682 caused by an oversight, a double-Fclose() that would be harmless if we
1683 wouldn't forcefully panic() when we encounter it!
1685 So i've spent another week on a review, and despite fixing many
1686 additional notational oversights i haven't found more oversights of
1687 newly introduced problems.  On the other hand i've found and fixed some
1688 old problems during the review, and tweaked some other things:
1690 - The INSTALL file now has a `Current codebase state' section.
1692 - Commands invoked via `!' should now be interruptable.
1693   I'm afraid the exit status of such a command will not be reflected by
1694   the return value of the `!' command yet, but hey, at least `!sleep 10'
1695   can now be interrupted -- try this with another Berkeley Mail!
1696   [381ff46]
1698 - All credential prompts should now be interruptable.
1699   (Inspired from Andy Switala) [c3bb2a2]
1701 - 'make test' will now test a silly S/MIME case when WANT_DEBUG (or
1702   'make devel') was used. [8cff17f]
1704 - *batch-exit-on-error* should now look at the exit status of *every*
1705   command when the command loop ticks. [c7e7d53]
1707 - The new `[?name-list]?search-pattern' search expression has been
1708   changed to `[@name-list]@search-pattern' -- like this it doesn't clash
1709   with the `?' help command and can thus be used on a line by itself,
1710   causing the default command (`next') to be invoked on its' result,
1711   shall there be one.  Ok, yes, that was surely also an oversight.
1712   [8368f70]
1714 - *attrlist* must now be exactly 13 characters, just as it should
1715   be.  An error message is printed if not.  It was always komisch,
1716   but i'd buggified it somewhen in the past.  Now fixed.
1717   [part of 0d4e934]
1719 - The NCL WANT_TABEXPAND feature now also works if *newfolders* is
1720   set to `maildir'.  Yet, if a folder was assumed to be of maildir
1721   type, shell globbing would not occur. [part of f5c184c]
1723 - The `X-Decoding-Data' S/MIME header field was set to the epoch
1724   origin instead of NOW in v14.6.
1726   Also the `certsave' command now supports file globbing (i.e.,
1727   '~/.certs/' should end up in your $HOME now).
1728   [both part of 7e0aec7]
1730 v14.6, 2014-02-15
1731 -----------------
1733 + With this release the S-nail codebase has been converted to my usual
1734   style of function-code-flow and notation.
1736   ?0[]$ git diff --shortstat v14.5.2..HEAD
1737    55 files changed, 28065 insertions(+), 25356 deletions(-)
1738   ?0[]$ git diff --ignore-all-space --shortstat v14.5.2..HEAD
1739    55 files changed, 14664 insertions(+), 11955 deletions(-)
1741   Maildir and S/MIME support have been restored, and a MIME bug that
1742   could have led to missing data in header display+ has been fixed.
1743   Ah, and users of compressed boxes should now feel luckier, too --
1744   at least once they've realized that the compress extension is no
1745   longer appended automatically, but must be given explicitly.
1747   Thus: i hope that all those i-am-new-to-the-codebase bugs i've
1748   introduced over a year ago have been found and fixed, and that
1749   v14.6 is the true "sweet sixteen" (months of maintainership).
1751 ChangeLog (packager-affine)
1752 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
1754 - If WANT_AMALGAMATION is set, `-pipe' will be added to our CFLAGS
1755   (which are only honoured with WANT_AUTOCC, of course).  [1330411]
1757 - New configuration option: WANT_IMAP_SEARCH, enabled by default.
1759   The regular expression support for IMAP-style search expressions has
1760   been removed again: it changed the IMAP search semantic in that it
1761   couldn't be executed on the server, but only local, and the syntax
1762   sucked, too.  (And we have a new `?' search expression.)  [402b7c6]
1764 - CONFIG=MEDIUM and CONFIG=NETSEND now both WANT_REGEX.  [dee954e]
1766 - The `make test' target should *really* work gracefully, now that usage
1767   of the `-#' command line option also sets the folder to be opened to
1768   `/dev/null'.  (Still no `void' box in sight.)  [0119d514]
1770 - All published patches may also be found in a new [patches] branch.
1772 ChangeLog
1773 ^^^^^^^^^
1775 - Several fixes that saw published patches (with equivalent
1776   functionality), and are thus described in NEWS, are included:
1778   . s-nail-14.5.2-sort-alt.patch
1779     Fixes a hasty commit that introduced string relaxation in a faulty
1780     way.  [5e75529]
1782   . s-nail-14_5_2-mimeheader.patch
1783     Fixes data loss if multiple MIME encoded-words follow each other in
1784     header bodies.  [c81afce]
1786   . s-nail-14_5_2-maildir.patch
1787     Effectively restores proper maildir support.  [1c2563b, 13f325f]
1789   . s-nail-14_5_2-smime.patch
1790     Fixes an off-by-one error and, in effect, restores S/MIME sign and
1791     encryption etc. support.  [e759f75]
1793 - The `screen' terminal type is by default recognized as being
1794   colour-capable.  [e759f75]
1796 - With the NCL command line editor and WANT_TABEXPAND hitting <TAB>
1797   should now act as if an "implicit asterisk" had been given in case
1798   there was no expansion of the original user input; e.g., '? ls <TAB>'
1799   may exceed your line limit now ;).  [0910a8f]
1801 - The S/MIME cipher list was outdated, RFC 5751 requires AES-128 as
1802   the default, the RC2 ones are long obsoleted (etc.).  Also we now
1803   should handle that OpenSSL may not support individual algorithms.
1805   Note: we use the option value `des3' for `DES EDE3' from now on!
1806   (Maybe see *smime-cipher-user@host* manual entry.)
1808   *ssl-method* may now also be assigned the new (default) method `auto'
1809   explicitly.
1810   [2472670]
1812 - Messages will now be stored in a set *record* even if only file or
1813   pipe addressees were given.  [a11935b]
1815 - Support for xz(1) compressed mailboxes has been added.
1816   (The `Can't canonicalize' warning for compressed boxes had the same
1817   cause that made maildir usage impossible, but i don't feel _too_ bad
1818   because looking into the code a bit revealed that the *newmail*
1819   mechanism never worked for such boxes anyway.  And will for a while.)
1820   [7fd9979]
1822 - S-nail now supports nested if..else..endif conditionals.  [3c22c04]
1824 - The NCL command line editor now locks its' history file when it reads
1825   and writes it, so as to protect against concurrent usage.  [c3a39ce]
1827 - You can now say 'fi%', 'fi&', 'p&10' and `ghost ps '!ps axu'' followed
1828   by 'ps|grep nail'.  [c3266c6]
1830 - Invocation cleanup: usage of -f and -u is mutual, -H and -u is ok, -u
1831   in send mode not.  [fa0a0aa]
1833 - New message specification: `[?name-list]?search-string' will search
1834   in locally available messages.  If the optional `?name-list' part is
1835   given, that specifies the (comma-separated list of) header fields to
1836   search in.  The special names `body' and `text' can be used to search
1837   in message bodies alone and bodies including the headers fields,
1838   respectively.  Note that "message bodies" unfortunately still means
1839   "including headers of attachments and attachments themselves", and
1840   until some later time.  [61bb460]
1842 - The new command line option `-L spec-list' prints a header summary of
1843   only those messages that comply to the specification list `spec-list'.
1844   If -L and -H are used in combination, no summary is printed at all,
1845   but the exit status reports wether `spec-list' would have matched some
1846   messages or not.  [934e12c]
1848 ChangeLog (purely technical)
1849 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1851 - Most of the work was changing the code-flow of the entire codebase to
1852   my usual style of programming, with a single function entry and
1853   a single function exit, including the addition of N(ot) Y(et) D(ead)
1854   points of interest, which finally enabled me to get rid of (sic!)
1855   using a debugger for S-nail development.  Just compile via 'make
1856   devel', and in case of a crash you should get a nice backtrace
1857   listing.  (You use IMAP, do you?)
1859   However, because practically every line of code has been touched, this
1860   caused some other changes along the way, e.g., the handling of
1861   temporary files was changed completely (the formerly used Ftemp()
1862   function has been replaced with a new Ftmp(), which handles unlinking
1863   itself as necessary etc.), it was detected that the S/MIME support was
1864   no longer compliant to any RFC, some resource leaks have been
1865   eliminated...  It is likely that a change so large introduced some
1866   other flees and flaws, however.  But it looks good so far.
1867   Thank you.
1869 v14.5.3, 2014-02-15
1870 -------------------
1872 + No official release, only exists as git(1) tag.
1874 v14.5.2: fix 4: 2014-02-15 (2014-02-14)
1875 ---------------------------------------
1877 - s-nail-14_5_2-smime.patch
1878   Fix a very stupid off-by-one error that i've introduced
1879   in [7bdf330] (OpenBSD 5.3: sigh, address strcpy(),strcat()
1880   etc., 2013-06-01).
1881   Until we've changed the used data from string to something
1882   line-wise, use strcat(3) again.
1884 v14.5.2: fix 3: 2014-02-10
1885 --------------------------
1887 - s-nail-14_5_2-maildir.patch
1888   maildir folders would have caused problems in environments which
1889   provide the realpath(3) function: beside a "cannot canonicalize PATH"
1890   warning the finally used path would be wrong (`test3' would end up as
1891   `test3/test3'), so that any further access would try to use the wrong
1892   path.  Please read the description of this patch and/or the commit
1893   logs of the commits [1c2563b] and [13f325f].
1895 v14.5.2: fix 2: 2014-02-05
1896 --------------------------
1898 - s-nail-14_5_2-mimeheader.patch
1899   A header like
1901     Subject: ehm, .getElementById("blink") needs <span
1902      =?US-ASCII?Q?id=3D"blink">,?= not =?US-ASCII?Q?class=3D"id"?=
1904   would yet be displayed without the " not " in between the two encoded
1905   words because of faulty "encoded-word-continuation" detection (note
1906   the quotation marks).  The error path could also have been seen in
1907   mail forwarding and in faulty searching etc.
1908   This patch is in a row of fixes for my hasty [0f9ad93] from 2013-03-12
1909   that already caused the v14.2 minor release (because of [b608c6b] from
1910   2013-03-14).  Those with mercy may read the commit message of [c81afce].
1912 v14.5.2: fix 1: 2014-01-30
1913 --------------------------
1915 - s-nail-14_5_2-sort.patch
1916   Reverses (sort(),thread(): use srelax()!, 2014-01-18, [a9b67e9]),
1917   which was a hasty commit of an untested diff that i've added few
1918   minutes beforehand:
1920     As a rather careless last-minute change i've added string relaxation
1921     to threaded and sorted display, but it's really one more step towards
1922     lowering memory pressure -- i couldn't resist [a9b67e9] after seeing
1924   An alternative, forward-heading patch that keeps string relaxation has
1925   been pushed to [master] as [5e75529] and is also available as
1926   s-nail-14_5_2-sort-alt.patch.
1928 v14.5.2, 2014-01-18
1929 -------------------
1931 Thanks to Ypnose, Sunil Nimmagadda and Gavin Troy.
1932 Gavin Troy *really* deserves special thanks for facing [next]!
1933 And i want to dedicate the new coloured message display functionality
1934 to John Dodson and Ypnose.  Thank you.
1935 (And best wishes to beautiful Australia!)
1937 ChangeLog (packager-affine)
1938 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
1940 - All utilities can now be overwritten during configuration so that
1941   their values are fixated in the generated makefile (`mk.mk').
1942   I.e., talking about MAKE=, STRIP=, awk=, cat=, chmod=, cp=, cmp=,
1943   grep=, mkdir=, mv=, tee=.
1944   rm= and sed= have to be overwritten from the command line, they're
1945   needed before `conf.rc' is read.
1946   [5c03347, 072ec65, 39a00ab, 23a1245, ?]
1947   (Ypnose)
1949 - The release tarball is now also available in a xz(1) version.
1951 - New configuration option: WANT_COLOUR, by default enabled.
1953 - 'make test' should now really work, even if the running user has
1954   a mailbox with content. [f223a91]
1956 - WANT_AUTOCC is now by default enabled, so as for normal users which
1957   don't have the need to embed into a defined packaging environment.
1958   [d7e4e31]
1960 - Installation no longer strip(1)s away debug symbols if WANT_DEBUG was
1961   enabled. [6d075c6]
1962   (Gavin Troy)
1964 ChangeLog
1965 ^^^^^^^^^
1967 - Fixes to some bugs that are present since the first cvs(1) commit of
1968   Heirloom mailx(1); includes that *ssl-key-user@host* should now work.
1969   [4405a2cc, 9770c26f, 692976b9]
1971 - Some off-by-XY fixes, thanks to the debug memory canaries.
1972   [19b2b0d, 202506e, 43df6e4]
1974 - Fixes for (other) stupidisms (of mine): [1c2161f]
1976   This includes true implementation of in-memory history limit for the
1977   NCL, which was the final and real solution to a segmentation fault
1978   that Gavin Troy had to deal with on [next]. [1089f2b]
1979   (Gavin Troy)
1981 - For completeness: new command `var-inspect' shows information about
1982   all given options.  Mostly ment for implementing future tests.
1983   [topic/okeys]
1985 - The `pipe' command no longer embeds message information into the
1986   data passed through to the command (when *piperaw* is set).
1987   [ef5ecc6 (part of topic/colour)]
1989 - Simple coloured message (header) display is now possible.  Please
1990   read the new manual section "Coloured message display", use
1991   *colour-disable* to turn it off.  (It is enabled by default if it
1992   knows the terminal is capable and, if used, the pager can, too.  Note
1993   we now set LESS=FRXi when starting PAGER and no LESS= is in the
1994   environment.)
1996   Dedicated to John Dodson and Ypnose.
1997   [topic/colour, c6e84c7]
1999 - The `if', `else', `endif' syntax has been extended.
2000   You can now "if 0" (never), "if 1" (always), "if $OPTION" (boolean
2001   check for OPTION) and "if $OPTION == 'VALUE'" as well as "if $OPTION
2002   != 'VALUE'".  Unfortunately it is still not possible to use
2003   conditionals inside conditionals. [0fb2ae7]
2005 - -# now also sets MBOX=/dev/null. [4be2f1e]
2007 - The NCL command line editor now supports cursor keys when the terminal
2008   produces xterm(1)-compatible keycodes ('ESC' + '[' + [DACB] for left,
2009   up, right and down, respectively).  What a thrill, yay!!! [0cbf672]
2011 - New (optional) command: `history': show or clear command line history,
2012   or select a specific command line from in there.
2013   History works a bit different now, and should no longer include
2014   command lines which include specific message numbers; more to come.
2015   [59c6195, topic/hist2]
2017   I plan to join all the history management and use only the one that is
2018   part of NCL now, hooking it into editline(3) and readline(3).  That
2019   would shrink tty.c a bit and also introduce duplicate elimination for
2020   readline(3).
2022 - The new ~u and ~U tilde escapes work like ~f and ~m, respectively, but
2023   don't include any header lines.  Inspired by a patch from
2024   Sunil Nimmagadda on openbsd-tech@.  [c37b8b3]
2026 - The `|' command should work again -- it has stopped working on
2027   2013-09-09 when i've accidentally changed the command name from `|' to
2028   ` | '. [5a8378d]
2029   (Gavin Troy)
2031 - As a rather careless last-minute change i've added string relaxation
2032   to threaded and sorted display, but it's really one more step towards
2033   lowering memory pressure -- i couldn't resist [a9b67e9] after seeing
2034     ?0[ /Users/steffen/src/nail.git/t.mbox]? sst
2035       Buffer allocs ever/max simultan. : 14/14
2036       Overall alloc count/bytes        : 17165/881088
2037       Cycle maximums: alloc count/bytes: 16906/876984+0
2038     ?0[ /Users/steffen/src/nail.git/t.mbox]? sst
2039       Buffer allocs ever/max simultan. : 0/0
2040       Overall alloc count/bytes        : 16515/841816
2041       Cycle maximums: alloc count/bytes: 16256/837712+829560
2043 ChangeLog (purely technical)
2044 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2046 - We now have debug canaries for all memory sources now that [8419d44]
2047   added them to the "string dope".
2049 - The most work has been done on our value system, which manages the
2050   binary and value options, like *folder* etc.
2051   It is now based on enumerations, i.e., constant integers, not on
2052   strings.  This of course only relates to non-dynamic options.
2053   Anyway, this saves us key hashing and allows more compact data
2054   representation in general (see the new header `okeys.h' for more).
2055   [topic/okeys]
2057 v14.5.1, 2013-12-27
2058 -------------------
2060 ChangeLog (packager-affine)
2061 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2063 - The build system *only* uses the automatically detected $CFLAGS and
2064   $LDFLAGS if WANT_AUTOCC=1.  I.e., even unset or empty $CFLAGS and
2065   $LDFLAGS are not touched until then.
2066   (We do however still set $CC if that is unset or empty or set to the
2067   plain string "cc".) [856625f6]
2069 ChangeLog
2070 ^^^^^^^^^
2072 - Fixed segmentation faults / bus errors when setting *nofolder*
2073   / *line-editor-cursor-right* to the null string (only with WANT_NCL),
2074   respectively. [d1f1a19b, 21e5c285, 9f6ff25d]
2076 - *prompt* handling is now really POSIX compliant (thus no prompting
2077   occurs not only for 'set noprompt', but also for setting *prompt* to
2078   the null string).
2080   This was indeed a rather large changeset that also introduced the new
2081   *prompt* escape character \&, which expands to `?' by default and to
2082   `&' if *bsdcompat* is set.
2084   Like that we now can simply assign "\& " to *prompt* at program
2085   startup, which (a) allows to do 'set noprompt' without error (once)
2086   and (b) allows for POSIX compliance in respect to prompt handling
2087   without any complicated conditional code, but (c) gives us the
2088   opportunity to continue to support BSD prompts.
2089   [0dfe53db]
2091 - For completeness: new command: `features'.  (Rather useful for being
2092   able to implement more tests in the future, and act according to what
2093   is really compiled into the tested binary.
2095 - The `-#' command line option now also sets *quiet* by itself.
2096   [7b5a5c87]
2098 - nail.1: a newly introduced empty line in the manual produced error
2099   messages on some systems.  Fixed.
2101 - The return value of the `mimetypes' command has been reversed and
2102   should now be fixed. [acf56ac52]
2104 - In threaded display the Subject: followup suppression no longer
2105   takes into account invisible messages.
2106   Also, rudely hack in a messages-already-written-in-this-round counter,
2107   so that the followup suppression knows when "the top of the screen" is
2108   reached, which (seems to) help(s) against missing subjects up there as
2109   well as after a `newmail'. [topic/subject]
2111 - Added a WANT_REGEX=1 toggle in `conf.rc'.
2112   When we find regular expressions then a new regex-enabled IMAP-style
2113   search is available (see the manual for more) [1ec8fe68]
2115     ? f (/or subject ^\[S-nail (subject ^\[nail-devel))
2116     ? f (/subject ^\[S-nail) (/subject ^\[nail-devel)
2117     ? f (/subject "^\\[(S-nail|nail-devel)")
2119   I'm looking forward for being able to add another, simplified, syntax.
2121 ChangeLog (purely technical)
2122 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2124 - The cc-test.sh has seen some tweaks, for easier future extension, and
2125   for adding a test for [d1f1a19]. [several, mentioned: 21e5c285]
2127 - On systems without a real wordexp(3) implementations deadlocks could
2128   occur because we sometimes hold_all_sigs() to avoid longjmp(3)s away
2129   (and will do so for quite some time, still), and that resulted in the
2130   SIGCHLD that reported the exit of the started subshell to be blocked,
2131   too (e.g., after '? *.h<Tab>': endless hang).  Fixed.
2133 v14.5, 2013-12-19
2134 -----------------
2136 Many thanks: Gaetan Bisson, William Yodlowsky, Gavin Troy,
2137 Thomas (wasd AT gmx DOT net), Ypnose.
2138 And Gavin Troy definetely deserves a very special credit.
2139 But thank you all, and very much indeed!
2141 ChangeLog (packager-affine)
2142 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2144 - The `test' make target has been fixed. [f0991e14]
2145   (Gaetan Bisson)
2147 - It is possible to gain a different kind of make(1) verbosity by
2148   using a VERBOSE=1 command line argument (this knob is not taken into
2149   account when deciding wether a rebuild is needed). [498e4ad0]
2150   (William Yodlowsky)
2152 - On Crux 3 Linux and OpenBSD the readline(3) and editline(3),
2153   respectively, libraries will now be found when desired. [a7d1aa78]
2154   (William Yodlowsky)
2156 - WANT_LINE_EDITOR has been renamed to WANT_NCL, *plus*.
2157   So now there are WANT_READLINE, WANT_EDITLINE and WANT_NLC, each of
2158   them can be set individually, and they are tested in the shown order.
2159   Also, WANT_TABEXPAND and WANT_HISTORY have been introduced and can be
2160   used to fine-tune functionality. [ae4e01e1, b2635feb, 9742bf40]
2162   (While here, i've fixed WANT_TABEXPAND code so that it is more
2163   sensitive to line excess; on Linux etc., where MAX_INPUT is 255,
2164   strange behaviour could be seen because we didn't take into account
2165   the length of the prompt at all.  The NCL is assumed to have only
2166   one remaining, but unfixable problem: backspace often is incapable
2167   to cross visual line boundaries; use ^A/^E + ^L, then. [e832c04a]
2169   Also, cursor (now ^B and ^F) and history movement (now ^P and ^N) of
2170   the NCL have been changed. [d7d928da])
2172 - WANT_QUOTE_FOLD is now enabled by default.  And WANT_ASSERTS has been
2173   renamed to WANT_DEBUG. [1e10da1f]
2175 - The build system has seen yet another overhaul in general.  CC, CFLAGS
2176   and LDFLAGS plus are now tracked and changes will force rebuilds.
2177   The new WANT_AUTOCC option can be used to let the build system figure
2178   out a compiler and choose known-to-work flags.  Use the new ADDCFLAGS=
2179   and ADDLDFLAGS= command line arguments to add your specific flags on
2180   top of those -- the final CFLAGS etc. are what is change-tracked.
2182   This rather massive internal rework revealed that old Bourne shells
2183   were yet not supported by the new build system, and so did testing
2184   that UnixWare installation was yet impossible due to tool
2185   incompatibility. [75c4b74e]
2187 - The new WANT_AMALGAMATION option will force compilation of all the
2188   sources in a single compilation unit.  This requires a rather large
2189   amount of memory, but may produce a more compact, maybe more optimized
2190   binary.  (Implementing this revealed quite some bugs which could
2191   therefore be fixed.) [topic/amalgam]
2193 - `nail.rc' has been pimped a bit (mostly comments, but
2194   *mime-counter-evidence* is now always set). [e3094ba7]
2196    That changeset was however buggy. [f3dcb46]
2197    (Gavin Troy)
2199 - We no longer use install(1) for `install'ation make rules. [80b02cd9]
2201 ChangeLog
2202 ^^^^^^^^^
2204 - Even '$ s-nail & fg $!' will now work with the NCL. [2a8b5c55]
2206 - Several off-by-one (off-by-two) fixes. [32ce9836, 71e6d013, f139dc36]
2207   (Gavin Troy, Thomas)
2209 - Setting *noprompt* now prevents prompting, as per POSIX. [ecefaf63]
2211 - *prompt*: new \$ (exit status of last command) and \@ (name of
2212   currently active mailbox) escape sequences. [6f652046]
2214 - One may now omit the space in '? unc' ('?unc') [05fcb383]
2216 - New commands: `ghost' and `unghost' define command aliases (since
2217   `alias' is taken for a different purpose) [topic/commands]
2219     ? ghost ps '!ps axu'
2220     ? ps |grep nail
2222 - There is now a pseudo account `null' (case-insensitive).
2223   Also a new `localopts' command exists; when used from within an
2224   `account' block, options changed will be reverted back to its former
2225   value when the account is left (e.g. by switching to `null'):
2227     define sdn_ {
2228        alternates sdaoden@users.sf.net sdaoden@users.sourceforge.net \
2229           sdaoden@googlemail.com sdaoden@gmail.com
2230        set Sign="\n--steffen\nForza Figa!" sign="\n--steffen"
2231        set smtp=smtp.gmail.com smtp-auth=plain smtp-use-starttls
2232        #..
2233     }
2234     account sdn_gm {
2235        localopts 1
2236        call sdn_
2237        set from="Steffen \"Daode\" Nurpmeso <sdaoden@gmail.com>"
2238     }
2239     account sdn_sf {
2240        localopts 1
2241        call sdn_
2242        set from="Steffen \"Daode\" Nurpmeso <sdaoden@users.sf.net>"
2243     }
2245   E.g., after
2247     ? acc sdn_gm
2248     ? acc null
2250   neither of *Sign*, *sign*, *smtp** nor *from* should be set.
2251   Please see the manual for more.
2252   TODO - neither command-ghosts nor alternates etc. are yet tracked
2253   TODO - we should have a boolify() so as to say 'localopts yes' etc.
2254   [topic/acmava]
2256 - New command: `cwd' (print current working directory).
2257   Also fixing the `chdir' return value. [eff4397c]
2259 - The *ssl-method* now allows explicit setting of 'tls.1.1' and
2260   'tls1.2' values. [c66b4196]
2262 - When sending to display, be aware that filenames in MIME parts may of
2263   course be MIME-encoded! [1454be03]
2265 - *hostname* is now honoured even if *smtp* is not set.  (We always
2266   supported *from*, so why not *hostname*?)
2268 - The `-u user' option now acts identically to setting the $USER
2269   environment variable and both now tend to mean something like
2270   "impersonate as user in some aspects".  Note that we have always used
2271   the latter in one or the other way, and `-u user' always ment more
2272   than just "open mailbox of user", so i think this change sharpens the
2273   edge in the right direction. [09632731]
2275 - Filename argument quoting has been tweaked for (some) function(s which
2276   take a filename argument last).  The following snippet as reported by
2277   Gavin Troy should work now: [2bb9b80e]
2279     ? mv +inbox.Junk\ Mail
2281 - The GNU implementation of wordexp(3) is also (i've added a workaround
2282   for the very same bug for Mac OS X in S-nail v14.3 [63273772]) buggy,
2283    which causes segmentation faults when expansions failed (`fi &VOID').
2284   [470527b7]
2285   (Gavin Troy)
2287 - The `fi' command no longer uses the (possibly truncated) display
2288   version of a filename, but the full path. [5cd85b07]
2290 ChangeLog (purely technical)
2291 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2293 - Large rework of internal structure: bundle inclusion of most of the
2294   external and the content of most of the internal #include files in the
2295   new nail.h.  If that would have been done very first bugs like the
2296   infamous MAXPATHLEN bug as reported by Paul Vojta (see v14.4.2) would
2297   never have occurred. [21f3155b]
2299 - Support for -fstrict-overflow cc(1) flags. [topic/strict-overflow]
2301 - Fixed the quotation filter which yet allocated memory even if not
2302   used. [c98cdaf5]
2304 - String relaxation reduces memory pressure rather drastically when
2305   working with many (especially MIME) mails at a time, e.g., when
2306   writing a modified mailbox.  Before all messages of a mailbox had to
2307   be worked without releasing any memory in between, now we give back
2308   memory (to our pool, not the system) after each and every message.
2309   [topic/srelax]
2311 - The other memory source now uses bound canaries, which also found some
2312   errors. [3d9fe741]
2314 - We now use the EL_PROMPT_ESC editline(3) mode for prompting, which
2315   should offer the possibility to use coloured prompts etc. with
2316   (even those) editline(3) (versions which do offer it -- older versions
2317   should just do fine by themselves).
2318   S-nail uses the special trigger control character \1. [ea30d818]
2319   (Ypnose)
2321   Note however that all tested editline(3) versions are buggy and
2322   either don't get it right (`\1COLOR-ON\1stuff\1COLOR-OFF\1') or are
2323   incapable of proper repainting (`\1COLOR-ONstuffCOLOR-OFF\1').
2325 - We now use the MD5 digest code from the OpenSSL library if that is
2326   usable. [893b16c0]
2328 v14.4.5, 2013-10-19
2329 -------------------
2331 Many thanks: Gaetan Bisson, Stephen Isard, Jérémie Courrèges-Anglas,
2332 William Yodlowsky, and Adam Sjøgren from GMANE.org!
2334 ChangeLog (packager-affine)
2335 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2337 - The packager-install: target has been fixed. [a8c1b0b]
2338   (Gaetan Bisson and William Yodlowsky)
2340 - As suggested by Gaetan Bisson the several build system tasks are now
2341   individually addressable, i.e., 'make [OPTIONS] config', 'make build',
2342   'make test', 'make packager-install'); nothing changes unless you want
2343   to, in which case: please see INSTALL. [4d3b799]
2345   The new target 'test' will call cc-test.sh with its new --check-only
2346   option which will only perform the (too few) function tests on the
2347   ready binary.
2348   And cc-test.sh will no longer create output files, but simply echoes
2349   to STDOUT and STDERR. [629e1ee, 786f219]
2350   (Gaetan Bisson)
2352 - The default configuration file now sets *bsdannounce* and *bsdflags*,
2353   all in one line, as suggested by William Yodlowsky.
2354   (If *header* is disabled, *bsdannounce* is ignored, but *header* must
2355   be enabled by default according to POSIX, and *bsdannounce* is just
2356   the same as *header*, but for the folder-switched event.  Thus setting
2357   *bsdannounce* is the more sane default, imho.) [6161f10]
2358   (William Yodlowsky)
2360 - Announcement messages are now tagged '[ANNOUNCE]'. [26e1b35]
2361   (Tagging suggested by Stephen Isard and Jérémie Courrèges-Anglas)
2363 - The manual NAME now includes the version (but it's somewhat ugly).
2364   [8adcca4]
2366 ChangeLog
2367 ^^^^^^^^^
2369 - When switching folders when in compose mode, message attachments
2370   become invalid.  For v14.4.5, at least warn when this happens.
2371   [47eb1ab]
2373 - When reading multipart/alternative messages which do not contain
2374   a text/plain part, the (most likely HTML) part is not displayed (even
2375   if S-nail is configured to display HTML).  The reason is a bug i've
2376   introduced with [0d43a999] (Change "Part X:" display message..,
2377   2012-12-20).  (Note that the committed fix i've posted to the list was
2378   not correct either and has been fixed itself.) [225c02b, ecfa149]
2380 v14.4.4, 2013-10-03
2381 -------------------
2383 Thanked, Gavin Troy, Gaetan Bisson.
2385 - Fix output buffer confusion that would have occurred when parts of
2386   a multipart mail had a pipe command set.  Longer story in [e75d16dd].
2387   (Gavin Troy)
2389 - The makefile now supports a `packager-install' target that bypasses
2390   the reevaluation of the configuration (after checking that there is
2391   one) and directly steps ahead to the install process.
2392   (Gaetan Bisson)
2394 - Notes in INSTALL that CFLAGS and LDFLAGS need to be overwritten from
2395   within (conf.rc or) the command line.
2396   (Gaetan Bisson)
2398 v14.4.3, 2013-10-02
2399 -------------------
2401 I convey special thanks to Karol Błażewicz and Gaetan Bisson.
2403 - The new build system didn't allow to overwrite CFLAGS= when used in
2404   conjunction with GNU make(1).  To make a long story short, removing
2405   a `.POSIX:' directive from the makefile fixed the problem.  Luckily.
2406   [e6b26526]
2408 - More INSTALL notes for UnixWare 7.1.4, which suffers from the same
2409   problem: here the fix is to use the -e option of make(1).
2411 - Karol Błażewicz reported a segmentation violation he got when using an
2412   Arch Linux S-nail test package, and Gaetan Bisson informed me about
2413   that.  The problem was that we didn't assign the resulting default
2414   address (which gets used when *from* is not set) to the result which
2415   gets used, effectively resulting in a NULL dereference. [cfd60479]
2417 v14.4.2, 2013-09-21
2418 -------------------
2420 Many thanks to Paul Vojta.
2422 - On GNU/Linux there is no MAXPATHLEN constant defined by default, as
2423   this is a non-standard legacy constant.  Mozilla ran into this some
2424   time ago, though a bit different [1].  It made it easier for S-nail.
2426     [1] <https://bugzilla.mozilla.org/show_bug.cgi?id=412610>
2428   We could include `sys/limits.h' to get at MAXPATHLEN, there it is
2429   defined to be PATH_MAX, but let's just include the standard `limits.h'
2430   and ensure MAXPATHLEN ends up >= PATH_MAX.  With this condition being
2431   true even FORTIFYd sources won't bail with reported buffer overflows
2432   because realpath(3) expects a buffer of PATH_MAX bytes. [bee5e57c]
2433   (Paul Vojta)
2435 - With the builtin LINE_EDITOR, ensure proper interaction with GNU
2436   rlogind(8), which is alone in its quest to set the ISTRIP termios(4)
2437   flag. [61e00f2d]
2439 - Bugfix a codepath that would have prevented compilation when
2440   HAVE_ICONV is not set.
2441   While there, allow to unselect message attachments when using the `~@'
2442   tilde command interactively, which i mysteriously had forgotten when
2443   allowing selection of 'em.  (oops?) [4f58ffea]
2445 - It's now easier for packagers to get at debug-enabled CFLAGS; simply
2446   use WANT_ASSERTS=1 (should not be enabled in shipouts, please).
2447   [d8663406]
2449 - Fixed a terrible bug that i've introduced in november 2012, that would
2450   have corrupted MBOX files when using the `resend' command.  (The
2451   so-called "From_ line" would have been quoted to ">From_ line" instead
2452   of simply being stripped.) [19d449e2]
2454 - Fixed a SIGSEGV for the builtin LINE_EDITOR, that would have occurred
2455   if a history traversal (^B or ^F) would have been continued by
2456   a reverse history completion (^R).
2457   While there, avoid some multiple-beeps-in-a-row that yet occurred due
2458   to code reuse, and document that ^G etc. reset the multibyte state
2459   machine. [003d9f6f]
2461   Also, the expand-on-tab code could have excessed line input maximums,
2462   e.g., after `? /usr/bin/*<Tab>'.  This was of course known, but
2463   i wanted to keep it because all tested (modern) terminals "mess up but
2464   won't break", and thus made it possible to use the data, even if it's
2465   visual representation was messed up.  The real solution will be much,
2466   *much* more complicated, i.e., show possible *completions*, page-wise,
2467   etc., i.e., just like is known by tab *completion*.  This will need
2468   far more time because it doesn't make sense to embed such complicated
2469   code into the current bed.
2470   Now i've chosen to simply don't display excess, but replace the
2471   content with a message that says that there was excess.  It simply
2472   looks better. [0320c8ba]
2474 - I've changed the use of `[?]' as a replacement sequence for invalid
2475   / non-displayable characters to `?' (again).  There are still code
2476   paths (from the original codebase) which use the real Unicode
2477   replacement character instead, so our display is still not unique.
2478   On the long term the codepath can anticipate in all levels wether
2479   use of Unicode is possible, so that, then, we will be unique again,
2480   using either only `?' or the Unicode replacement character. [faf6380]
2482 - I've anticipated in v15.0 and implemented *quote-fold* as a stream
2483   filter.  It is now multibyte safe and takes into account the visual
2484   width of characters, i.e., ideographs etc.  It is working almost as
2485   good as an algorithm can work that looks at data linewise, but is yet
2486   experimental and incomplete in that it will break lines even if only
2487   whitespace or a backslash escape follows.  It is code that is only
2488   a few hours old, which is why it is not enabled by default. [
2490 v14.4.1, 2013-09-14
2491 -------------------
2493 How terrible.
2495 - Fix some harmless stylos and typos in the manual and `conf.rc'.
2496   [1a6b880, 417b066]
2498 - Ensure *complete* proper cleanup on signal-caused configuration run
2499   aborts. [7a08bda]
2501 - Bugfix: reenable empty configuration variable overrides, as in
2503     $ make install SID= NAIL=mailx ...
2504   [171861d]
2506 - Bugfix: rename the `conf.rc' variables SHELL, LISTER and PAGER because
2507   they clash with the POSIX standard variables of the same names, which
2508   hurts now that the configuration is run through the shell itself.
2509   The configuration names are now XSHELL, XLISTER and XPAGER (ouch).
2510   [ef93c4e]
2512 - nail.rc: comment out some non-portable S-nail(1) specifics, for those
2513   who install this file as mailx.rc or so, somewhere. [3f14b01]
2515 - From now on S-nail will use simple version tags, as, e.g., `14.4.1',
2516   i.e., no more `s-nail-14.4.1'. [a75437d, 183d59c] (Jürgen Daubert)
2518   Also move UAGENT out of `version.h' [f7be5be]
2520 Uh! v14.4 must have originated in a bad dream; good it's vanished.
2522 v14.4, 2013-09-13
2523 -----------------
2525 Thanks to the entire vivid and virile S-nail(1) user community is
2526 proper, especially Stephen Isard, Gavin Troy, Martin Neitzel.
2527 Not to forget Ryan Kavanagh and Ayan George.
2529 Note this time the changes are in reverse order, i.e., oldest first.
2531 Topic Branches
2532 ^^^^^^^^^^^^^^
2534 15fbe09 ^bf9173f 'topic/varmac-unite'
2535   Simplification and unification of variable and macro handling
2536 40f6f58 ^15fbe09 'topic/cledit1'
2537   Command line editor; new manual section `Line editor'
2538 ad28a32 ^40f6f58 'topic/termsize'
2539   Honour POSIX mailx(1) and respect $COLUMNS and $LINES on startup
2540 dc3cd49 ^a446fd8 'topic/qf'
2541   You don't wanna know
2542 b8738f7 ^0651fd0 'topic/spam1'
2543   Interaction with SpamAssassin; new manual section `Handling spam'
2544 5419d6f ^b8738f7 'topic/make1'
2545   Reworked build system; please read `INSTALL' and `conf.rc'
2546 9ab4d6b ^5419d6f 'topic/list1'
2547   Slightly tweaked message thread display, fix `:u :r' to mean it
2549 ChangeLog
2550 ^^^^^^^^^
2552 - The default PAGER is now more(1).  (But read on.)
2554 - The `echo' command is now compliant, and fully supports XSI.
2556 - The `group' and `ungroup' command aliases have been removed, they are
2557   `alias' and `unalias'.
2559 - We now have the capability of line editing and history.
2560   One may choose from not less than three different implementations:
2561   a builtin editor as well as possible linkage against BSD editline(3)
2562   and also a GNU readline(3) compatible layer.
2563   Please read the new manual section `Line editor'.
2565   Input is now compliant in that an interactive line may be continued
2566   after escaping the newline character with a backslash.
2567   [topic/cledit1]  (all of them)
2569   The *prompt* variable may now contain shell escapes, just like the
2570   `echo' command. [0938d8a]
2571   As a special extension the new \? escape, when used within *prompt*,
2572   will expand to the exit status of the last command. [41076d2]
2574 - The POSIX standard environment variables $COLUMNS and $LINES are now
2575   honoured upon startup. [topic/termsize]
2577 - The `help' / `?' commands now support abbreviation, i.e.,
2578   ``$ ? unc'' should now find `uncollapse'. [7b86195]
2580 - The `~' abbreviation that has been introduced as an alias for `call'
2581   is now a real command, not a magic shortcut. [9987289]
2583 - The new variable *quote-as-attachment* can be used to additionally
2584   embed the quoted message as a `message/rfc822' MIME attachment.
2585   [topic/qf]
2587 - The compose-mode command `~@' will now attach messages from the
2588   current mailbox if given a filename of the style `#NUMBER'.
2589   Please read the corresponding manual section `Tilde escapes', though.
2591 - The `WANT_JUNK' and `WANT_SCORE', as well as Gunnar Ritters junk mail
2592   management have been removed.
2594   Instead S-nail(1) can now support interaction with SpamAssassin, but
2595   sofar only via the spamc(1) / spamd(1) client / server pair of
2596   programs that ships as part of SpamAssassin.  The new configuration
2597   directive `WANT_SPAM' controls wether this feature is desired.
2599   Please read the new manual section `Handling spam'.
2600   [topic/spam1] (Martin Neitzel)
2602   (S-nail(1) is now *definitely* floating-point free.)
2604 - The configuration and make system have been overhauled / reorganized.
2605   The configuration is now in `conf.rc', also contains directives like
2606   `PREFIX' etc, and is always read in.  However, only those directives
2607   which are not yet set (via environment or command line overwrites) are
2608   incorporated into the set of configuration options.  Therefore
2610     $ make WANT_IMAP=0
2611     $ make WANT_IMAP=1
2613   will now build S-nail(1) twice, because of the changed configuration.
2615   Note that `WANT_GSSAPI' is now by default disabled, which shrunk
2616   a freshly started s-nail image by more than 30 percent.
2618   We're not finished yet in that there is no dependency graph etc.
2619   Please do read `INSTALL' and `conf.rc'.
2620   [topic/make1]
2622 - Message selection has been slightly bugfixed in that `:u :r' really
2623   means `:u' AND `:r'.  Compared to NetBSD Mail(1) it's still a shame.
2625   Threaded message display has been slightly changed in that within
2626   a thread identical Subject: lines are not repeated.  It may not be
2627   perfect yet due to the general list / thread state. [topic/list1]
2629 - If, upon startup, the environment variable `NAIL_NO_SYSTEM_RC' is set,
2630   then the system wide initialization file isn't read, just as if the
2631   `-n' option had been given. [1b31535]
2633 - It is now possible to use CTRL-C during connection hangs.  (But in
2634   general error recovery capabilities of the socket related
2635   infrastructure is non-existent, practically speaking.) [45a9f36]
2637 - *quote-fold* has been temporarily disabled, as it is not multibyte
2638   safe.
2640 No review for v14.4.  And today is Friday, the 13th.  Ouuuh!
2642 v14.3.2, 2013-06-21
2643 -------------------
2645 I should *maybe* should have and want to give prominence to
2646 Martin Neitzel for this, i maybe have misunderstood.
2648 - Bugfix *synchronous* *pipe-** execution..
2650   Well, unfortunately yet another newly introduced bug slept in
2651   S-nail v14.3[.1] -- [a8d724b3, Add @ and @& shell command prefixes
2652   for pipe-MIMETYPE, 2013-05-03] falsely changed the waiting state
2653   for subprocesses, as has shown up by a HTML-only mail on the
2654   Unicode list today.
2655   'Seems i'm collecting one line fixes in this codebase; this needs
2656   to change in the future.
2658 v14.3.1, 2013-06-08
2659 -------------------
2661 I want to give prominence to Juergen Daubert (jue AT jue DOT li), who
2662 reported that i've broken plain-old unfancy send mode in 14.3.
2664 + Ok, i'll hope we're out of new errors for the v14.3 series with that.
2666 - New variable: *batch-exit-on-error*.
2667   Only works if the new -# command line option has been given, and will
2668   check the "current" exit status whenever one operation completes
2669   (S-nail returns to the command prompt).
2670   If the exit status implies error (e.g., sending the last message
2671   failed) then we exit forcefully with that error status.  (The normal
2672   behaviour is that the status is reset when the command loop ticks.)
2673   [4cddd55]
2675 - While here again, i've added the new -# command line option.
2676   This is the first step to implement a reliable batch mode;
2677   unfortunately it still selects the users system mailbox on startup,
2678   because we simply cannot go to "no" mailbox for quite some time -- at
2679   some future time we will be able to go to some VOID thing, and then
2680   this will end up as a rather efficient batch mode.
2681   For now it sets *dot*, *emptystart*, *noheader* and *sendwait*, and
2682   also implies the -~ command line option.  [7549569]
2684     (
2685       printf "m ${MBOX}\n~s subject1\nE-Mail Körper 1\n.\n" &&
2686       printf "m ${MBOX}\n~s subject2\nEmail body 2\n.\n" &&
2687       echo x
2688     ) | MAILRC=/dev/null "${NAIL}" -n -#
2690 - Also, -N set *header* instead of *noheader*.  [7b4a13f6]
2691   (Juergen Daubert.)
2693 - Plain old unfancy invocations like
2695     $ s-nail user@host
2696     $ echo bla|s-nail ./FILE1
2698   had been broken (by [522cb3ec]).  [260e19d]
2699   (Juergen Daubert.)
2701 v14.3, 2013-06-03
2702 -----------------
2704 Thanks to Gavin Troy (gavtroy AT gmail DOT com) who inspired the @ and
2705 @& pipe-command prefixes.
2707 Random notes
2708 ^^^^^^^^^^^^
2710 - S-nail has been registered at Coverity Scan, and the third build
2711   (after topic branches *coverity-444* and *coverity-444.2*) produced no
2712   more errors.  (<http://scan2.coverity.com/projects/444>.)
2713   (Then i used POP3 and IMAP and fixed some SIGSEGV. ;)  Still didn't
2714   look at S/MIME, Maildir, caches etc... o()
2716 - S-nail v14.3 doesn't produce any spurious linker warnings on
2717   OpenBSD 5.3; all (correct!) use cases of strcpy() and strcat() have
2718   been replaced.  [7bdf330, 2c8d7cb]
2720 - This is the first release with a (though very short) review -- i'm
2721   slowly getting comfortable with the code.  (But i'm too stupid to
2722   perform reviews on patches, 'always did reviews on C++/Perl/xy
2723   classes.  Aaah, how beautiful ... objects.)
2725 ChangeLog
2726 ^^^^^^^^^
2728 - It is now possible to "call" macros without using the `call' command
2729   by prefixing them with a tilde, as in
2731     ? define au {
2732       echo auau
2733     }
2734     ? ~au
2735     auau
2736   [93ea8acd]
2738 - Added the *pop3-bulk-load* option.
2739   Yes, there are mailing lists etc. which use plain text email, and,
2740   there, headers are often more data than the body, so it doesn't make
2741   sense to download the headers twice (unfortunately POP3 doesn't
2742   support a BODY command; if only it would support a RETRDELE command..)
2743   [978e13a7]
2745   And yep, from this changeset on i personally use S-nail even over the
2746   network, no longer my stale and incomplete S-Postman.  And i can tell
2747   you, this damn thing is so silent, i always set *verbose* not to go
2748   grazy ... but .. i hate to say it .. the healing will take time.
2750 - POP3 will now try to use APOP authentication automatically; thus the
2751   *use-apop* stuff has been replaced by *pop3-no-apop* options (just in
2752   case there are POP3 servers which advertise they support APOP but in
2753   fact fail to do so; anyone?)  [6c3c5575]
2755 - Some IMAP segmentation violations have been fixed:
2757     ? fi imaps://user1@localhost
2758     Password:Interrupt            <- CNTRL-C
2759     ? set imap-auth=cram-md5      <- hey, 'forgot to set correct auth
2760     ? fi imaps://user1@localhost
2761     IMAP write error: error:140D00CF:SSL routines:SSL_write:protocol is shutdown
2762     Segmentation fault
2764   And also, when *folder* was set to an IMAP account but hasn't been
2765   opened yet, and no IMAP account ever has been opened, a string
2766   comparison against a NULL pointer yet caused a SIGSEGV, too.
2767   [417c01f, 413c23d9]
2769 - `set folder=' now tolerates `%:' and expands PROTOs stuff etc.:
2771     ? short xp %:imaps://user1@localhost
2772     ? set folder=xp
2774   Pure convenience so that it doesn't need to be typed twice (still no
2775   completion in sight...).  Note that setting *folder* to a POP3 box
2776   will now be actively rejected.  [b12b17f5]
2778   NOTE: while implementing this i've detected another dead-end
2779   miscondition in S-nail -- you really should ensure that your target
2780   folder/box is connected before you leave your current POP3/network
2781   based folder, if there is data to be moved to the target (i.e.,
2782   mbox).  This problem will persist for a long time due to the way the
2783   entire codebase functions; i hope i can find a short/mid-term
2784   solution, but the real healing will take years.  The mentioned
2785   solution would at least make S-nail interruptable, currently we get
2786   stuck and interrupts are blocked...
2788 - If you're using S-nail on Mac OS X and have seen some segmentation
2789   faults when expanding shell stuff then you may be pleased to hear that
2790   S-nail now works around an Apple bug.  [63273772]
2792 - The builtin mime.types have been corrected and a lot of new ones have
2793   been added.  New data from
2794   <http://svn.apache.org/viewvc/tika/trunk/tika-core/src/main/resources/\
2795   org/apache/tika/mime/tika-mimetypes.xml>, thanks!  [8072fcb6]
2797 - BEWARE: handling of command line arguments has changed a bit!
2799   1. The -D, -d, -E, -i, -N and -v command line options are now
2800   implemented by means of setting the respective option, as via -S.
2801   (This means that from now on resource files can only *temporarily*
2802   overwrite command line arguments.)
2804   2. The -I and -T command line arguments have been dropped.
2805   It seems Gunnar Ritter stopped developing nail/Heirloom mailx once he
2806   started implementing Newsreader functionality.  It'll take a long time
2807   until we get there, so for now drop all the Newsreader stuff.
2809   3. Handling of -r has been changed.  E.g.:
2811     s-nail -A test -Snoeditalong -r 'La mort est <fem@me>' -d
2812     ? set from=bummer@m1.com
2813     ? m t1
2814     Subject: s1
2815     .
2816     Sendmail arguments: "sendmail" "-i" "-r" "fem@me" "t1"
2817     ? set from=bummer@m2.com
2818     ? m t2
2819     Subject: s2
2820     Sendmail arguments: "sendmail" "-i" "-r" "fem@me" "t2"
2822   ...
2824     s-nail -A test -Snoeditalong -r '' -d
2825     ? set from=bummer@m1.com
2826     ? m t1
2827     Subject: s1
2828     .
2829     Sendmail arguments: "sendmail" "-i" "-r" "bummer@m1.com" "t1"
2830     ? set from=bummer@m2.com
2831     ? m t2
2832     Subject: s2
2833     Sendmail arguments: "sendmail" "-i" "-r" "bummer@m2.com" "t2"
2835   [*main-fun-cleanup* topic branch]
2837 - *smime-sign-include-certs-** stuff works again, oops..  [9a8597c6]
2839 - A whole lot of smallest and small fixes due to registration at
2840   Coverity Scan, as project 444.  Error handling in S-nail is ridiculous.
2841   [*coverity-444* and *coverity-444.2* topic branches.  The sheer number
2842   of fixes was the reason to sit down and go for unplanned S-nail v14.3]
2844 - *idna-strict-checks* has been dropped.  It's silly to have in a MUA,
2845   especially given that GNU LibIDN doesn't ship with a lot of rules.
2846   We were able to drop quite some code (and a use-after-free, too :().
2847   [c81fd41d]
2849 - The ~p tilde command displays attachments more verbose.
2850   Until the big big MIME and send layer rewrite :) this is intermediate
2851   since until then we do not really know neither MIME type nor charset
2852   of an attachment at the time this is displayed (for sure).  Yet
2853   i think it's nicer to show what we have than keep it the way it was.
2854   [60e70463]
2856 - @ and @& shell command prefixes have been added for the pipe-MIMETYPE
2857   mechanism.  The former suppresses filters if multiple messages are
2858   displayed at once, the latter adds asynchronous program execution on
2859   top of that.  E.g., to display PDF documents, but only if you
2860   *explicitly* address the message *alone and by itself*, and without
2861   blocking S-nail and the $PAGER, do:
2863     set pipe-application/pdf="@&cat >"${TMPDIR}"/s-nail${$}.pdf;\
2864       mupdf "${TMPDIR}"/s-nail${$}.pdf; rm "${TMPDIR}"/s-nail${$}.pdf"
2866   (Inspired by Gavin Troy.)  [a8d724b3]
2868   Note: most of that had been posted to nail-devel@ already, but it was
2869   tweaked ([251b636]) so that you now *really* have to say `p MSGNO' to
2870   get there.
2872 - The NETLESS CONFIG= has been removed; it is almost identical to
2873   MINIMAL now (i.e., without WANT_JUNK and WANT_SCORE).
2875 - WANT_JUNK and WANT_SCORE have been disabled by default.
2876   They don't seem to be too useful; i hope i can implement
2877   a SpamAssassin hook for (downloaded) mail messages for v14.4.
2878   If so, expect these two "modules" to become removed completely.
2880 v14.2.2, 2013-05-01
2881 -------------------
2883 Another unplanned (minor) bugfix release after Gavin Troy (gavtroy AT
2884 gmail DOT com) pointed out that MIME CTE decoding was broken, who
2885 i therefore want to give a lot of prominence right here.
2887 - Fix MIME content decoding which has been broken by [01c0e135].
2888   [882caedd]
2889   (Gavin Troy.)
2891 v14.2.1, 2013-04-30
2892 -------------------
2894 An unplanned (minor) bugfix release after i've found two bugs today and
2895 heard from Jérémie Courrèges-Anglas (jca+nail AT wxcvbn DOT org) that
2896 there exists a S-nail OpenBSD package.
2898 I want to give prominence to the following people that helped to
2899 improve S-nail(1) during this development cycle, in order of
2900 appearance: Dirk Peters (peters AT schwertfisch DOT de).
2902 Thank you very much, and best from Germany!
2904 - Some warnings of newer clang(1) versions were silenced, including yet
2905   another alloca(3) problem (see *memtracer* topic branch in v14.0
2906   series).  [6f846efe]
2908 - Tweaking the MIME boundary detection left a little hole that could
2909   cause boundaries not to be detected, as has been shown by a Microsoft
2910   Word generated mail on the ICU list.  [11e5fb5b]
2912 - A format string could overflow bounds if unrealistic
2913   (18446744073709551615) line numbers or message sizes would have been
2914   produced.  [faa65c40]
2916 - An algorithmic error could cause overlong lines which wrapped around
2917   to the next display line.  [ade52660]
2918   (Dirk Peters.)
2920 v14.2, 2013-03-15 [v14.1, 2013-03-12]
2921 -------------------------------------
2923 I want to give prominence to the following people that helped to
2924 improve S-nail(1) during this development cycle, in order of
2925 appearance: Martin Neitzel, Christos Zoulas, Stephen Isard, jgw@txo.org
2926 and Gavin Troy.
2928 Thank you very much, and best from Germany!
2930 + v14.2 differs from v14.1 only by one commit, one that fixes
2931   (mime_fromhdr(): partial rewrite using n_iconv_str(), 2013-03-12),
2932   which i hastily implemented just hours before the release of v14.1,
2933   and simply shouldn't have made it (into there).
2934   The v14.1 tarball has been removed from the server.
2936 - A fix for the quoted-printable codec: "message truncation" occurred
2937   when a mail maliciously used a soft linebreak to escape the linebreak
2938   of a completely empty line.
2939   (That resulted in 0 written and 0 leftover bytes, a condition that was
2940   declared erroneous back in november 2012 when i started handling I/O
2941   errors.)
2943 - The "folders" command will work again when given an argument.
2944   A fault of mine introduced in (cmd1.c: expand() may fail, 2012-10-23).
2946 - The Base64 codec has been touched again, and we are finally capable to
2947   perform sequential decoding; this was targeted for the MIME/send layer
2948   rewrite, but it actually was possible today.
2949   The result as seen in ps(1), running on the Base64 encoded HTML5
2950   standard (4622545 bytes HTML, with a NUL appended to force Base64
2951   encoding, resulting in a 6244793 bytes email):
2953    7420 s006  S+    2:22pm 0:10.65 plain-nail -f HTML5
2954    1440 s006  S+    2:23pm 0:00.36 ./s-nail -f HTML5
2956   (So the only thing that is left for a good throughput is sequential
2957   decoding of quoted-printable encoded parts that maliciously use soft
2958   linebreaks to convert an entire part to a single line.  And i've seen
2959   that from Apple Mail.)
2961 - New option: *mime-allow-text-controls* (rather long manual entry).
2963 - *smtp-auth-password-user@host* and *smtp-auth-user-user@host* will
2964   finally work!
2965   (Reported by jgw@txo.org in November 2011, fixed by Gavin Troy in
2966   January 2012.)
2968 - Most *headline* formats now do support the '-' left-alignment flag.
2969   Note that you most likely have to change your *headline* accordingly.
2970   (The still missing %n format is one reason why there will be v14.2.)
2972 - *datefield* and *datefield-markout-older* can now be set to
2973   strftime(3) format strings (except %n).
2974   (From Stephen Isard's wishlist.)
2976 - A possible SEGV has been found and also fixed by Stephen Isard.
2977   (The "legendary" cross-world stereo fix!)
2979 - Wow!  S-nail will finally compile on GNU based Linux systems like
2980   Slackware 14 etc.  (Found while hunting bug reported by
2981   Stephen Isard.)
2983 - New option: *datefield-markout-older* can be used to choose
2984   a different date display for mails that are older than six months,
2985   in equal spirit to what POSIX describes for the -l option of the ls(1)
2986   command (Stephen Isard).
2988 - (Exotic) Years are (would) now (be) interpreted correctly according to
2989   RFC 5322, 4.3.
2991 - CRAM-MD5 usage has been fixed.
2993 - *folder* updates are now tracked when set, and we will show the
2994   realpath(3) name of it, showing PREFIX..SUFFIX if that wouldn't fit on
2995   the display.
2996   Tracking updates made it also possible to perform other more expensive
2997   tasks when setting *folder*, so that it is now possible to do
2998   something like:
3000     :set folder=$HOME
3001     :set folder=~
3003   et cetera (both ideas by Christos Zoulas).
3005 - Bugfix for the ~@ tilde-escape in non-interactive mode.
3006   (readtty(): quick shot: work in pipelines (on non-TTY).., 2013-01-25)
3007   introduced the possibility to "read data from the terminal" (STDIN
3008   that is) in non-interactive mode.
3009   The manual documents that attachment input must be terminated with an
3010   empty line, but if that had been omitted, as in the example below, we
3011   would have yet entered an endless loop.
3013      $ cat <<_EOT | /s-nail -~ -s boom ./OUT
3014     ~@
3015     test.c
3016     charset
3017     _EOT
3019 - Alias expansion will now be performed for members of Reply-To: fields
3020   (Martin Neitzel).
3022 - Decoding quoted-printable will now be more relaxed.
3023   (Even though the standard says that users should be given a hint when
3024   input is not absolutely clean; a possible warning will be added later,
3025   when we have an error message ring.)
3027 - New option: *mimetypes-load-control* can be used to control which of
3028   the mime.types resources will be loaded.
3030 - The builtin default mime.types have been extended a bit.
3032 v14.0, 2013-02-10
3033 -----------------
3035 I want to give prominence to the following people that helped to
3036 improve S-nail(1) during this development cycle, in order of
3037 appearance: John Dodson, Gianluca Ramunno, and Anon Ymous from the
3038 NetBSD project.
3040 Random notes
3041 ^^^^^^^^^^^^
3043 - Encoding defaults to *quoted-printable* not *8bit*.
3044   This has no technical background except that i think it's the better
3045   default.
3047 - Small progress for the "getting stuck due to the current folder
3048   becomes inaccessible due to whatever reasons"  problem.
3049   (schdir(): realpath() local files before leaving CWD.., 2013-01-08)
3051 - The names of temporary files have changed.  Whereas not all uses of
3052   temporary files already use really meaningful names, it has yet become
3053   possible to use the pattern "*mail-*"; or, to be compatible with
3054   NetBSD Mail(1) in one go, "*mail*".  (E.g., in my ~/.vimrc you'd read:
3055     :au   BufRead,BufNewFile *mutt*,*mail* setl fenc= | setf mail
3056   [the *mutt* is a leftover from times when i've used MUAs that suck].)
3058 ChangeLog
3059 ^^^^^^^^^
3061 - The Quoted-Printable MIME handling has been rewritten completely.
3062   We now correctly encode files with the MS-DOS newline sequence (CRLF).
3063   (Part of the *mime-cte* topic branch.)
3065   S-nail(1) continues to be able to handle text messages and text
3066   attachments without a trailing newline, but because these
3067   Content-Transfer-Encoding related things are now handled by the C-T-E
3068   layer instead of by sendout.c a text message body that comes in as
3069   part of a complete message via the -t command line option will loose
3070   the missing final newline (i.e., it'll gain one).
3071   This problem does *not* occur when *only* the message body comes in
3072   via STDIN, as in 'cat FILE | s-nail', but *only* when the -t option is
3073   used.
3074   (sendout.c: does no(t/ longer) know about CTE internals!, 2013-02-09)
3076 - Filename arguments for -a are now processed *after* all the resource
3077   files have been loaded etc., so that the usual "folder" specifics can
3078   be used (provided that proper care for shell quoting was taken).
3079   ((main(): delay -a processing.., 2013-01-10), as a part of the
3080   *mainaflags* topic branch.)
3082 - (d38c5bd, When the write command asks.., 2004-11-23) added support
3083   for pipes when saving attachments during a "write" command.
3084   It however used the wrong SIGPIPE signal handler; e.g.:
3086     Enter filename for part 2 (application/x-gzip): |exit
3087     Segmentation fault
3089   Of course, it still performs a jump and that most likely leaves memory
3090   chunks behind, thus causing some memory leaks.  This will be
3091   a long-term problem (you may want to read [mime.c:fwrite_td(): TODO
3092   notes on unfixable leaks, 2013-01-14] for more).
3093   (send.c:sendpart(): fix longjmp() SIGSEGV.., 2013-01-29)
3095 - Fixed a name quoting regression that i've introduced in
3096   (Rewrite *extract().., 2012-10-20), that would have caused
3097   "x \"y\" z" to become "x"y" z" instead of "x "y" z".
3098   (S-nail still does not really have RFC compliant parsers, just as
3099   NetBSD Mail(1) has, i.e., there are structured and unstructured fields
3100   etc...  I hope i can provide them in v15.0.)
3101   (names.c:yankname(): fix quote regression.., 2013-01-29)
3103 - The IDNA conversion now assumes domain names are specified in
3104   *ttycharset*, rather than in the LC_CTYPE locale charset.
3105   I.e., it integrates into the usual character set specifications.
3106   (IDNA: honour *ttycharset* for domain names, 2013-01-18)
3108 - The new *editalong* variable will automatically spawn an editor when
3109   composing a mail in interactive mode, just as if `~e' was given.
3110   (Add new *editalong* variable, 2012-01-07)
3112 - The manual has been converted to mdoc.
3113   (The manual has been converted to mdoc, 2012-12-28)
3115 - The ~@ tilde escape, when given filename arguments, will treat the
3116   arguments as a comma-separated instead of a whitespace-separated list.
3117   (collect: change separator of ~@ tilde escape.., 2012-12-28)
3119   The interactive mode of ~@ has also been changed, rather massively.
3120   Please do reread what the manual says.
3121   ((collect: support multiple attachment charsets.., 2013-01-23), as
3122   part of the *attach* topic branch.)
3124 - Thanks to Gianluca Ramunno (ramunno DOT gianluca AT gmail DOT com)
3125   S-Nail will no longer try to issue a STARTTLS command when it is about
3126   to establish a SMTPS connection, a task that logically fails since the
3127   connection is already secured.
3128   (Interestingly the nail codebase performs the necessary test for IMAP
3129   and POP3 already.)
3130   While here the undocumented nail v11.0 *smtp-use-tls* legacy option
3131   has been removed.
3132   (Fix SMPTS with a set *smtp-use-starttls*.., 2012-12-22)
3134 - The RFC 4155 compliant MBOX quoting is now exclusively used, the
3135   shitty *posix-mbox* variable has been removed again.
3136   (Shitty because i've implemented RFC 4155 compliant MBOX quoting and
3137   tested it, then added *posix-mbox* for those who liked the old
3138   behaviour and did not re-test -- the final code path was buggy.)
3140   In mails newly created and saved by S-nail(1) no From_ quoting at all
3141   will be used no more, but instead the rewritten MIME file classifier
3142   will detect unquoted From_ lines and enforce quoted-printable encoding.
3143   (This is an approach that is S/MIME compatible all through the way as
3144   the file data is not modified at all, but only encoded, so that the
3145   data checksum is not changed.)
3147   In yet existent mails that S-nail copies or moves around without
3148   reclassification an RFC 4155 compliant From_ line detector will apply
3149   MBOXO quoting (prepend a single '>') as necessary.
3150   Different to the old MBOXRD behaviour S-nail will neither quote yet
3151   quoted From_ lines ('>>From xy' -> '>>>From xy') nor will it unquote
3152   one quote level when reading etc. mails ('>> From xy' -> '>From xy').
3153   As a result the code could be simplified.
3155   This changeset also incorporates a fix for NetBSD PR bin/47453, as
3156   reported by Martin Brandenburg.  I.e., some mailers, noticeably
3157   UW-imap (with MBX format only?), use non-compliant From_ lines with
3158   RFC 822 date specifications.  Be aware of 'em.
3159   (RFC 4155 MBOX, and drop *posix-mbox* and foldergets().., 2013-01-06)
3161 - *rfc822-show-all* has been removed.
3162   It didn't work properly for more complex MIME structures, like
3163   message/rfc822 messages with attachments etc., just as i've seen today
3164   on the file(1) mailing list.
3165   So, instead of hacking it now i've dropped it and will come back with
3166   a better solution when the MIME and send layers have been overhauled.
3167   I.e., the real intent was to be able to specify that an embedded
3168   message/rfc822 is treated as a *unity*, and that's the goal.
3169   (Drop *rfc822-show-all*, 2013-01-23)
3170   [The manual will be adjusted in a different commit.]
3172 - *rfc822-no-body-from_* has been renamed to *rfc822-body-from_*.
3173   It thus must be set explicitly.
3174   On the other hand it now catches all cases...
3175   (*rfc822-no-body-from_* -> *rfc822-body-from_*, 2013-01-23)
3176   [The manual will be adjusted in a different commit.]
3178 - The new *charset-7bit* (defaults to US-ASCII) and *charset-8bit*
3179   (defaults to UTF-8) have been introduced.
3180   These are used if seven bit clean data is to be sent, and no
3181   *sendcharsets* are set or the convertion of all of them failed,
3182   respectively:
3184   - There is no functional change unless there is iconv(3) support.
3185   - There is no functional change unless you set them.
3186   (Introduce *charset-8bit* and *charset-7bit* variables.., 2013-01-18)
3187   [The manual will be adjusted in a different commit.]
3189   In addition the new *sendcharsets-else-ttycharset* variable can now
3190   be used to automatically use *ttycharset* as a *sendcharset(s)*,
3191   regardless of the new *charset-8bit* variable.
3192   (Add *sendcharsets-else-ttycharset* variable, 2013-01-24)
3193   [The manual will be adjusted in a different commit.]
3195   NOTE: before we apply charset conversion we now perform a string
3196   comparison to see wether character sets are identical.  If the strings
3197   match (case-insensitively), then *no* conversion is performed.
3198   This means that code like
3200     $ printf "LATIN1: \0376" | s-nail -Ssendcharsets= -s boom ./out.txt
3202   *succeeds* in an UTF-8 environment now, whereas older versions would
3203   fail with an "illegal byte sequence" error (unless the iconv(3)
3204   library of the system would not perform any conversion that seems
3205   superflous, of course).
3207   I thought about making this optional, but, in fact, if this would be
3208   done in an environment without iconv(3) support then the result would
3209   be equally corrupt.  And the way it is now we save the expensive and
3210   superflous conversions.  (See TODO for more.)
3212   Please *do* reread the manual section "Character sets".
3213   +++++++++++++++++++++++++++++++++++++++++++++++++++++++
3215 - An attempt was made to improve MIME Content-XY: detection.
3216   It should be more RFC compliant, and just overall better :);
3217   a simple one-pass classifier cannot match libmagic(3), of course.
3219   This changeset removes support of the long obsoleted (4fee1ef,
3220   2005-01-06) *charset* variable, as well as for the
3221   *maximum-unencoded-line-length* variable that has been introduced in
3222   (48a652bd, 2005-07-26).
3224   For S-nail v14.0 it'll be no longer necessary to do
3226     $ tr -d '\015' < input | s-nail ...
3228   to transport files which use the $-DOS (terminal) newline (sequence).
3229   We still depend upon *sendcharsets* for a while, though.
3230   (Rewrite file-content classification.., 2013-01-02)
3232 - The new *mime-counter-evidence* variable can be used to force
3233   a classification of non-text MIME parts (attachments) by their
3234   filename, i.e., a "reverse-classification" just as would be performed
3235   if S-nail(1) would itself *send* the file(name).  This can help
3236   against some stupid MUAs (Apple Mail?) that send .diff etc. files as
3237   `application/octet-stream' parts etc.
3239   At a later time this may become a valued option, causing a temporary
3240   save of unnamed attachments followed by a MIME classification of the
3241   file contents, followed by forced treatment as plain text if it seems
3242   to be human readable.  But not yet.  Just to warn you.
3243   (Add *mime-counter-evidence* variable.., 2012-12-29)
3245 - The special "pipe-" command "@" can be used to force treatment of
3246   a MIME message part as plain text (e.g.,
3247   'set pipe-application/pgp-signature=@' will henceforth print those
3248   signatures inline and as plain text).
3249   (Introduce the special "@" "pipe-" command, 2012-12-27)
3251 - The MIME types (as from mime.types(5)) will now be cached.  Before
3252   all possible sources would have been opened, read and parsed for each
3253   and every message part that required detection of the MIME
3254   Content-Type:.
3255   The new "mimetypes" command can be used to show or clear that cache.
3256   (Add mime.types(5) cache.., 2012-12-27)
3258 - A small set of MIME types (template: ./mime.types) will now become
3259   compiled into S-nail(1), and be used as a fallback if there are no
3260   ~/.mime.types and/or no /etc/mime.types, or those didn't contain
3261   a matching type.  E.g., NetBSD 6 doesn't ship a default database.
3262   Also, file extensions will be matched case-insensitively (case of
3263   attribute values is not specified afaik?).
3264   (Introduce compiled-in mime.types(5).., 2012-12-21)
3266 - The undocumented *charset7* variable was removed.
3268 - The "Message X:" display leader has been changed and will henceforth
3269   be matchable via "^[-- Message \d+ -- \d+ lines, \d+ bytes --]:$".
3270   These lines can no longer be suppressed by setting the *quiet*
3271   option (which was yet possible for print and top, though undocumented).
3272   (Change "Message X:" display message.., 2012-12-20)
3274 - When displaying multipart messages the "Part X:" introductional string
3275   has been changed; if the Content-type: header is not *retain*ed, then
3276   this string will include the part's type and size.  Ditto for
3277   Content-disposition: and a mentioned attachment filename.
3278   This is a first step only, for the final version the MIME and send
3279   layers will have to be adjusted.  But the string will be matchable via
3280   a "^[-- #.* --]$" regular expression from now on.
3281   (Change "Part X:" display message.., 2012-12-20)
3283 - MIME boundaries in multipart messages are now handled better in that
3284   no boundary string should get through to the display.
3285  (Tweak MIME boundary detection.., 2012-12-20)
3287 - A couple of long standing, even pre-Heirloom mailx(1) memory leaks and
3288   segmentation violations, most of them related to configurations
3289   without alloca(3) support, as well as one leak that i have introduced
3290   when i implemented RFC 4155 MBOX handling, have been fixed.
3291   But S-nail should now survive non-alloca(3) configurations.
3292   (*memtracer* topic branch.)
3294 - The Base64 MIME handling has been rewritten completely.
3295   This was an urgent topic, because the old implementation (a) read in
3296   all lines of a base64 encoded text part, repeatedly resizing a string
3297   storage and repeatedly decoding that string until all the lines have
3298   been swallowed (i.e., or by accident the last decoded byte was
3299   a newline character, and that in turn may of course have fucked up for
3300   multi-octet encodings, dependent on the actual byte-order), (b) used
3301   function local static data to keep state in between multiple
3302   invocations, which messed up multi-byte/-octet encodings like this
3304     �5��ɽ���Aɥ����́��٥��������[lots of data follows]
3306   and (c) did not perform any error checking at all.
3307   The new one does not run into the problem that (a) tried to circumvent
3308   since leftover decoded data (as opposed to leftover *encoded* data) is
3309   transported along the call-chain for later use.  It adds a minimal set
3310   of error handling ('may now see "[Invalid Base64 encoding ignored]"),
3311   with more to become possible in later S-nail versions when the entire
3312   layers are reworked.  (Until then DOS newline sequences [CRLF]
3313   embedded into base64 will no longer be decoded to Unix LF newlines.)
3314   Base64 encoded lines will now be 76 characters long, as stated (as
3315   a maximum value) in RFC 2045, not 72 as before.
3317   The Base64 code core has been shamelessly stolen from NetBSD's
3318   Mail(1), and i guess it was the second time that this happened :=).
3319   (*base64-rewrite* topic branch; and reworked later on the *mime-cte*
3320   topic branch.)
3322 - The string allocation strategy has been tweaked some more to, i think,
3323   a final version (regarding algorithm).
3324   In normal non-interactive send mode it should now no longer need any
3325   dynamic memory at all (unless some dozen recipients are specified).
3326   (Several other places still use normal dynamic memory, of course.)
3327   (*dope-stringdope-again* topic branch.)
3329 - Support for NSS (Network Security Services) has been removed.
3330   I've never worked with it and are, regarding the complexity of
3331   network security, not willing to spend any time on it.
3332   SSL is installed on all systems i'm using and/or testing on by
3333   default, and so i've choosen to go this way.
3334   (It may be that sometime in the future S-nail will add support for
3335   libcurl(3) connectivity, and then it may happen that not only NSS
3336   support is reintroduced again, but also GNU TLS.  All of that applies
3337   to network connectivity only, however, not to S/MIME afaik.)
3338   (*drop-nss-support* topic branch.)
3340 - I finally got a glue and understood that Sourceforge does (a) not
3341   support symbolic links and (b) doesn't like dots as regular parts of
3342   filenames.  This means that all this time the promised s-nail.tar.gz
3343   symbolic link did not work, and that s-nailv13.3.tar.gz wasn't
3344   accessible either (via the web interface).
3345   In the future S-nail(1) will not provide any more symbolic links (the
3346   Sourceforge website offers a "download latest" thing which seems to
3347   work), and use underscores in filenames -- s-nailv13.3.tar.gz has been
3348   renamed to s-nailv13_3.tar.gz.  The tags continue to use dot notation.
3349   Thanks.
3351 - The *heirloom-plus* support branch has been removed.
3352   The code bases diverged a lot and even more to come.
3353   It doesn't make sense to put any effort in that.
3355 v13.3, 2012-11-11
3356 -----------------
3358 - Configuration on UnixWare 7.1.4 will succeed (shell issue fixed).
3360 - Even on DragonFly BSD the IMAP GSSAPI is now found
3361   (in /usr/pkg/include/krb5/gssapi/gssapi.h).
3363 - Support for pkgsrc(7) systems and automatic integration of
3364   C_INCLUDE_PATH and LD_LIBRARY_PATH path configurations.
3365   Please see INSTALL.
3367 - Fixes a mortally embarassing regression that the current maintainer
3368   introduced before i really knew what i was doing, in (If *record* is
3369   set, avoid writing dead content twice.., 2012-09-14).
3370   It hit users that send through a MTA and have *record* set; in this
3371   combination data would not have reached the MTA.
3372   Interested parties may read the comment in savedeadletter() (part of
3373   the changeset) or the (Fix MTA/*record* descriptor clash..,
3374   2012-11-10) commit log.
3376   Deepest apologies to tortured users from the current maintainer!
3378 - RFC 4155 compatible MBOX file handling has been introduced, and so
3379   S-nail is now on par with (at least) NetBSD Mail in respect to this.
3380   It can be turned off with the new *posix-mbox* variable, which you may
3381   need to use since not all MUAs are capable to dig those MBOX files.
3382   E.g., less cutting-edge (.-) MUAs fail for this:
3384    |From - Thu May 10 20:40:54 2012
3385    |Date: Wed, 07 Nov 2012 11:48:30 +0100
3386    |To: super@duper.com
3387    |Subject: super1
3388    |
3389    |From me.
3390    |
3391    |From - Thu May 10 20:40:54 2012
3392    |Date: Wed, 07 Nov 2012 11:48:30 +0100
3393    |To: super@duper.com
3394    |Subject: super2
3395    |
3396    |>From - Thu May 10 20:40:54 2012
3397    |From - Thu May 10 20:40:54 2012
3399   I'm not completely happy since S-nail *does* still quote those lines,
3400   how rare they may be -- it *does* modify message content.  mutt(1)
3401   implements something more clever and that is quoted-printable encoding
3402   of the "F" from "From", when seen at the beginning of a line.
3403   This, when applied to just *any* "^From", will be a non-modifying and
3404   all-compatible solution.
3406 - SEND_MBOX handling has been changed to discard any Content-Length: and
3407   Lines: headers when it rewrites a message by default.
3408   I know that mutt(1) generates them (why, after
3409   http://www.jwz.org/doc/content-length.html?).
3410   Anyway, S-nail does neither use nor manage them, so that any
3411   modification renders those fields invalid, and then it seems best to
3412   discard them anyway.
3413   You may turn the new behaviour off with *keep-content-length*.
3415 v13.2, 2012-11-03
3416 -----------------
3418 The problem was that i really wanted to release on a 25th.
3419 But i have been able to improve S-nail(1) some more, so that this is
3420 possibly the first real release of it.  So i'll add only things that
3421 have changed since v13 -- please see below for the complete picture.
3423 - A new CONFIG=CUSTOM make directive was added, and the new user.conf
3424   variables WANT_SCORE and WANT_DOCSTRINGS have been added.  It is
3425   possible to create a floating-point free S-nail(1) now.
3426   Please see INSTALL.
3428 - If a feature is disabled not even functions stubs should remain now.
3430 - Many places which will work only with local filenames do now actually
3431   check that the target is a local filename.
3433 - Space-separated lists should work again, at a few places at least.
3435 - Tilde commands will be possible, even with -r.
3437 - The *sendmail-progname* has been added after NetBSD 6 dropped the
3438   send-mail entry in mailer.conf(5), which broke S-nail(1).  Now users
3439   have an option.
3441 - When editing messages via ~e or ~v file and pipe addressees will no
3442   longer be lost.
3444 - If recipients occur multiple times spread over lists, i.e., To:, Cc:,
3445   Bcc:, then only one occurrence remains, and in the "highest-order"
3446   list.
3448 - The "list" command prints the list alphabetically sorted (somewhat).
3450 - The "help" and "?" commands take an optional argument that shows
3451   a synopsis string for the given command (unless WANT_DOCSTRINGS was
3452   false).
3454 - String allocations are now more efficient.  The situation can still be
3455   improved.  However, for the first time Berkeley Mail(1) integrates
3456   harmonically into the system allocator, which may madvise(2) unused
3457   memory to the operating system as necessary and/or possible!
3459 v13.1, 2012-10-25
3460 -----------------
3462 Well, a version number 13 is anyway an ugly thing...
3464   commit 4f534bb33b7c911272cc66a0e3a9e47b73ad8deb
3465   Date:   2012-10-25 20:46:07 +0200
3467       FIX MIME quoted-printable encoding (char cast)..
3469       (;-{
3470       Auauauauau!!
3472       Well, one of the things that have already been started in v13 is
3473       the turn from using "int" when working with 8-bit characters to
3474       "unsigned char" (and as long as we do not support wide
3475       characters).
3477       Unfortunately one very important piece of code, that is handling
3478       encoding to quoted-printable, still used integer instead of
3479       unsigned char, which caused an automatic extension cast to take
3480       place, and that resulted in a messed up output.
3481       Sorry!
3483 v13, 2012-10-25
3484 ---------------
3486 I want to give prominence to the following people that helped to improve
3487 S-nail(1) during this development cycle, in order of appearance: Martin
3488 Neitzel, Ezequiel Garzón, Björn Persson, Paul Vojta, and, especially,
3489 John Dodson for warm words from beautiful Australia!  Many thanks also
3490 to Christos Zoulas.
3492 After i've officially forked nail(1) aka Heirloom mailx(1) as S-nail(1)
3493 on 2012-09-18 i have been able to work five weeks almost fulltime on
3494 S-nail(1) development.  The first three weeks can be characterized as
3495 hectic fireworks here and there, but then it got better and i was able
3496 to work more or less topic-centric.  In the meanwhile S-nail(1) is more
3497 than 230 commits away from the Heirloom base--and drifting further apart.
3499 S-nail(1) v13 is the first release of S-nail(1), but it was forked from
3500 Heirloom mailx(1) 12.5 7/5/10 that arose from Berkeley Mail 8. unless
3501 i'm mistaken.  What characterizes S-nail(1) v13?
3503 - The build system has been reworked almost completely.
3504   It is possible to fine-tune which features should be present in the
3505   binary and which don't.  The name of the binary can be chosen, and
3506   that choice is reflected all through the manual and the template
3507   resource file.  The manual is always complete and thus may document
3508   features that are not supported by the actual binary, though.
3509   Please see INSTALL for more.
3511 - Compiler warnings can now be used.  Please see the example WARN= flags
3512   in the Makefile, but '-Wall -Wextra -pedantic' should be silent though
3513   certainly insufficient to reflect the complex work of modern compilers.
3515 - The following recipient address list combines some of the major
3516   improvements that have been made:
3518     <addr1@cdröm.de>  (bier) , ./file1,
3519     Steffen Smöregäs (Humbabä) <sauer@bäüer.de> (Hummpäa)    ,
3520          sabberlot@träbbel.de  ,  (bier2) <a2@bür2.de> ,
3521        a3@b3.de (bier3)  , <a4@b4.de> (bier4, und \"bier5\")  ,
3522     |cat > pipe1 ,   (bier 6) <a6@bür6.de>  ,   ./file2        ,
3523     (co\$mm1) abc1@düf.de (cö,bmm,2)   (co\"m\"m.3) ,
3524     co\$bmm1 \"c,ömm2\" co\"m\"m.3 <abc2@däf2.de>  ,  |cat > pipe2 ,
3525     moppel@höppel.org
3527   That, on a single line, may be given to ":m" or (quoted) on the
3528   command line, or to "~c" or whatever, and it will work as expected
3529   (well, everything else would be a bug..) and result in the following
3530   sendmail(1) invocation:
3532   SENDMAIL.SH
3533   <-i a2@xn--br2-hoa.de a3@b3.de a4@b4.de a6@xn--br6-hoa.de abc1@xn--df-xka.de abc2@xn--df2-qla.de addr1@xn--cdrm-7qa.de moppel@xn--hppel-jua.org sabberlot@xn--trbbel-cua.de sauer@xn--ber-qla4j.de>
3534   >>>>>>>>>>>>>>>>>
3535   Date: Thu, 25 Oct 2012 17:12:15 +0200
3536   To:
3537   Cc: Steffen =?utf-8?Q?Sm=C3=B6reg=C3=A4s?=
3538     =?utf-8?Q?_(Humbab=C3=A4)?= <sauer@xn--ber-qla4j.de> (=?utf-8?Q?Hummp=C3=A4a?=),
3539     sabberlot@xn--trbbel-cua.de, moppel@xn--hppel-jua.org,
3540     <addr1@xn--cdrm-7qa.de> (bier),
3541     co$bmm1 =?utf-8?Q?"c,=C3=B6mm2"?= co"m"m.3 <abc2@xn--df2-qla.de>,
3542     (co$mm1) abc1@xn--df-xka.de (=?utf-8?Q?c=C3=B6,bmm,2?=) (co"m"m.3),
3543     (bier 6) <a6@xn--br6-hoa.de>, <a4@b4.de> (bier4, und "bier5"),
3544     a3@b3.de (bier3), (bier2) <a2@xn--br2-hoa.de>
3545   Subject: Re: SubjectTest
3546   MIME-Version: 1.0
3547   Content-Type: text/plain; charset=us-ascii
3548   Content-Transfer-Encoding: 7bit
3550   body
3551   <<<<<<<<<<<<<<<<<
3553   So list parsing has been fixed, IDNA support has been added, and it is
3554   possible to mix pipe and file recipients *and* multiple thereof, and
3555   the result is still correct for *all* of them.
3556   I think this kind of list can be given wherever a user can directly
3557   enter such a list.  And i think all that is unique to S-nail(1).
3559 - When writing back edited messages the target MBOX mailbox can no
3560   longer become "corrupted" when the trailing newline was removed during
3561   the edit.  Also affected FreeBSD and NetBSD mail(1).
3563 - A security fix for CVE-2011-2895 was applied.
3565 - The generated Message-Id: is now more human-friendly.
3567 - The -h command line option has been dropped.  Use "-O -h XY" if your
3568   MTA really supports that.
3570 - The -O and -r command line options no longer enforce a one-shot send
3571   mode, and instead persist for the duration of the entire session.
3573 - Variables set via the -S command line option are now (un)set twice;
3574   immediately and after all the resource files have been loaded.
3576 - Other new or changed options/commands, in order of appearance:
3577   recipients-in-cc, smime-sign-include-certs, quote-fold, stealthmua,
3578   add-file-recipients, write, rfc822-no-body-from_, rfc822-show-all,
3579   mail/Mail, idna-disable, idna-strict-checks, ??
3581 - In the codebase itself an effort to reduce duplicate work and
3582   introduce caching, and to minimize the use of local variables, was
3583   started, but that is long term.  A lot of improvements here and there,
3584   too, like using the well MD5 optimization from Wei Dai, Chris Torek's
3585   hash algorithm for hash tables etc.
3587 - Incredibly important: an heraldic animal was found: snailmail.jpg!
3589 The full history can be inspected by issuing the git(1) command
3591   $ git log --reverse s-nail..s-nailv13
3593 A new TODO has been introduced, and it is getting longer and longer.
3594 Thanks.
3596 # s-ts-mode