libobjc/objc/README

   1 This directory contains the public headers that are installed when
   2 libobjc is installed.
   3
   4 Deprecated parts of the API should be moved into objc/deprecated and
   5 then included by public headers until they are finally removed.  For
   6 example, if objc-api.h contains an _objc_unexpected_exception variable
   7 which is then deprecated, it should be moved into a header in
   8 objc/deprecated.  This header is then included into objc-api.h.
   9
  10 The result is that all the deprecated parts of the API are clearly
  11 separated in objc/deprecated, while objc/ retains only the current public
  12 API.
  13