WordPress 4.5
[autoinstalls/wordpress.git] / wp-includes / class-wp-role.php
index 59903e371f868fcd6a15514cf855f96b32acb7cd..335d20da9db2decd0b09e3f23ceb493c78d41da0 100644 (file)
@@ -81,18 +81,18 @@ class WP_Role {
        }
 
        /**
-        * Whether role has capability.
+        * Determines whether the role has the given capability.
         *
-        * The capabilities is passed through the 'role_has_cap' filter. The first
-        * parameter for the hook is the list of capabilities the class has
-        * assigned. The second parameter is the capability name to look for. The
-        * third and final parameter for the hook is the role name.
+        * The capabilities is passed through the {@see 'role_has_cap'} filter.
+        * The first parameter for the hook is the list of capabilities the class
+        * has assigned. The second parameter is the capability name to look for.
+        * The third and final parameter for the hook is the role name.
         *
         * @since 2.0.0
         * @access public
         *
         * @param string $cap Capability name.
-        * @return bool True, if user has capability. False, if doesn't have capability.
+        * @return bool True if the role has the given capability. False otherwise.
         */
        public function has_cap( $cap ) {
                /**
@@ -105,6 +105,7 @@ class WP_Role {
                 * @param string $name         Role name.
                 */
                $capabilities = apply_filters( 'role_has_cap', $this->capabilities, $cap, $this->name );
+
                if ( !empty( $capabilities[$cap] ) )
                        return $capabilities[$cap];
                else