gcc/libobjc/objc/README
Nicola Pero e976a775e2 deprecated: New directory.
* libobjc/objc/deprecated: New directory.
        * libobjc/objc/deprecated/README: New file.
        * libobjc/objc/README: New file.
        * libobjc/objc/typedstream.h: Moved into objc/deprecated/typedstream.h;
        objc/typedstream.h replaced with a placeholder including the file
        from the deprecated/ directory.
        * libobjc/objc/deprecated/objc-unexpected-exception.h: New file with the
        definition of _objc_unexpected_exception.       
        * libobjc/objc/objc-api.h: Include deprecated/objc-unexcepted-exception.h
        instead of defining _objc_unexpected_exception.
        * libobjc/objc/deprecated/Object.h: New file with the deprecated Object
        methods in a 'Deprecated' category.
        * libobjc/objc/Object.h Include deprecated/Object.h instead of defining
        the deprecated methods.
        * libobjc/Object.m: Moved deprecated methods into 'Deprecated' category.
        * libobjc/objc-private: New directory.
        * libobjc/objc-private/README: New file.
        * libobjc/Makefile.in (OBJC_DEPRECATED_H): New variable.
        (install-headers): Create installation directory for
        OBJC_DEPRECATED_H headers, and install them.

From-SVN: r164153
2010-09-10 09:56:40 +00:00

14 lines
573 B
Plaintext

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.