documenting this interface.

git-svn-id: https://hudson.dev.java.net/svn/hudson/trunk/hudson/main@9708 71c3de6d-444a-0410-be80-ed276b4c234a

core/src/main/java/hudson/security/AccessControlled.java

 package hudson.security;
 
+/**
+ * Object that has an {@link ACL}
+ *
+ * @since 1.220
+ */
 public interface AccessControlled {
+    /**
+     * Obtains the ACL associated with this object.
+     *
+     * @return never null.
+     */
+    ACL getACL();
+
+    /**
+     * Convenient short-cut for {@code getACL().checkPermission(permission)}
+     */
+    void checkPermission(Permission permission);
+
+    /**
+     * Convenient short-cut for {@code getACL().hasPermission(permission)}
+     */
+    boolean hasPermission(Permission permission);
 
-	void checkPermission(Permission permission);
-	boolean hasPermission(Permission permission);
-	
 }