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

@@ -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
 		 *

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
 		 *

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.

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.