This package is an attempt at making stock Emacs 19 correctly display
MIME-encoded messages in various charsets.  It is currently believed
to correctly display messages in alphabetic languages using
left-to-right scripts.

charset.el has been tested under GNU Emacs 19.34.1 with Gnus 5.3,
RMIME 1.2 and TM 7.89.

WHAT CHARSET DOES

`charset.el' provides functions `charset-decode-region' and
`charset-decode-string' for displaying various charsets.  It is
intended that User Agents interface to this function (and, for
efficiency, eventually to `charset-dont-munge-p'.)


INSTALLING

0. Check that you have the last version of `charset.el'.  I change my
   mind often.  My Web page is at

    http://www.dcs.ed.ac.uk/home/jec/

and my FTP directory at

    /anonymous@ftp.dcs.ed.ac.uk:/pub/jec/programs/

If this program is of any use to you, you might also be interested in
`ogonkify.tar.gz', to be found in the same place.


1. Put charset.el where Emacs will see it.  You will probably need to
   customize the first three variables in the file.  You'll also want
   to byte-compile it.


2. If you are using TM v. 7.89, apply the patch in file `TM.diff'.
   All changes are done to the file `emu-e19', except one.

   If you use it with Gnus, you might also want to say something like:

(setq gnus-newsgroup-default-charset-alist
      '(("soc\\.culture\\.polish" . iso-8859-2)))

   in order to decode messages with wrong headers.  It will slow
   reading down quite a bit, though.


3. If you are using RMIME 1.2, apply the patch provided in file
   `rmime-1.2.diff'.  This will produce a file `rmime-charset.el',
   which is a drop-in replacement for `rmime.el' (it also fixes the
   autosave bug of RMIME).
   As I no longer use RMIME, I might not adapt this code for new
   versions of RMIME.  Or perhaps I might.

   There is an RMIME Web page at

     http://www.cinti.net/~rmoody/rmime/index.html


4. If you're using Gnus, and do some heavy fontification (e.g. of
   quoted text, or signatures), you will want to load the file
   charset-gnus.el[c] *after* loading Gnus.  It will stop Gnus from
   undoing the work of charset.


5. If you are using a different MUA, you're on your own!


6. View the folder `example.babyl' in you favourite MUA.  Some parts
   of it were stolen from the distribution of Genscript 1.4.0.


7. Check the file `TODO', and send me any changes you make to the code!


