<?xml version="1.0"?>
<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
    title="Deprecated Function Parameters"
    >
    <standard>
    <![CDATA[
    Please refrain from passing deprecated WordPress function parameters.
    In case, you need to pass an optional parameter positioned <em>after</em> the deprecated parameter, only ever pass the default value.
    ]]>
    </standard>
    <code_comparison>
        <code title="Valid: Not passing a deprecated parameter.">
        <![CDATA[
// First - and only - parameter deprecated.
get_the_author();
        ]]>
        </code>
        <code title="Invalid: Passing a deprecated parameter.">
        <![CDATA[
// First - and only - parameter deprecated.
get_the_author( <em>$string</em> );
        ]]>
        </code>
    </code_comparison>
    <code_comparison>
        <code title="Valid: Passing default value for a deprecated parameter.">
        <![CDATA[
// Third parameter deprecated in WP 2.3.0.
add_option( 'option_name', 123, <em>''</em>, 'yes' );
        ]]>
        </code>
        <code title="Invalid: Not passing the default value for a deprecated parameter.">
        <![CDATA[
// Third parameter deprecated in WP 2.3.0.
add_option( 'my_name', 123, <em>'oops'</em>, 'yes' );
        ]]>
        </code>
    </code_comparison>
</documentation>
