Docs: Improve inline documentation in property and method DocBlocks for Walker_CategoryDropdown.

Props ramiy for the initial patch.
See #36300.


git-svn-id: https://develop.svn.wordpress.org/trunk@37045 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/class-walker-category-dropdown.php

@@ -15,32 +15,43 @@
  * @see Walker
  */
 class Walker_CategoryDropdown extends Walker {
+
 	/**
-	 * @see Walker::$tree_type
+	 * What the class handles.
+	 *
 	 * @since 2.1.0
+	 * @access private
 	 * @var string
+	 *
+	 * @see Walker::$tree_type
 	 */
 	public $tree_type = 'category';
 
 	/**
-	 * @see Walker::$db_fields
+	 * Database fields to use.
+	 *
 	 * @since 2.1.0
+	 * @access public
 	 * @todo Decouple this
 	 * @var array
+	 *
+	 * @see Walker::$db_fields
 	 */
 	public $db_fields = array ('parent' => 'parent', 'id' => 'term_id');
 
 	/**
-	 * Start the element output.
+	 * Starts the element output.
+	 *
+	 * @since 2.1.0
+	 * @access public
 	 *
 	 * @see Walker::start_el()
-	 * @since 2.1.0
 	 *
 	 * @param string $output   Passed by reference. Used to append additional content.
 	 * @param object $category Category data object.
 	 * @param int    $depth    Depth of category. Used for padding.
 	 * @param array  $args     Uses 'selected', 'show_count', and 'value_field' keys, if they exist.
-	 *                         See {@see wp_dropdown_categories()}.
+	 *                         See wp_dropdown_categories().
 	 * @param int    $id       Optional. ID of the current category. Default 0 (unused).
 	 */
 	public function start_el( &$output, $category, $depth = 0, $args = array(), $id = 0 ) {