api-doc-tools

api-doc-tools copied to clipboard

This is an example of a method with a vararg param: https://docs.microsoft.com/en-us/dotnet/api/system.console.write?view=netframework-4.8#System_Console_Write_System_String_System_Object_System_Object_System_Object_System_Object_ I don't know how many we had of these.

On MSDN, a ... param was added to the bottom of the list

And had special syntax for those:

You can see they look different on ildasm:

/cc @joelmartinez @dend

interesting ... ok, so digging into this a bit, it looks like we'll need to take the CallingConvention into consideration, something which mdoc doesn't currently do, as you can see below, the calling convention for this particular method in question is VarArg:

@dend, is the calling convention something that we should start tracking as a separate property on the model?

Aside from (possibly) adding the property/value to the model ... the formatters will need to take this into account when formatting parameter lists.