1 files changed, 27 insertions, 14 deletions
diff --git a/src/DotNetOpenId/RelyingParty/IAuthenticationRequest.cs b/src/DotNetOpenId/RelyingParty/IAuthenticationRequest.cs
index 3297b64..8773454 100644
--- a/src/DotNetOpenId/RelyingParty/IAuthenticationRequest.cs
+++ b/src/DotNetOpenId/RelyingParty/IAuthenticationRequest.cs
@@ -26,30 +26,21 @@ namespace DotNetOpenId.RelyingParty {
 		void AddExtension(IExtensionRequest extension);
 		/// <summary>
 		/// Redirects the user agent to the provider for authentication.
+		/// Execution of the current page terminates after this call.
 		/// </summary>
 		/// <remarks>
 		/// This method requires an ASP.NET HttpContext.
 		/// </remarks>
 		void RedirectToProvider();
 		/// <summary>
-		/// Redirects the user agent to the provider for authentication.
-		/// </summary>
-		/// <param name="endResponse">
-		/// Whether execution of this response should cease after this call.
-		/// </param>
-		/// <remarks>
-		/// This method requires an ASP.NET HttpContext.
-		/// </remarks>
-		void RedirectToProvider(bool endResponse);
-		/// <summary>
 		/// Gets/sets the mode the Provider should use during authentication.
 		/// </summary>
 		AuthenticationRequestMode Mode { get; set; }
 		/// <summary>
-		/// Gets the URL the user agent should be redirected to to begin the 
-		/// OpenID authentication process.
+		/// Gets the HTTP response the relying party should send to the user agent 
+		/// to redirect it to the OpenID Provider to start the OpenID authentication process.
 		/// </summary>
-		Uri RedirectToProviderUrl { get; }
+		IResponse RedirectingResponse { get; }
 		/// <summary>
 		/// Gets the URL that the user agent will return to after authentication
 		/// completes or fails at the Provider.
@@ -62,12 +53,34 @@ namespace DotNetOpenId.RelyingParty {
 		Realm Realm { get; }
 		/// <summary>
 		/// Gets the Claimed Identifier that the User Supplied Identifier
-		/// resolved to.
+		/// resolved to.  Null if the user provided an OP Identifier 
+		/// (directed identity).
 		/// </summary>
+		/// <remarks>
+		/// Null is returned if the user is using the directed identity feature
+		/// of OpenID 2.0 to make it nearly impossible for a relying party site
+		/// to improperly store the reserved OpenID URL used for directed identity
+		/// as a user's own Identifier.  
+		/// However, to test for the Directed Identity feature, please test the
+		/// <see cref="IsDirectedIdentity"/> property rather than testing this 
+		/// property for a null value.
+		/// </remarks>
 		Identifier ClaimedIdentifier { get; }
 		/// <summary>
+		/// Gets whether the authenticating user has chosen to let the Provider
+		/// determine and send the ClaimedIdentifier after authentication.
+		/// </summary>
+		bool IsDirectedIdentity { get; }
+		/// <summary>
+		/// Gets information about the OpenId Provider, as advertised by the
+		/// OpenId discovery documents found at the <see cref="ClaimedIdentifier"/>
+		/// location.
+		/// </summary>
+		IProviderEndpoint Provider { get; }
+		/// <summary>
 		/// The detected version of OpenID implemented by the Provider.
 		/// </summary>
+		[Obsolete("Use Provider.Version instead.")]
 		Version ProviderVersion { get; }
 	}
 }