~ubuntu-branches/ubuntu/precise/topal/precise

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>
Topal — Changelog
</title>
<style type="text/css">
body {
  font-family: Helvetica, Geneva, Arial,
        SunSans-Regular, sans-serif ;
  background-color: #fafffa }
a:link {
  color: blue }
a:visited {
  color: purple }
.navbar {
  text-align: center;
  font-size: x-small }
img.validator {
	float: right
}
.tail {
        text-align: center ;
        font-size: x-small ;
        float: none ;
        clear: both
}
</style>
</head>
<body>

<hr/>

<h1>Topal — Changelog</h1>

<p>Copyright © 2001–2011  Phillip J. Brooke</p>

<dl>
<dt>06/2001, 0.1</dt> <dd>First alpha release.</dd>

<dt>06/2001, 0.2</dt> <dd>Minor changes.</dd>

<dt>06/2001, 0.3</dt> <dd>Major changes to how keys are identified and
looked up.</dd>

<dt>06/2001, 0.4</dt> <dd>Adding more customization features.</dd>

<dt>11/2001, 0.4.4</dt> <dd>Cleaned up some error messages; added -nps
mode.</dd>

<dt>11/2001, 0.4.5</dt> <dd>Added &#x2018;gpg-options&#x2019; config item with
default &#x2018;--no-options&#x2019;.  (Forgot to add this note as well....)</dd>

<dt>11/2001, 0.5.0</dt> <dd>Dumped -verify and -decrypt modes in
favour of the multiple-block &#x2018;-display&#x2019; mode.  Added -help.  Added
caching.  Added more switches relating to caching.  Better output
formatting.</dd>

<dt>11/2001, 0.5.1</dt> <dd>Improved menus.  Tidied up some of the
interface.  Added -s, which does the same as -nps.</dd>

<dt>12/2001, 0.5.2</dt> <dd>Tidied disclaimer.  Added synonyms for
-help (-h, -?, --help, --h) Cleaned up menus; keypresses aren't echoed
any longer.</dd>

<dt>12/2001, 0.5.3</dt> <dd>Altered packaging to include version in
directory name.  Changed names of some -clear options to be a bit more
sensible.  Changing config settings method (big change).  Making -s
the default operation.  Some rearrangement of code, constants.  Some
configuration editing possible via Topal.  Send has access to
configuration menu.  </dd>

<dt>12/2001, 0.5.4</dt> <dd>Bug fix; one-off error in the sending
menus.</dd>

<dt>12/2001, 0.5.5</dt> <dd>Removed redundant examples directory.
Changed over to HTML documentation.  Tweaked the RELEASE stuff.  Use
space instead of enter when waiting to continue: this looks forward to
offering a help option at every prompt.  The receive/blocks
stuff now uses an expanding array.  The GPG return value is checked
when receiving: if it's bad, then some bits of the output are omitted;
the cache file is not written.  The date bit of Topal output moved
onto the previous line (echo -n blah blah).</dd>

<dt>12/2001, 0.5.6</dt> <dd>Adding installation instructions.  Using
tee and PIPESTATUS to get stderr on screen during receiving while also
saving that output and recording gpg's exit status.  Changed RELEASE
filename to release.  Tidied up the Makefile.  Invalid passphrase
messages are grep'd out of the output.  Added &#x2018;fast continue&#x2019; options.
Key lists in the configuration section now use expanding arrays.
Changed key details selection message.  Secret key selection now
offers a menu of secret keys on the secret keyring.  Initial recipient
search excludes keys in XK list.  Added key search/selection menu
choice - much nicer to use than the add menu.  More configuration
stuff added (still more to do, although the config file can always be
used).  Partial documentation update.</dd>

<dt>2/2002, 0.5.7</dt> <dd>Adding limited RFC2015/MIME decoding of
multipart email.</dd>

<dt>2/2002, 0.5.8</dt> <dd>Adding mime-construct to configuration in
expectation of more RFC2015 features.  Put test for the config file
existing before actually attempting to read it (oops).  Added -O2
-Wall and the TOPALDEBUG variable for compiling. Put up WWW page via
own Freeserve site.  Announcing via Freshmeat.  Automating output WWW
site generation (all the grunge in the Makefile).</dd>

<dt>3/2002, 0.6.0</dt> <dd>Distribution uses a gzip'd binary now....
Added a pre-built binary that is statically linked against the GNAT
stuff so that people don't need to acquire GNAT first (this, I
believe, complies with the GNAT licence).  <br/> Added the scripts
topal-fix-email and topal-fix-folder.  This makes it a lot easier to
work with other people's multipart/signed or /encrypted email.
Procmail recipe added to this README.<br/>Added display of
application/pgp messages.  Including the text of one of these in a
reply might be difficult, but then, it was difficult without topal's
mangling.  At least they can be verified and read now.<br/>-sendmime
option added. Hack needed (in topal-pine-patch [now pine-4.44.patch])
to allow non-text/blah content-types in Pine.  RFC2015 send and
received done (including micalg detection when sending clearsigned
messages: list used from RFC3156.).  Ditto for application/pgp, but
I'm not sure of some of the parameters, since I've only ever seen
signed emails of this form.<br/>Removed some of the waits for execution,
since it seems reliable.  Added error checking on return value of GPG
in sends.</dd>

