diff -r b2e360b78189 -r 39fec79de6e8 MYIdentity.h
--- a/MYIdentity.h	Thu Apr 09 22:27:51 2009 -0700
+++ b/MYIdentity.h	Sun Jun 07 21:53:56 2009 -0700
@@ -17,12 +17,20 @@
     SecIdentityRef _identityRef;
 }
 
-/** Initializes a MYIdentity given an existing SecIdentityRef. */
-- (id) initWithIdentityRef: (SecIdentityRef)identityRef;
+/** Creates a MYIdentity object for an existing Keychain identity reference. */
++ (MYIdentity*) identityWithIdentityRef: (SecIdentityRef)identityRef;
+
+/** The underlying SecIdentityRef. */
+@property (readonly) SecIdentityRef identityRef;
 
 /** The identity's associated private key. */
 @property (readonly) MYPrivateKey *privateKey;
 
+
+/** @name Mac-Only
+ *  Functionality not available on iPhone. 
+ */
+//@{
 #if !TARGET_OS_IPHONE
 
 /** Returns the identity that's been set as the preferred one for the given name, or nil. */
@@ -33,5 +41,17 @@
 - (BOOL) makePreferredIdentityForName: (NSString*)name;
 
 #endif
+//@}
+
+
+/** @name Expert
+ *  Advanced methods. 
+ */
+//@{
+
+/** Initializes a MYIdentity given an existing SecIdentityRef. */
+- (id) initWithIdentityRef: (SecIdentityRef)identityRef;
+
+//@}
 
 @end