[svn] gpgme - r1216 - trunk/doc

[svn author marcus]

Author: marcus
Date: 2007-05-19 00:30:42 +0200 (Sat, 19 May 2007)
New Revision: 1216

Modified:
   trunk/doc/ChangeLog
   trunk/doc/gpgme.texi
Log:
2007-05-18  Marcus Brinkmann  <marcus at g10code.de>

	* gpgme.texi (Error Strings): Fix documentation of
	gpgme_strerror_r.


Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog	2007-05-03 20:12:40 UTC (rev 1215)
+++ trunk/doc/ChangeLog	2007-05-18 22:30:42 UTC (rev 1216)
@@ -1,4 +1,8 @@
+2007-05-18  Marcus Brinkmann  <marcus at g10code.de>
 
+	* gpgme.texi (Error Strings): Fix documentation of
+	gpgme_strerror_r.
+
 2006-11-01  Moritz Schulte  <moritz at g10code.com>
 
 	* gpgme.texi (Data Buffer I/O Operations): Fixed entry for

Modified: trunk/doc/gpgme.texi
===================================================================
--- trunk/doc/gpgme.texi	2007-05-03 20:12:40 UTC (rev 1215)
+++ trunk/doc/gpgme.texi	2007-05-18 22:30:42 UTC (rev 1216)
@@ -21,7 +21,7 @@
 @value{VERSION}.
 
 @c NOTE: Don't forget to update the year for the TeX version, too.
-Copyright @copyright{} 2002, 2003, 2004, 2005 g10 Code GmbH.
+Copyright @copyright{} 2002, 2003, 2004, 2005, 2006, 2007 g10 Code GmbH.
 
 The GPGME reference manual is free software; you can redistribute it
 and/or modify it under the terms of the GNU Lesser General Public
@@ -54,7 +54,7 @@
 @center for version @value{VERSION}
 @page
 @vskip 0pt plus 1filll
-Copyright @copyright{} 2002, 2003, 2004, 2005 g10 Code GmbH.
+Copyright @copyright{} 2002, 2003, 2004, 2005, 2006, 2007 g10 Code GmbH.
 
 
 The GPGME reference manual is free software; you can redistribute it
@@ -1403,12 +1403,15 @@
 @end deftypefun
 
 
- at deftypefun {char *} gpgme_strerror_r (@w{gpgme_error_t @var{err}})
-The function @code{gpgme_strerror_r} returns a pointer to a
-dynamically allocated string containing a description of the error
-code contained in the error value @var{err}.  This string can be used
-to output a diagnostic message to the user.  When it is not needed
-anymore, the user must deallocate it with @code{free}.
+ at deftypefun {int} gpgme_strerror_r (@w{gpgme_error_t @var{err}}, @w{char *@var{buf}}, @w{size_t @var{buflen}})
+The function @code{gpgme_strerror_r} returns the error string for
+ at var{err} in the user-supplied buffer @var{buf} of size @var{buflen}.
+This function is, in contrast to @code{gpgme_strerror}, thread-safe if
+a thread-safe @code{strerror_r} function is provided by the system.
+If the function succeeds, 0 is returned and @var{buf} contains the
+string describing the error.  If the buffer was not large enough,
+ERANGE is returned and @var{buf} contains as much of the beginning of
+the error string as fits into the buffer.
 @end deftypefun