Noteworthy changes in version 1.17 (2014-10-15) [C13/A13/R0]
-----------------------------------------------

 * New error codes for TLS protocol libraries.

 * New configure option --enable-build-timestamp.

 * New man page for gpg-error-config.

 * Interface changes relative to the 1.16 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_SOURCE_TLS               NEW.
 GPG_ERR_NO_CERT_CHAIN            NEW.
 GPG_ERR_CERT_TOO_LARGE	          NEW.
 GPG_ERR_INV_RECORD               NEW.
 GPG_ERR_BAD_MAC	          NEW.
 GPG_ERR_UNEXPECTED_MSG           NEW.
 GPG_ERR_COMPR_FAILED             NEW.
 GPG_ERR_WOULD_WRAP               NEW.
 GPG_ERR_FATAL_ALERT              NEW.
 GPG_ERR_NO_CIPHER                NEW.
 GPG_ERR_MISSING_CLIENT_CERT      NEW.
 GPG_ERR_CLOSE_NOTIFY             NEW.
 GPG_ERR_TICKET_EXPIRED           NEW.
 GPG_ERR_BAD_TICKET               NEW.
 GPG_ERR_UNKNOWN_IDENTITY         NEW.
 GPG_ERR_BAD_HS_CERT              NEW.
 GPG_ERR_BAD_HS_CERT_REQ          NEW.
 GPG_ERR_BAD_HS_CERT_VER          NEW.
 GPG_ERR_BAD_HS_CHANGE_CIPHER     NEW.
 GPG_ERR_BAD_HS_CLIENT_HELLO      NEW.
 GPG_ERR_BAD_HS_SERVER_HELLO      NEW.
 GPG_ERR_BAD_HS_SERVER_HELLO_DONE NEW.
 GPG_ERR_BAD_HS_FINISHED          NEW.
 GPG_ERR_BAD_HS_SERVER_KEX        NEW.
 GPG_ERR_BAD_HS_CLIENT_KEX        NEW.
 GPG_ERR_BOGUS_STRING             NEW.
 gpgrt_pending                    NEW.
 gpgrt_pending_unlocked           NEW.


Noteworthy changes in version 1.16 (2014-09-18) [C12/A12/R2]
-----------------------------------------------

 * Support building for iOS.

 * Fixed a prototype mismatch.

 * Fix es_fclose for streams opened with "samethread".


Noteworthy changes in version 1.15 (2014-09-11) [C12/A12/R1]
-----------------------------------------------

 * This releases fixes problems with the use of off_t and ssize_t by
   the estream functions introduced with 1.14.  Although this is
   technically an ABI break on some platforms, we take this as a
   simple bug fix for 1.14.  The new functions are very unlikely in
   use by any code and thus no breakage should happen.  The 1.14
   tarball will be removed from the archive.

 * Add type gpgrt_off_t which is guaranteed to be 64 bit.

 * Add type gpgrt_ssize_t to make use on Windows easier.  On Unix
   platforms this is an alias for ssize_t.


Noteworthy changes in version 1.14 (2014-09-08) [C12/A12/R0]
-----------------------------------------------

 * Added gpgrt_lock_trylock.

 * Added the estream library under the name gpgrt and a set of macros
   to use them with their "es_" names.

 * Interface changes relative to the 1.13 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_KEY_DISABLED         NEW.
 gpgrt_init                   NEW macro.
 gpgrt_check_version          NEW.
 gpgrt_lock_trylock           NEW.
 gpgrt_set_syscall_clamp      NEW.
 gpgrt_set_alloc_func         NEW.
 gpgrt_stream_t               NEW.
 gpgrt_cookie_io_functions_t  NEW.
 gpgrt_syshd_t                NEW.
 GPGRT_SYSHD_NONE             NEW.
 GPGRT_SYSHD_FD               NEW.
 GPGRT_SYSHD_SOCK             NEW.
 GPGRT_SYSHD_RVID             NEW.
 GPGRT_SYSHD_HANDLE           NEW.
 gpgrt_stdin                  NEW macro.
 gpgrt_stdout                 NEW macro.
 gpgrt_stderr                 NEW macro.
 gpgrt_fopen                  NEW.
 gpgrt_mopen                  NEW.
 gpgrt_fopenmem               NEW.
 gpgrt_fopenmem_init          NEW.
 gpgrt_fdopen                 NEW.
 gpgrt_fdopen_nc              NEW.
 gpgrt_sysopen                NEW.
 gpgrt_sysopen_nc             NEW.
 gpgrt_fpopen                 NEW.
 gpgrt_fpopen_nc              NEW.
 gpgrt_freopen                NEW.
 gpgrt_fopencookie            NEW.
 gpgrt_fclose                 NEW.
 gpgrt_fclose_snatch          NEW.
 gpgrt_onclose                NEW.
 gpgrt_fileno                 NEW.
 gpgrt_fileno_unlocked        NEW.
 gpgrt_syshd                  NEW.
 gpgrt_syshd_unlocked         NEW.
 gpgrt_flockfile              NEW.
 gpgrt_ftrylockfile           NEW.
 gpgrt_funlockfile            NEW.
 gpgrt_feof                   NEW.
 gpgrt_feof_unlocked          NEW.
 gpgrt_ferror                 NEW.
 gpgrt_ferror_unlocked        NEW.
 gpgrt_clearerr               NEW.
 gpgrt_clearerr_unlocked      NEW.
 gpgrt_fflush                 NEW.
 gpgrt_fseek                  NEW.
 gpgrt_fseeko                 NEW.
 gpgrt_ftell                  NEW.
 gpgrt_ftello                 NEW.
 gpgrt_rewind                 NEW.
 gpgrt_getc                   NEW macro.
 gpgrt_getc_unlocked          NEW macro.
 gpgrt_fgetc                  NEW.
 gpgrt_fputc                  NEW.
 gpgrt_ungetc                 NEW.
 gpgrt_read                   NEW.
 gpgrt_write                  NEW.
 gpgrt_write_sanitized        NEW.
 gpgrt_write_hexstring        NEW.
 gpgrt_fread                  NEW.
 gpgrt_fwrite                 NEW.
 gpgrt_fgets                  NEW.
 gpgrt_putc                   NEW macro.
 gpgrt_putc_unlocked          NEW macro.
 gpgrt_fputs                  NEW.
 gpgrt_fputs_unlocked         NEW.
 gpgrt_getline                NEW.
 gpgrt_read_line              NEW.
 gpgrt_free                   NEW.
 gpgrt_fprintf                NEW.
 gpgrt_fprintf_unlocked       NEW.
 gpgrt_printf                 NEW.
 gpgrt_printf_unlocked        NEW.
 gpgrt_vfprintf               NEW.
 gpgrt_vfprintf_unlocked      NEW.
 gpgrt_setvbuf                NEW.
 gpgrt_setbuf                 NEW.
 gpgrt_set_binary             NEW.
 gpgrt_tmpfile                NEW.
 gpgrt_opaque_set             NEW.
 gpgrt_opaque_get             NEW.
 gpgrt_fname_set              NEW.
 gpgrt_fname_get              NEW.
 gpgrt_asprintf               NEW.
 gpgrt_vasprintf              NEW.
 gpgrt_bsprintf               NEW.
 gpgrt_vbsprintf              NEW.
 gpgrt_snprintf               NEW.
 gpgrt_vsnprintf              NEW.


Noteworthy changes in version 1.13 (2014-04-15) [C11/A11/R0]
-----------------------------------------------

 * Added a portable mutex API.

 * The AM_PATH_GPG_ERROR macro now defines GPG_ERROR_MT_CFLAGS and
   GPG_ERROR_MT_LIBS autoconf output variables for use by programs
   which need gpgrt based thread support.  gpg-error-config has a new
   option --mt.

 * Interface changes relative to the 1.12 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_KEY_ON_CARD          NEW.
 GPG_ERR_MAC_ALGO             NEW.
 GPG_ERR_INV_LOCK_OBJ         NEW.
 gpgrt_lock_t                 NEW.
 GPGRT_LOCK_INITIALIZER       NEW.
 GPGRT_LOCK_DEFINE            NEW.
 gpgrt_lock_init              NEW.
 gpgrt_lock_lock              NEW.
 gpgrt_lock_unlock            NEW.
 gpgrt_lock_destroy           NEW.
 gpgrt_yield                  NEW.


