I’m finally reading up on commenting code with ASDoc (http://livedocs.adobe.com/flex/201/html/wwhelp/wwhimpl/common/html/wwhelp.htm?context=LiveDocs_Book_Parts&file=asdoc_127_1.html) but the way ASDoc is set up doesn’t seem to agree with the way I write my getter/setters.
Here is how I write them:
//I want to add the ASDoc tags here, before this chunk of code
private var _enabled:Boolean = true;
public function get enabled():Boolean
{ return _enabled; }
public function set enabled(new_enabled:Boolean):void
{ _enabled = new_enabled; }
Sadly, if I ad the tags where I want them, if I understand correctly, they will comment the private variable instead. Bummer.
So, either I change the coding style I have been using for the past three years, or insert the tags inside of my code, making it ugly and less structured. I’m leaning towards option A.
My question is, how do YOU write your getter/setters so they are ASDoc friendly?
