# HG changeset patch
# User paulb
# Date 1209678222 0
# Node ID 104e051e6024a0518c53b7561affdae94dac8774
# Parent  dfd5e052c72af95b912d11b68ac29045740a0c1f
[project @ 2008-05-01 21:43:41 by paulb]
Added 'app_url' clarifications.

diff -r dfd5e052c72a -r 104e051e6024 WebStack/Resources/LoginRedirect.py
--- a/WebStack/Resources/LoginRedirect.py	Thu May 01 21:42:52 2008 +0000
+++ b/WebStack/Resources/LoginRedirect.py	Thu May 01 21:43:42 2008 +0000
@@ -4,7 +4,7 @@
 Login redirection resources, sending unauthenticated users to a login screen
 URL.
 
-Copyright (C) 2004, 2005, 2006, 2007 Paul Boddie <paul@boddie.org.uk>
+Copyright (C) 2004, 2005, 2006, 2007, 2008 Paul Boddie <paul@boddie.org.uk>
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -43,6 +43,9 @@
         later time or provided by 'get_login_url' and 'get_app_url' methods in
         a subclass of this class.
 
+        The 'app_url' should be the "bare" reference using a protocol, host
+        and port, not including any path information.
+
         If the optional 'anonymous_parameter_name' is set, clients providing a
         parameter of that name in the URL will not be authenticated, but then
         such clients will get a predefined user identity associated with them,
diff -r dfd5e052c72a -r 104e051e6024 WebStack/Resources/OpenIDLogin.py
--- a/WebStack/Resources/OpenIDLogin.py	Thu May 01 21:42:52 2008 +0000
+++ b/WebStack/Resources/OpenIDLogin.py	Thu May 01 21:43:42 2008 +0000
@@ -40,7 +40,8 @@
 
         """
         Initialise the resource with the application URL 'app_url' and an
-        'authenticator'.
+        'authenticator'. The 'app_url' should be the "bare" reference using a
+        protocol, host and port, not including any path information.
 
         The optional 'associations' is a mapping from association handles to
         secret keys.
diff -r dfd5e052c72a -r 104e051e6024 WebStack/Resources/OpenIDRedirect.py
--- a/WebStack/Resources/OpenIDRedirect.py	Thu May 01 21:42:52 2008 +0000
+++ b/WebStack/Resources/OpenIDRedirect.py	Thu May 01 21:43:42 2008 +0000
@@ -70,7 +70,9 @@
 
         """
         Initialise the authenticator with a 'secret_key', 'app_url' and optional
-        'associations', 'replay_limit', 'cookie_name' and 'urlencoding'.
+        'associations', 'replay_limit', 'cookie_name' and 'urlencoding'. The
+        'app_url' should be the "bare" reference using a protocol, host and
+        port, not including any path information.
         """
 
         Verifier.__init__(self, secret_key, cookie_name)