From 40483d0ce26119fd3b23aea6cce532a8a78670cf Mon Sep 17 00:00:00 2001 From: Nick Wellnhofer Date: Sun, 6 Mar 2022 13:55:48 +0100 Subject: Deprecate module init and cleanup functions These functions shouldn't be part of the public API. Most init functions are only thread-safe when called from xmlInitParser. Global variables should only be cleaned up by calling xmlCleanupParser. --- dict.c | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) (limited to 'dict.c') diff --git a/dict.c b/dict.c index ecc90e0f..0e4c87b9 100644 --- a/dict.c +++ b/dict.c @@ -146,8 +146,10 @@ static unsigned int rand_seed = 0; /** * xmlInitializeDict: * + * DEPRECATED: This function will be made private. Call xmlInitParser to + * initialize the library. + * * Do the dictionary mutex initialization. - * this function is deprecated * * Returns 0 if initialization was already done, and 1 if that * call led to the initialization @@ -210,6 +212,11 @@ int __xmlRandom(void) { /** * xmlDictCleanup: * + * DEPRECATED: This function will be made private. Call xmlCleanupParser + * to free global state but see the warnings there. xmlCleanupParser + * should be only called once at program exit. In most cases, you don't + * have call cleanup functions at all. + * * Free the dictionary mutex. Do not call unless sure the library * is not in use anymore ! */ -- cgit v1.2.1