<dt>3/2002, 0.6.1</dt> <dd>The Content-Type for MIME sending is
displayed on the screen using &#x2018;cat&#x2019; rather than &#x2018;less&#x2019;, which was
getting to be annoying.<br/>Two changes that are related to how I
manage the source code: Slight tweak to makefile for keeping track
of RCS files; and using rcs -n&lt;symbolic-name&gt; to tag the
released files.</dd>

<dt>3/2002, 0.6.2</dt> <dd>MIME clear-signed messages: trailing blank
lines are now deleted before signing (this would cause BAD signature
when verifying on some other MTAs).  Added remarks to documentation
about the patch to Pine and attachments.</dd>

<dt>4/2002, 0.6.3</dt> <dd>RFC1847 multipart encapsulation added.
(See section 6.1 of RFC3156.)  Cleaned up related receiving/caching
behaviour.<br/>Another MIME clear-signed messages bugfix.  This one
sorts out line-end conventions correctly.  <br/>New patch for Pine: this
stops a SEGFAULT when using RFC2015 stuff and other attachments at the
same time.<br/>Updated documentation; added man pages for the two scripts.</dd>

<dt>4/2002, 0.6.4</dt> <dd>New patch for Pine.  Adds a workaround for
the problem where some versions of MS Exchange would silently lose
inbound MIME clearsigned email.  It turns out that a slight formatting
change stops the problem.</dd>

<dt>5/2002, 6/2002; 0.6.5, 0.6.6, 0.6.7, 0.6.8</dt> <dd>Adding more debugging,
mostly to the menus code.  Used for tracking down a nasty problem
causing exceptions.  Many thanks to Felix Madlener for pointing this
out and testing the revised code.</dd>

