Chnages to supporta pinnetry notification
[gpgme.git] / assuan / README.1st
1 This is a modified copy of the libassuan library.  Don't modify it,
2 but instead modify the original Assuan library and merge the changes
3 back into this copy.
4
5 The changes to the original libassuan, that have to preserved when
6 updating this directory, are:
7
8 * Makefile.am
9 ** Build the library with libtool as a convenience library, which can
10    be linked into the shared library GPGME.
11 ** Do not install the library or the header file.
12 ** Define -D_ASSUAN_IN_GPGME_BUILD_ASSUAN to wrap some POSIX functions
13    with ATH replacements.
14
15 * assuan.h
16 ** Preserve the block between "Begin/End GPGME specific modifications".
17    In particular make sure that
18      #define _ASSUAN_EXT_SYM_PREFIX _gpgme_
19      #define _ASSUAN_NO_PTH 
20      #define _ASSUAN_NO_FIXED_SIGNALS 
21      #define _ASSUAN_USE_DOUBLE_FORK
22    are defined.  This puts all exported Assuan functions in the _gpgme
23    namespace.  It also wraps all system functions that are wrapped by
24    GNU Pth to _gpgme wrappers.
25
26 * assuan-io-pth.c
27   We don't need this file as GPGME doesn't use sendmsg and recvmsg.
28   If it would, we would need to pick up the W32 implementation.
29
30 * assuan-io.c
31 ** _assuan_simple_read() and _assuan_simple_write() must always use
32    read()/write() (which actually translates to _gpgme_io_read() and
33    _gpgme_io_write()).  _assuan_close must always() use close() (which
34    translates to _gpgme_io_close()).
35
36
37  Copyright 2004, 2007 g10 Code GmbH
38
39  This file is free software; as a special exception the author gives
40  unlimited permission to copy and/or distribute it, with or without
41  modifications, as long as this notice is preserved.
42
43  This file is distributed in the hope that it will be useful, but
44  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
45  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.