Missing @return statement in function

[subrataemfluence]

Are we already tracking the following or fixed already?

If not, get_admin_page_parent function in wp-admin/includes/plugin.php has no return type specified in its Doc block.

Also, it does not have a signature for $parent argument in Doc block as well.

I think the Doc block may be rewritten in the following manner:

/**
 *
 * @global string $parent_file
 * @global array $menu
 * @global array $submenu
 * @global string $pagenow
 * @global string $typenow
 * @global string $plugin_page
 * @global array $_wp_real_parent_file
 * @global array $_wp_menu_nopriv
 * @global array $_wp_submenu_nopriv
 *
 * $parent string. Name of admin page parent. Default is empty when current page has no parent.
 * @return string.
 */

 function get_admin_page_parent( $parent = '' ) {
    ...
 }

[SergeyBiryukov]

@return tag was added in [45085], though it would also benefit from a description.

@param tag is still missing.

[SergeyBiryukov]

In 47546:

Docs: Add documentation for the $parent parameter of get_admin_page_parent().

Props subrataemfluence.
Fixes #45849.