[wp-trac] [WordPress Trac] #14928: wp_mkdir_p() phpdocs do not explain the "p" in the function name in full

[WordPress Trac]

#14928: wp_mkdir_p() phpdocs do not explain the "p" in the function name in full
--------------------------+-------------------------------------------------
 Reporter:  hakre         |       Owner:                 
     Type:  defect (bug)  |      Status:  new            
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Inline Docs   |     Version:  3.0            
 Severity:  normal        |    Keywords:  has-patch      
--------------------------+-------------------------------------------------

Comment(by dd32):

 > Default MKDIR chmod is 0777, so it's the latest and greatest. Let me
 know if that should replace FS_CHMOD_DIR. I doubt it. Are you okay for
 0755? Or what do you mean by higher credentials.

 FS_CHMOD_DIR is used by the Filesystem API, The Filesystem API is designed
 to work as the user who owns the files, Ie. "higher credentials than
 Apache will be running as". wp_mkdir_p() is directly by apache and is not
 run as the user who owns the files.

 > And regarding coding standards

 I'm not sure why, But the Coding style wiki doesnt refer to 'Common Sense'
 directly unfortunately. Its an If statement, Use the right tool for the
 job.

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/14928#comment:19>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software