diff --git a/README.md b/README.md
index 101c5a7..71b8990 100644
--- a/README.md
+++ b/README.md
@@ -393,7 +393,9 @@ s('fòô bàř')->hasUpperCase(); // false
 
 ##### htmlDecode()
 
-Convert all HTML entities to their applicable characters.
+Convert all HTML entities to their applicable characters. An alias of
+html_entity_decode. For a list of flags, refer to
+http://php.net/manual/en/function.html-entity-decode.php
 
 ```php
 s('&')->htmlDecode(); // '&'
@@ -401,7 +403,9 @@ s('&')->htmlDecode(); // '&'
 
 ##### htmlEncode()
 
-Convert all applicable characters to HTML entities.
+Convert all applicable characters to HTML entities. An alias of
+htmlentities. Refer to http://php.net/manual/en/function.htmlentities.php
+for a list of flags.
 
 ```php
 s('&')->htmlEncode(); // '&'
diff --git a/src/Stringy.php b/src/Stringy.php
index 4dd897c..9b05396 100644
--- a/src/Stringy.php
+++ b/src/Stringy.php
@@ -1704,9 +1704,11 @@ class Stringy implements \Countable, \IteratorAggregate, \ArrayAccess
     }
 
     /**
-     * Convert all applicable characters to HTML entities.
+     * Convert all applicable characters to HTML entities. An alias of
+     * htmlentities. Refer to http://php.net/manual/en/function.htmlentities.php
+     * for a list of flags.
      *
-     * @param  int|null $flags See http://php.net/manual/en/function.htmlentities.php
+     * @param  int|null $flags Optional flags
      * @return Stringy  Object with the resulting $str after being html encoded.
      */
     public function htmlEncode($flags = ENT_COMPAT)
@@ -1717,9 +1719,11 @@ class Stringy implements \Countable, \IteratorAggregate, \ArrayAccess
     }
 
     /**
-     * Convert all HTML entities to their applicable characters.
+     * Convert all HTML entities to their applicable characters. An alias of
+     * html_entity_decode. For a list of flags, refer to
+     * http://php.net/manual/en/function.html-entity-decode.php
      *
-     * @param  int|null $flags See http://php.net/manual/en/function.html-entity-decode.php
+     * @param  int|null $flags Optional flags
      * @return Stringy  Object with the resulting $str after being html decoded.
      */
     public function htmlDecode($flags = ENT_COMPAT)