WordPress.org

Make WordPress Core

Ticket #14928: 14928.docs-only.patch

File 14928.docs-only.patch, 1.5 KB (added by hakre, 8 years ago)

PHPDOCs and Inline Docs only

  • wp-includes/functions.php

     
    20152015}
    20162016
    20172017/**
     2018 * Make Directories.
     2019 *
    20182020 * Recursive directory creation based on full path.
     2021 * Attempts to set permissions on newly created folders.
    20192022 *
    2020  * Will attempt to set permissions on folders.
     2023 * As php mkdir() (PHP < 5.0.0) does not support recursive paths, this function mimics
     2024 * the *nix `mkdir -p` / `mkdir --parent` command.
    20212025 *
     2026 * In difference to mkdir, the permissions set on newly created folders
     2027 * is based on the parent folder permissions - not umask.
     2028 *
     2029 * @link http://www.gnu.org/software/coreutils/manual/coreutils.html#mkdir-invocation
     2030 * @link http://php.net/mkdir
    20222031 * @since 2.0.1
    20232032 *
    2024  * @param string $target Full path to attempt to create.
    2025  * @return bool Whether the path was created. True if path already exists.
     2033 * @param string $target Path of a directory to create.
     2034 * @return bool Whether the target path exists (already or just created does not make a difference).
    20262035 */
    20272036function wp_mkdir_p( $target ) {
    2028         // from php.net/mkdir user contributed notes
     2037        // undocumented, from a removed php.net/mkdir user contributed notes
    20292038        $target = str_replace( '//', '/', $target );
    20302039
    20312040        // safe mode fails with a trailing slash under certain PHP versions.
     
    20332042        if ( empty($target) )
    20342043                $target = '/';
    20352044
     2045        // Handle existing target.
    20362046        if ( file_exists( $target ) )
    20372047                return @is_dir( $target );
    20382048