MSON aligned parameter parser trips up when inline description contains round brackets

[kylef]

When an inline description of an MSON aligned parameter is used that contains round brackets () the parser seems to trip up and says the whole block is unrecognised.

Problematic syntax

+ Parameters
    + query (string) - This is a (short) inline description

Working alternatives

+ Parameters
    + query - This is a (short) inline description

+ Parameters
    + query (string)
        This is a (short) inline description

[pksunkara]

Can you try the following and see what happens?

+ Parameters
    + query: sample (string) - This is a (short) inline description

[kylef]

That also works @pksunkara.

[pksunkara]

@kylef The problem is that the default is old parameter style. Since the following parameter is also valid old style paramter, it will default to old style parameter and try to parse it which is giving the error.

+ query (string) - This is a (short) inline description

[kylef]

Since the following parameter is also valid old style parameter

But this isn't valid with the old syntax because it throws an error?

[pksunkara]

Yes. So, we need to add the option of trying to parse with the other style if the recognised style throws error.

[pksunkara]

Actually, the issue here is in trying to recognise the parameter syntax style. Instead of trying to match brackets, this line directly goes to the last closing bracket. And when the next non-empty character is not a description delimiter, the parameter doesn't get recognised as a whole.