Upgrading the function html_escape() - documentation corrections.
diff --git a/system/core/Common.php b/system/core/Common.php
index fd248e9..74864ec 100644
--- a/system/core/Common.php
+++ b/system/core/Common.php
@@ -691,11 +691,10 @@
 {
 	/**
 	 * Returns HTML escaped variable.
-	 * $double_encode set to FALSE prevents escaping twice.
 	 *
-	 * @param	mixed
-	 * @param	bool
-	 * @return	mixed
+	 * @param	mixed	$var		The input string or array of strings to be escaped.
+	 * @param	bool	$double_encode	$double_encode set to FALSE prevents escaping twice.
+	 * @return	mixed			The escaped string or array of strings as a result.
 	 */
 	function html_escape($var, $double_encode = TRUE)
 	{
diff --git a/user_guide_src/source/changelog.rst b/user_guide_src/source/changelog.rst
index 4ff71a5..165ef42 100644
--- a/user_guide_src/source/changelog.rst
+++ b/user_guide_src/source/changelog.rst
@@ -489,7 +489,7 @@
       -  Removed the third (`$php_error`) argument from function :func:`log_message()`.
       -  Changed internal function ``load_class()`` to accept a constructor parameter instead of (previously unused) class name prefix.
       -  Removed default parameter value of :func:`is_php()`.
-      -  Added a second optional argument ``$double_encode`` to :func:`html_escape()`. When ``$double_encode`` is set to FALSE, escaping twice is prevented.
+      -  Added a second argument ``$double_encode`` to :func:`html_escape()`.
 
    -  :doc:`Output Library <libraries/output>` changes include: