Index: wp-includes/taxonomy.php
===================================================================
--- wp-includes/taxonomy.php	(revision 51846)
+++ wp-includes/taxonomy.php	(working copy)
@@ -2919,8 +2919,7 @@
  * Will make slug unique, if it isn't already.
  *
  * The `$slug` has to be unique global to every taxonomy, meaning that one
- * taxonomy term can't have a matching slug with another taxonomy term. Each
- * slug has to be globally unique for every taxonomy.
+ * taxonomy term can't have a matching slug with another taxonomy term.
  *
  * The way this works is that if the taxonomy that the term belongs to is
  * hierarchical and has a parent, it will append that parent to the $slug.
@@ -3022,18 +3021,18 @@
  * Update term based on arguments provided.
  *
  * The `$args` will indiscriminately override all values with the same field name.
- * Care must be taken to not override important information need to update or
- * update will fail (or perhaps create a new term, neither would be acceptable).
+ * Care must be taken to not override important information need to update 
+ * or update will fail (or perhaps create a new term, neither would be acceptable).
  *
- * Defaults will set 'alias_of', 'description', 'parent', and 'slug' if not
+ * Defaults will set for the parameters like 'alias_of', 'description', 'parent', and 'slug' if not
  * defined in `$args` already.
  *
  * 'alias_of' will create a term group, if it doesn't already exist, and
  * update it for the `$term`.
  *
- * If the 'slug' argument in `$args` is missing, then the 'name' will be used.
+ * If the 'slug' argument in `$args` is missing, then the 'name' will be used in place of 'slug'.
  * If you set 'slug' and it isn't unique, then a WP_Error is returned.
- * If you don't pass any slug, then a unique one will be created.
+ * If you don't pass any slug, then a unique slug will be created.
  *
  * @since 2.3.0
  *
@@ -3046,7 +3045,7 @@
  *
  *     @type string $alias_of    Slug of the term to make this term an alias of.
  *                               Default empty string. Accepts a term slug.
- *     @type string $description The term description. Default empty string.
+ *     @type string $description The description of term . Default empty string.
  *     @type int    $parent      The id of the parent term. Default 0.
  *     @type string $slug        The term slug to use. Default empty string.
  * }