Noteworthy changes in version 1.12 (2013-06-24)
-----------------------------------------------

 * Add support for 64 bit Windows (use ./autogen.sh --build-w64).

 * Fixed parsing and installing of the Windows .def file.

 * Interface changes relative to the 1.11 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_NO_CRYPT_CTX         NEW.
 GPG_ERR_WRONG_CRYPT_CTX      NEW.
 GPG_ERR_BAD_CRYPT_CTX        NEW.
 GPG_ERR_CRYPT_CTX_CONFLICT   NEW.
 GPG_ERR_BROKEN_PUBKEY        NEW.
 GPG_ERR_BROKEN_SECKEY        NEW.


Noteworthy changes in version 1.11 (2013-02-25)
-----------------------------------------------

 * New error source GPG_ERR_SOURCE_ASSUAN for Libassuan related
   errors.

 * New macros GPG_ERROR_VERSION and GPG_ERROR_VERSION_NUMBER.  New
   function gpg_error_check_version.

 * Interface changes relative to the 1.10 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_NO_KEYSERVER          NEW.
 GPG_ERR_INV_CURVE             NEW.
 GPG_ERR_UNKNOWN_CURVE         NEW.
 GPG_ERR_DUP_KEY               NEW.
 GPG_ERR_AMBIGUOUS             NEW.
 GPG_ERR_SOURCE_ASSUAN         NEW.
 gpg_error_check_version       NEW.
 GPG_ERROR_VERSION             NEW.
 GPG_ERROR_VERSION_NUMBER      NEW.


Noteworthy changes in version 1.10 (2010-10-26)
-----------------------------------------------

 * Using a static library on W32 does now work.

 * Interface changes relative to the 1.9 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_NOT_INITIALIZED       NEW.
 GPG_ERR_MISSING_ISSUER_CERT   NEW.
 GPG_ERR_FULLY_CANCELED        NEW.


Noteworthy changes in version 1.9 (2010-07-21)
----------------------------------------------

 * New function gpg_err_deinit.

 * Fix building of static lib under W32.

 * Interface changes relative to the 1.8 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_MISSING_KEY           NEW.
 GPG_ERR_TOO_MANY              NEW.
 GPG_ERR_LIMIT_REACHED         NEW.
 gpg_err_deinit                NEW.


Noteworthy changes in version 1.8 (2010-05-06)
----------------------------------------------

 * Support for WindowsCE.

 * New option --list for gpg-error.

 * Interface changes relative to the 1.7 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_NOT_ENABLED           NEW.
 GPG_ERR_SOURCE_G13            NEW.
 GPG_ERR_NO_ENGINE             NEW.
 gpg_err_set_errno             NEW.


Noteworthy changes in version 1.7 (2008-11-26)
----------------------------------------------

 * Minor fixes and a few new error codes.

 * Interface changes relative to the 1.6 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_NOT_OPERATIONAL       NEW
 GPG_ERR_NO_PASSPHRASE         NEW
 GPG_ERR_NO_PIN                NEW


Noteworthy changes in version 1.6 (2007-10-29)
----------------------------------------------

 * Fixed a build problem under Windows.

 * Interface changes relative to the 1.4 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GPG_ERR_UNFINISHED            NEW
 GPG_ERR_SOURCE_GPA            NEW
 GPG_ERR_SOURCE_KLEO           NEW


Noteworthy changes in version 1.5 (2006-11-30)
----------------------------------------------

 * Minor build system fixes.

 * Updated gettext.  Removed included gettext copy.

 * gpg-error has a new option --version.


