You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Currently, Bikeshed autoformats the dfn text of IDL methods to include the argument names, and relies on the "spelling variation" feature to handle autolinking to them without args (so you can just write {{Element/appendChild()}}, for example). This is because overloads are separate entities in WebIDL that need to be independently linkable, so I use the arglist to differentiate them.
In w3c/reffy#336, @dontcallmedom points out that WebIDL now requires overloads to show up in the same, non-partial, interface definition; they can't be spread out over blocks or specs. This is great, as it means I can now detect at build-time whether an overload is present or not, and thus I can output the arg-full dfn text only when there's an overload; in all other cases I can just make the text the argless version and make everything dramatically simpler.
The text was updated successfully, but these errors were encountered:
Currently, Bikeshed autoformats the dfn text of IDL methods to include the argument names, and relies on the "spelling variation" feature to handle autolinking to them without args (so you can just write
{{Element/appendChild()}}
, for example). This is because overloads are separate entities in WebIDL that need to be independently linkable, so I use the arglist to differentiate them.In w3c/reffy#336, @dontcallmedom points out that WebIDL now requires overloads to show up in the same, non-partial, interface definition; they can't be spread out over blocks or specs. This is great, as it means I can now detect at build-time whether an overload is present or not, and thus I can output the arg-full dfn text only when there's an overload; in all other cases I can just make the text the argless version and make everything dramatically simpler.
The text was updated successfully, but these errors were encountered: