From: Jean-Claude Beaudoin Date: Sun, 24 Jun 2012 06:32:51 +0000 (-0400) Subject: Added documentation to abort and exit callback hook declarations. X-Git-Tag: gc7_4_0~263^2^2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=24792b4d9efbf8f1ff855192bf9c8329822494ae;p=gc Added documentation to abort and exit callback hook declarations. --- diff --git a/include/gc.h b/include/gc.h index 9cbc560a..c7d0d0ce 100644 --- a/include/gc.h +++ b/include/gc.h @@ -1612,14 +1612,26 @@ GC_API void GC_CALL GC_win32_free_heap(void); typedef void (GC_CALLBACK * GC_exit_func)(int /* status */); - GC_API void GC_CALL GC_set_exit_func(GC_exit_func); GC_API GC_exit_func GC_CALL GC_get_exit_func(void); + /* The function registered by this setter is */ + /* invoked when the GC is just about to call */ + /* exit(). */ + /* If this callback function returns then, and */ + /* only then, exit() is called. */ + /* These setter and getter are synchronized. */ typedef void (GC_CALLBACK * GC_abort_func)(const char * /* msg */); - GC_API void GC_CALL GC_set_abort_func(GC_abort_func); GC_API GC_abort_func GC_CALL GC_get_abort_func(void); + /* The function registered by this setter is */ + /* invoked when the GC is just about to call */ + /* abort(). */ + /* If this callback function returns then, and */ + /* only then, abort() may be called. */ + /* This callback function is passed a string */ + /* that describes the cause of the abort. */ + /* These setter and getter are synchronized. */ #ifdef __cplusplus } /* end of extern "C" */