[wp-trac] [WordPress Trac] #27083: PHPDoc updates for wp-includes/comment-template.php

[WordPress Trac]

#27083: PHPDoc updates for wp-includes/comment-template.php
--------------------------+---------------------------
 Reporter:  DrewAPicture  |       Owner:  DrewAPicture
     Type:  defect (bug)  |      Status:  reopened
 Priority:  normal        |   Milestone:  3.9
Component:  Comments      |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  has-patch     |     Focuses:  docs
--------------------------+---------------------------

Comment (by SergeyBiryukov):

 Replying to [comment:4 DrewAPicture]:
 > All arguments in a hash notation need to be expressed as variables per
 the standard.

 I see, thanks for clarifying that.

 > However, I don't think we necessarily need to keep the hyphen for the
 purposes of the docs -- I don't have a problem with changing it to an
 underscore there.

 I think that might cause a confusion with someone trying to pass
 `'end_callback'` instead of `'end-callback'` and wondering why it doesn't
 work. Could we perhaps add some kind of a comment there, like
 [attachment:27083.2.diff]?

--
Ticket URL: <https://core.trac.wordpress.org/ticket/27083#comment:5>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform