4 Commits

Author	SHA1	Message	Date
Drew Jaynes	4c5276edcf	Docs: Improve the file header for class-wp-widget.php to describe what the file contains. ... Also rewrites the class DocBlock summary for `WP_Widget` to better describe the '''purpose''' of the class. See #33413. See #33701. git-svn-id: https://develop.svn.wordpress.org/trunk@33869 602fd350-edb4-49c9-b593-d223f7449a82	2015-09-03 02:49:39 +00:00
Drew Jaynes	8aefa21974	Docs: Bring the file header and class DocBlock summaries for class-wp-widget.php in-line with the intention of the docs standard: ... * File headers: _What_ the file is * Class DocBlocks: What purpose the class serves. Mentioning the class name in the class DocBlock is redundant See #33413 git-svn-id: https://develop.svn.wordpress.org/trunk@33816 602fd350-edb4-49c9-b593-d223f7449a82	2015-08-30 23:13:45 +00:00
Drew Jaynes	76f5134023	Docs: Add a file header to wp-includes/class-wp-widget.php, created when the WP_Widget class was moved to its own file in [33746]. ... It's important for every file in WordPress, regardless of makeup or architecture, to have its own file header, even if the file contains nothing but a class. When parsed, files and classes are mutually exclusive and should be documented with this in mind. See [33746]. See #33413. git-svn-id: https://develop.svn.wordpress.org/trunk@33755 602fd350-edb4-49c9-b593-d223f7449a82	2015-08-26 07:44:59 +00:00
Scott Taylor	6c71ee8d84	Widgets: move classes into their own files, widgets.php loads the new files, so this is 100% BC if someone is loading widgets.php directly. New files created using svn cp. ... Creates: `class-wp-widget.php` `class-wp-widget-factory.php` `widget-functions.php` `widgets.php` contains only top-level code. Class files only contain classes. Functions file only contains functions. See #33413. git-svn-id: https://develop.svn.wordpress.org/trunk@33746 602fd350-edb4-49c9-b593-d223f7449a82	2015-08-26 02:39:50 +00:00