Description List not handled in docs

[asfalcone]

Describe the bug
Description List (<dl>, <dt>, <dd>) isn't parsed properly.

In java, the description items are removed. In Kotlin they appear as body text instead of structured DocTag elements

Expected behaviour
Dl, Dt, DD appear as structured DocTag elements

Screenshots
From Kotlin source:

From Java source:

To Reproduce

/** 
 * <dl>
 *     <dt>
 *         <code>name="<i>name</i>"</code>
 *     </dt>
 *     <dd>
 *         A URI path segment. To enforce security, this value hides the name of the subdirectory
 *         you're sharing. The subdirectory name for this value is contained in the
 *         <code>path</code> attribute.
 *     </dd>
 *     <dt>
 *         <code>path="<i>path</i>"</code>
 *     </dt>
 *     <dd>
 *         The subdirectory you're sharing. While the <code>name</code> attribute is a URI path
 *         segment, the <code>path</code> value is an actual subdirectory name. Notice that the
 *         value refers to a <b>subdirectory</b>, not an individual file or files. You can't
 *         share a single file by its file name, nor can you specify a subset of files using
 *         wildcards.
 *     </dd>
 * </dl>
 */
 * class Foo

Installation

• Dokka version: 1.6.0-dev-122

[IgnatBeresnev]

@asfalcone Hi! I can't tell from the Foo class whether it's a kotlin or a java class :) What's the use case? Would you like to be able to make description lists in JavaDocs only or in KDocs as well?

It's definitely a bug in the javadoc parser (working on a fix), but it's unclear to me at the moment whether we should support parsing html tags in KDoc at all. Is it possible to make some sort of a description list using markdown?

[IgnatBeresnev]

Will be included in the upcoming 1.6.10. The dev version is out.