Docs: Various docblock corrections.

See #32246

Built from https://develop.svn.wordpress.org/trunk@36250


git-svn-id: http://core.svn.wordpress.org/trunk@36217 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/class-feed.php

@@ -9,6 +9,11 @@ class WP_Feed_Cache extends SimplePie_Cache {
 	 *
 	 * @static
 	 * @access public
+	 *
+	 * @param string $location  URL location (scheme is used to determine handler).
+	 * @param string $filename  Unique identifier for cache object.
+	 * @param string $extension 'spi' or 'spc'.
+	 * @return WP_Feed_Cache_Transient Feed cache handler object that uses transients.
 	 */
 	public function create($location, $filename, $extension) {
 		return new WP_Feed_Cache_Transient($location, $filename, $extension);
@@ -20,6 +25,13 @@ class WP_Feed_Cache_Transient {
 	public $mod_name;
 	public $lifetime = 43200; //Default lifetime in cache of 12 hours
 
+	/**
+	 * Class instantiator.
+	 * 
+	 * @param string $location  URL location (scheme is used to determine handler).
+	 * @param string $filename  Unique identifier for cache object.
+	 * @param string $extension 'spi' or 'spc'.
+	 */
 	public function __construct($location, $filename, $extension) {
 		$this->name = 'feed_' . $filename;
 		$this->mod_name = 'feed_mod_' . $filename;

wp-includes/class-wp-comment.php

@@ -350,6 +350,8 @@ final class WP_Comment {
 	 * unneeded database queries.
 	 *
 	 * @since 4.4.0
+	 *
+	 * @param bool $set Whether the comment's children have already been populated.
 	 */
 	public function populated_children( $set ) {
 		$this->populated_children = (bool) $set;

wp-includes/class-wp-image-editor.php

@@ -21,6 +21,8 @@ abstract class WP_Image_Editor {
 
 	/**
 	 * Each instance handles a single file.
+	 *
+	 * @param string $file Path to the file to load.
 	 */
 	public function __construct( $file ) {
 		$this->file = $file;

wp-includes/class-wp-term.php

@@ -237,7 +237,8 @@ final class WP_Term {
 	 * @since 4.4.0
 	 * @access public
 	 *
-	 * @return mixed
+	 * @param string $key Property to get.
+	 * @return mixed Property value.
 	 */
 	public function __get( $key ) {
 		switch ( $key ) {

wp-includes/class-wp-theme.php

@@ -350,7 +350,8 @@ final class WP_Theme implements ArrayAccess {
 	/**
 	 * __get() magic method for properties formerly returned by current_theme_info()
 	 *
-	 * @return mixed
+	 * @param string $offset Property to get.
+	 * @return mixed Property value.
 	 */
 	public function __get( $offset ) {
 		switch ( $offset ) {

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.5-alpha-36249';
+$wp_version = '4.5-alpha-36250';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.