$pagenow is used but not define in documentation of this function add_customize_screen_to_heartbeat_settings()

[jontyravi]

global $pagenow is used add_customize_screen_to_heartbeat_settings($settings) in this function. But it is not mentioned in the documentation of the function.

[jontyravi]

I have added patch of this ticket

[bhrugesh12]

Add doc comment for $global variable $pagenow. Find the latest attachment.

[kebbet]

A search for string $pagenow in the src-directory gives that global variables should be declared between the since-tag and the param-tags in the docblock.

Something like

* Filters heartbeat settings for the Customizer.
*
* @since 4.9.0
*
* @global string $pagenow Description
*
* @param array $settings Current settings to filter.

[SergeyBiryukov]

Hi there, thanks for the patches!

I think we should add the missing @global tag but may want to skip the description for now, as this global is also used in other methods of the same class, as well as many other areas of core, and should probably have a consistent description everywhere.

[SergeyBiryukov]

In 53059:

Docs: Consistently document the $pagenow global in WP_Customize_Manage methods.

Follow-up to [41839].

Props jontyravi, bhrugesh12, kebbet.
Fixes #55499.

[SergeyBiryukov]

In 53060:

Docs: Add missing description for $pagenow global in various functions.

See #54729, #55499.