1.1 --- a/MYIdentity.h	Thu Apr 09 22:27:51 2009 -0700
     1.2 +++ b/MYIdentity.h	Sat Jun 06 15:36:35 2009 -0700
     1.3 @@ -17,12 +17,20 @@
     1.4      SecIdentityRef _identityRef;
     1.5  }
     1.6  
     1.7 -/** Initializes a MYIdentity given an existing SecIdentityRef. */
     1.8 -- (id) initWithIdentityRef: (SecIdentityRef)identityRef;
     1.9 +/** Creates a MYIdentity object for an existing Keychain identity reference. */
    1.10 ++ (MYIdentity*) identityWithIdentityRef: (SecIdentityRef)identityRef;
    1.11 +
    1.12 +/** The underlying SecIdentityRef. */
    1.13 +@property (readonly) SecIdentityRef identityRef;
    1.14  
    1.15  /** The identity's associated private key. */
    1.16  @property (readonly) MYPrivateKey *privateKey;
    1.17  
    1.18 +
    1.19 +/** @name Mac-Only
    1.20 + *  Functionality not available on iPhone. 
    1.21 + */
    1.22 +//@{
    1.23  #if !TARGET_OS_IPHONE
    1.24  
    1.25  /** Returns the identity that's been set as the preferred one for the given name, or nil. */
    1.26 @@ -33,5 +41,17 @@
    1.27  - (BOOL) makePreferredIdentityForName: (NSString*)name;
    1.28  
    1.29  #endif
    1.30 +//@}
    1.31 +
    1.32 +
    1.33 +/** @name Expert
    1.34 + *  Advanced methods. 
    1.35 + */
    1.36 +//@{
    1.37 +
    1.38 +/** Initializes a MYIdentity given an existing SecIdentityRef. */
    1.39 +- (id) initWithIdentityRef: (SecIdentityRef)identityRef;
    1.40 +
    1.41 +//@}
    1.42  
    1.43  @end