<dt>7/2002, 0.6.9</dt><dd>Renamed the Pine patch for when new versions
come out.  (It's still the same patch as for Topal 0.6.4.)  Added trap
for non-existent file when using &#x2018;-s&#x2019;.  Cache directory as well as
.topal directory is also chmod'd to 700.  Added README.txt to package
file (even though it's generated from the .html) so that those who
just want to &#x2018;less&#x2019; it (instead of firing up a HTML reader) can do so.</dd>

<dt>8/2002, 0.7.0</dt><dd>Changed email address in man page.  Lots more
exception handling for extra info when something goes wrong.  Moderate
code reorganisation: mostly splitting blocks of code out for future
work.  Fixed &#x2018;bug&#x2019; (feature?) where send fails if a public key is
unusable (although this may risk sending plaintext through; we assume
that if an output file was generated, then the GPG errors weren't
fatal).  Now we check instead if the output file exists.  Checking all
source files for any similar bugs in menus (cf. the 5/2002 entry).
Modified MIME RFC2015 receiving function so that it isn't so reliant
on shell calls of sed (which can fall over with nasty characters in an
incoming emails boundary).  Moreover, it can now cope with MIME parts
that don't end with a newline.  Tweaking MIME/verify cache handling:
we shouldn't actually get an output file from GPG (since we're only
verifying one part with the other); we put a vague warning if this
happens, and trap when reading the cache.  Added content-type to
plaintext for MIME/encrypted.  Documentation update.</dd>

<dt>8/2002, 0.7.1</dt><dd>Fixed minor bug with inverted return code
(&#x2018;-s&#x2019; trap).  Doc update.</dd>

<dt>9/2002, 0.7.2</dt><dd>Fixed minor bug in key list handling code
(dealing with key selection).</dd>

<dt>9/2002; 0.7.3, 0.7.4 (BETA)</dt><dd>Disposed of the dependency on a shell by
introducing Ada bindings for fork/exec/dup/pipe/glob, etc..  Several
external binaries are no longer needed (cat, echo).  Most return codes
are now properly checked (although still need to do a better audit).
Followed Eduardo Chappa's advice and changed Pine patch version
letter.  Miscellaneous cleanups and fixes.  Many thanks to Peter
Losher for giving me the incentive to sort out the external calls.</dd>

<dt>9/2002; 0.7.5 (BETA)</dt><dd>Tidying up structure of external calls, and
how the various messages are built up and torn down.  Changed the lynx
switches at the suggestion of Felix Madlener (many thanks!).  When
receiving MIME encrypted attachments, the output is not included in
the Topal output, but only in the metamail invocation.</dd>

<dt>10/2002; 0.7.6 (BETA)</dt><dd>Explicitly noted which versions are
not intended for general use (beta versions).  Rearranged command line
parsing for more flexibility in future.</dd>

<dt>10/2002; 0.7.7 (BETA)</dt><dd>Re-implementing topal-fix-email and
topal-fix-folder as part of the main topal binary.  This removes the
(script) dependency on munpack, but adds formail and diff to the main
binary.  Fixed some missing bits for particular binaries in
configuration handling.  Adding &#x2018;important changes from last stable
version&#x2019; documentation.  Tweaked the body extraction procedure.
Tweaked some output messages.  Major changes to menus: they now use
enumerated types rather than integers....  Tweaking cl_menu some
more.  Added &#x2018;pass-thu&#x2019; option to send menu (so you can always use the
Topal filter.  This might also fix the minor problem with text/html
occasionally being sent when it shouldn't be....)  Fixed bug where
MIME decrypt failure would still cause metamail to be invoked, but
that's a waste of time.</dd>

<dt>10/2002; 0.7.8</dt><dd>Clearing out case statements with &#x2018;when
others&#x2019;.  Tidying up sending.adb.  Fixed problem in MIME output where
a leading blank line was added.  Finally implemented &#x2018;topal
--fix-folders&#x2019; functionality added.  No longer need the two old
scripts (I hope)!  Another documentation tidy-up.  Added
&#x2018;inline-separate-output&#x2019; option: this effectively turns off the GnuPG/Topal
wrappers in output.  However, the side-effect is that the cache must
be cleared when upgrading to this version.
</dd>

<dt>11/2002; 0.7.9</dt><dd>Added some infrastructure for
encrypting/signing attachments (but this is nowhere near working yet).
Documentation and manpage update (again).  Seems stable, will release.
</dd>

<dt>2/2003; 0.7.10, 0.7.11</dt><dd>Tweaking distribution pages (mkdistrib).
Including patches against Pine versions 4.50 and 4.53.  (They're all
more-or-less the same patch.  It's pretty
easy to apply them against 4.51 and 4.52 if you feel so inclined.)
Further doc clean up (particular the stuff about important changes
from previous stable versions).  Implemented Felix M.'s suggestion for
handling non-existant command-line options: things that aren't valid
options, but are prefixed with a &#x2018;-&#x2019; get a more helpful error
message.  --fix-email workaround also writes out the original input in 
the exception handler.  Changed recommended procmail recipe so that
Topal's exit code is checked.
</dd>

<dt>2/2003; 0.7.12</dt><dd>Adding &#x2018;workaround-error-log&#x2019; file to
.topal. This accepts output from topal --fix-email when it fails to
exit cleanly.  Not quite clear if this bit works yet (was tracking
down other problem).  It appears that when running without a real
terminal, the call to set_echo fails.  Odd.  Nasty workaround
implemented.
</dd>

<dt>2/2002; 0.7.13</dt><dd>Added missing includes to ada-echo-c.c.
Perhaps related to issue in the previous entry.</dd>

<dt>4/2003; 0.7.13b</dt><dd>Bug fix release only - backported from
(not-yet-released 0.8.0).  Fixed bug when
changing own signing key using the -config option - thanks to Stewart
James for the bug report.  </dd>

<dt>10/2003; 0.7.13.2</dt><dd>Bug fix release only - backported from
(not-yet-released 0.8.0).  Changed bug fix versioning scheme.
Makefile now links properly against static GNAT runtime.  Fixed
problem which manifests as: &#x2018;relocation error: /lib/libreadline.so.4:
undefined symbol: BC&#x2019; (needed instruction to link against ncurses) -
thanks to Marty Hoff for the bug report. Added patch against Pine
version 4.58.</dd>

<dt>10/2003; 0.7.13.3</dt><dd>Now use -gnatwa and -gnato for all Ada
compilation.  It was omitted from the main binary build command
before.  Fixed all the resulting warnings.</dd>

<dt>1/2004; 0.7.13.4</dt><dd>Patched externals calls for errno to
prevent (in some cases) warnings from ld.so, and in other cases,
failures to build.</dd>

<dt>6/2004; 0.7.13.5</dt><dd>Added patch against Pine version
4.60.  Updated some notices.</dd>

<dt>1/4/2005; 0.7.13.6</dt><dd>Calls to the GPG binary now have LANG
set to C before exec so that we don't have to worry about different
language output in GPG.  Thanks for Joern Brederec for the bug report
and suggestion of how to fix it.</dd>

<dt>2005-2007</dt><dd>Four internal development releases junked.</dd>

<dt>8/1/2008; release 55</dt><dd>
<tt>--fix-email</tt> now replaces the original message with a
multipart/misc wrapper, rather than expanding it into a
multipart/alternative message.
<br/>
Replaced some key selection code.  Hopefully, this reduces the number
of locale-dependent and GPG version-specific problems.  Additionally,
revoked, disabled and invalid keys are no longer offered; checks are
made to ensure that the key is valid for encryption/signing when applicable.
<br/>
New patch for Alpine 1.00.  Includes configuration setting.
<br/>
The &#x2018;pass through unchanged&#x2019; send option no longer modifies the
content-type to text/plain.
<br/>
Should now build and run on Cygwin.
<br/>
Licence is now GPL-3.
<br/>
Attempt to prevent potential memory leak (if running for a long time)
by making the implementation of <tt>expanding_array</tt> a controlled type.
<br/>
Cleaned up Ada source to reduce warnings.
<br/>
Other minor changes, e.g., better checks on keylists, documentation clean-up.
<br/>
Changed <a href="#release-numbering">release numbering</a>.
<br/>
HTML cleaned up and CSS added.</dd>

<dt>8/1/2008; release 56</dt><dd>
<tt>--read-from</tt> option added to select different signing keys
depending on the From line.  Also added <tt>sake</tt> and <tt>sxk</tt>
configurations.
<br/>
Fixed bug in Keys.Remove.Key (didn't match if the full fingerprint
wasn't given).
<br/>
Command-line parser now accepts 1 or more hyphens for any option.
<br/>
Improved keylist documentation.
<br/>
Corrected release date for release 55... oops.
</dd>

<dt>8/1/2008; release 57</dt><dd>
Initial attempt at supporting attachments within Topal.
<br/>
Changed MIME boundary detection code (the previous algorithm couldn't
cope with multipart included in a signed email).  Please tell me if
this breaks your emails....
<br/>
Bug fix to _INCLUDEALLHDRS_ - it needs to turn the CRLF back into LF
or it might chop off some of your message....
</dd>
<dt>22/6/2008; release 58</dt><dd>
UI improvements (count keys in keylist, clearer indication of position
in menus).
<br/>
Added patch for Alpine 1.10.  Renamed all patch files.
<br/>
Default paths for binaries are no longer absolute.  
<br/>
Configuration files now allow comments, but they're not preserved by Topal.
<br/>
Added more exception handling messages.
<br/>
Sending and receiving both save off original input as tempfiles to
help debugging.
<br/>
Added --ask-charset command line option.  This is really only for
testing a new workaround for locale-related bad signatures.  Please
see <a href="#locale-problems">locale problems</a> in the notes and
send feedback.
<br/>
Started removing dependency on mime-construct; new source files mime.ad[sb].
<br/>
Build date added to binary.
</dd>
<dt>3/7/2008; release 59</dt><dd>
Added sequence numbers to temporary files to reduce possible name
conflicts.
<br/>
The makefile's install target now installs to INSTALLPATH.  This can
be overridden, e.g., <tt>make install INSTALLPATH=/usr/local</tt>.
The four more specific paths, INSTALLPATHBIN, INSTALLPATHMAN,
INSTALLPATHDOC and INSTALLPATHPATCHES can also be overridden.  Fixes
request from Nils Schlupp re: ebuild.
<br/>
The --ask-charset command-line option is now only used if a bad signature
is returned; a second attempt is then made if a different character
set is suggested by the user.
</dd>
<dt>13/7/2008; release 60</a></dt><dd>
Update installation instructions for make install.
<br/>
We now use a modified version of Jeffrey S. Dutky's mime-tool instead
of mime-construct for creating MIME messages.  We include our modified
version in the Topal tarball (since both are GPL, and our
modifications are needed if creating MIME messages).
<br/>
MIME viewing can now use metamail, use run-mailcap or save the attachment to the
folder <tt>~/.topal/viewmime</tt> (which you can then open in
Alpine).  run-mailcap and saving support are new.
<br/>
Sending menu allows user to view and edit the email.  A quicker
method for changing/setting the signing (own) key is available.
</dd>
<dt>14/7/2008; release 61</dt><dd>
An initial, rather crude, but (for my purposes at least) effective
remote mode for sending.
<br/>
Some history is now saved.
</dd>
<dt>17/7/2008; release 62</dt><dd>
Added basic support for S/MIME verification of messages.
<br/>
Quoted-printable encoder (in MIME-tool) improved (single dots and
leading "From ") as per RFC2049.
<br/>
Decode quoted-printable and base64 before calling run-mailcap.
<br/>
Ignore errors in strip in Makefile (trips up Cygwin, which expects the
executable to be foo.exe).
<br/>
Update feature list for remote sending.
<br/>
Internal changes to configuration storage.
</dd>
<dt>31/8/2008; release 63</dt><dd>
Update change list for release 62 (omitted some items...).
<br/>
Give a sensible warning message instead of dying with an exception
when (1) signing operations are called without own key set; (2)
attempting to choose own key without any secret keys available.
<br/>
Added some hints in the documentation.
<br/>
Initial attempt at supporting remote decryption.
<br/>
Handle SIGINT ourselves so that temporary files are cleaned up.  Also
clean up more often when exceptions occur.
</dd>
<dt>24/10/2008; release 64</dt><dd>
Update feature list for release 63's remote decryption support.
<br/>
Add patch to Topal sources for Cygwin. (The recent interrupt code
doesn't build.)
<br/>
Bug fix: temporary files weren't being deleted, because
Rm_Tempfiles_PID hadn't been changed to match Temp_File_Name.
<br/>
Added patch for Alpine 2.00.   Alpine's S/MIME needs to be turned off
for Topal's S/MIME verification to work.
<br/>
Bug fix in Externals.Simple.Guess_Content_Type.
</dd>
<dt>1/5/2009; release 65</dt><dd>
MIME sending now uses the current locale as the content-type header charset.
<br/>
MIME receiving (verification) tries to use the character set given in
its first attempt.
<br/>
Signing calls to GPG use <tt>--textmode flag</tt> (shouldn't be needed
if the dos2unix calls work, but experiments suggest some problems if
we don't do this).
<br/>
Fix remote server so that emails with multiple recipients are handled
properly.
<br/>
Added new patch to Alpine that might make it easier to read
multipart signed/encrypted messages.  This makes the procmail recipe
redundant, but needs more testing.
<br/>
Attempt to manage different character sets when verifying S/MIME.
<br/>
MIME messages now include a prolog explaining that they're OpenPGP
messages.  Also added appropriate Content-Disposition headers to help
client programs.
<br/>
Update docs re: Alpine patches.
<br/>
Code cleanup (e.g., vars that could be declared constant, and some
unused procedure formals).
</dd>
<dt>6/6/2009; release 66</dt><dd>
Removed spurious spaces from Topal &#x2018;-----&#x2019; text that were messing up
format=flowed text.  Note that this doesn't fix cache files that
already have this problem.
<br/>
Changed the default sending and receiving GPG options (use
the <tt>-default</tt> option to see them).  This does not override
whatever is in your current <tt>.topal/config</tt> file.
<br/>
Added a configuration option &#x2018;omit-inline-disposition-name&#x2019;:
apparently some mail services mistreat inline MIME parts if they have
a filename.  If this option is set, then no filename parameter is
added to inline content-disposition headers.  The option can be
changed via the configuration menu.
</dd>
<dt>6/6/2009; release 67</dt><dd>
Added another configuration option &#x2018;omit-inline-disposition-header&#x2019;.
If a disposition header of value inline would be added, it's simply
omitted altogether.
</dd>
<dt>27/6/2009; release 68</dt><dd>
Minor bug fix with configuration handling of
omit-inline-disposition-header.
<br/>
Added new configuration option save-on-send.
<br/>
A range of major and minor changes to the sending interface.
<br/>
Added the sd configuration option that allows keys or emails to be
associated with particularly sending options.
<br/>
When secret keys aren't available, still try to add a suitable key for
self for encryption.
<br/>
MIME viewer setting has been replaced by two: one for decrypt and one
for verify.
<br/>
Bad lines in the configuration file now result in a warning, not an exception.
<br/>
Internal modifications to configuration handling.
</dd>
<dt>21/7/2009; release 69</dt><dd>
No longer calling an external app for line-end conversions.
<br/>
Added a note re: Alpine's S/MIME message about certificates.
<br/>
Show the list of recipients just before sending (from the to/cc/bcc
lists; not lcc, as Alpine doesn't pass those to in the _RECIPIENTS_
token).  The idea is to allow the user to spot the “oh no, I didn't
intend to email that person” problem.
</dd>
<dt>22/9/2009; release 70</a></dt><dd>
Added <tt>use-agent</tt> configuration option.  This has three values:
(1) never use an agent, (2) only use it for decryption, (3) always use
it.  Don't put GPG's <tt>--[no-]use-agent</tt> options in any other
configuration options or it might be confusing.
<br/>
Adding attachments when using a non-MIME mode forces a change to a
suitable mode (where possible).
<br/>
Presentation changes for recipient list check.
<br/>
Fixed a minor typo in a user message.
</dd>
<dt>25/2/2010; release 71</a></dt><dd>
Added more MICALGs from RFC4880.
<br/>
Handle missing Content-Type headers in multipart messages.
<br/>
Reorganise menus: hopefully, they're easier to read now.
Add some colourisation (this can be disabled by
setting <tt>ansi-terminal</tt> to <tt>off</tt>).
Assorted tidying.
<br/>
Warn if sending defaults to encryption, but some keys are missing.
<br/>
Add -pd - pipe-display mode.  Takes stdin and treats it as a MIME
email for display/verification.
<br/>
Release code is now taken from the <tt>README.html</tt> file rather
than a separate <tt>release</tt> file.
<br/>
Slight clean-up of this README.
</dd>
<dt>25/2/2010; release 72</a></dt><dd>
Fix menus for non-Pine sending.  (‘Go’ wasn't working!)
<br/>
Trap attempts to encrypt when no keys are in the key list.
<br/>
Minor change to distrib text and Makefile.
<br/>
Distrib target in Makefile now uses GPG agent.
</dd>

<!-- Don't remove the next line - or its counterpart later on! -->
<!-- MRC -->

<dt><a name="last-changes"/>29/4/2011; release 73</a></dt><dd>
Fix crash when sending attachments with spaces in filenames.
<br/>
Add new switch, <tt>wait-if-missing-keys</tt>, which requires the user
to acknowledge if keys are missing when defaulting to encryption.
<br/>
Slightly reorganise configuration menu to keep it within 24 lines.
<br/>
Update documentation re: crashes related to the second patch and
mailcap files.
<br/>
Topal makes greater efforts to check that external commands exist
before running them.
<br/>
Exception messages are repeated via Ada's exception handling (if Topal
panics).
<br/>
Added <tt>decrypt-prereq</tt> option.  See <a href="#decrypt-prereq">this note</a>.
<br/>
Experimental S/MIME sending support added.
<br/>
More use of GnuPG's <tt>--status-fd</tt> option so that we can determine exit
status properly.
<br/>
Replaced ancient <tt>expanding_array</tt> package
with <tt>Ada.Containers.Vectors</tt>.
<br/>
Adding sendmail-path filter mode.  This is needed for the S/MIME
encrypted and S/MIME sign+encrypted modes.  (Otherwise only Topal can
read them; neither Outlook nor Thunderbird will cope with an S/MIME
part inside multipart/mixed.)  This mode also
needs <tt>pinentry-qt</tt>
for <tt>gpgsm</tt>: <tt>pinentry-curses</tt> doesn't like this environment.
<br/>
In the sendmail-path filter mode, we no longer need the content-type
guessing.  We can simply re-use the content-type from the original
header.
<br/>
Added replace-ids option which can replace Message-ID (and also
Content-ID) in sendmail-path filter mode.
<br/>
The sendmail-path mode can also add a token to help spot our cc'd
emails.  Use something like <tt>st=user@domain,token</tt> to set a
password.  This is hashed with some headers for each email and added
to an <tt>X-Topal-Send-Token</tt> header.  Topal then has a <tt>-cst
  token</tt> mode which adds a <tt>X-Topal-Check-Send-Token</tt>
header with either <tt>yes</tt> or <tt>no</tt> for that header.
<br/>
Investigation suggests that group addresses are handled other than I
expect.  E.g., <tt>Group name:;</tt> in the to: field and the actual
list of addresses in lcc field will result in the addresses appearing
in the bcc field in sendmail-path filter mode.
<br/>
Rewrite main documentation in LaTeX: the main manual is
now  <a href="topal.pdf"><tt>topal.pdf</tt></a>.  The 
<a href="Changelog.html">change log</a> is still in HTML.
<br>
Start adding interoperability notes to manual.
<br/>
Diagnosing issue with clearsigned (both OpenPGP and S/MIME) emails
that have passed through an MS Exchange server being corrupted.
<br/>
Added opaque signing option for S/MIME.
<br/>
Added <tt>attachment-trap</tt> boolean option.  In <tt>-asend</tt>
mode, this causes Topal to complain if the message body contains the
string “attach” but doesn't have any attachments.
</dd>
<dt><a name="last-changes"/>23/6/2011; release 74</a></dt><dd>
Oops, wrong year in release 73 date….
<br/>
Topal needs GNAT's <tt>-gnat05</tt> switch.
<br/>
Documentation update:<ul>
<li> Noted the need for GNU's sed (particularly
important if you're using
Mac OS X). </li>
<li> Noted that <tt>gpg-agent</tt> needs HUPing
  if <tt>trustlist.txt</tt> is updated.
</li> 
</ul>
<br/>
Added <tt>include-send-token</tt> switch, where 1 never includes them,
2 asks and 3 always includes them.
<br/>
Warnings about configuration errors now go to stderr, rather than
messing up other processing output.
<br/>
Heuristic for attachment trap is improved.  This now copes with the
case where the email comprises a single multipart/mixed MIME part.
<br/>
Some comparisons for content-types are case-insensitive now.
</dd>
<!-- MRC -->
</dl>

<hr/>

<p>See the documentation in <a href="topal.pdf"><tt>topal.pdf</tt></a>
  for further details.</p>

<hr/>

</body>
</html>