I'm simply baffled as to why this is, and can't figure out where the path is wrong.
There are quite a few 'hidden' functions that are simply not listed in the function_reference. Although it's usually not an issue to have bad documentation, for a function reference index it really kills the application.
Here's a quick example:
- You are trying to obtain the list of all comments for a specific post
- Looking at: http://codex.wordpress.org/Function_Reference you don't see anything about the list of comments.
- Naturally you go about getting the comments through something like get_comments and go through the pain of formatting your comments
Little did you know this function list is INCOMPLETE!
If you look through some other themes (hmm TwentyTen) you'll notice the use the following function:
Which returns exactly what you needed. How can this be? How could I have wasted time? It's not in the above function reference - Must be a one-off functions.php. Nope.. then you search the codex and you find the following:
- wp_list_comments: http://codex.wordpress.org/Function_Reference/wp_list_comments
Wait, so the function is a built-in wordpress function, correctly in the right path according to the URL.
Going back and forth through the pages there is absolutely ZERO reference to that function.
So my question is - What the hell?? How can you simply decide not to index certain functions on the index, yet have full documentation of it hidden away.
Thank you for the (partially) useless codex documentation.