diff --git a/docs/source/simplesamlphp-idp.xml b/docs/source/simplesamlphp-idp.xml
index d04bff6980bdd4048b4d99b27eb4ca1a9157a880..c3d4c9a35914596a8df2ebe7bdebb85d4b9d59a2 100644
--- a/docs/source/simplesamlphp-idp.xml
+++ b/docs/source/simplesamlphp-idp.xml
@@ -773,8 +773,9 @@ openssl x509 -req -days 60 -in server2.csr -signkey server2.key -out server2.crt
             <glossterm>name</glossterm>
 
             <glossdef>
-              <para>A descriptive name of the SP. (Used in the consent
-              module)</para>
+              <para>A descriptive name of the SP. This can be a string, or an
+              associative array with language code =&gt; translation
+              pairs.</para>
             </glossdef>
           </glossentry>
 
@@ -782,7 +783,9 @@ openssl x509 -req -days 60 -in server2.csr -signkey server2.key -out server2.crt
             <glossterm>description</glossterm>
 
             <glossdef>
-              <para>A longer description of the SP. (Not used)</para>
+              <para>A longer description of the SP. This can be a string, or an
+              associative array with language code =&gt; translation
+              pairs.</para>
             </glossdef>
           </glossentry>
 
diff --git a/docs/source/simplesamlphp-sp.xml b/docs/source/simplesamlphp-sp.xml
index 80767bc355587dbe376afef30644ddbc5fc08822..bd26fff7147a318d207ef5ba459d04549b81758f 100644
--- a/docs/source/simplesamlphp-sp.xml
+++ b/docs/source/simplesamlphp-sp.xml
@@ -397,8 +397,9 @@
             <glossterm>name</glossterm>
 
             <glossdef>
-              <para>A textual name of the IdP. This name is used in the SAML
-              2.0 discovery service.</para>
+              <para>A textual name of the IdP.  This can contain a string or an
+              associative array of language code =&gt; translation pairs. This
+              name is used in the SAML 2.0 discovery service.</para>
             </glossdef>
           </glossentry>
 
@@ -406,8 +407,9 @@
             <glossterm>description</glossterm>
 
             <glossdef>
-              <para>A longer description of the IdP. The description is used
-              in the SAML 2.0 discovery service.</para>
+              <para>A longer description of the IdP. This can contain a string
+              or an associative array of language code =&gt; translation pairs.
+              The description is used in the SAML 2.0 discovery service.</para>
             </glossdef>
           </glossentry>