diff --git a/functions/strings.xml b/functions/strings.xml
index e66a0c8eba..d8f1b65f3b 100644
--- a/functions/strings.xml
+++ b/functions/strings.xml
@@ -748,9 +748,9 @@ $original = strtr ($str, $trans);
     </funcsynopsis>
     <para>
      This function is identical to
-     <function>Htmlspecialchars</function> in all ways, except that
-     all characters which have HTML entity equivalents are translated
-     into these entities.
+     <function>htmlspecialchars</function> in all ways, except that
+     all characters which have HTML character entity equivalents are
+     translated into these entities.
     </para>
     <para>
      At present, the ISO-8859-1 character set is used.
@@ -780,8 +780,11 @@ $original = strtr ($str, $trans);
     <para>
      Certain characters have special significance in HTML, and should
      be represented by HTML entities if they are to preserve their
-     meanings. This function returns a string with these conversions
-     made.
+     meanings. This function returns a string with some of these
+     conversions made; the four translations made are those most
+     useful for everyday web programming. If you require all HTML
+     character entities to be translated, use
+     <function>htmlentities</function> instead.
     </para>
     <simpara>
      This function is useful in preventing user-supplied text from
@@ -789,7 +792,7 @@ $original = strtr ($str, $trans);
      application.
     </simpara>
     <para>
-     At present, the translations that are done are:
+     The translations performed are:
      <itemizedlist>
       <listitem>
        <simpara>