WordPress.org

Make WordPress Core

Ticket #14928: 14928.docs-only.patch

File 14928.docs-only.patch, 1.5 KB (added by hakre, 4 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