gcc/libobjc/objc
Nicola Pero bc18535a3e objc.h: Updated comments.
2010-10-11  Nicola Pero  <nicola.pero@meta-innovation.com>

        * objc/objc.h: Updated comments.
        * objc/objc-api.h: (object_copy): Added one argument; use a
        #define to maintain backwards-compatibility.  Moved
        _objc_object_alloc, _objc_object_copy, _objc_object_dispose and
        objc_get_uninstalled_dtable into
        objc/deprecated/objc_get_uninstalled_dtable.h and
        objc/deprecated/objc_object_alloc.h.  Include these files.
        * objc/deprecated/objc_get_uninstalled_dtable.h: New.
        * objc/deprecated/objc_object_alloc.h: New.
        * objc/runtime.h (set_getName): New.
        (sel_getType): New.
        (sel_getUid): New.
        (sel_registerName): New.
        (sel_registerTypedName): New.
        (sel_isEqual): New.
        (class_createInstance): New.
        (object_copy): New.
        (object_dispose): New.
        * objects.c: Do not include tconfig.h.  Include gc_typed.h if
        building the garbage collection version.
        (__objc_object_alloc): Removed.
        (__objc_object_copy): Removed.
        (__objc_object_dispose): Removed.
        (class_createInstance): New from code in class_create_instance.
        Cast second argument of GC_malloc_explicitly_typed.  Use
        objc_calloc.  Do not call _objc_object_alloc.
        (class_create_instance): Call class_createInstance.
        (object_copy): Added extraBytes argument.  Do not call
        _objc_object_copy.
        (object_dispose): Do not call _objc_object_dispose.
        * memory.c (objc_free): When using garbage collection, mark the
        argument as unused.
        * selector.c (sel_getName): New.
        (sel_get_name): Call sel_getName.
        (sel_getType): New.
        (sel_get_type): Call sel_getType.
        (sel_registerName): New.
        (sel_register_name): Call sel_registerName.
        (sel_registerTypedName): New.
        (sel_register_typed_name): Call sel_registerTypedName.
        (sel_getUid): New.
        (sel_get_uid): Call sel_getUid.

From-SVN: r165264
2010-10-10 23:28:12 +00:00
..
deprecated objc.h: Updated comments. 2010-10-10 23:28:12 +00:00
encoding.h In libobjc/: 2010-10-10 Nicola Pero <nicola.pero@meta-innovation.com> 2010-10-10 17:43:07 +00:00
hash.h In libobjc/: 2010-09-17 16:52:36 +00:00
message.h In libobjc/: 2010-10-09 Nicola Pero <nicola.pero@meta-innovation.com> 2010-10-09 20:11:02 +00:00
NXConstStr.h Licensing changes to GPLv3 resp. GPLv3 with GCC Runtime Exception. 2009-04-09 17:00:19 +02:00
objc-api.h objc.h: Updated comments. 2010-10-10 23:28:12 +00:00
objc-decls.h sendmsg.c (get_imp): Remove inline. 2010-09-26 16:32:45 +02:00
objc-exception.h In libobjc/: 2010-10-10 Nicola Pero <nicola.pero@meta-innovation.com> 2010-10-10 11:18:57 +00:00
objc-list.h In libobjc/: 2010-09-17 16:52:36 +00:00
objc-sync.h In libobjc/: Implemented objc_sync_enter() and objc_sync_exit(), which are required by @synchronized() to work. 2010-09-14 10:23:37 +00:00
objc.h objc.h: Updated comments. 2010-10-10 23:28:12 +00:00
Object.h deprecated: New directory. 2010-09-10 09:56:40 +00:00
Protocol.h Licensing changes to GPLv3 resp. GPLv3 with GCC Runtime Exception. 2009-04-09 17:00:19 +02:00
README deprecated: New directory. 2010-09-10 09:56:40 +00:00
runtime.h objc.h: Updated comments. 2010-10-10 23:28:12 +00:00
sarray.h In libobjc/: 2010-09-18 09:34:58 +00:00
thr.h Removed obsolete intermediate threading layer. 2010-09-08 09:35:50 +00:00
typedstream.h In libobjc/: 2010-09-17 16:35:15 +00:00

This directory contains the public headers that are installed when
libobjc is installed.

Deprecated parts of the API should be moved into objc/deprecated and
then included by public headers until they are finally removed.  For
example, if objc-api.h contains an _objc_unexpected_exception variable
which is then deprecated, it should be moved into a header in
objc/deprecated.  This header is then included into objc-api.h.

The result is that all the deprecated parts of the API are clearly
separated in objc/deprecated, while objc/ retains only the current public
API.