From b1b59d27a081ee42679060a2f28aa17eab1eb5f8 Mon Sep 17 00:00:00 2001
From: Peter Wilson <peterwilsoncc@git.wordpress.org>
Date: Wed, 13 Apr 2022 03:02:43 +0000
Subject: [PATCH] Docs: Improve doc blocks for hooks added in [53126].

Fix a variable name and provide examples of the hook names.

Follow up to [53126].

Props dlh, pbiron.
Fixes #53212.


git-svn-id: https://develop.svn.wordpress.org/trunk@53170 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/class-wp-post-type.php | 7 ++++++-
 src/wp-includes/class-wp-taxonomy.php  | 7 ++++++-
 src/wp-includes/post.php               | 5 +++++
 src/wp-includes/taxonomy.php           | 5 +++++
 4 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/class-wp-post-type.php b/src/wp-includes/class-wp-post-type.php
index 777ef58dce..3c3ec0e3ab 100644
--- a/src/wp-includes/class-wp-post-type.php
+++ b/src/wp-includes/class-wp-post-type.php
@@ -445,7 +445,12 @@ final class WP_Post_Type {
 		/**
 		 * Filters the arguments for registering a specific post type.
 		 *
-		 * The dynamic portion of the filter name, `$this->name`, refers to the post type key.
+		 * The dynamic portion of the filter name, `$post_type`, refers to the post type key.
+		 *
+		 * Possible hook names include:
+		 *
+		 *  - `register_post_post_type_args`
+		 *  - `register_page_post_type_args`
 		 *
 		 * @since 6.0.0
 		 *
diff --git a/src/wp-includes/class-wp-taxonomy.php b/src/wp-includes/class-wp-taxonomy.php
index 72f039adcd..0fac7a0501 100644
--- a/src/wp-includes/class-wp-taxonomy.php
+++ b/src/wp-includes/class-wp-taxonomy.php
@@ -320,7 +320,12 @@ final class WP_Taxonomy {
 		/**
 		 * Filters the arguments for registering a specific taxonomy.
 		 *
-		 * The dynamic portion of the filter name, `$this->name`, refers to the taxonomy key.
+		 * The dynamic portion of the filter name, `$taxonomy`, refers to the taxonomy key.
+		 *
+		 * Possible hook names include:
+		 *
+		 *  - `register_category_taxonomy_args`
+		 *  - `register_post_tag_taxonomy_args`
 		 *
 		 * @since 6.0.0
 		 *
diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php
index 0793de3760..a03897e736 100644
--- a/src/wp-includes/post.php
+++ b/src/wp-includes/post.php
@@ -1714,6 +1714,11 @@ function register_post_type( $post_type, $args = array() ) {
 	 *
 	 * The dynamic portion of the filter name, `$post_type`, refers to the post type key.
 	 *
+	 * Possible hook names include:
+	 *
+	 *  - `registered_post_type_post`
+	 *  - `registered_post_type_page`
+	 *
 	 * @since 6.0.0
 	 *
 	 * @param string       $post_type        Post type.
diff --git a/src/wp-includes/taxonomy.php b/src/wp-includes/taxonomy.php
index fa6c2c641a..40faa8b984 100644
--- a/src/wp-includes/taxonomy.php
+++ b/src/wp-includes/taxonomy.php
@@ -534,6 +534,11 @@ function register_taxonomy( $taxonomy, $object_type, $args = array() ) {
 	 *
 	 * The dynamic portion of the filter name, `$taxonomy`, refers to the taxonomy key.
 	 *
+	 * Possible hook names include:
+	 *
+	 *  - `registered_taxonomy_category`
+	 *  - `registered_taxonomy_post_tag`
+	 *
 	 * @since 6.0.0
 	 *
 	 * @param string       $taxonomy    Taxonomy slug.