Mark deprecated functions with the #[\Deprecated] attribute

reference/datetime/functions/date-sunrise.xml

@@ -19,6 +19,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname>
    <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>

reference/datetime/functions/date-sunset.xml

@@ -21,6 +21,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname>
    <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>

reference/datetime/functions/gmstrftime.xml

@@ -17,6 +17,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>

reference/datetime/functions/strftime.xml

@@ -17,6 +17,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>

reference/datetime/functions/strptime.xml

@@ -15,6 +15,7 @@
    <refsect1 role="description">
     &reftitle.description;
     <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname>
    <methodparam><type>string</type><parameter>timestamp</parameter></methodparam>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>

reference/enchant/functions/enchant-broker-free-dict.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>enchant_broker_free_dict</methodname>
    <methodparam><type>EnchantDictionary</type><parameter>dictionary</parameter></methodparam>
   </methodsynopsis>
@@ -48,6 +49,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated in favor of unsetting the object.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

reference/enchant/functions/enchant-broker-free.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>enchant_broker_free</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
   </methodsynopsis>
@@ -49,6 +50,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated in favor of unsetting the object.
+      </entry>
+     </row>
      &enchant.changelog.broker-param;
     </tbody>
    </tgroup>

reference/enchant/functions/enchant-broker-get-dict-path.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>enchant_broker_get_dict_path</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
    <methodparam><type>int</type><parameter>type</parameter></methodparam>
@@ -59,6 +60,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated.
+      </entry>
+     </row>
      &enchant.changelog.broker-param;
     </tbody>
    </tgroup>

reference/enchant/functions/enchant-broker-set-dict-path.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>enchant_broker_set_dict_path</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
    <methodparam><type>int</type><parameter>type</parameter></methodparam>
@@ -67,6 +68,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated.
+      </entry>
+     </row>
      &enchant.changelog.broker-param;
     </tbody>
    </tgroup>

reference/libxml/functions/libxml-disable-entity-loader.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
 <refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>libxml_disable_entity_loader</refname>
@@ -14,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>libxml_disable_entity_loader</methodname>
    <methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
@@ -59,6 +59,28 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 <!--
  <refsect1 role="errors">
   &reftitle.errors;
@@ -112,7 +134,6 @@
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/mhash/functions/mhash-count.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>int</type><methodname>mhash_count</methodname>
    <void/>
   </methodsynopsis>
@@ -82,7 +83,6 @@ for ($i = 0; $i <= $nr; $i++) {
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/mhash/functions/mhash-get-block-size.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>int</type><type>false</type></type><methodname>mhash_get_block_size</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
   </methodsynopsis>

reference/mhash/functions/mhash-get-hash-name.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash_get_hash_name</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
   </methodsynopsis>

reference/mhash/functions/mhash-keygen-s2k.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mhash-keygen-s2k">
+<refentry xml:id="function.mhash-keygen-s2k" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mhash_keygen_s2k</refname>
   <refpurpose>Generates a key</refpurpose>
@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash_keygen_s2k</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
    <methodparam><type>string</type><parameter>password</parameter></methodparam>

reference/mhash/functions/mhash.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
    <methodparam><type>string</type><parameter>data</parameter></methodparam>

reference/mysqli/mysqli/get-client-info.xml

@@ -13,6 +13,7 @@
   <para>&style.oop;</para>
   <fieldsynopsis><type>string</type><varname linkend="mysqli.get-client-info">mysqli-&gt;client_info</varname></fieldsynopsis>
   <methodsynopsis role="mysqli">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>string</type><methodname>mysqli::get_client_info</methodname>
    <void/>
   </methodsynopsis>

reference/mysqli/mysqli/init.xml

@@ -11,6 +11,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type class="union"><type>bool</type><type>null</type></type><methodname>mysqli::init</methodname>
    <void/>
   </methodsynopsis>

reference/mysqli/mysqli/kill.xml

@@ -15,11 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::kill</methodname>
    <methodparam><type>int</type><parameter>process_id</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>mysqli_kill</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type>int</type><parameter>process_id</parameter></methodparam>

reference/mysqli/mysqli/ping.xml

@@ -15,11 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::ping</methodname>
    <void/>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>mysqli_ping</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
   </methodsynopsis>

reference/mysqli/mysqli/refresh.xml

@@ -15,11 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::refresh</methodname>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>mysqli_refresh</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>

reference/openssl/functions/openssl-free-key.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>void</type><methodname>openssl_free_key</methodname>
    <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
   </methodsynopsis>

reference/openssl/functions/openssl-pkey-free.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>void</type><methodname>openssl_pkey_free</methodname>
    <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
   </methodsynopsis>

reference/openssl/functions/openssl-x509-free.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>void</type><methodname>openssl_x509_free</methodname>
    <methodparam><type>OpenSSLCertificate</type><parameter>certificate</parameter></methodparam>
   </methodsynopsis>

reference/random/functions/lcg-value.xml

@@ -13,9 +13,10 @@
  <refsect1 role="description">
   &reftitle.description;
    <methodsynopsis>
-    <type>float</type><methodname>lcg_value</methodname>
-    <void/>
-   </methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
+   <type>float</type><methodname>lcg_value</methodname>
+   <void/>
+  </methodsynopsis>
   <para>
    <function>lcg_value</function> returns a pseudo random number in
    the range of (0, 1).  The function combines two CGs with periods
@@ -85,7 +86,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

reference/reflection/reflectionfunction/isdisabled.xml

@@ -13,6 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="ReflectionFunction">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>ReflectionFunction::isDisabled</methodname>
    <void/>
   </methodsynopsis>
@@ -31,10 +32,33 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &true; if it's disable, otherwise &false;
+   &true; if it's disabled, otherwise &false;
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       This function has been deprecated, as <classname>ReflectionFunction</classname>
+       can no longer be constructed for disabled functions.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>