Add warning about empty string / file. (bug 43095)

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

reference/dom/functions/dom-domdocument-load.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.13 $ -->
+<!-- $Revision: 1.14 $ -->
 <refentry xml:id="function.dom-domdocument-load" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument->load()</refname>
@@ -28,6 +28,14 @@
     <varlistentry>
      <term><parameter>filename</parameter></term>
      <listitem>
+      <warning>
+       <para>
+        If an empty string is passed as the <parameter>filename</parameter>
+        or an empty file is named, a warning will be generated. This warning
+        is not generated by libxml and cannot be handled using libxml's error
+        handling functions.
+       </para>
+      </warning>
       <para>
        The path to the XML document.
       </para>

reference/dom/functions/dom-domdocument-loadhtml.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xml:id="function.dom-domdocument-loadhtml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument->loadHTML()</refname>
@@ -32,6 +32,13 @@
     <varlistentry>
      <term><parameter>source</parameter></term>
      <listitem>
+      <warning>
+       <para>
+        If an empty string is passed as the <parameter>source</parameter>,
+        a warning will be generated. This warning is not generated by libxml
+        and cannot be handled using libxml's error handling functions.
+       </para>
+      </warning>
       <para>
        The HTML string.
       </para>

reference/dom/functions/dom-domdocument-loadhtmlfile.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xml:id="function.dom-domdocument-loadhtmlfile" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument->loadHTMLFile()</refname>
@@ -35,6 +35,14 @@
     <varlistentry>
      <term><parameter>filename</parameter></term>
      <listitem>
+      <warning>
+       <para>
+        If an empty string is passed as the <parameter>filename</parameter>
+        or an empty file is named, a warning will be generated. This warning
+        is not generated by libxml and cannot be handled using libxml's error
+        handling functions.
+       </para>
+      </warning>
       <para>
        The path to the HTML file.
       </para>

reference/dom/functions/dom-domdocument-loadxml.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry xml:id="function.dom-domdocument-loadxml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument->loadXML()</refname>
@@ -34,6 +34,13 @@
     <varlistentry>
      <term><parameter>source</parameter></term>
      <listitem>
+      <warning>
+       <para>
+        If an empty string is passed as the <parameter>source</parameter>,
+        a warning will be generated. This warning is not generated by libxml
+        and cannot be handled using libxml's error handling functions.
+       </para>
+      </warning>
       <para>
        The string containing the XML.
       </para>