Checking in changes prior to tagging of version 1.006. Changelog diff is:

=== Changes
==================================================================
--- Changes	(revision 7951)
+++ Changes	(local)
@@ -1,6 +1,7 @@
1.006  2008-10-06
- Added username_field configuration option. I need this to play
nice with Catalyst::Authentication::Store::Tangram.
+  - Doc cleanups / clarifications related to RT#39838

1.005  2008-09-25
- Added better description of the use of the domains and

diff --git a/Changes b/Changes
index 728b13c..c82adba 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,6 +1,7 @@
 1.006  2008-10-06
   - Added username_field configuration option. I need this to play
     nice with Catalyst::Authentication::Store::Tangram.
+  - Doc cleanups / clarifications related to RT#39838
 
 1.005  2008-09-25
   - Added better description of the use of the domains and

diff --git a/lib/Catalyst/Authentication/Credential/HTTP.pm b/lib/Catalyst/Authentication/Credential/HTTP.pm
index 2814830..728581f 100644 (file)
--- a/lib/Catalyst/Authentication/Credential/HTTP.pm
+++ b/lib/Catalyst/Authentication/Credential/HTTP.pm
@@ -408,9 +408,11 @@ for Catalyst.
 
         $c->authenticate({ realm => "example" }); 
         # either user gets authenticated or 401 is sent
-        # Note that the authentication realm sent to the client is overridden
-        # here, but this does not affect the Catalyst::Authentication::Realm
-        # used for authentication.
+        # Note that the authentication realm sent to the client (in the 
+        # RFC 2617 sense) is overridden here, but this *does not* 
+        # effect the Catalyst::Authentication::Realm used for 
+        # authentication - to do that, you need 
+        # $c->authenticate({}, 'otherrealm')
 
         do_stuff();
     }