Add missing doc blocks to wp-admin/includes/*.

Fix some egregious uses of tabbing.
Some functions can simply return `apply_filters(...)` instead of setting a variable that is immediately returned.

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32654 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Scott Taylor
2015-05-29 20:16:22 +00:00
parent d55800a4f2
commit ec5758225c
44 changed files with 557 additions and 191 deletions
@@ -20,7 +20,11 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
*/
public $ftp;
public function __construct($opt = '') {
/**
*
* @param array $opt
*/
public function __construct( $opt = '' ) {
$this->method = 'ftpsockets';
$this->errors = new WP_Error();
@@ -52,6 +56,10 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
$this->options['password'] = $opt['password'];
}
/**
*
* @return bool
*/
public function connect() {
if ( ! $this->ftp )
return false;
@@ -226,9 +234,9 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
return $dir[$file]['group'];
}
/**
* @param string $source
* @param string $destination
* @param bool $overwrite
* @param string $source
* @param string $destination
* @param bool $overwrite
* @param int|bool $mode
* @return bool
*/
@@ -245,7 +253,7 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
/**
* @param string $source
* @param string $destination
* @param bool $overwrite
* @param bool $overwrite
* @return bool
*/
public function move($source, $destination, $overwrite = false ) {
@@ -253,7 +261,7 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @param string $file
* @param bool $recursive
* @param bool $recursive
* @param string $type
* @return bool
*/
@@ -359,9 +367,9 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
/**
* @param string $path
* @param mixed $chmod
* @param mixed $chown
* @param mixed $chgrp
* @param mixed $chmod
* @param mixed $chown
* @param mixed $chgrp
* @return bool
*/
public function mkdir($path, $chmod = false, $chown = false, $chgrp = false ) {
@@ -387,8 +395,8 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
/**
* @param string $path
* @param bool $include_hidden
* @param bool $recursive
* @param bool $include_hidden
* @param bool $recursive
* @return bool|array
*/
public function dirlist($path = '.', $include_hidden = true, $recursive = false ) {