[wp-trac] [WordPress Trac] #25393: Hook Docs: wp-login.php

[WordPress Trac]

#25393: Hook Docs: wp-login.php
-------------------------+---------------------------
 Reporter:  ShinichiN    |       Owner:  DrewAPicture
     Type:  enhancement  |      Status:  closed
 Priority:  normal       |   Milestone:  3.7
Component:  Inline Docs  |     Version:
 Severity:  normal       |  Resolution:  fixed
 Keywords:  has-patch    |
-------------------------+---------------------------

Comment (by tivnet):

 Replying to [comment:12 DrewAPicture]:

 The docblock applies @param int to the $user_data for the code following
 it.

 In general, this use of docblocks is illegal, according to

 http://www.phpdoc.org/docs/latest/for-users/phpdoc/basic-syntax.html
 #which-elements-can-have-a-docblock

 So, why not to keep is as just comments, without docblock @-isms? Using @s
 will only disturb phpdocumentor, IMO.

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