sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/LICENSE

@@ -1,165 +0,0 @@
-                   GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-
-  This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
-
-  0. Additional Definitions.
-
-  As used herein, "this License" refers to version 3 of the GNU Lesser
-General Public License, and the "GNU GPL" refers to version 3 of the GNU
-General Public License.
-
-  "The Library" refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
-
-  An "Application" is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
-
-  A "Combined Work" is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the "Linked
-Version".
-
-  The "Minimal Corresponding Source" for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
-
-  The "Corresponding Application Code" for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
-
-  1. Exception to Section 3 of the GNU GPL.
-
-  You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
-
-  2. Conveying Modified Versions.
-
-  If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
-
-   a) under this License, provided that you make a good faith effort to
-   ensure that, in the event an Application does not supply the
-   function or data, the facility still operates, and performs
-   whatever part of its purpose remains meaningful, or
-
-   b) under the GNU GPL, with none of the additional permissions of
-   this License applicable to that copy.
-
-  3. Object Code Incorporating Material from Library Header Files.
-
-  The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
-
-   a) Give prominent notice with each copy of the object code that the
-   Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the object code with a copy of the GNU GPL and this license
-   document.
-
-  4. Combined Works.
-
-  You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
-
-   a) Give prominent notice with each copy of the Combined Work that
-   the Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the Combined Work with a copy of the GNU GPL and this license
-   document.
-
-   c) For a Combined Work that displays copyright notices during
-   execution, include the copyright notice for the Library among
-   these notices, as well as a reference directing the user to the
-   copies of the GNU GPL and this license document.
-
-   d) Do one of the following:
-
-       0) Convey the Minimal Corresponding Source under the terms of this
-       License, and the Corresponding Application Code in a form
-       suitable for, and under terms that permit, the user to
-       recombine or relink the Application with a modified version of
-       the Linked Version to produce a modified Combined Work, in the
-       manner specified by section 6 of the GNU GPL for conveying
-       Corresponding Source.
-
-       1) Use a suitable shared library mechanism for linking with the
-       Library.  A suitable mechanism is one that (a) uses at run time
-       a copy of the Library already present on the user's computer
-       system, and (b) will operate properly with a modified version
-       of the Library that is interface-compatible with the Linked
-       Version.
-
-   e) Provide Installation Information, but only if you would otherwise
-   be required to provide such information under section 6 of the
-   GNU GPL, and only to the extent that such information is
-   necessary to install and execute a modified version of the
-   Combined Work produced by recombining or relinking the
-   Application with a modified version of the Linked Version. (If
-   you use option 4d0, the Installation Information must accompany
-   the Minimal Corresponding Source and Corresponding Application
-   Code. If you use option 4d1, you must provide the Installation
-   Information in the manner specified by section 6 of the GNU GPL
-   for conveying Corresponding Source.)
-
-  5. Combined Libraries.
-
-  You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
-
-   a) Accompany the combined library with a copy of the same work based
-   on the Library, uncombined with any other library facilities,
-   conveyed under the terms of this License.
-
-   b) Give prominent notice with the combined library that part of it
-   is a work based on the Library, and explaining where to find the
-   accompanying uncombined form of the same work.
-
-  6. Revised Versions of the GNU Lesser General Public License.
-
-  The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
-
-  Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License "or any later version"
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
-
-  If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
-Library.

package/vendor/phpcsstandards/phpcsextra/Modernize/Docs/FunctionCalls/DirnameStandard.xml

