3 files changed, 33 insertions, 0 deletions
diff --git a/Acl/Model/FieldAwareEntryInterface.php b/Acl/Model/FieldAwareEntryInterface.php
index 032d6e3..bcf292c 100644
--- a/Acl/Model/FieldAwareEntryInterface.php
+++ b/Acl/Model/FieldAwareEntryInterface.php
@@ -18,5 +18,10 @@ namespace Symfony\Component\Security\Acl\Model;
  */
 interface FieldAwareEntryInterface
 {
+    /**
+     * Returns the field used for this entry.
+     *
+     * @return string
+     */
     function getField();
 }
 \ No newline at end of file
diff --git a/Core/SecurityContext.php b/Core/SecurityContext.php
index 76ec4c1..2910e3b 100644
--- a/Core/SecurityContext.php
+++ b/Core/SecurityContext.php
@@ -45,6 +45,14 @@ class SecurityContext implements SecurityContextInterface
         $this->alwaysAuthenticate = $alwaysAuthenticate;
     }
 
+    /**
+     * Checks if the attributes are granted against the current token.
+     *
+     * @throws AuthenticationCredentialsNotFoundException when the security context has no authentication token.
+     * @param mixed $attributes
+     * @param mixed|null $object
+     * @return boolean
+     */
     public final function isGranted($attributes, $object = null)
     {
         if (null === $this->token) {
diff --git a/Core/SecurityContextInterface.php b/Core/SecurityContextInterface.php
index a811557..a47c89d 100644
--- a/Core/SecurityContextInterface.php
+++ b/Core/SecurityContextInterface.php
@@ -15,7 +15,27 @@ interface SecurityContextInterface
     const AUTHENTICATION_ERROR = '_security.last_error';
     const LAST_USERNAME        = '_security.last_username';
 
+    /**
+     * Returns the current security token.
+     *
+     * @return TokenInterface|null A TokenInterface instance or null if no authentication information is available
+     */
     function getToken();
+
+    /**
+     * Sets the authentication token.
+     *
+     * @param TokenInterface $token
+     * @return void
+     */
     function setToken(TokenInterface $token);
+
+    /**
+     * Checks if the attributes are granted against the current authentication token and optionally supplied object.
+     *
+     * @param array $attributes
+     * @param mixed $object
+     * @return boolean
+     */
     function isGranted($attributes, $object = null);
 }
 \ No newline at end of file