From 3a869818ea36d3deacec90168de465f8fce02c4e Mon Sep 17 00:00:00 2001 From: kohsuke Date: Thu, 18 Dec 2008 00:28:41 +0000 Subject: [PATCH] [HUDSON-2716] doc improvement. git-svn-id: https://hudson.dev.java.net/svn/hudson/trunk/hudson/main@13715 71c3de6d-444a-0410-be80-ed276b4c234a --- core/src/main/java/hudson/security/AuthorizationStrategy.java | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/core/src/main/java/hudson/security/AuthorizationStrategy.java b/core/src/main/java/hudson/security/AuthorizationStrategy.java index a3f8b747ef..c798ae6000 100644 --- a/core/src/main/java/hudson/security/AuthorizationStrategy.java +++ b/core/src/main/java/hudson/security/AuthorizationStrategy.java @@ -111,6 +111,10 @@ public abstract class AuthorizationStrategy implements Describable * This method is used by {@link ContainerAuthentication} to work around the servlet API issue * that prevents us from enumerating roles that the user has. + *

+ * If such enumeration is impossible, do the best to list as many as possible, then + * return it. In the worst case, just return an empty list. Doing so would prevent + * users from using role names as group names (see HUDSON-2716 for such one such report.) * * @return * never null.