flex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeffry Houser <jef...@dot-com-it.com>
Subject Re: Proposition :: ASDoc and compiler adjustments
Date Wed, 04 Jan 2012 23:07:48 GMT

  I'm curious if we'll be able to generate the full ASDocs, like what 
are on the Adobe site without the source code for the Flash stuff.  We 
can only go so far up the inheritance tree.

On 1/4/2012 5:40 PM, Michael Schmalle wrote:
>
> I do not have a lot of experience with the actual compiler and asdoc 
> tool but that has not stopped me from having fun with parsers and AST. :)
>
> I am wondering if there is any interest in creating some apis in the 
> compiler that jive with the asdoc tool(modifying the asdoc tool). I'm 
> going to be looking into the source code of this tomorrow so I will 
> have a clear understanding of what the work would be.
>
> My idea is this; If we could allow public api in both tools that 
> expose themselves through java it would allow 3rd party developers and 
> applications that could be made to enhance the documentation process 
> through formatters and asdoc editor applications.
>
> This a highlevel idea but I have already written such an application 
> using the jasblocks and asblocks AST framework, that are used to 
> create a user interface into creating asdoc comments and such through 
> visual editing of descriptions and tags.
>
> No more typing  /** ... */ is what I mean, the editor using the AST 
> reinserts the comment using tokens.
>
> I have found taking the actual documentation process out of the IDE's 
> code view allows for better documentation and actual revelation that 
> creating great docs can be fun. 


-- 
Jeffry Houser
Technical Entrepreneur
203-379-0773
--
http://www.flextras.com?c=104
UI Flex Components: Tested! Supported! Ready!
--
http://www.theflexshow.com
http://www.jeffryhouser.com
http://www.asktheflexpert.com
--
Part of the DotComIt Brain Trust


Mime
View raw message