README.apichanges                                          -*- text -*-

API changes between 1.0.5 and 2.0.0:
====================================

While allowing to build libassuan as a DSO we decided to clean up the
API.  The changes are straightforward and it should only take a few
minutes to fix your code.

See the NEWS file for functions that have been renamed or replaced by
alternatives that are used in the same way (but may have extra
arguments with suitable default values or similar).  The rest of this
document lists significant changes only.

There have been many macros provided now for fixed constants, you may
consider using them (but the old hard-coded values will continue to
work where applicable).  Particularly noteworthy is ASSUAN_INVALID_PID
and all flags values.

Use of libgpg-error is mandatory.

assuan_pipe_connect child fds are now of assuan_fd_t type, not of int
type.  Use assuan_fd_from_posix_fd() for conversion.  If you use
assuan_pipe_connect with NAME of NULL, you have to provide a non-NULL
ARGV argument and check that against "server" or "client" to determine
which end you got after fork().

assuan_init_pipe_server closes the provided fds after terminating the
connection now.  Use assuan_fdopen to duplicate them first.

If you use the assuan sock interface, you must call assuan_sock_init after
setting global context defaults.

Pth support has changed.  This now follows the same style as libgcrypt
by setting system hook callbacks.