Index: src/wp-includes/comment-template.php
===================================================================
--- src/wp-includes/comment-template.php	(revision 51876)
+++ src/wp-includes/comment-template.php	(working copy)
@@ -2028,7 +2028,7 @@
  * Displays a list of comments.
  *
  * Used in the comments.php template to list comments for a particular post.
- *
+ * 
  * @since 2.7.0
  *
  * @see WP_Query->comments
@@ -2065,6 +2065,8 @@
  * @param WP_Comment[] $comments Optional. Array of WP_Comment objects.
  * @return void|string Void if 'echo' argument is true, or no comments to list.
  *                     Otherwise, HTML list of comments.
+ * 
+ * Note: While using the custom call back funciton the $args and $depth parameters will interchange.
  */
 function wp_list_comments( $args = array(), $comments = null ) {
 	global $wp_query, $comment_alt, $comment_depth, $comment_thread_alt, $overridden_cpage, $in_comment_loop;