After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 677678 - Wrong documentation of strong, weak and unsafe_unretained properties
Wrong documentation of strong, weak and unsafe_unretained properties
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: documentation
1.8.1
Other Mac OS
: Normal minor
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2012-06-08 07:36 UTC by Jean-Pierre Distler
Modified: 2012-07-12 15:42 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Jean-Pierre Distler 2012-06-08 07:36:59 UTC
Propeties with the new ARC keywords strong and weak were documented as assign properties.
Unsafe_unretained properties become retain in documentation
Comment 1 Dimitri van Heesch 2012-06-09 11:24:26 UTC
Indeed. I'll add support for strong and weak.
Comment 2 Dimitri van Heesch 2012-06-10 09:41:51 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.1.1. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.
Comment 3 Jean-Pierre Distler 2012-06-11 06:24:47 UTC
Strong and weak is working but unsafe_unretained is still documented as retain.
Comment 4 Dimitri van Heesch 2012-06-11 19:49:18 UTC
I couldn't find anything about it in the official docs, but I'll add it.
Comment 5 Jean-Pierre Distler 2012-06-11 19:55:31 UTC
You can find it here https://developer.apple.com/library/mac/#releasenotes/ObjectiveC/RN-TransitioningToARC/Introduction/Introduction.html
it is used on iOS4 and  (OS X 10.6 i think)  because they doesn't support weak references.
Comment 6 Dimitri van Heesch 2012-06-11 20:04:01 UTC
I nowhere see it as being part of a property attribute, like so:

@property (nonatomic, unsafe_unretained) NSNumber *yearOfBirth;

but I read somewhere that unsafe_unretained is defined as an alias for assign.
Comment 7 Jean-Pierre Distler 2012-06-12 04:40:52 UTC
Sorry the wrong documentation. Here you find it in section 4.1.1

http://clang.llvm.org/docs/AutomaticReferenceCounting.html 

It's right unsafe_unretained and weak is like an alias for assign. 
The difference between unsafe_unretained and weak is that 
weak properties get nil when the object they store is released. 
Unsafe_unretained properties remain as a dangling pointer.
Comment 8 Dimitri van Heesch 2012-07-12 15:42:00 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.1.2. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.