Inline Docs audit for 4.1

[DrewAPicture]

[30595] fixed the DocBlock and added some inline comments to wp_ajax_destroy_sessions().

[DrewAPicture]

In 30599:

4.1 Docs Audit: Clarify the DocBlock summary for the edit_form_before_permalink hook.

See #30469.

[DrewAPicture]

In 30600:

4.1 Docs Audit: Convert a hook reference to an inline @see tag in the hook docs for the image_add_caption_text filter.

See #30469.

[DrewAPicture]

In 30601:

4.1 Docs Audit: Fix a variety of issues with the DocBlock for the default_page_template_title filter.

Includes hyphenating 'drop-down', ensuring the DocBlock itself is correctly indented, and wraps lines at an appropriate length.

See #30469.

[DrewAPicture]

In 30602:

4.1 Docs Audit: Document the $post global in the DocBlock for wp_print_revision_templates().

See #30469.

[DrewAPicture]

In 30603:

4.1 Docs Audit: Clarify the DocBlock summary for network_settings_add_js() to specify that it's specific to the Network Settings screen.

See #30469.

[DrewAPicture]

In 30604:

4.1 Docs Audit: Fix some line-wrapping in the DocBlock for WP_Http::parse_url().

See #30469.

[DrewAPicture]

In 30605:

4.1 Docs Audit: Improve inline documentation for various properties and methods in the WP_Customize_Control and WP_Customize_Upload_Control classes.

See #30469.

[DrewAPicture]

In 30606:

4.1 Docs Audit: Improve inline documentation for various properties and methods in the WP_Customize_Manager class.

See #30469.

[DrewAPicture]

In 30607:

4.1 Docs Audit: Improve inline documentation for various properties and methods in the WP_Customize_Panel class.

See #30469.

[DrewAPicture]

In 30608:

4.1 Docs Audit: Improve inline documentation for various properties and methods in the WP_Customize_Section, WP_Customize_Section, and WP_Customize_Sidebar_Section classes.

See #30469.

[DrewAPicture]

In 30609:

4.1 Docs Audit: Fix DocBlock formatting for the customize_preview_{$this->type} hook.

See #30469.

[DrewAPicture]

In 30610:

4.1 Docs Audit: Various formatting fixes for inline documentation in class-wp-list-table.php and comment-template.php.

See #30469.

[DrewAPicture]

In 30611:

4.1 Docs Audit: Improve inline documentation in various WP_Date_Query methods modified in 4.1.

See #30469.

[DrewAPicture]

In 30612:

Ensure only spaces are used instead of a mixture of tabs and spaces for alignment within the DocBlock for the date_query_valid_columns hook. See [30611].

See #30469.

[DrewAPicture]

In 30613:

4.1 Docs Audit: Ensure optional arguments in wp_json_encode() are properly documented as such.

See #30469.

[DrewAPicture]

In 30614:

Improve line-wrapping and formatting in the DocBlock for wp_send_json_error().

See #30469.

[DrewAPicture]

In 30615:

Ensure the private function _wp_render_title_tag() is marked for internal usage only.

See #30469.

[DrewAPicture]

In 30616:

4.1 Docs Audit: Ensure optional arguments in get_the_post_navigation(), the_post_navigation(), get_the_posts_navigation(), the_posts_navigation(), get_the_pagination(), and the_pagination() are properly documented with defaults.

See #30469.

[DrewAPicture]

In 30617:

4.1 Docs Audit: Improve inline documentation for various WP_Meta_Query methods introduced or modified in 4.1.

See #30469.

[DrewAPicture]

In 30618:

4.1 Docs Audit: Spell out HTML element names in DocBlock summaries for the nav_menu_css_class, nav_menu_item_id, and nav_menu_link_attributes filters.

Due to a recent clarification in the core inline documentation standards, HTML tags are no longer allowed in DocBlock summaries as they wreak havoc on displaying pages in the official Code Reference. See #30473.

See #30469.

[DrewAPicture]

In 30619:

4.1 Docs Audit: Formatting, line-wrap, and other fixes for the wp_get_nav_menus() DocBlock.

See #30469.

[DrewAPicture]

In 30620:

4.1 Docs Audit: Improve inline documentation for the new WP_Query::setup_postdata() method.

See #30469.

[DrewAPicture]

In 30621:

4.1 Docs Audit: Remove a duplicate word from a parameter description in the DocBlock for the wp_save_post_revision_post_has_changed hook.

See #30469.

[DrewAPicture]

In 30622:

4.1 Docs Audit: Improve inline documentation in DocBlocks for various WP_Tax_Query methods, the pre_delete_term hook, and get_ancestors().

See #30469.

[DrewAPicture]

In 30623:

4.1 Docs Audit: Fix formatting for changelog entries in count_user_posts() and the get_usernumposts hook.

See #30469.

[ericlewis]

attachment:30469.diff​ includes @since tags, function summaries and @param tags.

[DrewAPicture]

@wonderboymusic: Could you please review and commit Eric's patch​ for 4.1 JS docs?

[wonderboymusic]

In 30738:

Add some inline JS docs for Customizer.

See #30469.