dijit._Widget#get - Underscore in docs get mangled by /api

[Andrew Muraco]

When looking at the dojotoolkit.org/api docs for dijit._Widget#get, It doesn't match the docs in the file, and leads the programmer to use it wrong.

The following text is found in the file:

//		and "bar" and a method named "_getFooAttr", calling:
//	|	myWidget.get("foo");
//		would be equivalent to writing:
//	|	widget._getFooAttr();

On the /api website, the doc doesn't show the _ and instead italicizes the text, which leads to a different meaning. (this.getFooAttr() is wrong vs. this._getFooAttr())

The doc parse shouldn't parse the _ if it doesn't terminate on the same line.

[Andrew Muraco]

To be clear, compare the src/dijit/_WidgetBase.js comments for the get() method with the docs on the /api website.

[bill]

Not sure what to do here, Tom is this something to fix on your end?

[Tom Trenka]

Not entirely sure either; it may very well be that the markdown parser is seeing that set of underscores and trying to italicize things. My suggestion would be to try to not use italics in the inline docs, and instead maybe use the code indicators instead?

[bill]

There's only one underscore, unless you are counting the underscores across multiple lines. Note that the inline docs are not trying to use italics. I'll try the backquotes.

[bill]

In [26533]:

fix api doc for get(), set(), and on(), fixes #13870 !strict