[wp-trac] [WordPress Trac] #25514: Hook Docs: wp-includes/query.php

[WordPress Trac]

#25514: Hook Docs: wp-includes/query.php
--------------------------+------------------------------
 Reporter:  dougwollison  |       Owner:  DrewAPicture
     Type:  enhancement   |      Status:  reviewing
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Inline Docs   |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  needs-patch   |
--------------------------+------------------------------

Comment (by DrewAPicture):

 [attachment:WP_Query-hook-docs.3.diff] is looking much better. More
 changes:
 * Any function references in descriptions need parenthesis, e.g.
 s/parse_query/parse_query()

 `posts_clauses` filter:
 * Specify which clauses this covers

 `posts_where_request`, `posts_groupby_request`, `posts_join_request`,
 `posts_orderby_request`, `posts_distinct_request`, `posts_fields_request`,
 `post_limits_request`, `posts_clauses_request` filters:
 * Specify that these filters are for use by caching plugins in each hook's
 description

 `posts_clauses_request` filter:
 * Specify which clauses this covers

 `split_the_query` filter:
 * Specify the default (true or false) at the end of the parameter
 description.

--
Ticket URL: <http://core.trac.wordpress.org/ticket/25514#comment:8>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software