Clarify accepted values for style argument in wp_list_comments()

[jeremyfelt]

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.

[functionalrhyme]

The documentation can be found here:
​https://developer.wordpress.org/reference/functions/wp_list_comments/#comments

The code is here:
wp-includes/class-walker-comment.php#L58

[liuhaibin]

I've attached the patch. My very first one. Please take a look. Thanks.

[liuhaibin]

I should have named the patched as 49181.diff. But to avoid duplication, I did not upload the same patch again with another name.

[liuhaibin]

Hi, is there anything that I can do to move the ticket forward?

[SergeyBiryukov]

In 48597:

Docs: Improve documentation for wp_list_comments().

Note that passing div to the style parameter will result in no additional list markup.

Props liuhaibin, jeremyfelt, functionalrhyme.
Fixes #49181.