ntwb / wordpress

src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php

Doc Comments +2 added lines, -2 removed lines

@@ -248,7 +248,7 @@ 
 	 * @access public
 	 *
 	 * @param WP_REST_Request $request Request object.
-	 * @return WP_Error|stdClass $prepared_attachment Post object.
+	 * @return string $prepared_attachment Post object.
 	 */
 	protected function prepare_item_for_database( $request ) {
 		$prepared_attachment = parent::prepare_item_for_database( $request );
@@ -483,7 +483,7 @@ 
 	 * @since 4.7.0
 	 * @access protected
 	 *
-	 * @param array $data    Supplied file data.
+	 * @param string $data    Supplied file data.
 	 * @param array $headers HTTP headers from the request.
 	 * @return array|WP_Error Data from wp_handle_sideload().
 	 */

src/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

Doc Comments +1 added lines, -1 removed lines

@@ -1002,7 +1002,7 @@
 	 * @since 4.7.0
 	 * @access protected
 	 *
-	 * @param string|int $comment_approved comment status.
+	 * @param string $comment_approved comment status.
 	 * @return string Comment status.
 	 */
 	protected function prepare_status_response( $comment_approved ) {

src/wp-includes/rest-api/endpoints/class-wp-rest-controller.php

Doc Comments +1 added lines, -1 removed lines

@@ -179,7 +179,7 @@
 	 * @access public
 	 *
 	 * @param WP_REST_Request $request Request object.
-	 * @return WP_Error|object The prepared item, or WP_Error object on failure.
+	 * @return WP_Error The prepared item, or WP_Error object on failure.
 	 */
 	protected function prepare_item_for_database( $request ) {
 		return new WP_Error( 'invalid-method', sprintf( __( "Method '%s' not implemented. Must be overridden in subclass." ), __METHOD__ ), array( 'status' => 405 ) );

src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Doc Comments +2 added lines, -2 removed lines

@@ -1061,7 +1061,7 @@ 
 	 * @access protected
 	 *
 	 * @param string $post_status Post status.
-	 * @param object $post_type   Post type.
+	 * @param WP_Post_Type|null $post_type   Post type.
 	 * @return string|WP_Error Post status or WP_Error if lacking the proper permission.
 	 */
 	protected function handle_status_param( $post_status, $post_type ) {
@@ -1201,7 +1201,7 @@ 
 	 * @since 4.7.0
 	 * @access protected
 	 *
-	 * @param object|string $post_type Post type name or object.
+	 * @param WP_Post_Type|null $post_type Post type name or object.
 	 * @return bool Whether the post type is allowed in REST.
 	 */
 	protected function check_is_post_type_allowed( $post_type ) {

src/wp-admin/includes/class-wp-community-events.php

Doc Comments +1 added lines, -1 removed lines

@@ -307,7 +307,7 @@
 	 * @since 4.8.0
 	 *
 	 * @param  array $location Should contain 'latitude' and 'longitude' indexes.
-	 * @return bool|string false on failure, or a string on success.
+	 * @return string|false false on failure, or a string on success.
 	 */
 	protected function get_events_transient_key( $location ) {
 		$key = false;

src/wp-admin/includes/class-wp-filesystem-ftpext.php

Doc Comments +1 added lines, -1 removed lines

@@ -153,7 +153,7 @@
 	 *
 	 * @param string $file
 	 * @param string $contents
-	 * @param bool|int $mode
+	 * @param string|boolean $mode
 	 * @return bool
 	 */
 	public function put_contents($file, $contents, $mode = false ) {

src/wp-admin/includes/image-edit.php

Doc Comments +1 added lines, -1 removed lines

@@ -384,7 +384,7 @@
  * @ignore
  * @param resource  $img   Image resource.
  * @param float|int $angle Image rotation angle, in degrees.
- * @return resource|false GD image resource, false otherwise.
+ * @return resource GD image resource, false otherwise.
  */
 function _rotate_image_resource($img, $angle) {
 	_deprecated_function( __FUNCTION__, '3.5.0', 'WP_Image_Editor::rotate()' );

src/wp-admin/includes/ms.php

Doc Comments +1 added lines, -1 removed lines

@@ -780,7 +780,7 @@
  * @global int    $wp_db_version The version number of the database.
  * @global string $pagenow
  *
- * @return false False if the current user is not a super admin.
+ * @return false|null False if the current user is not a super admin.
  */
 function site_admin_notice() {
 	global $wp_db_version, $pagenow;

src/wp-admin/includes/plugin.php

Doc Comments +5 added lines, -4 removed lines

@@ -51,7 +51,7 @@ 
  * @param bool   $markup      Optional. If the returned data should have HTML markup applied.
  *                            Default true.
  * @param bool   $translate   Optional. If the returned data should be translated. Default true.
- * @return array {
+ * @return string {
  *     Plugin data. Values will be empty if not supplied by the plugin.
  *
  *     @type string $Name        Name of the plugin. Should be unique.
@@ -188,7 +188,7 @@ 
  * @since 2.8.0
  *
  * @param string $plugin Path to the main plugin file from plugins directory.
- * @return array List of files relative to the plugin root.
+ * @return string[] List of files relative to the plugin root.
  */
 function get_plugin_files($plugin) {
 	$plugin_file = WP_PLUGIN_DIR . '/' . $plugin;
@@ -767,7 +767,7 @@ 
  *
  * @global WP_Filesystem_Base $wp_filesystem
  *
- * @param array  $plugins    List of plugins to delete.
+ * @param string[]  $plugins    List of plugins to delete.
  * @param string $deprecated Deprecated.
  * @return bool|null|WP_Error True on success, false is $plugins is empty, WP_Error on failure.
  *                            Null if filesystem credentials are required to proceed.
@@ -985,7 +985,7 @@ 
  * @since 2.7.0
  *
  * @param string $plugin Path to the main plugin file from plugins directory.
- * @return true True if a plugin's uninstall.php file has been found and included.
+ * @return boolean|null True if a plugin's uninstall.php file has been found and included.
  */
 function uninstall_plugin($plugin) {
 	$file = plugin_basename($plugin);
@@ -1505,6 +1505,7 @@ 
  * @global array $_wp_real_parent_file
  * @global array $_wp_menu_nopriv
  * @global array $_wp_submenu_nopriv
+ * @return string
  */
 function get_admin_page_parent( $parent = '' ) {
 	global $parent_file, $menu, $submenu, $pagenow, $typenow,