Many: unite many HAVE_ to HAVE_C90AMEND1, plus
[s-mailx.git] / NEWS
blobd1155f0c8da4c86d7218ecf38a45ae0f6a17c797
1 S - n a i l  N e w s
2 ====================
4 The complete changelog of commits in between two versions can be
5 inspected by using the git(1) `log' command as shown below, where `OLD'
6 and `NEW' are the two versions to be compared, e.g., v14.4.5 and v14.5:
8   # All commits:
9   $ git log --reverse --topo-order OLD..NEW
10   # Only topic branch headers:
11   $ git log --oneline --merges --reverse OLD..NEW
12   # Same, but truly accessible:
13   $ git log --oneline --parents --merges --reverse OLD..NEW |
14     while read c1 c2 c3 c4 c5 c6; do
15       printf "%-24s: \$ git log --oneline --no-merges ${c1} ^${c2}\n" "${c6}";
16     done
18 v14.5, 2013-12-19
19 -----------------
21 Many thanks: Gaetan Bisson, William Yodlowsky, Gavin Troy,
22 Thomas (wasd AT gmx DOT net), Ypnose.
23 And Gavin Troy definetely deserves a very special credit.
24 But thank you all, and very much indeed!
26 ChangeLog (packager-affine)
27 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
29 - The `test' make target has been fixed. [f0991e14]
30   (Gaetan Bisson)
32 - It is possible to gain a different kind of make(1) verbosity by
33   using a VERBOSE=1 command line argument (this knob is not taken into
34   account when deciding wether a rebuild is needed). [498e4ad0]
35   (William Yodlowsky)
37 - On Crux 3 Linux and OpenBSD the readline(3) and editline(3),
38   respectively, libraries will now be found when desired. [a7d1aa78]
39   (William Yodlowsky)
41 - WANT_LINE_EDITOR has been renamed to WANT_NCL, *plus*.
42   So now there are WANT_READLINE, WANT_EDITLINE and WANT_NLC, each of
43   them can be set individually, and they are tested in the shown order.
44   Also, WANT_TABEXPAND and WANT_HISTORY have been introduced and can be
45   used to fine-tune functionality. [ae4e01e1, b2635feb, 9742bf40]
47   (While here, i've fixed WANT_TABEXPAND code so that it is more
48   sensitive to line excess; on Linux etc., where MAX_INPUT is 255,
49   strange behaviour could be seen because we didn't take into account
50   the length of the prompt at all.  The NCL is assumed to have only
51   one remaining, but unfixable problem: backspace often is incapable
52   to cross visual line boundaries; use ^A/^E + ^L, then. [e832c04a]
54   Also, cursor (now ^B and ^F) and history movement (now ^P and ^N) of
55   the NCL have been changed. [d7d928da])
57 - WANT_QUOTE_FOLD is now enabled by default.  And WANT_ASSERTS has been
58   renamed to WANT_DEBUG. [1e10da1f]
60 - The build system has seen yet another overhaul in general.  CC, CFLAGS
61   and LDFLAGS plus are now tracked and changes will force rebuilds.
62   The new WANT_AUTOCC option can be used to let the build system figure
63   out a compiler and choose known-to-work flags.  Use the new ADDCFLAGS=
64   and ADDLDFLAGS= command line arguments to add your specific flags on
65   top of those -- the final CFLAGS etc. are what is change-tracked.
67   This rather massive internal rework revealed that old Bourne shells
68   were yet not supported by the new build system, and so did testing
69   that UnixWare installation was yet impossible due to tool
70   incompatibility. [75c4b74e]
72 - The new WANT_AMALGAMATION option will force compilation of all the
73   sources in a single compilation unit.  This requires a rather large
74   amount of memory, but may produce a more compact, maybe more optimized
75   binary.  (Implementing this revealed quite some bugs which could
76   therefore be fixed.) [topic/amalgam]
78 - `nail.rc' has been pimped a bit (mostly comments, but
79   *mime-counter-evidence* is now always set). [e3094ba7]
81    That changeset was however buggy. [f3dcb46]
82    (Gavin Troy)
84 - We no longer use install(1) for `install'ation make rules. [80b02cd9]
86 ChangeLog
87 ^^^^^^^^^
89 - Even '$ s-nail & fg $!' will now work with the NCL. [2a8b5c55]
91 - Several off-by-one (off-by-two) fixes. [32ce9836, 71e6d013, f139dc36]
92   (Gavin Troy, Thomas)
94 - Setting *noprompt* now prevents prompting, as per POSIX. [ecefaf63]
96 - *prompt*: new \$ (exit status of last command) and \@ (name of
97   currently active mailbox) escape sequences. [6f652046]
99 - One may now omit the space in '? unc' ('?unc') [05fcb383]
101 - New commands: `ghost' and `unghost' define command aliases (since
102   `alias' is taken for a different purpose) [topic/commands]
104     ? ghost ps '!ps axu'
105     ? ps |grep nail
107 - There is now a pseudo account `null' (case-insensitive).
108   Also a new `localopts' command exists; when used from within an
109   `account' block, options changed will be reverted back to its former
110   value when the account is left (e.g. by switching to `null'):
112     define sdn_ {
113        alternates sdaoden@users.sf.net sdaoden@users.sourceforge.net \
114           sdaoden@googlemail.com sdaoden@gmail.com
115        set Sign="\n--steffen\nForza Figa!" sign="\n--steffen"
116        set smtp=smtp.gmail.com smtp-auth=plain smtp-use-starttls
117        #..
118     }
119     account sdn_gm {
120        localopts 1
121        call sdn_
122        set from="Steffen \"Daode\" Nurpmeso <sdaoden@gmail.com>"
123     }
124     account sdn_sf {
125        localopts 1
126        call sdn_
127        set from="Steffen \"Daode\" Nurpmeso <sdaoden@users.sf.net>"
128     }
130   E.g., after
132     ? acc sdn_gm
133     ? acc null
135   neither of *Sign*, *sign*, *smtp** nor *from* should be set.
136   Please see the manual for more.
137   TODO - neither command-ghosts nor alternates etc. are yet tracked
138   TODO - we should have a boolify() so as to say 'localopts yes' etc.
139   [topic/acmava]
141 - New command: `cwd' (print current working directory).
142   Also fixing the `chdir' return value. [eff4397c]
144 - The *ssl-method* now allows explicit setting of 'tls.1.1' and
145   'tls1.2' values. [c66b4196]
147 - When sending to display, be aware that filenames in MIME parts may of
148   course be MIME-encoded! [1454be03]
150 - *hostname* is now honoured even if *smtp* is not set.  (We always
151   supported *from*, so why not *hostname*?)
153 - The `-u user' option now acts identically to setting the $USER
154   environment variable and both now tend to mean something like
155   "impersonate as user in some aspects".  Note that we have always used
156   the latter in one or the other way, and `-u user' always ment more
157   than just "open mailbox of user", so i think this change sharpens the
158   edge in the right direction. [09632731]
160 - Filename argument quoting has been tweaked for (some) function(s which
161   take a filename argument last).  The following snippet as reported by
162   Gavin Troy should work now: [2bb9b80e]
164     ? mv +inbox.Junk\ Mail
166 - The GNU implementation of wordexp(3) is also (i've added a workaround
167   for the very same bug for Mac OS X in S-nail v14.3 [63273772]) buggy,
168    which causes segmentation faults when expansions failed (`fi &VOID').
169   [470527b7]
170   (Gavin Troy)
172 - The `fi' command no longer uses the (possibly truncated) display
173   version of a filename, but the full path. [5cd85b07]
175 ChangeLog (purely technical)
176 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
178 - Large rework of internal structure: bundle inclusion of most of the
179   external and the content of most of the internal #include files in the
180   new nail.h.  If that would have been done very first bugs like the
181   infamous MAXPATHLEN bug as reported by Paul Vojta (see v14.4.2) would
182   never have occurred. [21f3155b]
184 - Support for -fstrict-overflow cc(1) flags. [topic/strict-overflow]
186 - Fixed the quotation filter which yet allocated memory even if not
187   used. [c98cdaf5]
189 - String relaxation reduces memory pressure rather drastically when
190   working with many (especially MIME) mails at a time, e.g., when
191   writing a modified mailbox.  Before all messages of a mailbox had to
192   be worked without releasing any memory in between, now we give back
193   memory (to our pool, not the system) after each and every message.
194   [topic/srelax]
196 - The other memory source now uses bound canaries, which also found some
197   errors. [3d9fe741]
199 - We now use the EL_PROMPT_ESC editline(3) mode for prompting, which
200   should offer the possibility to use coloured prompts etc. with
201   (even those) editline(3) (versions which do offer it -- older versions
202   should just do fine by themselves).
203   S-nail uses the special trigger control character \1. [ea30d818]
204   (Ypnose)
206   Note however that all tested editline(3) versions are buggy and
207   either don't get it right (`\1COLOR-ON\1stuff\1COLOR-OFF\1') or are
208   incapable of proper repainting (`\1COLOR-ONstuffCOLOR-OFF\1').
210 - We now use the MD5 digest code from the OpenSSL library if that is
211   usable. [893b16c0]
213 v14.4.5, 2013-10-19
214 -------------------
216 Many thanks: Gaetan Bisson, Stephen Isard, Jérémie Courrèges-Anglas,
217 William Yodlowsky, and Adam Sjøgren from GMANE.org!
219 ChangeLog (packager-affine)
220 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
222 - The packager-install: target has been fixed. [a8c1b0b]
223   (Gaetan Bisson and William Yodlowsky)
225 - As suggested by Gaetan Bisson the several build system tasks are now
226   individually addressable, i.e., 'make [OPTIONS] config', 'make build',
227   'make test', 'make packager-install'); nothing changes unless you want
228   to, in which case: please see INSTALL. [4d3b799]
230   The new target 'test' will call cc-test.sh with its new --check-only
231   option which will only perform the (too few) function tests on the
232   ready binary.
233   And cc-test.sh will no longer create output files, but simply echoes
234   to STDOUT and STDERR. [629e1ee, 786f219]
235   (Gaetan Bisson)
237 - The default configuration file now sets *bsdannounce* and *bsdflags*,
238   all in one line, as suggested by William Yodlowsky.
239   (If *header* is disabled, *bsdannounce* is ignored, but *header* must
240   be enabled by default according to POSIX, and *bsdannounce* is just
241   the same as *header*, but for the folder-switched event.  Thus setting
242   *bsdannounce* is the more sane default, imho.) [6161f10]
243   (William Yodlowsky)
245 - Announcement messages are now tagged '[ANNOUNCE]'. [26e1b35]
246   (Tagging suggested by Stephen Isard and Jérémie Courrèges-Anglas)
248 - The manual NAME now includes the version (but it's somewhat ugly).
249   [8adcca4]
251 ChangeLog
252 ^^^^^^^^^
254 - When switching folders when in compose mode, message attachments
255   become invalid.  For v14.4.5, at least warn when this happens.
256   [47eb1ab]
258 - When reading multipart/alternative messages which do not contain
259   a text/plain part, the (most likely HTML) part is not displayed (even
260   if S-nail is configured to display HTML).  The reason is a bug i've
261   introduced with [0d43a999] (Change "Part X:" display message..,
262   2012-12-20).  (Note that the committed fix i've posted to the list was
263   not correct either and has been fixed itself.) [225c02b, ecfa149]
265 v14.4.4, 2013-10-03
266 -------------------
268 Thanked, Gavin Troy, Gaetan Bisson.
270 - Fix output buffer confusion that would have occurred when parts of
271   a multipart mail had a pipe command set.  Longer story in [e75d16dd].
272   (Gavin Troy)
274 - The makefile now supports a `packager-install' target that bypasses
275   the reevaluation of the configuration (after checking that there is
276   one) and directly steps ahead to the install process.
277   (Gaetan Bisson)
279 - Notes in INSTALL that CFLAGS and LDFLAGS need to be overwritten from
280   within (conf.rc or) the command line.
281   (Gaetan Bisson)
283 v14.4.3, 2013-10-02
284 -------------------
286 I convey special thanks to Karol Błażewicz and Gaetan Bisson.
288 - The new build system didn't allow to overwrite CFLAGS= when used in
289   conjunction with GNU make(1).  To make a long story short, removing
290   a `.POSIX:' directive from the makefile fixed the problem.  Luckily.
291   [e6b26526]
293 - More INSTALL notes for UnixWare 7.1.4, which suffers from the same
294   problem: here the fix is to use the -e option of make(1).
296 - Karol Błażewicz reported a segmentation violation he got when using an
297   Arch Linux S-nail test package, and Gaetan Bisson informed me about
298   that.  The problem was that we didn't assign the resulting default
299   address (which gets used when *from* is not set) to the result which
300   gets used, effectively resulting in a NULL dereference. [cfd60479]
302 v14.4.2, 2013-09-21
303 -------------------
305 Many thanks to Paul Vojta.
307 - On GNU/Linux there is no MAXPATHLEN constant defined by default, as
308   this is a non-standard legacy constant.  Mozilla ran into this some
309   time ago, though a bit different [1].  It made it easier for S-nail.
311     [1] <https://bugzilla.mozilla.org/show_bug.cgi?id=412610>
313   We could include `sys/limits.h' to get at MAXPATHLEN, there it is
314   defined to be PATH_MAX, but let's just include the standard `limits.h'
315   and ensure MAXPATHLEN ends up >= PATH_MAX.  With this condition being
316   true even FORTIFYd sources won't bail with reported buffer overflows
317   because realpath(3) expects a buffer of PATH_MAX bytes. [bee5e57c]
318   (Paul Vojta)
320 - With the builtin LINE_EDITOR, ensure proper interaction with GNU
321   rlogind(8), which is alone in its quest to set the ISTRIP termios(4)
322   flag. [61e00f2d]
324 - Bugfix a codepath that would have prevented compilation when
325   HAVE_ICONV is not set.
326   While there, allow to unselect message attachments when using the `~@'
327   tilde command interactively, which i mysteriously had forgotten when
328   allowing selection of 'em.  (oops?) [4f58ffea]
330 - It's now easier for packagers to get at debug-enabled CFLAGS; simply
331   use WANT_ASSERTS=1 (should not be enabled in shipouts, please).
332   [d8663406]
334 - Fixed a terrible bug that i've introduced in november 2012, that would
335   have corrupted MBOX files when using the `resend' command.  (The
336   so-called "From_ line" would have been quoted to ">From_ line" instead
337   of simply being stripped.) [19d449e2]
339 - Fixed a SIGSEGV for the builtin LINE_EDITOR, that would have occurred
340   if a history traversal (^B or ^F) would have been continued by
341   a reverse history completion (^R).
342   While there, avoid some multiple-beeps-in-a-row that yet occurred due
343   to code reuse, and document that ^G etc. reset the multibyte state
344   machine. [003d9f6f]
346   Also, the expand-on-tab code could have excessed line input maximums,
347   e.g., after `? /usr/bin/*<Tab>'.  This was of course known, but
348   i wanted to keep it because all tested (modern) terminals "mess up but
349   won't break", and thus made it possible to use the data, even if it's
350   visual representation was messed up.  The real solution will be much,
351   *much* more complicated, i.e., show possible *completions*, page-wise,
352   etc., i.e., just like is known by tab *completion*.  This will need
353   far more time because it doesn't make sense to embed such complicated
354   code into the current bed.
355   Now i've chosen to simply don't display excess, but replace the
356   content with a message that says that there was excess.  It simply
357   looks better. [0320c8ba]
359 - I've changed the use of `[?]' as a replacement sequence for invalid
360   / non-displayable characters to `?' (again).  There are still code
361   paths (from the original codebase) which use the real Unicode
362   replacement character instead, so our display is still not unique.
363   On the long term the codepath can anticipate in all levels wether
364   use of Unicode is possible, so that, then, we will be unique again,
365   using either only `?' or the Unicode replacement character. [faf6380]
367 - I've anticipated in v15.0 and implemented *quote-fold* as a stream
368   filter.  It is now multibyte safe and takes into account the visual
369   width of characters, i.e., ideographs etc.  It is working almost as
370   good as an algorithm can work that looks at data linewise, but is yet
371   experimental and incomplete in that it will break lines even if only
372   whitespace or a backslash escape follows.  It is code that is only
373   a few hours old, which is why it is not enabled by default. [
375 v14.4.1, 2013-09-14
376 -------------------
378 How terrible.
380 - Fix some harmless stylos and typos in the manual and `conf.rc'.
381   [1a6b880, 417b066]
383 - Ensure *complete* proper cleanup on signal-caused configuration run
384   aborts. [7a08bda]
386 - Bugfix: reenable empty configuration variable overrides, as in
388     $ make install SID= NAIL=mailx ...
389   [171861d]
391 - Bugfix: rename the `conf.rc' variables SHELL, LISTER and PAGER because
392   they clash with the POSIX standard variables of the same names, which
393   hurts now that the configuration is run through the shell itself.
394   The configuration names are now XSHELL, XLISTER and XPAGER (ouch).
395   [ef93c4e]
397 - nail.rc: comment out some non-portable S-nail(1) specifics, for those
398   who install this file as mailx.rc or so, somewhere. [3f14b01]
400 - From now on S-nail will use simple version tags, as, e.g., `14.4.1',
401   i.e., no more `s-nail-14.4.1'. [a75437d, 183d59c] (Jürgen Daubert)
403   Also move UAGENT out of `version.h' [f7be5be]
405 Uh! v14.4 must have originated in a bad dream; good it's vanished.
407 v14.4, 2013-09-13
408 -----------------
410 Thanks to the entire vivid and virile S-nail(1) user community is
411 proper, especially Stephen Isard, Gavin Troy, Martin Neitzel.
412 Not to forget Ryan Kavanagh and Ayan George.
414 Note this time the changes are in reverse order, i.e., oldest first.
416 Topic Branches
417 ^^^^^^^^^^^^^^
419 15fbe09 ^bf9173f 'topic/varmac-unite'
420   Simplification and unification of variable and macro handling
421 40f6f58 ^15fbe09 'topic/cledit1'
422   Command line editor; new manual section `Line editor'
423 ad28a32 ^40f6f58 'topic/termsize'
424   Honour POSIX mailx(1) and respect $COLUMNS and $LINES on startup
425 dc3cd49 ^a446fd8 'topic/qf'
426   You don't wanna know
427 b8738f7 ^0651fd0 'topic/spam1'
428   Interaction with SpamAssassin; new manual section `Handling spam'
429 5419d6f ^b8738f7 'topic/make1'
430   Reworked build system; please read `INSTALL' and `conf.rc'
431 9ab4d6b ^5419d6f 'topic/list1'
432   Slightly tweaked message thread display, fix `:u :r' to mean it
434 ChangeLog
435 ^^^^^^^^^
437 - The default PAGER is now more(1).  (But read on.)
439 - The `echo' command is now compliant, and fully supports XSI.
441 - The `group' and `ungroup' command aliases have been removed, they are
442   `alias' and `unalias'.
444 - We now have the capability of line editing and history.
445   One may choose from not less than three different implementations:
446   a builtin editor as well as possible linkage against BSD editline(3)
447   and also a GNU readline(3) compatible layer.
448   Please read the new manual section `Line editor'.
450   Input is now compliant in that an interactive line may be continued
451   after escaping the newline character with a backslash.
452   [topic/cledit1]  (all of them)
454   The *prompt* variable may now contain shell escapes, just like the
455   `echo' command. [0938d8a]
456   As a special extension the new \? escape, when used within *prompt*,
457   will expand to the exit status of the last command. [41076d2]
459 - The POSIX standard environment variables $COLUMNS and $LINES are now
460   honoured upon startup. [topic/termsize]
462 - The `help' / `?' commands now support abbreviation, i.e.,
463   ``$ ? unc'' should now find `uncollapse'. [7b86195]
465 - The `~' abbreviation that has been introduced as an alias for `call'
466   is now a real command, not a magic shortcut. [9987289]
468 - The new variable *quote-as-attachment* can be used to additionally
469   embed the quoted message as a `message/rfc822' MIME attachment.
470   [topic/qf]
472 - The compose-mode command `~@' will now attach messages from the
473   current mailbox if given a filename of the style `#NUMBER'.
474   Please read the corresponding manual section `Tilde escapes', though.
476 - The `WANT_JUNK' and `WANT_SCORE', as well as Gunnar Ritters junk mail
477   management have been removed.
479   Instead S-nail(1) can now support interaction with SpamAssassin, but
480   sofar only via the spamc(1) / spamd(1) client / server pair of
481   programs that ships as part of SpamAssassin.  The new configuration
482   directive `WANT_SPAM' controls wether this feature is desired.
484   Please read the new manual section `Handling spam'.
485   [topic/spam1] (Martin Neitzel)
487   (S-nail(1) is now *definitely* floating-point free.)
489 - The configuration and make system have been overhauled / reorganized.
490   The configuration is now in `conf.rc', also contains directives like
491   `PREFIX' etc, and is always read in.  However, only those directives
492   which are not yet set (via environment or command line overwrites) are
493   incorporated into the set of configuration options.  Therefore
495     $ make WANT_IMAP=0
496     $ make WANT_IMAP=1
498   will now build S-nail(1) twice, because of the changed configuration.
500   Note that `WANT_GSSAPI' is now by default disabled, which shrunk
501   a freshly started s-nail image by more than 30 percent.
503   We're not finished yet in that there is no dependency graph etc.
504   Please do read `INSTALL' and `conf.rc'.
505   [topic/make1]
507 - Message selection has been slightly bugfixed in that `:u :r' really
508   means `:u' AND `:r'.  Compared to NetBSD Mail(1) it's still a shame.
510   Threaded message display has been slightly changed in that within
511   a thread identical Subject: lines are not repeated.  It may not be
512   perfect yet due to the general list / thread state. [topic/list1]
514 - If, upon startup, the environment variable `NAIL_NO_SYSTEM_RC' is set,
515   then the system wide initialization file isn't read, just as if the
516   `-n' option had been given. [1b31535]
518 - It is now possible to use CTRL-C during connection hangs.  (But in
519   general error recovery capabilities of the socket related
520   infrastructure is non-existent, practically speaking.) [45a9f36]
522 - *quote-fold* has been temporarily disabled, as it is not multibyte
523   safe.
525 No review for v14.4.  And today is Friday, the 13th.  Ouuuh!
527 v14.3.2, 2013-06-21
528 -------------------
530 I should *maybe* should have and want to give prominence to
531 Martin Neitzel for this, i maybe have misunderstood.
533 - Bugfix *synchronous* *pipe-** execution..
535   Well, unfortunately yet another newly introduced bug slept in
536   S-nail v14.3[.1] -- [a8d724b3, Add @ and @& shell command prefixes
537   for pipe-MIMETYPE, 2013-05-03] falsely changed the waiting state
538   for subprocesses, as has shown up by a HTML-only mail on the
539   Unicode list today.
540   'Seems i'm collecting one line fixes in this codebase; this needs
541   to change in the future.
543 v14.3.1, 2013-06-08
544 -------------------
546 I want to give prominence to Juergen Daubert (jue AT jue DOT li), who
547 reported that i've broken plain-old unfancy send mode in 14.3.
549 + Ok, i'll hope we're out of new errors for the v14.3 series with that.
551 - New variable: *batch-exit-on-error*.
552   Only works if the new -# command line option has been given, and will
553   check the "current" exit status whenever one operation completes
554   (S-nail returns to the command prompt).
555   If the exit status implies error (e.g., sending the last message
556   failed) then we exit forcefully with that error status.  (The normal
557   behaviour is that the status is reset when the command loop ticks.)
558   [4cddd55]
560 - While here again, i've added the new -# command line option.
561   This is the first step to implement a reliable batch mode;
562   unfortunately it still selects the users system mailbox on startup,
563   because we simply cannot go to "no" mailbox for quite some time -- at
564   some future time we will be able to go to some VOID thing, and then
565   this will end up as a rather efficient batch mode.
566   For now it sets *dot*, *emptystart*, *noheader* and *sendwait*, and
567   also implies the -~ command line option.  [7549569]
569     (
570       printf "m ${MBOX}\n~s subject1\nE-Mail Körper 1\n.\n" &&
571       printf "m ${MBOX}\n~s subject2\nEmail body 2\n.\n" &&
572       echo x
573     ) | MAILRC=/dev/null "${NAIL}" -n -#
575 - Also, -N set *header* instead of *noheader*.  [7b4a13f6]
576   (Juergen Daubert.)
578 - Plain old unfancy invocations like
580     $ s-nail user@host
581     $ echo bla|s-nail ./FILE1
583   had been broken (by [522cb3ec]).  [260e19d]
584   (Juergen Daubert.)
586 v14.3, 2013-06-03
587 -----------------
589 Thanks to Gavin Troy (gavtroy AT gmail DOT com) who inspired the @ and
590 @& pipe-command prefixes.
592 Random notes
593 ^^^^^^^^^^^^
595 - S-nail has been registered at Coverity Scan, and the third build
596   (after topic branches *coverity-444* and *coverity-444.2*) produced no
597   more errors.  (<http://scan2.coverity.com/projects/444>.)
598   (Then i used POP3 and IMAP and fixed some SIGSEGV. ;)  Still didn't
599   look at S/MIME, Maildir, caches etc... o()
601 - S-nail v14.3 doesn't produce any spurious linker warnings on
602   OpenBSD 5.3; all (correct!) use cases of strcpy() and strcat() have
603   been replaced.  [7bdf330, 2c8d7cb]
605 - This is the first release with a (though very short) review -- i'm
606   slowly getting comfortable with the code.  (But i'm too stupid to
607   perform reviews on patches, 'always did reviews on C++/Perl/xy
608   classes.  Aaah, how beautiful ... objects.)
610 ChangeLog
611 ^^^^^^^^^
613 - It is now possible to "call" macros without using the `call' command
614   by prefixing them with a tilde, as in
616     ? define au {
617       echo auau
618     }
619     ? ~au
620     auau
621   [93ea8acd]
623 - Added the *pop3-bulk-load* option.
624   Yes, there are mailing lists etc. which use plain text email, and,
625   there, headers are often more data than the body, so it doesn't make
626   sense to download the headers twice (unfortunately POP3 doesn't
627   support a BODY command; if only it would support a RETRDELE command..)
628   [978e13a7]
630   And yep, from this changeset on i personally use S-nail even over the
631   network, no longer my stale and incomplete S-Postman.  And i can tell
632   you, this damn thing is so silent, i always set *verbose* not to go
633   grazy ... but .. i hate to say it .. the healing will take time.
635 - POP3 will now try to use APOP authentication automatically; thus the
636   *use-apop* stuff has been replaced by *pop3-no-apop* options (just in
637   case there are POP3 servers which advertise they support APOP but in
638   fact fail to do so; anyone?)  [6c3c5575]
640 - Some IMAP segmentation violations have been fixed:
642     ? fi imaps://user1@localhost
643     Password:Interrupt            <- CNTRL-C
644     ? set imap-auth=cram-md5      <- hey, 'forgot to set correct auth
645     ? fi imaps://user1@localhost
646     IMAP write error: error:140D00CF:SSL routines:SSL_write:protocol is shutdown
647     Segmentation fault
649   And also, when *folder* was set to an IMAP account but hasn't been
650   opened yet, and no IMAP account ever has been opened, a string
651   comparison against a NULL pointer yet caused a SIGSEGV, too.
652   [417c01f, 413c23d9]
654 - `set folder=' now tolerates `%:' and expands PROTOs stuff etc.:
656     ? short xp %:imaps://user1@localhost
657     ? set folder=xp
659   Pure convenience so that it doesn't need to be typed twice (still no
660   completion in sight...).  Note that setting *folder* to a POP3 box
661   will now be actively rejected.  [b12b17f5]
663   NOTE: while implementing this i've detected another dead-end
664   miscondition in S-nail -- you really should ensure that your target
665   folder/box is connected before you leave your current POP3/network
666   based folder, if there is data to be moved to the target (i.e.,
667   mbox).  This problem will persist for a long time due to the way the
668   entire codebase functions; i hope i can find a short/mid-term
669   solution, but the real healing will take years.  The mentioned
670   solution would at least make S-nail interruptable, currently we get
671   stuck and interrupts are blocked...
673 - If you're using S-nail on Mac OS X and have seen some segmentation
674   faults when expanding shell stuff then you may be pleased to hear that
675   S-nail now works around an Apple bug.  [63273772]
677 - The builtin mime.types have been corrected and a lot of new ones have
678   been added.  New data from
679   <http://svn.apache.org/viewvc/tika/trunk/tika-core/src/main/resources/\
680   org/apache/tika/mime/tika-mimetypes.xml>, thanks!  [8072fcb6]
682 - BEWARE: handling of command line arguments has changed a bit!
684   1. The -D, -d, -E, -i, -N and -v command line options are now
685   implemented by means of setting the respective option, as via -S.
686   (This means that from now on resource files can only *temporarily*
687   overwrite command line arguments.)
689   2. The -I and -T command line arguments have been dropped.
690   It seems Gunnar Ritter stopped developing nail/Heirloom mailx once he
691   started implementing Newsreader functionality.  It'll take a long time
692   until we get there, so for now drop all the Newsreader stuff.
694   3. Handling of -r has been changed.  E.g.:
696     s-nail -A test -Snoeditalong -r 'La mort est <fem@me>' -d
697     ? set from=bummer@m1.com
698     ? m t1
699     Subject: s1
700     .
701     Sendmail arguments: "sendmail" "-i" "-r" "fem@me" "t1"
702     ? set from=bummer@m2.com
703     ? m t2
704     Subject: s2
705     Sendmail arguments: "sendmail" "-i" "-r" "fem@me" "t2"
707   ...
709     s-nail -A test -Snoeditalong -r '' -d
710     ? set from=bummer@m1.com
711     ? m t1
712     Subject: s1
713     .
714     Sendmail arguments: "sendmail" "-i" "-r" "bummer@m1.com" "t1"
715     ? set from=bummer@m2.com
716     ? m t2
717     Subject: s2
718     Sendmail arguments: "sendmail" "-i" "-r" "bummer@m2.com" "t2"
720   [*main-fun-cleanup* topic branch]
722 - *smime-sign-include-certs-** stuff works again, oops..  [9a8597c6]
724 - A whole lot of smallest and small fixes due to registration at
725   Coverity Scan, as project 444.  Error handling in S-nail is ridiculous.
726   [*coverity-444* and *coverity-444.2* topic branches.  The sheer number
727   of fixes was the reason to sit down and go for unplanned S-nail v14.3]
729 - *idna-strict-checks* has been dropped.  It's silly to have in a MUA,
730   especially given that GNU LibIDN doesn't ship with a lot of rules.
731   We were able to drop quite some code (and a use-after-free, too :().
732   [c81fd41d]
734 - The ~p tilde command displays attachments more verbose.
735   Until the big big MIME and send layer rewrite :) this is intermediate
736   since until then we do not really know neither MIME type nor charset
737   of an attachment at the time this is displayed (for sure).  Yet
738   i think it's nicer to show what we have than keep it the way it was.
739   [60e70463]
741 - @ and @& shell command prefixes have been added for the pipe-MIMETYPE
742   mechanism.  The former suppresses filters if multiple messages are
743   displayed at once, the latter adds asynchronous program execution on
744   top of that.  E.g., to display PDF documents, but only if you
745   *explicitly* address the message *alone and by itself*, and without
746   blocking S-nail and the $PAGER, do:
748     set pipe-application/pdf="@&cat >"${TMPDIR}"/s-nail${$}.pdf;\
749       mupdf "${TMPDIR}"/s-nail${$}.pdf; rm "${TMPDIR}"/s-nail${$}.pdf"
751   (Inspired by Gavin Troy.)  [a8d724b3]
753   Note: most of that had been posted to nail-devel@ already, but it was
754   tweaked ([251b636]) so that you now *really* have to say `p MSGNO' to
755   get there.
757 - The NETLESS CONFIG= has been removed; it is almost identical to
758   MINIMAL now (i.e., without WANT_JUNK and WANT_SCORE).
760 - WANT_JUNK and WANT_SCORE have been disabled by default.
761   They don't seem to be too useful; i hope i can implement
762   a SpamAssassin hook for (downloaded) mail messages for v14.4.
763   If so, expect these two "modules" to become removed completely.
765 v14.2.2, 2013-05-01
766 -------------------
768 Another unplanned (minor) bugfix release after Gavin Troy (gavtroy AT
769 gmail DOT com) pointed out that MIME CTE decoding was broken, who
770 i therefore want to give a lot of prominence right here.
772 - Fix MIME content decoding which has been broken by [01c0e135].
773   [882caedd]
774   (Gavin Troy.)
776 v14.2.1, 2013-04-30
777 -------------------
779 An unplanned (minor) bugfix release after i've found two bugs today and
780 heard from Jérémie Courrèges-Anglas (jca+nail AT wxcvbn DOT org) that
781 there exists a S-nail OpenBSD package.
783 I want to give prominence to the following people that helped to
784 improve S-nail(1) during this development cycle, in order of
785 appearance: Dirk Peters (peters AT schwertfisch DOT de).
787 Thank you very much, and best from Germany!
789 - Some warnings of newer clang(1) versions were silenced, including yet
790   another alloca(3) problem (see *memtracer* topic branch in v14.0
791   series).  [6f846efe]
793 - Tweaking the MIME boundary detection left a little hole that could
794   cause boundaries not to be detected, as has been shown by a Microsoft
795   Word generated mail on the ICU list.  [11e5fb5b]
797 - A format string could overflow bounds if unrealistic
798   (18446744073709551615) line numbers or message sizes would have been
799   produced.  [faa65c40]
801 - An algorithmic error could cause overlong lines which wrapped around
802   to the next display line.  [ade52660] 
803   (Dirk Peters.)
805 v14.2, 2013-03-15 [v14.1, 2013-03-12]
806 -------------------------------------
808 I want to give prominence to the following people that helped to
809 improve S-nail(1) during this development cycle, in order of
810 appearance: Martin Neitzel, Christos Zoulas, Stephen Isard, jgw@txo.org
811 and Gavin Troy.
813 Thank you very much, and best from Germany!
815 + v14.2 differs from v14.1 only by one commit, one that fixes
816   (mime_fromhdr(): partial rewrite using n_iconv_str(), 2013-03-12),
817   which i hastily implemented just hours before the release of v14.1,
818   and simply shouldn't have made it (into there).
819   The v14.1 tarball has been removed from the server.
821 - A fix for the quoted-printable codec: "message truncation" occurred
822   when a mail maliciously used a soft linebreak to escape the linebreak
823   of a completely empty line.
824   (That resulted in 0 written and 0 leftover bytes, a condition that was
825   declared erroneous back in november 2012 when i started handling I/O
826   errors.)
828 - The "folders" command will work again when given an argument.
829   A fault of mine introduced in (cmd1.c: expand() may fail, 2012-10-23).
831 - The Base64 codec has been touched again, and we are finally capable to
832   perform sequential decoding; this was targeted for the MIME/send layer
833   rewrite, but it actually was possible today.
834   The result as seen in ps(1), running on the Base64 encoded HTML5
835   standard (4622545 bytes HTML, with a NUL appended to force Base64
836   encoding, resulting in a 6244793 bytes email):
838    7420 s006  S+    2:22pm 0:10.65 plain-nail -f HTML5
839    1440 s006  S+    2:23pm 0:00.36 ./s-nail -f HTML5
841   (So the only thing that is left for a good throughput is sequential
842   decoding of quoted-printable encoded parts that maliciously use soft
843   linebreaks to convert an entire part to a single line.  And i've seen
844   that from Apple Mail.)
846 - New option: *mime-allow-text-controls* (rather long manual entry).
848 - *smtp-auth-password-user@host* and *smtp-auth-user-user@host* will
849   finally work!
850   (Reported by jgw@txo.org in November 2011, fixed by Gavin Troy in
851   January 2012.)
853 - Most *headline* formats now do support the '-' left-alignment flag.
854   Note that you most likely have to change your *headline* accordingly.
855   (The still missing %n format is one reason why there will be v14.2.)
857 - *datefield* and *datefield-markout-older* can now be set to
858   strftime(3) format strings (except %n).
859   (From Stephen Isard's wishlist.)
861 - A possible SEGV has been found and also fixed by Stephen Isard.
862   (The "legendary" cross-world stereo fix!)
864 - Wow!  S-nail will finally compile on GNU based Linux systems like
865   Slackware 14 etc.  (Found while hunting bug reported by
866   Stephen Isard.)
868 - New option: *datefield-markout-older* can be used to choose
869   a different date display for mails that are older than six months,
870   in equal spirit to what POSIX describes for the -l option of the ls(1)
871   command (Stephen Isard).
873 - (Exotic) Years are (would) now (be) interpreted correctly according to
874   RFC 5322, 4.3.
876 - CRAM-MD5 usage has been fixed.
878 - *folder* updates are now tracked when set, and we will show the
879   realpath(3) name of it, showing PREFIX..SUFFIX if that wouldn't fit on
880   the display.
881   Tracking updates made it also possible to perform other more expensive
882   tasks when setting *folder*, so that it is now possible to do
883   something like:
885     :set folder=$HOME
886     :set folder=~
888   et cetera (both ideas by Christos Zoulas).
890 - Bugfix for the ~@ tilde-escape in non-interactive mode.
891   (readtty(): quick shot: work in pipelines (on non-TTY).., 2013-01-25)
892   introduced the possibility to "read data from the terminal" (STDIN
893   that is) in non-interactive mode.
894   The manual documents that attachment input must be terminated with an
895   empty line, but if that had been omitted, as in the example below, we
896   would have yet entered an endless loop.
898      $ cat <<_EOT | /s-nail -~ -s boom ./OUT
899     ~@
900     test.c
901     charset
902     _EOT
904 - Alias expansion will now be performed for members of Reply-To: fields
905   (Martin Neitzel).
907 - Decoding quoted-printable will now be more relaxed.
908   (Even though the standard says that users should be given a hint when
909   input is not absolutely clean; a possible warning will be added later,
910   when we have an error message ring.)
912 - New option: *mimetypes-load-control* can be used to control which of
913   the mime.types resources will be loaded.
915 - The builtin default mime.types have been extended a bit.
917 v14.0, 2013-02-10
918 -----------------
920 I want to give prominence to the following people that helped to
921 improve S-nail(1) during this development cycle, in order of
922 appearance: John Dodson, Gianluca Ramunno, and Anon Ymous from the
923 NetBSD project.
925 Random notes
926 ^^^^^^^^^^^^
928 - Encoding defaults to *quoted-printable* not *8bit*.
929   This has no technical background except that i think it's the better
930   default.
932 - Small progress for the "getting stuck due to the current folder
933   becomes inaccessible due to whatever reasons"  problem.
934   (schdir(): realpath() local files before leaving CWD.., 2013-01-08)
936 - The names of temporary files have changed.  Whereas not all uses of
937   temporary files already use really meaningful names, it has yet become
938   possible to use the pattern "*mail-*"; or, to be compatible with
939   NetBSD Mail(1) in one go, "*mail*".  (E.g., in my ~/.vimrc you'd read:
940     :au   BufRead,BufNewFile *mutt*,*mail* setl fenc= | setf mail
941   [the *mutt* is a leftover from times when i've used MUAs that suck].)
943 ChangeLog
944 ^^^^^^^^^
946 - The Quoted-Printable MIME handling has been rewritten completely.
947   We now correctly encode files with the MS-DOS newline sequence (CRLF).
948   (Part of the *mime-cte* topic branch.)
950   S-nail(1) continues to be able to handle text messages and text
951   attachments without a trailing newline, but because these
952   Content-Transfer-Encoding related things are now handled by the C-T-E
953   layer instead of by sendout.c a text message body that comes in as
954   part of a complete message via the -t command line option will loose
955   the missing final newline (i.e., it'll gain one).
956   This problem does *not* occur when *only* the message body comes in
957   via STDIN, as in 'cat FILE | s-nail', but *only* when the -t option is
958   used.
959   (sendout.c: does no(t/ longer) know about CTE internals!, 2013-02-09)
961 - Filename arguments for -a are now processed *after* all the resource
962   files have been loaded etc., so that the usual "folder" specifics can
963   be used (provided that proper care for shell quoting was taken).
964   ((main(): delay -a processing.., 2013-01-10), as a part of the
965   *mainaflags* topic branch.)
967 - (d38c5bd, When the write command asks.., 2004-11-23) added support
968   for pipes when saving attachments during a "write" command.
969   It however used the wrong SIGPIPE signal handler; e.g.:
971     Enter filename for part 2 (application/x-gzip): |exit
972     Segmentation fault
974   Of course, it still performs a jump and that most likely leaves memory
975   chunks behind, thus causing some memory leaks.  This will be
976   a long-term problem (you may want to read [mime.c:fwrite_td(): TODO
977   notes on unfixable leaks, 2013-01-14] for more).
978   (send.c:sendpart(): fix longjmp() SIGSEGV.., 2013-01-29)
980 - Fixed a name quoting regression that i've introduced in
981   (Rewrite *extract().., 2012-10-20), that would have caused
982   "x \"y\" z" to become "x"y" z" instead of "x "y" z".
983   (S-nail still does not really have RFC compliant parsers, just as
984   NetBSD Mail(1) has, i.e., there are structured and unstructured fields
985   etc...  I hope i can provide them in v15.0.)
986   (names.c:yankname(): fix quote regression.., 2013-01-29)
988 - The IDNA conversion now assumes domain names are specified in
989   *ttycharset*, rather than in the LC_CTYPE locale charset.
990   I.e., it integrates into the usual character set specifications.
991   (IDNA: honour *ttycharset* for domain names, 2013-01-18)
993 - The new *editalong* variable will automatically spawn an editor when
994   composing a mail in interactive mode, just as if `~e' was given.
995   (Add new *editalong* variable, 2012-01-07)
997 - The manual has been converted to mdoc.
998   (The manual has been converted to mdoc, 2012-12-28)
1000 - The ~@ tilde escape, when given filename arguments, will treat the
1001   arguments as a comma-separated instead of a whitespace-separated list.
1002   (collect: change separator of ~@ tilde escape.., 2012-12-28)
1004   The interactive mode of ~@ has also been changed, rather massively.
1005   Please do reread what the manual says.
1006   ((collect: support multiple attachment charsets.., 2013-01-23), as
1007   part of the *attach* topic branch.)
1009 - Thanks to Gianluca Ramunno (ramunno DOT gianluca AT gmail DOT com)
1010   S-Nail will no longer try to issue a STARTTLS command when it is about
1011   to establish a SMTPS connection, a task that logically fails since the
1012   connection is already secured.
1013   (Interestingly the nail codebase performs the necessary test for IMAP
1014   and POP3 already.)
1015   While here the undocumented nail v11.0 *smtp-use-tls* legacy option
1016   has been removed.
1017   (Fix SMPTS with a set *smtp-use-starttls*.., 2012-12-22)
1019 - The RFC 4155 compliant MBOX quoting is now exclusively used, the
1020   shitty *posix-mbox* variable has been removed again.
1021   (Shitty because i've implemented RFC 4155 compliant MBOX quoting and
1022   tested it, then added *posix-mbox* for those who liked the old
1023   behaviour and did not re-test -- the final code path was buggy.)
1025   In mails newly created and saved by S-nail(1) no From_ quoting at all
1026   will be used no more, but instead the rewritten MIME file classifier
1027   will detect unquoted From_ lines and enforce quoted-printable encoding.
1028   (This is an approach that is S/MIME compatible all through the way as
1029   the file data is not modified at all, but only encoded, so that the
1030   data checksum is not changed.)
1032   In yet existent mails that S-nail copies or moves around without
1033   reclassification an RFC 4155 compliant From_ line detector will apply
1034   MBOXO quoting (prepend a single '>') as necessary.
1035   Different to the old MBOXRD behaviour S-nail will neither quote yet
1036   quoted From_ lines ('>>From xy' -> '>>>From xy') nor will it unquote
1037   one quote level when reading etc. mails ('>> From xy' -> '>From xy').
1038   As a result the code could be simplified.
1040   This changeset also incorporates a fix for NetBSD PR bin/47453, as
1041   reported by Martin Brandenburg.  I.e., some mailers, noticeably
1042   UW-imap (with MBX format only?), use non-compliant From_ lines with
1043   RFC 822 date specifications.  Be aware of 'em.
1044   (RFC 4155 MBOX, and drop *posix-mbox* and foldergets().., 2013-01-06)
1046 - *rfc822-show-all* has been removed.
1047   It didn't work properly for more complex MIME structures, like
1048   message/rfc822 messages with attachments etc., just as i've seen today
1049   on the file(1) mailing list.
1050   So, instead of hacking it now i've dropped it and will come back with
1051   a better solution when the MIME and send layers have been overhauled.
1052   I.e., the real intent was to be able to specify that an embedded
1053   message/rfc822 is treated as a *unity*, and that's the goal.
1054   (Drop *rfc822-show-all*, 2013-01-23)
1055   [The manual will be adjusted in a different commit.]
1057 - *rfc822-no-body-from_* has been renamed to *rfc822-body-from_*.
1058   It thus must be set explicitly.
1059   On the other hand it now catches all cases...
1060   (*rfc822-no-body-from_* -> *rfc822-body-from_*, 2013-01-23)
1061   [The manual will be adjusted in a different commit.]
1063 - The new *charset-7bit* (defaults to US-ASCII) and *charset-8bit*
1064   (defaults to UTF-8) have been introduced.
1065   These are used if seven bit clean data is to be sent, and no
1066   *sendcharsets* are set or the convertion of all of them failed,
1067   respectively:
1069   - There is no functional change unless there is iconv(3) support.
1070   - There is no functional change unless you set them.
1071   (Introduce *charset-8bit* and *charset-7bit* variables.., 2013-01-18)
1072   [The manual will be adjusted in a different commit.]
1074   In addition the new *sendcharsets-else-ttycharset* variable can now
1075   be used to automatically use *ttycharset* as a *sendcharset(s)*,
1076   regardless of the new *charset-8bit* variable.
1077   (Add *sendcharsets-else-ttycharset* variable, 2013-01-24)
1078   [The manual will be adjusted in a different commit.]
1080   NOTE: before we apply charset conversion we now perform a string
1081   comparison to see wether character sets are identical.  If the strings
1082   match (case-insensitively), then *no* conversion is performed.
1083   This means that code like
1085     $ printf "LATIN1: \0376" | s-nail -Ssendcharsets= -s boom ./out.txt
1087   *succeeds* in an UTF-8 environment now, whereas older versions would
1088   fail with an "illegal byte sequence" error (unless the iconv(3)
1089   library of the system would not perform any conversion that seems
1090   superflous, of course).
1092   I thought about making this optional, but, in fact, if this would be
1093   done in an environment without iconv(3) support then the result would
1094   be equally corrupt.  And the way it is now we save the expensive and
1095   superflous conversions.  (See TODO for more.)
1097   Please *do* reread the manual section "Character sets".
1098   +++++++++++++++++++++++++++++++++++++++++++++++++++++++
1100 - An attempt was made to improve MIME Content-XY: detection.
1101   It should be more RFC compliant, and just overall better :);
1102   a simple one-pass classifier cannot match libmagic(3), of course.
1104   This changeset removes support of the long obsoleted (4fee1ef,
1105   2005-01-06) *charset* variable, as well as for the
1106   *maximum-unencoded-line-length* variable that has been introduced in
1107   (48a652bd, 2005-07-26).
1109   For S-nail v14.0 it'll be no longer necessary to do
1111     $ tr -d '\015' < input | s-nail ...
1113   to transport files which use the $-DOS (terminal) newline (sequence).
1114   We still depend upon *sendcharsets* for a while, though.
1115   (Rewrite file-content classification.., 2013-01-02)
1117 - The new *mime-counter-evidence* variable can be used to force
1118   a classification of non-text MIME parts (attachments) by their
1119   filename, i.e., a "reverse-classification" just as would be performed
1120   if S-nail(1) would itself *send* the file(name).  This can help
1121   against some stupid MUAs (Apple Mail?) that send .diff etc. files as
1122   `application/octet-stream' parts etc.
1124   At a later time this may become a valued option, causing a temporary
1125   save of unnamed attachments followed by a MIME classification of the
1126   file contents, followed by forced treatment as plain text if it seems
1127   to be human readable.  But not yet.  Just to warn you.
1128   (Add *mime-counter-evidence* variable.., 2012-12-29)
1130 - The special "pipe-" command "@" can be used to force treatment of
1131   a MIME message part as plain text (e.g.,
1132   'set pipe-application/pgp-signature=@' will henceforth print those
1133   signatures inline and as plain text).
1134   (Introduce the special "@" "pipe-" command, 2012-12-27)
1136 - The MIME types (as from mime.types(5)) will now be cached.  Before
1137   all possible sources would have been opened, read and parsed for each
1138   and every message part that required detection of the MIME
1139   Content-Type:.
1140   The new "mimetypes" command can be used to show or clear that cache.
1141   (Add mime.types(5) cache.., 2012-12-27)
1143 - A small set of MIME types (template: ./mime.types) will now become
1144   compiled into S-nail(1), and be used as a fallback if there are no
1145   ~/.mime.types and/or no /etc/mime.types, or those didn't contain
1146   a matching type.  E.g., NetBSD 6 doesn't ship a default database.
1147   Also, file extensions will be matched case-insensitively (case of
1148   attribute values is not specified afaik?).
1149   (Introduce compiled-in mime.types(5).., 2012-12-21)
1151 - The undocumented *charset7* variable was removed.
1153 - The "Message X:" display leader has been changed and will henceforth
1154   be matchable via "^[-- Message \d+ -- \d+ lines, \d+ bytes --]:$".
1155   These lines can no longer be suppressed by setting the *quiet*
1156   option (which was yet possible for print and top, though undocumented).
1157   (Change "Message X:" display message.., 2012-12-20)
1159 - When displaying multipart messages the "Part X:" introductional string
1160   has been changed; if the Content-type: header is not *retain*ed, then
1161   this string will include the part's type and size.  Ditto for
1162   Content-disposition: and a mentioned attachment filename.
1163   This is a first step only, for the final version the MIME and send
1164   layers will have to be adjusted.  But the string will be matchable via
1165   a "^[-- #.* --]$" regular expression from now on.
1166   (Change "Part X:" display message.., 2012-12-20)
1168 - MIME boundaries in multipart messages are now handled better in that
1169   no boundary string should get through to the display.
1170  (Tweak MIME boundary detection.., 2012-12-20)
1172 - A couple of long standing, even pre-Heirloom mailx(1) memory leaks and
1173   segmentation violations, most of them related to configurations
1174   without alloca(3) support, as well as one leak that i have introduced
1175   when i implemented RFC 4155 MBOX handling, have been fixed.
1176   But S-nail should now survive non-alloca(3) configurations.
1177   (*memtracer* topic branch.)
1179 - The Base64 MIME handling has been rewritten completely.
1180   This was an urgent topic, because the old implementation (a) read in
1181   all lines of a base64 encoded text part, repeatedly resizing a string
1182   storage and repeatedly decoding that string until all the lines have
1183   been swallowed (i.e., or by accident the last decoded byte was
1184   a newline character, and that in turn may of course have fucked up for
1185   multi-octet encodings, dependent on the actual byte-order), (b) used
1186   function local static data to keep state in between multiple
1187   invocations, which messed up multi-byte/-octet encodings like this
1189     �5��ɽ���Aɥ����́��٥��������[lots of data follows]
1191   and (c) did not perform any error checking at all.
1192   The new one does not run into the problem that (a) tried to circumvent
1193   since leftover decoded data (as opposed to leftover *encoded* data) is
1194   transported along the call-chain for later use.  It adds a minimal set
1195   of error handling ('may now see "[Invalid Base64 encoding ignored]"),
1196   with more to become possible in later S-nail versions when the entire
1197   layers are reworked.  (Until then DOS newline sequences [CRLF]
1198   embedded into base64 will no longer be decoded to Unix LF newlines.)
1199   Base64 encoded lines will now be 76 characters long, as stated (as
1200   a maximum value) in RFC 2045, not 72 as before.
1202   The Base64 code core has been shamelessly stolen from NetBSD's
1203   Mail(1), and i guess it was the second time that this happened :=).
1204   (*base64-rewrite* topic branch; and reworked later on the *mime-cte*
1205   topic branch.)
1207 - The string allocation strategy has been tweaked some more to, i think,
1208   a final version (regarding algorithm).
1209   In normal non-interactive send mode it should now no longer need any
1210   dynamic memory at all (unless some dozen recipients are specified).
1211   (Several other places still use normal dynamic memory, of course.)
1212   (*dope-stringdope-again* topic branch.)
1214 - Support for NSS (Network Security Services) has been removed.
1215   I've never worked with it and are, regarding the complexity of
1216   network security, not willing to spend any time on it.
1217   SSL is installed on all systems i'm using and/or testing on by
1218   default, and so i've choosen to go this way.
1219   (It may be that sometime in the future S-nail will add support for
1220   libcurl(3) connectivity, and then it may happen that not only NSS
1221   support is reintroduced again, but also GNU TLS.  All of that applies
1222   to network connectivity only, however, not to S/MIME afaik.)
1223   (*drop-nss-support* topic branch.)
1225 - I finally got a glue and understood that Sourceforge does (a) not
1226   support symbolic links and (b) doesn't like dots as regular parts of
1227   filenames.  This means that all this time the promised s-nail.tar.gz
1228   symbolic link did not work, and that s-nailv13.3.tar.gz wasn't
1229   accessible either (via the web interface).
1230   In the future S-nail(1) will not provide any more symbolic links (the
1231   Sourceforge website offers a "download latest" thing which seems to
1232   work), and use underscores in filenames -- s-nailv13.3.tar.gz has been
1233   renamed to s-nailv13_3.tar.gz.  The tags continue to use dot notation.
1234   Thanks.
1236 - The *heirloom-plus* support branch has been removed.
1237   The code bases diverged a lot and even more to come.
1238   It doesn't make sense to put any effort in that.
1240 v13.3, 2012-11-11
1241 -----------------
1243 - Configuration on UnixWare 7.1.4 will succeed (shell issue fixed).
1245 - Even on DragonFly BSD the IMAP GSSAPI is now found
1246   (in /usr/pkg/include/krb5/gssapi/gssapi.h).
1248 - Support for pkgsrc(7) systems and automatic integration of
1249   C_INCLUDE_PATH and LD_LIBRARY_PATH path configurations.
1250   Please see INSTALL.
1252 - Fixes a mortally embarassing regression that the current maintainer
1253   introduced before i really knew what i was doing, in (If *record* is
1254   set, avoid writing dead content twice.., 2012-09-14).
1255   It hit users that send through a MTA and have *record* set; in this
1256   combination data would not have reached the MTA.
1257   Interested parties may read the comment in savedeadletter() (part of
1258   the changeset) or the (Fix MTA/*record* descriptor clash..,
1259   2012-11-10) commit log.
1261   Deepest apologies to tortured users from the current maintainer!
1263 - RFC 4155 compatible MBOX file handling has been introduced, and so
1264   S-nail is now on par with (at least) NetBSD Mail in respect to this.
1265   It can be turned off with the new *posix-mbox* variable, which you may
1266   need to use since not all MUAs are capable to dig those MBOX files.
1267   E.g., less cutting-edge (.-) MUAs fail for this:
1269    |From - Thu May 10 20:40:54 2012
1270    |Date: Wed, 07 Nov 2012 11:48:30 +0100
1271    |To: super@duper.com
1272    |Subject: super1
1273    |
1274    |From me.
1275    |
1276    |From - Thu May 10 20:40:54 2012
1277    |Date: Wed, 07 Nov 2012 11:48:30 +0100
1278    |To: super@duper.com
1279    |Subject: super2
1280    |
1281    |>From - Thu May 10 20:40:54 2012
1282    |From - Thu May 10 20:40:54 2012
1284   I'm not completely happy since S-nail *does* still quote those lines,
1285   how rare they may be -- it *does* modify message content.  mutt(1)
1286   implements something more clever and that is quoted-printable encoding
1287   of the "F" from "From", when seen at the beginning of a line.
1288   This, when applied to just *any* "^From", will be a non-modifying and
1289   all-compatible solution.
1291 - SEND_MBOX handling has been changed to discard any Content-Length: and
1292   Lines: headers when it rewrites a message by default.
1293   I know that mutt(1) generates them (why, after
1294   http://www.jwz.org/doc/content-length.html?).
1295   Anyway, S-nail does neither use nor manage them, so that any
1296   modification renders those fields invalid, and then it seems best to
1297   discard them anyway.
1298   You may turn the new behaviour off with *keep-content-length*.
1300 v13.2, 2012-11-03
1301 -----------------
1303 The problem was that i really wanted to release on a 25th.
1304 But i have been able to improve S-nail(1) some more, so that this is
1305 possibly the first real release of it.  So i'll add only things that
1306 have changed since v13 -- please see below for the complete picture.
1308 - A new CONFIG=CUSTOM make directive was added, and the new user.conf
1309   variables WANT_SCORE and WANT_DOCSTRINGS have been added.  It is
1310   possible to create a floating-point free S-nail(1) now.
1311   Please see INSTALL.
1313 - If a feature is disabled not even functions stubs should remain now.
1315 - Many places which will work only with local filenames do now actually
1316   check that the target is a local filename.
1318 - Space-separated lists should work again, at a few places at least.
1320 - Tilde commands will be possible, even with -r.
1322 - The *sendmail-progname* has been added after NetBSD 6 dropped the
1323   send-mail entry in mailer.conf(5), which broke S-nail(1).  Now users
1324   have an option.
1326 - When editing messages via ~e or ~v file and pipe addressees will no
1327   longer be lost.
1329 - If recipients occur multiple times spread over lists, i.e., To:, Cc:,
1330   Bcc:, then only one occurrence remains, and in the "highest-order"
1331   list.
1333 - The "list" command prints the list alphabetically sorted (somewhat).
1335 - The "help" and "?" commands take an optional argument that shows
1336   a synopsis string for the given command (unless WANT_DOCSTRINGS was
1337   false).
1339 - String allocations are now more efficient.  The situation can still be
1340   improved.  However, for the first time Berkeley Mail(1) integrates
1341   harmonically into the system allocator, which may madvise(2) unused
1342   memory to the operating system as necessary and/or possible!
1344 v13.1, 2012-10-25
1345 -----------------
1347 Well, a version number 13 is anyway an ugly thing...
1349   commit 4f534bb33b7c911272cc66a0e3a9e47b73ad8deb
1350   Date:   2012-10-25 20:46:07 +0200
1352       FIX MIME quoted-printable encoding (char cast)..
1353       
1354       (;-{
1355       Auauauauau!!
1356       
1357       Well, one of the things that have already been started in v13 is
1358       the turn from using "int" when working with 8-bit characters to
1359       "unsigned char" (and as long as we do not support wide
1360       characters).
1361       
1362       Unfortunately one very important piece of code, that is handling
1363       encoding to quoted-printable, still used integer instead of
1364       unsigned char, which caused an automatic extension cast to take
1365       place, and that resulted in a messed up output.
1366       Sorry!
1368 v13, 2012-10-25
1369 ---------------
1371 I want to give prominence to the following people that helped to improve
1372 S-nail(1) during this development cycle, in order of appearance: Martin
1373 Neitzel, Ezequiel Garzón, Björn Persson, Paul Vojta, and, especially,
1374 John Dodson for warm words from beautiful Australia!  Many thanks also
1375 to Christos Zoulas.
1377 After i've officially forked nail(1) aka Heirloom mailx(1) as S-nail(1)
1378 on 2012-09-18 i have been able to work five weeks almost fulltime on
1379 S-nail(1) development.  The first three weeks can be characterized as
1380 hectic fireworks here and there, but then it got better and i was able
1381 to work more or less topic-centric.  In the meanwhile S-nail(1) is more
1382 than 230 commits away from the Heirloom base--and drifting further apart.
1384 S-nail(1) v13 is the first release of S-nail(1), but it was forked from
1385 Heirloom mailx(1) 12.5 7/5/10 that arose from Berkeley Mail 8. unless
1386 i'm mistaken.  What characterizes S-nail(1) v13?
1388 - The build system has been reworked almost completely.
1389   It is possible to fine-tune which features should be present in the
1390   binary and which don't.  The name of the binary can be chosen, and
1391   that choice is reflected all through the manual and the template
1392   resource file.  The manual is always complete and thus may document
1393   features that are not supported by the actual binary, though.
1394   Please see INSTALL for more.
1396 - Compiler warnings can now be used.  Please see the example WARN= flags
1397   in the Makefile, but '-Wall -Wextra -pedantic' should be silent though
1398   certainly insufficient to reflect the complex work of modern compilers.
1400 - The following recipient address list combines some of the major
1401   improvements that have been made:
1403     <addr1@cdröm.de>  (bier) , ./file1,
1404     Steffen Smöregäs (Humbabä) <sauer@bäüer.de> (Hummpäa)    ,
1405          sabberlot@träbbel.de  ,  (bier2) <a2@bür2.de> ,
1406        a3@b3.de (bier3)  , <a4@b4.de> (bier4, und \"bier5\")  ,
1407     |cat > pipe1 ,   (bier 6) <a6@bür6.de>  ,   ./file2        ,
1408     (co\$mm1) abc1@düf.de (cö,bmm,2)   (co\"m\"m.3) ,
1409     co\$bmm1 \"c,ömm2\" co\"m\"m.3 <abc2@däf2.de>  ,  |cat > pipe2 ,
1410     moppel@höppel.org
1412   That, on a single line, may be given to ":m" or (quoted) on the
1413   command line, or to "~c" or whatever, and it will work as expected
1414   (well, everything else would be a bug..) and result in the following
1415   sendmail(1) invocation:
1417   SENDMAIL.SH
1418   <-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>
1419   >>>>>>>>>>>>>>>>>
1420   Date: Thu, 25 Oct 2012 17:12:15 +0200
1421   To:
1422   Cc: Steffen =?utf-8?Q?Sm=C3=B6reg=C3=A4s?=
1423     =?utf-8?Q?_(Humbab=C3=A4)?= <sauer@xn--ber-qla4j.de> (=?utf-8?Q?Hummp=C3=A4a?=),
1424     sabberlot@xn--trbbel-cua.de, moppel@xn--hppel-jua.org,
1425     <addr1@xn--cdrm-7qa.de> (bier),
1426     co$bmm1 =?utf-8?Q?"c,=C3=B6mm2"?= co"m"m.3 <abc2@xn--df2-qla.de>,
1427     (co$mm1) abc1@xn--df-xka.de (=?utf-8?Q?c=C3=B6,bmm,2?=) (co"m"m.3),
1428     (bier 6) <a6@xn--br6-hoa.de>, <a4@b4.de> (bier4, und "bier5"),
1429     a3@b3.de (bier3), (bier2) <a2@xn--br2-hoa.de>
1430   Subject: Re: SubjectTest
1431   MIME-Version: 1.0
1432   Content-Type: text/plain; charset=us-ascii
1433   Content-Transfer-Encoding: 7bit
1435   body
1436   <<<<<<<<<<<<<<<<<
1438   So list parsing has been fixed, IDNA support has been added, and it is
1439   possible to mix pipe and file recipients *and* multiple thereof, and
1440   the result is still correct for *all* of them.
1441   I think this kind of list can be given wherever a user can directly
1442   enter such a list.  And i think all that is unique to S-nail(1).
1444 - When writing back edited messages the target MBOX mailbox can no
1445   longer become "corrupted" when the trailing newline was removed during
1446   the edit.  Also affected FreeBSD and NetBSD mail(1).
1448 - A security fix for CVE-2011-2895 was applied.
1450 - The generated Message-Id: is now more human-friendly.
1452 - The -h command line option has been dropped.  Use "-O -h XY" if your
1453   MTA really supports that.
1455 - The -O and -r command line options no longer enforce a one-shot send
1456   mode, and instead persist for the duration of the entire session.
1458 - Variables set via the -S command line option are now (un)set twice;
1459   immediately and after all the resource files have been loaded.
1461 - Other new or changed options/commands, in order of appearance:
1462   recipients-in-cc, smime-sign-include-certs, quote-fold, stealthmua,
1463   add-file-recipients, write, rfc822-no-body-from_, rfc822-show-all,
1464   mail/Mail, idna-disable, idna-strict-checks, ??
1466 - In the codebase itself an effort to reduce duplicate work and
1467   introduce caching, and to minimize the use of local variables, was
1468   started, but that is long term.  A lot of improvements here and there,
1469   too, like using the well MD5 optimization from Wei Dai, Chris Torek's
1470   hash algorithm for hash tables etc.
1472 - Incredibly important: an heraldic animal was found: snailmail.jpg!
1474 The full history can be inspected by issuing the git(1) command
1476   $ git log --reverse s-nail..s-nailv13
1478 A new TODO has been introduced, and it is getting longer and longer.
1479 Thanks.