@@ -1,40 +0,0 @@
-<?xml version="1.0"?>
-<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
-    title="Function Calls to Dirname"
-    >
-    <standard>
-    <![CDATA[
-    PHP >= 5.3: Usage of dirname(__FILE__) can be replaced with __DIR__.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: Using __DIR__.">
-        <![CDATA[
-$path = <em>__DIR__</em>;
-        ]]>
-        </code>
-        <code title="Invalid: dirname(__FILE__).">
-        <![CDATA[
-$path = <em>dirname(__FILE__)</em>;
-        ]]>
-        </code>
-    </code_comparison>
-    <standard>
-    <![CDATA[
-    PHP >= 7.0: Nested calls to dirname() can be replaced by using dirname() with the $levels parameter.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: Using dirname() with the $levels parameter.">
-        <![CDATA[
-$path = <em>dirname($file, 3)</em>;
-        ]]>
-        </code>
-        <code title="Invalid: Nested function calls to dirname().">
-        <![CDATA[
-$path = <em>dirname(dirname(dirname($file)))</em>;
-        ]]>
-        </code>
-    </code_comparison>
-</documentation>

package/vendor/phpcsstandards/phpcsextra/Modernize/Sniffs/FunctionCalls/DirnameSniff.php

@@ -1,382 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2020 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Modernize\Sniffs\FunctionCalls;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\BackCompat\Helper;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\Context;
-use PHPCSUtils\Utils\PassedParameters;
-
-/**
- * Detect `dirname(__FILE__)` and nested uses of `dirname()`.
- *
- * @since 1.0.0
- */
-final class DirnameSniff implements Sniff
-{
-
-    /**
-     * PHP version as configured or 0 if unknown.
-     *
-     * @since 1.1.1
-     *
-     * @var int
-     */
-    private $phpVersion;
-
-    /**
-     * Registers the tokens that this sniff wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_STRING];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        if (isset($this->phpVersion) === false || \defined('PHP_CODESNIFFER_IN_TESTS')) {
-            // Set default value to prevent this code from running every time the sniff is triggered.
-            $this->phpVersion = 0;
-
-            $phpVersion = Helper::getConfigData('php_version');
-            if ($phpVersion !== null) {
-                $this->phpVersion = (int) $phpVersion;
-            }
-        }
-
-        if ($this->phpVersion !== 0 && $this->phpVersion < 50300) {
-            // PHP version too low, nothing to do.
-            return;
-        }
-
-        $tokens = $phpcsFile->getTokens();
-
-        if (\strtolower($tokens[$stackPtr]['content']) !== 'dirname') {
-            // Not our target.
-            return;
-        }
-
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextNonEmpty === false
-            || $tokens[$nextNonEmpty]['code'] !== \T_OPEN_PARENTHESIS
-            || isset($tokens[$nextNonEmpty]['parenthesis_owner']) === true
-        ) {
-            // Not our target.
-            return;
-        }
-
-        if (isset($tokens[$nextNonEmpty]['parenthesis_closer']) === false) {
-            // Live coding or parse error, ignore.
-            return;
-        }
-
-        if (Context::inAttribute($phpcsFile, $stackPtr) === true) {
-            // Class instantiation in attribute, not function call.
-            return;
-        }
-
-        // Check if it is really a function call to the global function.
-        $prevNonEmpty = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-
-        if (isset(Collections::objectOperators()[$tokens[$prevNonEmpty]['code']]) === true
-            || $tokens[$prevNonEmpty]['code'] === \T_NEW
-        ) {
-            // Method call, class instantiation or other "not our target".
-            return;
-        }
-
-        if ($tokens[$prevNonEmpty]['code'] === \T_NS_SEPARATOR) {
-            $prevPrevToken = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($prevNonEmpty - 1), null, true);
-            if ($tokens[$prevPrevToken]['code'] === \T_STRING
-                || $tokens[$prevPrevToken]['code'] === \T_NAMESPACE
-            ) {
-                // Namespaced function.
-                return;
-            }
-        }
-
-        /*
-         * As of here, we can be pretty sure this is a function call to the global function.
-         */
-        $opener = $nextNonEmpty;
-        $closer = $tokens[$nextNonEmpty]['parenthesis_closer'];
-
-        $parameters = PassedParameters::getParameters($phpcsFile, $stackPtr);
-        $paramCount = \count($parameters);
-        if (empty($parameters) || $paramCount > 2) {
-            // No parameters or too many parameter.
-            return;
-        }
-
-        $pathParam = PassedParameters::getParameterFromStack($parameters, 1, 'path');
-        if ($pathParam === false) {
-            // If the path parameter doesn't exist, there's nothing to do.
-            return;
-        }
-
-        $levelsParam = PassedParameters::getParameterFromStack($parameters, 2, 'levels');
-        if ($levelsParam === false && $paramCount === 2) {
-            // There must be a typo in the param name or an otherwise stray parameter. Ignore.
-            return;
-        }
-
-        /*
-         * PHP 5.3+: Detect use of dirname(__FILE__).
-         */
-        if (\strtoupper($pathParam['clean']) === '__FILE__') {
-            $levelsValue = false;
-
-            // Determine if the issue is auto-fixable.
-            $hasComment = $phpcsFile->findNext(Tokens::$commentTokens, ($opener + 1), $closer);
-            $fixable    = ($hasComment === false);
-
-            if ($fixable === true) {
-                $levelsValue = $this->getLevelsValue($phpcsFile, $levelsParam);
-                if ($levelsParam !== false && $levelsValue === false) {
-                    // Can't autofix if we don't know the value of the $levels parameter.
-                    $fixable = false;
-                }
-            }
-
-            $error = 'Use the __DIR__ constant instead of calling dirname(__FILE__) (PHP >= 5.3)';
-            $code  = 'FileConstant';
-
-            // Throw the error.
-            if ($fixable === false) {
-                $phpcsFile->addError($error, $stackPtr, $code);
-                return;
-            }
-
-            $fix = $phpcsFile->addFixableError($error, $stackPtr, $code);
-            if ($fix === true) {
-                if ($levelsParam === false || $levelsValue === 1) {
-                    // No $levels or $levels set to 1: we can replace the complete function call.
-                    $phpcsFile->fixer->beginChangeset();
-
-                    $phpcsFile->fixer->replaceToken($stackPtr, '__DIR__');
-
-                    for ($i = ($stackPtr + 1); $i <= $closer; $i++) {
-                        $phpcsFile->fixer->replaceToken($i, '');
-                    }
-
-                    // Remove potential leading \.
-                    if ($tokens[$prevNonEmpty]['code'] === \T_NS_SEPARATOR) {
-                        $phpcsFile->fixer->replaceToken($prevNonEmpty, '');
-                    }
-
-                    $phpcsFile->fixer->endChangeset();
-                } else {
-                    // We can replace the $path parameter and will need to adjust the $levels parameter.
-                    $filePtr   = $phpcsFile->findNext(\T_FILE, $pathParam['start'], ($pathParam['end'] + 1));
-                    $levelsPtr = $phpcsFile->findNext(\T_LNUMBER, $levelsParam['start'], ($levelsParam['end'] + 1));
-
-                    $phpcsFile->fixer->beginChangeset();
-                    $phpcsFile->fixer->replaceToken($filePtr, '__DIR__');
-                    $phpcsFile->fixer->replaceToken($levelsPtr, ($levelsValue - 1));
-                    $phpcsFile->fixer->endChangeset();
-                }
-            }
-
-            return;
-        }
-
-        /*
-         * PHP 7.0+: Detect use of nested calls to dirname().
-         */
-        if ($this->phpVersion !== 0 && $this->phpVersion < 70000) {
-            // No need to check for this issue if the PHP version would not allow for it anyway.
-            return;
-        }
-
-        if (\preg_match('`^\s*\\\\?dirname\s*\(`i', $pathParam['clean']) !== 1) {
-            return;
-        }
-
-        /*
-         * Check if there is something _behind_ the nested dirname() call within the same parameter.
-         *
-         * Note: the findNext() calls are safe and will always match the dirname() function call
-         * as otherwise the above regex wouldn't have matched.
-         */
-        $innerDirnamePtr = $phpcsFile->findNext(\T_STRING, $pathParam['start'], ($pathParam['end'] + 1));
-        $innerOpener     = $phpcsFile->findNext(\T_OPEN_PARENTHESIS, ($innerDirnamePtr + 1), ($pathParam['end'] + 1));
-        if (isset($tokens[$innerOpener]['parenthesis_closer']) === false) {
-            // Shouldn't be possible.
-            return; // @codeCoverageIgnore
-        }
-
-        $innerCloser = $tokens[$innerOpener]['parenthesis_closer'];
-        if ($innerCloser !== $pathParam['end']) {
-            $hasContentAfter = $phpcsFile->findNext(
-                Tokens::$emptyTokens,
-                ($innerCloser + 1),
-                ($pathParam['end'] + 1),
-                true
-            );
-            if ($hasContentAfter !== false) {
-                // Matched code like: `dirname(dirname($file) . 'something')`. Ignore.
-                return;
-            }
-        }
-
-        /*
-         * Determine if this is an auto-fixable error.
-         */
-
-        // Step 1: Are there comments ? If so, not auto-fixable as we don't want to remove comments.
-        $fixable          = true;
-        $outerLevelsValue = false;
-        $innerParameters  = [];
-        $innerLevelsParam = false;
-        $innerLevelsValue = false;
-
-        for ($i = ($opener + 1); $i < $closer; $i++) {
-            if (isset(Tokens::$commentTokens[$tokens[$i]['code']])) {
-                $fixable = false;
-                break;
-            }
-
-            if ($tokens[$i]['code'] === \T_OPEN_PARENTHESIS
-                && isset($tokens[$i]['parenthesis_closer'])
-            ) {
-                // Skip over everything within the nested dirname() function call.
-                $i = $tokens[$i]['parenthesis_closer'];
-            }
-        }
-
-        // Step 2: Does the `$levels` parameter exist for the outer dirname() call and if so, is it usable ?
-        if ($fixable === true) {
-            $outerLevelsValue = $this->getLevelsValue($phpcsFile, $levelsParam);
-            if ($levelsParam !== false && $outerLevelsValue === false) {
-                // Can't autofix if we don't know the value of the $levels parameter.
-                $fixable = false;
-            }
-        }
-
-        // Step 3: Does the `$levels` parameter exist for the inner dirname() call and if so, is it usable ?
-        if ($fixable === true) {
-            $innerParameters  = PassedParameters::getParameters($phpcsFile, $innerDirnamePtr);
-            $innerLevelsParam = PassedParameters::getParameterFromStack($innerParameters, 2, 'levels');
-            $innerLevelsValue = $this->getLevelsValue($phpcsFile, $innerLevelsParam);
-            if ($innerLevelsParam !== false && $innerLevelsValue === false) {
-                // Can't autofix if we don't know the value of the $levels parameter.
-                $fixable = false;
-            }
-        }
-
-        /*
-         * Throw the error.
-         */
-        $error  = 'Pass the $levels parameter to the dirname() call instead of using nested dirname() calls';
-        $error .= ' (PHP >= 7.0)';
-        $code   = 'Nested';
-
-        if ($fixable === false) {
-            $phpcsFile->addError($error, $stackPtr, $code);
-            return;
-        }
-
-        $fix = $phpcsFile->addFixableError($error, $stackPtr, $code);
-        if ($fix === false) {
-            return;
-        }
-
-        /*
-         * Fix the error.
-         */
-        $phpcsFile->fixer->beginChangeset();
-
-        // Remove the info in the _outer_ param call.
-        for ($i = $opener; $i < $innerOpener; $i++) {
-            $phpcsFile->fixer->replaceToken($i, '');
-        }
-
-        for ($i = ($innerCloser + 1); $i <= $closer; $i++) {
-            $phpcsFile->fixer->replaceToken($i, '');
-        }
-
-        if ($innerLevelsParam !== false) {
-            // Inner $levels parameter already exists, just adjust the value.
-            $innerLevelsPtr = $phpcsFile->findNext(
-                \T_LNUMBER,
-                $innerLevelsParam['start'],
-                ($innerLevelsParam['end'] + 1)
-            );
-            $phpcsFile->fixer->replaceToken($innerLevelsPtr, ($innerLevelsValue + $outerLevelsValue));
-        } else {
-            // Inner $levels parameter does not exist yet. We need to add it.
-            $content = ', ';
-
-            $prevBeforeCloser = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($innerCloser - 1), null, true);
-            if ($tokens[$prevBeforeCloser]['code'] === \T_COMMA) {
-                // Trailing comma found, no need to add the comma.
-                $content = ' ';
-            }
-
-            $innerPathParam = PassedParameters::getParameterFromStack($innerParameters, 1, 'path');
-            if (isset($innerPathParam['name_token']) === true) {
-                // Non-named param cannot follow named param, so add param name.
-                $content .= 'levels: ';
-            }
-
-            $content .= ($innerLevelsValue + $outerLevelsValue);
-            $phpcsFile->fixer->addContentBefore($innerCloser, $content);
-        }
-
-        $phpcsFile->fixer->endChangeset();
-    }
-
-    /**
-     * Determine the value of the $levels parameter passed to dirname().
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File     $phpcsFile   The file being scanned.
-     * @param array<string, int|string>|false $levelsParam The information about the parameter as retrieved
-     *                                                     via PassedParameters::getParameterFromStack().
-     *
-     * @return int|false Integer levels value or FALSE if the levels value couldn't be determined.
-     */
-    private function getLevelsValue($phpcsFile, $levelsParam)
-    {
-        if ($levelsParam === false) {
-            return 1;
-        }
-
-        $ignore   = Tokens::$emptyTokens;
-        $ignore[] = \T_LNUMBER;
-
-        $hasNonNumber = $phpcsFile->findNext($ignore, $levelsParam['start'], ($levelsParam['end'] + 1), true);
-        if ($hasNonNumber !== false) {
-            return false;
-        }
-
-        return (int) $levelsParam['clean'];
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Modernize/ruleset.xml

@@ -1,5 +0,0 @@
-<?xml version="1.0"?>
-<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="Modernize" namespace="PHPCSExtra\Modernize" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/PHPCSStandards/PHP_CodeSniffer/master/phpcs.xsd">
-
-    <description>A collection of sniffs to detect code modernization opportunities.</description>
-</ruleset>

package/vendor/phpcsstandards/phpcsextra/NormalizedArrays/Docs/Arrays/ArrayBraceSpacingStandard.xml

@@ -1,94 +0,0 @@
-<?xml version="1.0"?>
-<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
-    title="Array Brace Spacing"
-    >
-    <standard>
-    <![CDATA[
-        There should be no space between the "array" keyword and the array open brace.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: No space between the keyword and the open brace.">
-        <![CDATA[
-$args = array(1, 2);
-        ]]>
-        </code>
-        <code title="Invalid: Space between the keyword and the open brace.">
-        <![CDATA[
-$args = array<em>  </em>(1, 2);
-        ]]>
-        </code>
-    </code_comparison>
-    <standard>
-    <![CDATA[
-        There should be no space between the array open brace and the array close brace for an empty array.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: No space between the braces.">
-        <![CDATA[
-$args = array();
-
-$args = [];
-        ]]>
-        </code>
-        <code title="Invalid: Space between the braces.">
-        <![CDATA[
-$args = array(<em> </em>);
-
-$args = [<em>  </em>];
-        ]]>
-        </code>
-    </code_comparison>
-    <standard>
-    <![CDATA[
-        There should be no space after the array open brace and before the array close brace in a single-line array.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: No space on the inside of the braces.">
-        <![CDATA[
-$args = array(1, 2);
-
-$args = [1, 2];
-        ]]>
-        </code>
-        <code title="Invalid: Space on the inside of the braces.">
-        <![CDATA[
-$args = array(<em> </em>1, 2<em> </em>);
-
-$args = [<em>  </em>1, 2<em>  </em>];
-        ]]>
-        </code>
-    </code_comparison>
-    <standard>
-    <![CDATA[
-        There should be a new line after the array open brace and before the array close brace in a multi-line array.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: One new line after the open brace and before the close brace.">
-        <![CDATA[
-$args = array(<em>
-</em>    1,
-    2<em>
-</em>);
-
-$args = [<em>
-</em>    1,
-    2<em>
-</em>];
-        ]]>
-        </code>
-        <code title="Invalid: No new lines after the open brace and/or before the close brace.">
-        <![CDATA[
-$args = array(1,
-    2);
-
-$args = [1,
-    2];
-        ]]>
-        </code>
-    </code_comparison>
-</documentation>