From b486e46c4eceebbc63a784822c2fb2ca255909fe Mon Sep 17 00:00:00 2001
From: Jesse Glick <jglick@cloudbees.com>
Date: Tue, 4 Nov 2014 15:32:33 -0500
Subject: [PATCH] Better Javadoc for new impersonate overload.

---
 core/src/main/java/hudson/security/ACL.java | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/core/src/main/java/hudson/security/ACL.java b/core/src/main/java/hudson/security/ACL.java
index cc4739bd7b..2a1b230f5f 100644
--- a/core/src/main/java/hudson/security/ACL.java
+++ b/core/src/main/java/hudson/security/ACL.java
@@ -27,6 +27,7 @@ import javax.annotation.Nonnull;
 import hudson.remoting.Callable;
 import jenkins.security.NonSerializableSecurityContext;
 import jenkins.model.Jenkins;
+import jenkins.security.NotReallyRoleSensitiveCallable;
 import org.acegisecurity.AccessDeniedException;
 import org.acegisecurity.Authentication;
 import org.acegisecurity.context.SecurityContext;
@@ -150,8 +151,8 @@ public abstract class ACL {
     /**
      * Safer variant of {@link #impersonate(Authentication)} that does not require a finally-block.
      * @param auth authentication, such as {@link #SYSTEM}
-     * @param body an action to run with this alternate authentication in effect
-     * @since TODO
+     * @param body an action to run with this alternate authentication in effect (try {@link NotReallyRoleSensitiveCallable})
+     * @since 1.587
      */
     public static <V,T extends Exception> V impersonate(Authentication auth, Callable<V,T> body) throws T {
         SecurityContext old = impersonate(auth);