[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 DrewAPicture):

 Replying to [comment:5 SergeyBiryukov]:
 > 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]?

 I think at a certain point, this becomes an exercise in futility :) I'm
 thinking we should just leave the hyphen in, rather than modify it here
 and make a note about why it was modified over there, etc. Seems like
 overkill.

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