===================================================================
@@ -83,11 +83,7 @@
/* Add protocol to class. */
static void __objc_class_add_protocols (Class, struct objc_protocol_list *);
-/* This is a hook which is called by __objc_exec_class every time a
- class or a category is loaded into the runtime. This may e.g. help
- a dynamic loader determine the classes that have been loaded when
- an object file is dynamically linked in. */
-/* TODO: This needs to be declared in a public file with the new API. */
+/* Load callback hook. */
void (*_objc_load_callback) (Class class, struct objc_category *category); /* !T:SAFE */
/* Are all categories/classes resolved? */
@@ -724,6 +720,10 @@
objc_send_load ();
objc_mutex_unlock (__objc_runtime_mutex);
+
+ /* TODO: Do we need to add a call to __objc_resolve_class_links()
+ here ? gnustep-base does it manually after it loads a module.
+ Shouldn't we do it automatically ? */
}
static void
===================================================================
@@ -1,5 +1,11 @@
2010-12-19 Nicola Pero <nicola.pero@meta-innovation.com>
+ * init.c: Updated comments.
+ * objc/objc-api.h: Updated comments.
+ * objc/runtime.h (_objc_load_callback): Declare.
+
+2010-12-19 Nicola Pero <nicola.pero@meta-innovation.com>
+
* objc/Object.h: Include deprecated/typedstream.h and
deprecated/hash.h instead of typedstream.h. Updated comments.
===================================================================
@@ -876,7 +876,15 @@
/* TODO: Add all the other functions in the API. */
+/** Implementation: the following hook is in init.c. */
+/* This is a hook which is called by __objc_exec_class every time a
+ class or a category is loaded into the runtime. This may e.g. help
+ a dynamic loader determine the classes that have been loaded when
+ an object file is dynamically linked in. */
+objc_EXPORT void (*_objc_load_callback)(Class _class, struct objc_category *category);
+
+
/** Implementation: the following functions are in objc-foreach.c. */
/* 'objc_enumerationMutation()' is called when a collection is
===================================================================
@@ -26,25 +26,28 @@
#ifndef __objc_api_INCLUDE_GNU
#define __objc_api_INCLUDE_GNU
-/*
- This file declares the "traditional" GNU Objective-C Runtime API.
- It is the API supported by older versions of the GNU Objective-C
- Runtime. Include this file to use it.
+/* This file declares the "traditional" GNU Objective-C Runtime API.
+ It is the API supported by older versions of the GNU Objective-C
+ Runtime. Include this file to use it.
- This API is being replaced by the "modern" GNU Objective-C Runtime
- API, which is declared in objc/runtime.h. The "modern" API is very
- similar to the API used by the modern Apple/NeXT runtime.
+ This API is being replaced by the "modern" GNU Objective-C Runtime
+ API, which is declared in objc/runtime.h. The "modern" API is very
+ similar to the API used by the modern Apple/NeXT runtime.
- Because the two APIs have some conflicting definitions (in
- particular, Method and Category are defined differently) you should
- include either objc/objc-api.h (to use the traditional GNU
- Objective-C Runtime API) or objc/runtime.h (to use the modern GNU
- Objective-C Runtime API), but not both.
-*/
+ The last version of GCC supporting the traditional API is GCC 4.6.
+ This file will not exist in later versions of GCC.
+
+ Because the two APIs have some conflicting definitions (in
+ particular, Method and Category are defined differently) you should
+ include either objc/objc-api.h (to use the traditional GNU
+ Objective-C Runtime API) or objc/runtime.h (to use the modern GNU
+ Objective-C Runtime API), but not both. */
#ifdef __objc_runtime_INCLUDE_GNU
# error You can not include both objc/objc-api.h and objc/runtime.h. Include objc/objc-api.h for the traditional GNU Objective-C Runtime API and objc/runtime.h for the modern one.
#endif
+/* TODO: A deprecation warning any time the file is included ? */
+
#include "objc.h"
#ifndef GNU_LIBOBJC_COMPILING_LIBOBJC_ITSELF
# include "deprecated/hash.h"
@@ -182,6 +185,8 @@
** objc_get_class if the runtime is not able to find the class.
** This may e.g. try to load in the class using dynamic loading.
** The function is guaranteed to be passed a non-NULL name string.
+** In the Modern API, this is replaced by
+** objc_setGetUnknownClassHandler ().
*/
objc_EXPORT Class (*_objc_lookup_class)(const char *name);