WordPress/wp-includes
audrasjb 8c76c6d58c Docs: Replace multiple single line comments with multi-line comments.
This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.

Follow-up to [56174], [56175], [56176], [56177], [56178], [56179].

Props costdev, audrasjb.
See #58459.



Built from https://develop.svn.wordpress.org/trunk@56180


git-svn-id: http://core.svn.wordpress.org/trunk@55692 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-07-09 21:48:22 +00:00
..
assets Editor: update npm packages with bug fixes and blessed tasks. 2023-07-07 07:21:17 +00:00
block-patterns
block-supports Editor: fix comment indentation. 2023-07-06 04:41:23 +00:00
blocks Editor: update npm packages with bug fixes and blessed tasks. 2023-07-07 07:21:17 +00:00
certificates
css Editor: update npm packages with bug fixes and blessed tasks. 2023-07-07 07:21:17 +00:00
customize Docs: Fix a few more typos in DocBlocks and inline comments. 2023-05-19 13:27:20 +00:00
fonts
html-api HTML API: Fix a fatal error when processing malformed document with unclosed attribute. 2023-07-04 20:45:23 +00:00
ID3
images General: Remove Windows Live Writer manifest file. 2023-04-04 14:56:22 +00:00
IXR
js Editor: update npm packages with bug fixes and blessed tasks. 2023-07-07 07:21:17 +00:00
php-compat
PHPMailer External Libraries: Upgrade PHPMailer to version 6.8.0. 2023-03-17 14:22:22 +00:00
pomo Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
Requests External Libraries: Update the Requests library to version 2.0.6. 2023-04-05 13:12:26 +00:00
rest-api Docs: Docblock correction in WP_REST_Attachments_Controller::upload_from_data(). 2023-07-08 21:59:23 +00:00
SimplePie
sitemaps
sodium_compat Upgrade/Install: Update sodium_compat to v1.20.0. 2023-04-30 14:08:23 +00:00
style-engine Editor: add box shadow support to blocks. 2023-06-26 23:44:29 +00:00
Text Code Modernization: Explicitly declare all properties in Text_Diff_Engine_native. 2023-05-12 08:51:22 +00:00
theme-compat General: Replace some instances of "blog" with "site" in documentation, translator comments, and user-facing text strings. 2023-06-19 18:27:27 +00:00
widgets Media: Ensure that the image widget supports loading optimization attributes. 2023-07-06 16:33:27 +00:00
admin-bar.php I18N: Provide gettext context to disambiguate various translation strings. 2023-06-05 21:05:22 +00:00
atomlib.php
author-template.php Code Modernization: Correct fallback return value in get_the_author(). 2023-05-14 17:58:24 +00:00
block-editor.php Editor: add iframe around post editor. 2023-06-27 00:23:23 +00:00
block-i18n.json
block-patterns.php Editor: allow filtering block patterns by source. 2023-06-27 11:13:27 +00:00
block-template-utils.php Editor: update template titles in browse mode. 2023-07-06 03:04:23 +00:00
block-template.php Themes: Block template is located twice in get_query_template(). 2023-06-27 10:15:28 +00:00
blocks.php Editor: Allow Query Block to show posts from multiple selected authors. 2023-06-29 13:30:33 +00:00
bookmark-template.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
bookmark.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
cache-compat.php
cache.php
canonical.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
capabilities.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
category-template.php
category.php Coding Standards: Use strict comparison in wp-includes/category.php. 2023-06-05 11:16:18 +00:00
class-feed.php
class-http.php
class-IXR.php
class-json.php
class-oembed.php
class-phpass.php
class-phpmailer.php
class-pop3.php
class-requests.php External Libraries: Update the Requests library to version 2.0.6. 2023-04-05 13:12:26 +00:00
class-simplepie.php Docs: Various corrections and improvements to inline docs and docblocks. 2023-05-12 21:35:21 +00:00
class-smtp.php
class-snoopy.php
class-walker-category-dropdown.php
class-walker-category.php Coding Standards: Use strict comparison in wp-includes/class-walker-category.php. 2023-06-06 00:30:20 +00:00
class-walker-comment.php
class-walker-nav-menu.php Menus: Allow themes and plugins to pass HTML attributes to various Nav Walker outputs. 2023-06-27 15:26:27 +00:00
class-walker-page-dropdown.php Coding Standards: Use strict comparison in wp-includes/class-walker-page-dropdown.php. 2023-06-11 09:27:18 +00:00
class-walker-page.php Coding Standards: Use strict comparison in wp-includes/class-walker-page.php. 2023-06-12 06:12:24 +00:00
class-wp-admin-bar.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-ajax-response.php
class-wp-application-passwords.php Docs: A host of corrections and improvements to inline documentation. 2023-05-08 22:37:24 +00:00
class-wp-block-editor-context.php
class-wp-block-list.php
class-wp-block-parser-block.php Editor: Update block-serialization-default-parser package for WP 6.3 Beta 1. 2023-06-27 00:45:38 +00:00
class-wp-block-parser-frame.php Editor: Update block-serialization-default-parser package for WP 6.3 Beta 1. 2023-06-27 00:45:38 +00:00
class-wp-block-parser.php Editor: Update block-serialization-default-parser package for WP 6.3 Beta 1. 2023-06-27 00:45:38 +00:00
class-wp-block-pattern-categories-registry.php
class-wp-block-patterns-registry.php Docs: Correct and improve various documented types for properties, functions, and hooks. 2023-04-27 22:29:18 +00:00
class-wp-block-styles-registry.php
class-wp-block-supports.php Docs: A host of corrections and improvements to inline documentation. 2023-05-08 22:37:24 +00:00
class-wp-block-template.php REST API: return post modified datetime for Templates. 2023-06-23 06:29:23 +00:00
class-wp-block-type-registry.php
class-wp-block-type.php Editor: Add selectors field to block type definition 2023-04-21 10:43:25 +00:00
class-wp-block.php
class-wp-classic-to-block-menu-converter.php Editor: add navigation fallback. 2023-06-27 05:54:19 +00:00
class-wp-comment-query.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-comment.php Docs: Use third-person singular verbs in various function descriptions, as per docblocks standards. 2023-04-24 16:37:22 +00:00
class-wp-customize-control.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-customize-manager.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-customize-nav-menus.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
class-wp-customize-panel.php
class-wp-customize-section.php
class-wp-customize-setting.php
class-wp-customize-widgets.php Code Modernization: Replace usage of strpos() with str_starts_with(). 2023-05-02 15:45:22 +00:00
class-wp-date-query.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-dependencies.php
class-wp-dependency.php
class-wp-duotone.php Editor: update duotone support. 2023-06-29 06:21:28 +00:00
class-wp-editor.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-embed.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-error.php
class-wp-fatal-error-handler.php
class-wp-feed-cache-transient.php
class-wp-feed-cache.php
class-wp-hook.php Plugins: Remove is_object() check in WP_Hook:build_preinitialized_hooks(). 2023-05-11 11:43:21 +00:00
class-wp-http-cookie.php Code Modernization: Use str_starts_with() and str_ends_with() in a few more places. 2023-06-24 17:17:23 +00:00
class-wp-http-curl.php HTTP API: Declare a few default parameters in WP_Http_Curl and WP_Http_Streams. 2023-07-03 14:03:29 +00:00
class-wp-http-encoding.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
class-wp-http-ixr-client.php
class-wp-http-proxy.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-http-requests-hooks.php
class-wp-http-requests-response.php
class-wp-http-response.php
class-wp-http-streams.php HTTP API: Declare a few default parameters in WP_Http_Curl and WP_Http_Streams. 2023-07-03 14:03:29 +00:00
class-wp-http.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-image-editor-gd.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 20:17:29 +00:00
class-wp-image-editor-imagick.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-image-editor.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-list-util.php General: Revert strict comparison in WP_List_Util for now. 2023-07-05 11:15:22 +00:00
class-wp-locale-switcher.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-locale.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-matchesmapregex.php
class-wp-meta-query.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-metadata-lazyloader.php Networks and Sites: Lazy load site meta. 2023-05-11 11:15:24 +00:00
class-wp-navigation-fallback.php Editor: add navigation fallback. 2023-06-27 05:54:19 +00:00
class-wp-network-query.php
class-wp-network.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
class-wp-object-cache.php
class-wp-oembed-controller.php
class-wp-oembed.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-paused-extensions-storage.php
class-wp-post-type.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-post.php
class-wp-query.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-recovery-mode-cookie-service.php
class-wp-recovery-mode-email-service.php Code Modernization: Replace usage of strpos() with str_starts_with(). 2023-05-02 15:45:22 +00:00
class-wp-recovery-mode-key-service.php
class-wp-recovery-mode-link-service.php
class-wp-recovery-mode.php Code Modernization: Replace usage of strpos() with str_starts_with(). 2023-05-02 15:45:22 +00:00
class-wp-rewrite.php Code Modernization: Use str_contains() in a few more places. 2023-06-26 10:17:25 +00:00
class-wp-role.php
class-wp-roles.php
class-wp-scripts.php Script Loader: Fix unintended adding of async to scripts that are printed directly with wp_print_scripts() without enqueueing them beforehand. 2023-06-28 14:16:27 +00:00
class-wp-session-tokens.php
class-wp-simplepie-file.php Coding Standards: Use strict comparison in wp-includes/class-wp-simplepie-file.php. 2023-07-07 06:42:25 +00:00
class-wp-simplepie-sanitize-kses.php
class-wp-site-query.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
class-wp-site.php
class-wp-styles.php Code Modernization: Replace usage of strpos() with str_starts_with(). 2023-05-02 15:45:22 +00:00
class-wp-tax-query.php Coding Standards: Use strict comparison in wp-includes/class-wp-tax-query.php. 2023-07-08 10:48:24 +00:00
class-wp-taxonomy.php Docs: All sorts of improvements and corrections to function and hook docs. 2023-04-27 23:15:17 +00:00
class-wp-term-query.php Taxonomy: Always lazily load term meta. 2023-04-21 09:24:22 +00:00
class-wp-term.php
class-wp-text-diff-renderer-inline.php
class-wp-text-diff-renderer-table.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-textdomain-registry.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:25:23 +00:00
class-wp-theme-json-data.php
class-wp-theme-json-resolver.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:40:23 +00:00
class-wp-theme-json-schema.php Docs: Remove @return void from various DocBlocks. 2023-05-06 11:40:24 +00:00
class-wp-theme-json.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:40:23 +00:00
class-wp-theme.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
class-wp-user-meta-session-tokens.php
class-wp-user-query.php Coding Standards: Use strict comparison in wp-includes/class-wp-user-query.php. 2023-07-09 09:59:24 +00:00
class-wp-user-request.php
class-wp-user.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
class-wp-walker.php
class-wp-widget-factory.php
class-wp-widget.php
class-wp-xmlrpc-server.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
class-wp.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
class-wpdb.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
class.wp-dependencies.php Coding Standards: Rename WordPress Dependencies API class files. 2022-09-20 14:17:12 +00:00
class.wp-scripts.php
class.wp-styles.php
comment-template.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
comment.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
compat.php General: Increase the minimum supported version of PHP to 7.0.0. 2023-07-05 17:41:22 +00:00
cron.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
date.php
default-constants.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
default-filters.php Default Filters: Correct hook type for wp_print_scripts and customize_controls_print_styles. 2023-07-05 16:21:27 +00:00
default-widgets.php
deprecated.php Editor: adds deprecation for deleted block_core_navigation_submenu_build_css_colors function. 2023-07-03 06:57:23 +00:00
embed-template.php
embed.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
error-protection.php Code Modernization: Replace usage of strpos() with str_starts_with(). 2023-05-02 15:45:22 +00:00
feed-atom-comments.php
feed-atom.php
feed-rdf.php
feed-rss2-comments.php
feed-rss2.php
feed-rss.php
feed.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
formatting.php Options, Meta APIs: Check if the gmt_offset value is numeric in sanitize_option(). 2023-07-04 13:42:24 +00:00
functions.php General: Ignore invalid types for the '_wp_http_referer' URL query variable. 2023-06-29 23:27:23 +00:00
functions.wp-scripts.php Script Loader: Add support for HTML 5 "async" and "defer" attributes. 2023-06-26 13:42:23 +00:00
functions.wp-styles.php
general-template.php Code Modernization: Use str_contains() in a few more places. 2023-06-26 10:17:25 +00:00
global-styles-and-settings.php Editor: update duotone support. 2023-06-29 06:21:28 +00:00
http.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
https-detection.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
https-migration.php
kses.php Editor: add box shadow support to blocks. 2023-06-26 23:44:29 +00:00
l10n.php I18N: Ensure determine_locale() does not potentially return an empty string. 2023-06-23 16:03:25 +00:00
link-template.php Editor: fix post edit navigation link. 2023-06-27 06:02:22 +00:00
load.php Docs: Use third-person singular verbs in various function descriptions of load.php, as per docblocks standards. 2023-07-06 14:16:20 +00:00
locale.php
media-template.php Media: Redirect deprecated wp-admin/media.php file. 2023-06-19 23:20:21 +00:00
media.php Media: Avoid programmatically created images within post content from incorrectly receiving fetchpriority="high". 2023-07-07 18:08:24 +00:00
meta.php Networks and Sites: Load WP_Metadata_Lazyloader class file if class in meta.php. 2023-05-19 12:46:24 +00:00
ms-blogs.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
ms-default-constants.php
ms-default-filters.php
ms-deprecated.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
ms-files.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
ms-functions.php Code Modernization: Use str_starts_with() and str_ends_with() in a few more places. 2023-06-24 16:50:24 +00:00
ms-load.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
ms-network.php Cache API: Add helper function wp_cache_set_last_changed. 2023-05-02 11:26:24 +00:00
ms-settings.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
ms-site.php Networks and Sites: Lazy load site meta. 2023-05-11 11:15:24 +00:00
nav-menu-template.php
nav-menu.php Docs: Add missing param description to update_menu_item_cache in wp_get_nav_menu_items(). 2023-06-21 08:18:19 +00:00
navigation-fallback.php Editor: add navigation fallback. 2023-06-27 05:54:19 +00:00
option.php Options, Meta APIs: Prime network options in a single cache call using wp_cache_get_multiple. 2023-06-27 10:41:30 +00:00
pluggable-deprecated.php
pluggable.php Media: Automatically add fetchpriority="high" to hero image to improve load time performance. 2023-06-26 16:17:23 +00:00
plugin.php Docs: Mark apply_filters() third parameter $args as optional. 2023-06-08 07:54:22 +00:00
post-formats.php Docs: Document default values for optional parameters in various DocBlocks. 2023-02-21 16:39:19 +00:00
post-template.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
post-thumbnail-template.php Media: Introduce wp_get_attachment_image_context filter. 2023-05-17 18:31:24 +00:00
post.php Editor: rename sync_status and move it to top level. 2023-07-07 07:29:23 +00:00
query.php
registration-functions.php
registration.php
rest-api.php REST API: add revisions endpoint for global styles. 2023-06-28 03:35:25 +00:00
revision.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
rewrite.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
robots-template.php
rss-functions.php
rss.php Docs: Fix a typo in wp-includes/rss.php inline comments. 2023-04-10 19:31:18 +00:00
script-loader.php Editor: Fix font paths in iframed editor. 2023-07-05 12:34:21 +00:00
session.php
shortcodes.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
sitemaps.php
spl-autoload-compat.php
style-engine.php Docs: Correct default value for the $optimize option in Style Engine. 2023-05-17 12:06:19 +00:00
taxonomy.php Taxonomy: Prevent deprecation notices clearing terms. 2023-06-14 23:51:22 +00:00
template-canvas.php
template-loader.php
template.php Code Modernization: Replace usage of strpos() with str_contains(). 2023-06-22 14:36:26 +00:00
theme-i18n.json
theme-templates.php
theme.json Editor: stabilise layout and refactor definitions. 2023-06-27 07:25:22 +00:00
theme.php Media: Ensure custom header image tag supports loading optimization attributes. 2023-07-05 19:30:25 +00:00
update.php Upgrade/Install: Pass the full database version string to WordPress.org for parsing. 2023-06-27 05:11:27 +00:00
user.php Coding Standards: Add missing newline at the end of wp-admin/user.php. 2023-07-06 12:54:22 +00:00
vars.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
version.php Docs: Replace multiple single line comments with multi-line comments. 2023-07-09 21:48:22 +00:00
widgets.php Code Modernization: Replace usage of substr() with str_starts_with() and str_ends_with(). 2023-06-22 14:57:24 +00:00
wp-db.php
wp-diff.php