[wp-trac] [WordPress Trac] #49181: Clarify accepted values for style argument in wp_list_comments()

[WordPress Trac]

#49181: Clarify accepted values for style argument in wp_list_comments()
--------------------------+----------------------------------------
 Reporter:  jeremyfelt    |      Owner:  (none)
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Comments      |    Version:
 Severity:  normal        |   Keywords:  needs-patch good-first-bug
  Focuses:  docs          |
--------------------------+----------------------------------------
 `wp_list_comments()` accepts `style` as part of the arguments it passes to
 the comment walker to determine how a list of comments should be
 displayed.

 * If `div` is passed, no markup is output in the walker's `start_lvl()`
 method.
 * If `ol` is passed, `ol` markup is output.
 * If `ul` or any other value is passed, `ul` markup is output.

 The functions docs imply right now that only `ol` and `ul` are valid. It
 should clarify that `div` will result in no additional list markup.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/49181>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform