aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--libobjc/ChangeLog5
-rw-r--r--libobjc/objc/message.h5
-rw-r--r--libobjc/objc/runtime.h32
3 files changed, 34 insertions, 8 deletions
diff --git a/libobjc/ChangeLog b/libobjc/ChangeLog
index 7dc29b8..44ae7f5 100644
--- a/libobjc/ChangeLog
+++ b/libobjc/ChangeLog
@@ -1,5 +1,10 @@
2010-12-19 Nicola Pero <nicola.pero@meta-innovation.com>
+ * objc/message.h: Updated comments.
+ * objc/runtime.h: Updated comments.
+
+2010-12-19 Nicola Pero <nicola.pero@meta-innovation.com>
+
* class.c (objc_lookupClass): Renamed to objc_lookUpClass.
* protocols.c: Updated all calls to objc_lookupClass to call
objc_lookUpClass instead.
diff --git a/libobjc/objc/message.h b/libobjc/objc/message.h
index 9d5e6d8..8d03fef 100644
--- a/libobjc/objc/message.h
+++ b/libobjc/objc/message.h
@@ -130,10 +130,7 @@ objc_EXPORT IMP objc_msg_lookup_super (struct objc_super *super, SEL sel);
built-in forwarding with one based on a library, such as ffi, that
implement closures, thereby avoiding gcc's __builtin_apply
problems. __objc_msg_forward2's result will be preferred over that
- of __objc_msg_forward if both are set and return non-NULL.
-
- TODO: The API should define objc_set_msg_forward_handler () or
- similar instead of these hooks. */
+ of __objc_msg_forward if both are set and return non-NULL. */
objc_EXPORT IMP (*__objc_msg_forward)(SEL);
objc_EXPORT IMP (*__objc_msg_forward2)(id, SEL);
diff --git a/libobjc/objc/runtime.h b/libobjc/objc/runtime.h
index 758d2d0..8d38015 100644
--- a/libobjc/objc/runtime.h
+++ b/libobjc/objc/runtime.h
@@ -45,8 +45,6 @@ see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
# 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: This file is incomplete. */
-
#include "objc.h"
#include "objc-decls.h"
@@ -875,8 +873,6 @@ objc_EXPORT Property *protocol_copyPropertyList (Protocol *protocol, unsigned in
objc_EXPORT Protocol **protocol_copyProtocolList (Protocol *protocol, unsigned int *numberOfReturnedProtocols);
-/* 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
@@ -937,6 +933,28 @@ struct __objcFastEnumerationState
*/
+/* Compatibility Note: The Apple/NeXT runtime has the functions
+ objc_copyImageNames (), class_getImageName () and
+ objc_copyClassNamesForImage () but they are undocumented. The GNU
+ runtime does not have them at the moment. */
+
+/* Compatibility Note: The Apple/NeXT runtime has the functions
+ objc_setAssociatedObject (), objc_getAssociatedObject (),
+ objc_removeAssociatedObjects () and the objc_AssociationPolicy type
+ and related enum. The GNU runtime does not have them yet.
+ TODO: Implement them. */
+
+/* Compatibility Note: The Apple/NeXT runtime has the function
+ objc_setForwardHandler (). The GNU runtime does not have it
+ because messaging (and, in particular, forwarding) works in a
+ different (incompatible) way with the GNU runtime. If you need to
+ customize message forwarding at the Objective-C runtime level (that
+ is, if you are implementing your own "Foundation" library such as
+ GNUstep Base on top of the Objective-C runtime), in objc/message.h
+ there are hooks (that work in the framework of the GNU runtime) to
+ do so. */
+
+
/** Implementation: the following functions are in memory.c. */
/* Traditional GNU Objective-C Runtime functions that are used for
@@ -964,6 +982,12 @@ objc_EXPORT void objc_free(void *mem);
/** Implementation: the following functions are in gc.c. */
+/* The GNU Objective-C Runtime has a different implementation of
+ garbage collection.
+
+ Compatibility Note: these functions are not available with the
+ Apple/NeXT runtime. */
+
/* Mark the instance variable as inaccessible to the garbage
collector. */
objc_EXPORT void class_ivar_set_gcinvisible (Class _class,