[wp-trac] [WordPress Trac] #14034: is_single() or its documentation needs update

[WordPress Trac]

#14034: is_single() or its documentation needs update
--------------------------+-------------------------------------------------
 Reporter:  sirzooro      |       Owner:             
     Type:  defect (bug)  |      Status:  new        
 Priority:  normal        |   Milestone:  Unassigned 
Component:  General       |     Version:  3.0        
 Severity:  normal        |    Keywords:  needs-patch
--------------------------+-------------------------------------------------
 I have compared how `is_single()` works with its documentation, and I am a
 bit confused:[[BR]]
 - implementation: `is_single()` returns `true` for Posts, Attachments and
 Custom Post Types; for Pages it returns `false`;[[BR]]
 - documentation on
 [http://codex.wordpress.org/Conditional_Tags#A_Single_Post_Page codex]:
 "When any single Post page is being displayed." (my understanding: it
 should return `true` for Posts only);[[BR]]
 - inline documentation in code: "Whether the current page query is single
 page. [...] This applies to other post types, attachments, pages, posts.
 Just means that the current query has only a single object.".

 Need to determine how this function should really works, and update it,
 its inline doc and/or codex accordingly.

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/14034>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software