views:

24

answers:

0

Hi everybody ::- ). Do you know of any tool that can generate documentation based on a custom comment format, as long as that format is consistent across the application? I have an ActionScript3 project but I strongly dislike JSDoc style (the one with /* * * * comments). I have an abbreviated and dare-say nicer looking format to which I stay faithful and consistent across my project:

//This function creates a DropDown Evenat.
//PARAM type: what kind of Dropdown Event this is.
//PARAM callback: function to call back.
//PARAM payload: object to associate with this event. Will be transmitted back when the event fires via a G3EventAnswer-inheriting class.
//PARAM target: Widget to which this event should be registered. Used especially when setting up G3Animations. The G3Director automatically attaches events to the appropriate Widgets based solely on this information.
public function G3WDropdownEvent (type: G3WDropdownEventType, callback: Function, payload: Object, target: G3WDropdown): void
{
  bla_bla_bla; //Code.
}

I know DoxyGen generates stuff based on certain formats, but I am unaware if it is customizable.

So... anybody? ::- D.