From bf5b295c6ae0da86f24a4646d0552d3b5ce8bbb3 Mon Sep 17 00:00:00 2001 From: David Ayers Date: Thu, 15 Dec 2005 17:46:17 +0100 Subject: [PATCH] re PR libobjc/14382 ([libobjc] Calling +initialize on a per category basis) 2005-12-15 David Ayers PR libobjc/14382 * README (+load,+initialize): Fix documentation to reflect intended and implemented semantics for +load and +initialize. From-SVN: r108584 --- libobjc/ChangeLog | 6 ++++++ libobjc/README | 25 ++++++++++++++++--------- 2 files changed, 22 insertions(+), 9 deletions(-) diff --git a/libobjc/ChangeLog b/libobjc/ChangeLog index 8273db801ef..3ac957d3baf 100644 --- a/libobjc/ChangeLog +++ b/libobjc/ChangeLog @@ -1,3 +1,9 @@ +2005-12-15 David Ayers + + PR libobjc/14382 + * README (+load,+initialize): Fix documentation to reflect + intended and implemented semantics for +load and +initialize. + 2005-12-12 Andrew Pinski * encoding.c (TYPE_FIELDS): Fix to skip over just _C_STRUCT_B and diff --git a/libobjc/README b/libobjc/README index f478d67dec8..093116fd594 100644 --- a/libobjc/README +++ b/libobjc/README @@ -39,19 +39,26 @@ adopts it -- it is not enough to inherit them. The flag `-Wprotocols' is the default which requires them defined. ++load +=========== +This method, if defined, is called for each class and category +implementation when the class is loaded into the runtime. This method +is not inherited, and is thus not called for a subclass that doesn't +define it itself. Thus, each +load method is called exactly once by +the runtime. The runtime invocation of this method is thread safe. + + +initialize =========== This method, if defined, is called before any other instance or class -methods of that particular class. This method is not inherited, and -is thus not called as initializer for a subclass that doesn't define -it itself. Thus, each +initialize method is called exactly once (or -never if no methods of that particular class is never called). -Besides this, it is allowed to have several +initialize methods, one -for each category. The order in which these (multiple methods) are -called is not well defined. I am not completely certain what the -semantics of this method is for other implementations, but this is -how it works for GNU Objective C. +methods of that particular class. For the GNU runtime, this method is +not inherited, and is thus not called as initializer for a subclass that +doesn't define it itself. Thus, each +initialize method is called exactly +once by the runtime (or never if no methods of that particular class is +never called). It is wise to guard against multiple invocations anyway +to remain portable with the NeXT runtime. The runtime invocation of +this method is thread safe. Passivation/Activation/Typedstreams