- initial documentation and note about different behaviour in contrast to DOM

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@79414 c90b9560-bf6c-de11-be94-00142212c4b1

reference/domxml/functions/DomDocument-get-element-by-id.xml

@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/domxml.xml, last change in rev 1.38 -->
   <refentry id="function.DomDocument-get-element-by-id">
    <refnamediv>
     <refname>DomDocument->get_element_by_id</refname>
     <refpurpose>
+     Searches for an element with a certain id
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -14,9 +15,17 @@
      <methodparam><type>string</type><parameter>id</parameter></methodparam>
     </methodsynopsis>
     <para>
+     This function is similar to
+     <function>DomDocument_get_elements_by_tagname</function> but searches for
+     an element with a given id. According to the DOM standard this requires a
+     DTD which defines the attribute ID to be of type ID, though the current
+     implementation simply does an xpath search for "//*[@ID = '%s']". This
+     does not comply to the DOM standard which requires to return null if it
+     is not known which attribute is of type id. This behaviour is likely to
+     be fixed, so do not rely on the current behaviour.
     </para>
     <para>
-     See also <function>DomDocument_add_root</function>
+     See also <function>DomDocument_get_elements_by_tagname</function>
     </para>
    </refsect1>
   </refentry>