phpdoc references to filters/actions

[bananastalktome]

I noticed that many of the apply_filters and do_action calls used in functions throughout the codebase are not reflected in the functions doc description. I was not sure if it was a worthwhile task of going through and adding these, or whether this was not really desirable.

If so, is there any preferred syntax by which these should be documented?

Is, for example, this snippet for do_action hooks taken from do_feed() (@uses do_action() Calls 'do_feed_$feed' hook, if a hook exists for the feed.) and, for apply_filters, this snippet from wp_ext2type() (@uses apply_filters() Calls 'ext2type' hook on default supported types.) acceptable template examples?

[ocean90]

Related: #16809

(Or a duplicate of the filter part.)

[bananastalktome]

Should I hold off on any potential patch attempts on this until after 3.4?

[nacin]

Yes. I would hold off on any patches. duck_ and I have been discussing a new WordPress docblock standard for actions and filters, which we hope to start come 3.5.

[bananastalktome]

Sounds good nacin, excited to hear news of a new standard being discussed (and eager to see it :) )