                            GMime, version 1.0.1
                   by Jeffrey Stedfast <fejj@helixcode.com>


WHAT IS GMIME
-------------

GMime is a set of utilities for parsing and creating messages using
the Multipurpose Internet Mail Extension (MIME) as defined by the
following RFCs:

 * 0822: Standard for the Format of Arpa Internet Text Messages
 * 1521: MIME (Multipurpose Internet Mail Extensions) Part One:
         Mechanisms for Specifying and Describing the Format of 
         Internet Message Bodies
 * 2045: Multipurpose Internet Mail Extensions (MIME) Part One:
         Format of Internet Message Bodies
 * 2046: Multipurpose Internet Mail Extensions (MIME) Part Two:
         Media Types
 * 2047: Multipurpose Internet Mail Extensions (MIME) Part Three:
         Message Header Extensions for Non-ASCII Text
 * 2048: Multipurpose Internet Mail Extensions (MIME) Part Four:
         Registration Procedures
 * 2049: Multipurpose Internet Mail Extensions (MIME) Part Five:
         Conformance Criteria and Examples
 * 2183: Communicating Presentation Information in Internet Messages:
         The Content-Disposition Header Field
 * 2184: MIME Parameter Value and Encoded Word Extensions: Character
         Sets, Languages, and Continuations
 * 2231: MIME Parameter Value and Encoded Word Extensions: Character
         Sets, Languages, and Continuations (Obsoletes rfc2184)

Other RFCs of interest:

 * 1847: Security Multiparts for MIME: Multipart/Signed and 
         Multipart/Encrypted
 * 1872: The MIME Multipart/Related Content-type
 * 1927: Suggested Additional MIME Types for Associating Documents
 * 2015: MIME Security with Pretty Good Privacy (PGP)
 * 2311: S/MIME Version 2 Message Specification
 * 2312: S/MIME Version 2 Certificate Handling
 * 2387: The Multipart/Related Content-Type.
 * 2424: Content Duration MIME Header Definition
 * 2632: S/MIME Version 3 Certificate Handling
 * 2633: S/MIME Version 3 Message Specification
 * 2634: Enhanced Security Services for S/MIME


LICENSE INFORMATION
-------------------

The GMime library is Copyright (C) 2000,2002 Jeffrey Stedfast.

This library is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


HISTORY
-------

As a developer and user of Electronic Mail clients, I had come to
realize that the vast majority of E-Mail client solutions had
less-than-satisfactory MIME implementations. More often than not these
E-Mail clients created broken MIME messages and/or would incorrectly
try to parse a MIME message thus subtracting from the full benefits
that MIME was meant to provide. GMime is meant to address this issue
by following the MIME specification as closely as possible while also
providing programmers with an extremely easy to use application
programming interface (API).


OBTAINING GMIME
---------------

Sources to GMime may be obtained from:
  http://spruce.sourceforge.net/gmime/sources/

Information regarding GMime may be obtained from the Spruce home page:
  http://spruce.sourceforge.net/gmime/

Experimental CVS versions of GMime may be obtained by following the
directions at cvs.gnome.org, module gmime.

  cvs -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
  cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co gmime


REQUIREMENTS
------------

For proper compilation and functionality of GMime, the following packages
are REQUIRED:

  - Glib version 1.2.x
    Glib provides a number of portability-enhancing functions and types.
    Glib is included in most GMime-supported operating system
    distributions.  Glib sources may be obtained from:
      ftp://ftp.gtk.org/pub/gtk/v1.2


DOCUMENTATION
-------------

This is the README file for GMime.  Additional documentation related to
development using GMime has been included within the source release
of GMime.

  doc/                  Contains SGML and HTML versions of the GMime manual

  rfc/                  Contains text versions of the RFCs for the
                        specifications GMime supports

  AUTHORS               List of primary authors (source code developers)

  COPYING               The GNU General Public License, version 2

  ChangeLog             Log of changes made to the source code

  INSTALL               In-depth installation instructions

  NEWS                  Release notes (Overview of changes)

  TODO                  Description of planned GMime development


You can find online developer documentation at
http://spruce.sourceforge.net/gmime/doc


REPORTING BUGS
--------------

Bugs may be reported to the GMime development team by sending email to:
fejj@helixcode.com
