Document possibility and handling of oob callback in get_redirect_uri.

1 files changed, 5 insertions, 1 deletions

diff --git a/oauthlib/oauth1/rfc5849/request_validator.py b/oauthlib/oauth1/rfc5849/request_validator.py
index 70ce6d9..933a65a 100644
--- a/oauthlib/oauth1/rfc5849/request_validator.py
+++ b/oauthlib/oauth1/rfc5849/request_validator.py
@@ -360,12 +360,16 @@ class RequestValidator(object):
         raise NotImplementedError("Subclasses must implement this function.")
 
     def get_redirect_uri(self, token, request):
-        """Get the redirect uri associated with a request token.
+        """Get the redirect URI associated with a request token.
 
         :param token: The request token string.
         :param request: An oauthlib.common.Request object.
         :returns: The redirect URI associated with the request token.
 
+        It may be desirable to return a custom URI if the redirect is set to "oob".
+        In this case, the user will be redirected to the returned URI and at that 
+        endpoint the verifier can be displayed.
+
         This method is used by
 
         * AuthorizationEndpoint