[wp-trac] [WordPress Trac] #14783: Incorrect/missing PHPDoc

[WordPress Trac]

#14783: Incorrect/missing PHPDoc
-------------------------+--------------------------------------------------
 Reporter:  duck_        |       Owner:     
     Type:  enhancement  |      Status:  new
 Priority:  normal       |   Milestone:  3.1
Component:  Inline Docs  |     Version:     
 Severity:  normal       |    Keywords:     
-------------------------+--------------------------------------------------

Comment(by jacobsantos):

 Replying to [comment:5 nacin]:
 > (In [15564]) phpdoc, @since, whitespace. Also require an argument in
 wp_insert_post(). props duck_, see #14783.

 If that is the case, then the bug is somewhere else in the code and you
 are just covering up the cause.

 While it is true that probably no where in the code will this function be
 called without passing at least something in the $postarr variable, it is
 made at the very least to stand as a feature for someone who wants to
 create a post and then fill it at some later time. There are a few cases
 where you'll want to fill in some data and then go back and fill in the
 rest once you know more.

 Furthermore, this change should be in its own ticket to further track its
 progress and any other information that might be needed.

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