Noteworthy changes in version 1.4 (2006-09-14)
----------------------------------------------

 * Support for Common Lisp is included.

 * New error codes for the Assuan IPC library.

 * New error code GPG_ERR_MISSING_ERRNO to be used in cases when a
   system accidently does not set errno but a system error definitely
   occured.

 * New error source GPG_ERR_SOURCE_ANY to allow proper use of
   libgpg-error even if a specific source is not available.

 * New convenience functions gpg_err_code_from_syserror and
   gpg_error_from_syserror which make sure never to return 0.

 * Interface changes relative to the 1.2 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 gpg_err_code_from_syserror    NEW
 gpg_error_from_syserror       NEW
 GPG_ERR_SOURCE_ANY            NEW
 GPG_ERR_MISSING_ERRNO         NEW
 GPG_ERR_UNKNOWN_OPTION        NEW
 GPG_ERR_UNKNOWN_COMMAND       NEW
 GPG_ERR_ASS_GENERAL           NEW
 GPG_ERR_ASS_ACCEPT_FAILED     NEW
 GPG_ERR_ASS_CONNECT_FAILED    NEW
 GPG_ERR_ASS_INV_RESPONSE      NEW
 GPG_ERR_ASS_INV_VALUE         NEW
 GPG_ERR_ASS_INCOMPLETE_LINE   NEW
 GPG_ERR_ASS_LINE_TOO_LONG     NEW
 GPG_ERR_ASS_NESTED_COMMANDS   NEW
 GPG_ERR_ASS_NO_DATA_CB        NEW
 GPG_ERR_ASS_NO_INQUIRE_CB     NEW
 GPG_ERR_ASS_NOT_A_SERVER      NEW
 GPG_ERR_ASS_NOT_A_CLIENT      NEW
 GPG_ERR_ASS_SERVER_START      NEW
 GPG_ERR_ASS_READ_ERROR        NEW
 GPG_ERR_ASS_WRITE_ERROR       NEW
 GPG_ERR_ASS_TOO_MUCH_DATA     NEW
 GPG_ERR_ASS_UNEXPECTED_CMD    NEW
 GPG_ERR_ASS_UNKNOWN_CMD       NEW
 GPG_ERR_ASS_SYNTAX            NEW
 GPG_ERR_ASS_CANCELED          NEW
 GPG_ERR_ASS_NO_INPUT          NEW
 GPG_ERR_ASS_NO_OUTPUT         NEW
 GPG_ERR_ASS_PARAMETER         NEW
 GPG_ERR_ASS_UNKNOWN_INQUIRE   NEW
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Noteworthy changes in version 1.3 (2006-03-14)
----------------------------------------------

 * GNU gettext is included for systems that do not provide it.


Noteworthy changes in version 1.2 (2006-03-03)
----------------------------------------------

 * New function gpg_err_init, which binds the locale directory to
   the text domain.  This function is a constructor on GCC targets,
   so it does not need to be called explicitely.  The header file
   defines GPG_ERR_INITIALIZED in this case.  This is experimental for
   now.

 * "./autogen.sh --build-w32" does now also build a DLL for W32.
   Translations are not yet provided for this platform.

 * New error codes GPG_ERR_UNKNOWN_EXTN and GPG_ERR_UNKNOWN_CRIT_EXTN.

 * New error code GPG_ERR_LOCKED.

 * New translations included for France, Romania, and Vietnamese.

 * Interface changes relative to the 1.1 release:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
GPG_ERR_UNKNOWN_EXTN		NEW
GPG_ERR_UNKNOWN_CRIT_EXTN	NEW
GPG_ERR_LOCKED			NEW
gpg_err_init			NEW
GPG_ERR_INITIALIZED		NEW
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Noteworthy changes in version 1.1 (2005-06-20)
----------------------------------------------

 * Bug fixes.


Noteworthy changes in version 1.0 (2004-07-30)
----------------------------------------------

 * Ported to Solaris 2.8.

 * Added a new error source GPG_ERR_SOURCE_GSTI, and new error
   codes GPG_ERR_PROTOCOL_VIOLATION and GPG_ERR_INV_MAC for this
   source.

 * Interface changes relative to the 0.7 release:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
GPG_ERR_SOURCE_GSTI		NEW
GPG_ERR_PROTOCOL_VIOLATION	NEW
GPG_ERR_INV_MAC			NEW
GPG_ERR_INV_REQUEST             NEW
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Noteworthy changes in version 0.7 (2004-03-07)
----------------------------------------------

 * libgpg-error can be built on systems where the errno macros do not
   evaluate to plain numbers, but expressions.  If you want to
   cross-compile, you might have to set CC_FOR_BUILD, though.

 * A new tool gpg-error to convert error numbers into symbols into
   strings is provided.

 * Interface changes relative to the 0.6 release:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
GPG_ERR_LOCALE_PROBLEM          NEW
GPG_ERR_NOT_LOCKED              NEW
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Noteworthy changes in version 0.6 (2003-11-14)
----------------------------------------------

 * German translation included.

 * It is now possible to use the inline functions even for non C99
   compliant compilers by given e.g. -DGPG_ERR_INLINE=inline when
   compiling an application using this library.  Note, that gcc will
   use inline anyway.

 * Interface changes relative to the 0.5 release:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
