Nested properties

[totty90]

here you have:

/**
 * @property user A user record
 * @property user.name The name of the user.
 * @property user.email The email of the user.
 */
user: {},

But sometimes I need to use it like this:

/**
 * @property user A user record
 */
user: {
    /**
     * @property user.name The name of the user.
     */
    username: {type: String},
    /**
     * @property user.email The name of the user.
     */
    email: {type: String},
},

Is it possible to join multiple comments? The output currently is a mess, only shows the first one.

Gives me the "Duplicate property name user"

[nene]

This is something that's been requested several times in various forms of the possible syntax.

So I'm leaving this open as a feature request. But I can not make any promises as to if and when it will get done.