Add a missing file header and clean up class DocBlocks in wp-includes…

…/class-wp-customize-section.php.

* Adds a file header separate from the `WP_Customize_Section` class block
* Fixes formatting for the `WP_Customize_Section`, `WP_Customize_Themes_Section`, and `WP_Customize_Sidebar_Section` class DocBlocks.

See #31446.

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


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

wp-includes/class-wp-customize-section.php

@@ -1,13 +1,21 @@
 <?php
 /**
- * Customize Section Class.
- *
- * A UI container for controls, managed by the WP_Customize_Manager.
+ * WordPress Customize Section classes
  *
  * @package WordPress
  * @subpackage Customize
  * @since 3.4.0
  */
+
+/**
+ * Customize Section class.
+ *
+ * A UI container for controls, managed by the WP_Customize_Manager class.
+ *
+ * @since 3.4.0
+ *
+ * @see WP_Customize_Manager
+ */
 class WP_Customize_Section {
 
 	/**
@@ -312,13 +320,13 @@ protected function render() {
 }
 
 /**
- * Customize Themes Section Class.
+ * Customize Themes Section class.
  *
  * A UI container for theme controls, which behaves like a backwards Panel.
  *
- * @package WordPress
- * @subpackage Customize
  * @since 4.2.0
+ *
+ * @see WP_Customize_Section
  */
 class WP_Customize_Themes_Section extends WP_Customize_Section {
 
@@ -365,9 +373,6 @@ protected function render() {
 /**
  * Customizer section representing widget area (sidebar).
  *
- * @package WordPress
- * @subpackage Customize
- *
  * @since 4.1.0
  *
  * @see WP_Customize_Section

wp-includes/version.php

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