* gpgme.texi (Manipulating Data Buffers): New type GpgmeDataEncoding.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 279e9831b28313c42971debf494f160dfaae3a7c..8405f5957ef4d6f1ddf6ab5e1e8f572b6901e6df 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2002-04-27  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Manipulating Data Buffers): New type GpgmeDataEncoding.
+
 2002-04-23  Marcus Brinkmann  <marcus@g10code.de>
 
        * gpgme.texi (Passphrase Callback): Document that either return

diff --git a/doc/gpgme.texi b/doc/gpgme.texi
index cb4666814e87507a9b6f0a66dbacf5c90543ddc9..a028bb01a457e195b349984c6408b4c759dab2bb 100644 (file)
--- a/doc/gpgme.texi
+++ b/doc/gpgme.texi
@@ -887,6 +887,9 @@ writing, and @code{GPGME_Out_Of_Core} if not enough memory is
 available.
 @end deftypefun
 
+@c
+@c  GpgmeDataType
+@c
 @deftp {Data type} {enum GpgmeDataType}
 @tindex GpgmeDataType
 The @code{GpgmeDataType} type specifies the type of a @code{GpgmeData} object.
@@ -917,7 +920,50 @@ object with the handle @var{dh}.  If @var{dh} is not a valid pointer,
 @code{GPGME_DATA_TYPE_NONE} is returned.
 @end deftypefun
 
+@c
+@c  GpgmeDataEncoding
+@c
+@deftp {Data type} {enum GpgmeDataEncoding}
+@tindex GpgmeDataEncoding
+The @code{GpgmeDataEncoding} type specifies the encoding of a
+@code{GpgmeData} object.  This encoding is useful to give the backend a
+hint on the type of data.  The following data types are available:
 
+@table @code
+@item GPGME_DATA_ENCODING_NONE
+This specifies that the encoding is not known.  Thsi si the default for
+a new data object.
+
+@item GPGME_DATA_ENCODING_BINARY
+This specifies that the data is encoding in binary form; i.e. there is
+no special encoding.
+
+@item GPGME_DATA_ENCODING_BASE64
+This specifies that the data is encoded using the Base-64 encoding
+scheme as used by @acronym{MIME} and other protocols.
+
+@item GPGME_DATA_ENCODING_ARMOR
+This specifies that the data is encoded in an armored form as used by
+OpenPGP and PEM.
+
+@end table
+@end deftp
+
+@deftypefun GpgmeDataEncoding gpgme_data_get_encoding (@w{GpgmeData @var{dh}})
+The function @code{gpgme_data_get_encoding} returns the encoding of the data
+object with the handle @var{dh}.  If @var{dh} is not a valid pointer
+(e.g. @code{NULL})@code{GPGME_DATA_ENCODING_NONE} is returned.
+@end deftypefun
+
+@deftypefun GpgmeError gpgme_data_set_encoding (@w{GpgmeData @var{dh}, GpgmeDataEncoding @var{enc}})
+The function @code{gpgme_data_set_encoding} changes the encoding of the data
+object with the handle @var{dh} to @var{enc}. 
+@end deftypefun
+
+
+@c
+@c    Chapter Contexts
+@c 
 @node Contexts
 @chapter Contexts
 @cindex context