Added "/// @docsEditable" to all generated members in the HTML lib.

Added "// @editable" to all generated members in the HTML lib.

This is included as a way to find exacly the members that will have docs
injected after the fact. The members without @editable are expected to be
documented inline, wherever the source or template is defined.

Committed: https://code.google.com/p/dart/source/detail?r=15179

[Andrei Mouravski, 2012-11-18 23:22:46]

Ahoy.

Here's my first pass at getting a hook into the HTML library where I can attach
my human generated docs.

Willing to discuss other options, but I think this makes sense.

I'm pretty sure I caught all the places I need to add this tag, but let me know
if you see anything that looks off.

Thanks!

[blois, 2012-11-19 17:25:46]

On 2012/11/18 23:22:46, Andrei Mouravski wrote:
> Ahoy.
> 
> Here's my first pass at getting a hook into the HTML library where I can
attach
> my human generated docs.
> 
> Willing to discuss other options, but I think this makes sense.
> 
> I'm pretty sure I caught all the places I need to add this tag, but let me
know
> if you see anything that looks off.
> 
> Thanks!

What is the plan for removing the @domName annotation? I'd sort of prefer that
the @editable be put in when @domName is replaced with actual documentation.

How about @docsEditable or something, and putting it in the doc comment? It sort
of looks like a commented out code annotation as it is.

[Andrei Mouravski, 2012-11-19 22:19:59]

Okay, see if this is good.

[blois, 2012-11-19 23:19:06]

lgtm

Looks good, but can you make sure that this doesn't break the MDN generation
code? Not sure how fragile that is.

http://codereview.chromium.org/11308087/diff/9/sdk/lib/html/scripts/htmldartg...
File sdk/lib/html/scripts/htmldartgenerator.py (right):

http://codereview.chromium.org/11308087/diff/9/sdk/lib/html/scripts/htmldartg...
sdk/lib/html/scripts/htmldartgenerator.py:43: self._members_emitter.Emit('\n 
/** @domName $DOMINTERFACE.$DOMNAME */\n'
Seems odd to have two doc comments- can we just roll them into one? Or make them
the same style?

[Andrei Mouravski, 2012-11-20 20:54:20]

Okay, I was doing the wrong thing with tags, and MDN docs were not showing up,
but now they are.

[blois, 2012-11-20 21:01:53]

https://codereview.chromium.org/11308087/diff/13001/sdk/lib/html/scripts/html...
File sdk/lib/html/scripts/htmldartgenerator.py (right):

https://codereview.chromium.org/11308087/diff/13001/sdk/lib/html/scripts/html...
sdk/lib/html/scripts/htmldartgenerator.py:43: self._members_emitter.Emit('\n 
/** @domName $DOMINTERFACE.$DOMNAME;'
Semi-colon delimiter? Aren't these normally just on different lines?

[blois, 2012-11-20 21:03:39]

lgtm