From fb30f462391ee9bb7eff6f3216d06a1e636ffeda Mon Sep 17 00:00:00 2001
From: Richard Quadling <rquadling@php.net>
Date: Thu, 25 Oct 2007 08:59:47 +0000
Subject: [PATCH] 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       | 10 +++++++++-
 reference/dom/functions/dom-domdocument-loadhtml.xml   |  9 ++++++++-
 .../dom/functions/dom-domdocument-loadhtmlfile.xml     | 10 +++++++++-
 reference/dom/functions/dom-domdocument-loadxml.xml    |  9 ++++++++-
 4 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/reference/dom/functions/dom-domdocument-load.xml b/reference/dom/functions/dom-domdocument-load.xml
index 6a1e45286a..5f94c26b3f 100644
--- a/reference/dom/functions/dom-domdocument-load.xml
+++ b/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>
diff --git a/reference/dom/functions/dom-domdocument-loadhtml.xml b/reference/dom/functions/dom-domdocument-loadhtml.xml
index 5f3afe1576..8909581a1e 100644
--- a/reference/dom/functions/dom-domdocument-loadhtml.xml
+++ b/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>
diff --git a/reference/dom/functions/dom-domdocument-loadhtmlfile.xml b/reference/dom/functions/dom-domdocument-loadhtmlfile.xml
index d70c6bca03..ac7aa7feae 100644
--- a/reference/dom/functions/dom-domdocument-loadhtmlfile.xml
+++ b/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>
diff --git a/reference/dom/functions/dom-domdocument-loadxml.xml b/reference/dom/functions/dom-domdocument-loadxml.xml
index 2d1e5c2273..fadc91c2e7 100644
--- a/reference/dom/functions/dom-domdocument-loadxml.xml
+++ b/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>