GPG_ERR_SOURCE_KSBA             NEW
GPG_ERR_SOURCE_DIRMNGR          NEW
GPG_ERR_TRUNCATED		NEW
GPG_ERR_NO_ENCODING_METHOD      NEW
GPG_ERR_NO_ENCRYPTION_SCHEME    NEW
GPG_ERR_NO_SIGNATURE_SCHEME     NEW
GPG_ERR_INV_ATTR                NEW
GPG_ERR_NO_VALUE                NEW
GPG_ERR_NOT_FOUND               NEW
GPG_ERR_VALUE_NOT_FOUND         NEW
GPG_ERR_SYNTAX                  NEW
GPG_ERR_INV_CRL                 NEW
GPG_ERR_BAD_BER                 NEW
GPG_ERR_INV_BER                 NEW
GPG_ERR_ELEMENT_NOT_FOUND       NEW
GPG_ERR_IDENTIFIER_NOT_FOUND    NEW
GPG_ERR_INV_TAG                 NEW
GPG_ERR_INV_LENGTH              NEW
GPG_ERR_INV_KEYINFO             NEW
GPG_ERR_UNEXPECTED_TAG          NEW
GPG_ERR_NOT_DER_ENCODED,        NEW
GPG_ERR_NO_CMS_OBJ              NEW
GPG_ERR_INV_CMS_OBJ             NEW
GPG_ERR_UNKNOWN_CMS_OBJ,        NEW
GPG_ERR_UNSUPPORTED_CMS_OBJ     NEW
GPG_ERR_UNSUPPORTED_ENCODING,   NEW
GPG_ERR_UNSUPPORTED_CMS_VERSION NEW
GPG_ERR_UNKNOWN_ALGORITHM       NEW
GPG_ERR_ENCODING_PROBLEM        NEW
GPG_ERR_INV_STATE               NEW
GPG_ERR_DUP_VALUE,              NEW
GPG_ERR_MISSING_ACTION          NEW
GPG_ERR_MODULE_NOT_FOUND        NEW
GPG_ERR_INV_OID_STRING          NEW
GPG_ERR_INV_TIME                NEW
GPG_ERR_INV_CRL_OBJ             NEW
GPG_ERR_UNSUPPORTED_CRL_VERSION NEW
GPG_ERR_INV_CERT_OBJ            NEW
GPG_ERR_UNKNOWN_NAME            NEW
GPG_ERR_BUFFER_TOO_SHORT.       NEW
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Noteworthy changes in version 0.5 (2003-10-06)
----------------------------------------------

 * New thread safe interface gpg_strerror_r.

 * New error code GPG_ERR_PIN_NOT_SYNCED has been added.

 * Interface changes relative to the 0.4 release:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
gpg_strerror_r			NEW
GPG_ERR_PIN_NOT_SYNCED		NEW
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Noteworthy changes in version 0.4 (2003-09-03)
----------------------------------------------

 * Fixed another bug that prevented that system errors were created
   correctly in the first place.

 * Use inline in public header file only on C99 compilers.


Noteworthy changes in version 0.3 (2003-07-31)
----------------------------------------------

 * Fixed bug that prevented that system errors were mapped to error
   strings correctly.


Noteworthy changes in version 0.2 (2003-07-30)
----------------------------------------------

 * Value of the error code GPG_ERR_CANCELED was fixed.

 * New error codes GPG_ERR_WRONG_CARD, GPG_ERR_HARDWARE,
   GPG_ERR_PIN_BLOCKED and GPG_ERR_USE_CONDITIONS have been added.

 * The header file has been made C++ clean.

 * AM_PATH_GPG_ERR has been fixed to work without explicit version
   number.

 * The header file now uses inline instead __inline__ for non-GNU
   compilers.


Noteworthy changes in version 0.1 (2003-06-06)
----------------------------------------------

 * Initial release.


 Copyright 2003, 2004, 2005, 2010 g10 Code GmbH

 This file is free software; as a special exception the author gives
 unlimited permission to copy and/or distribute it, with or without
 modifications, as long as this notice is preserved.

 This file is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
