First of all I think I have to clarify at least one thing. I have criticised Adobe in the past for a lof of reasons. Not because I do not like them or the technologies they produce but because I want to improve the Flash Platform. This is of course pure self-interest since Flash is a key technology for the Hobnox AudioTool.
Continue reading ‘This is an outrage!’
Tag Archive for 'as3doc'
Adobe released ASDoc. An Actionscript3 documentation tool. The official Flex 2 Language Reference has been created with ASDoc. No need to work on AS3Doc any longer.
I must say that I really like Adobes attitude about the Flex2 SDK, a free documentation tool and all the free APIs. Great work!
Finally I found a list of supported MXML metadata tags. It was a struggle to get there. When I started to write this post I wanted to say, that I can not work on this without a list of all tags. But there it is. I am fine.
I hope a first beta will be available soon. But do not blame me for being that slow. 35°C are so rare here in Germany. :-) The last problem is that my beta3-version will expire in twelve days. I am not sure how to work on this without the Flex Builder. And if I can not use it, it makes no sense for me any longer.
Here is a preview of current html output. As you can see the classes show in the classes-list the name of their base-class which is wrong. The general output idea is based on LiveDocs and I hope you will not miss any feature.
From code to Html.
- Start creation of Xml using “as3toxml input classpath output title”
- Walk through every file and directory.
- Analyze the code and safe the structure in outpu Xml
- Start creation of Html using “xmltohtml skin input output”
- Load input Xml (which is output of as3toxml) and parse it
- Create for every output file a special Xml which will be transformed into Html using Xslt
The last step is an interesting one if you want to create your own output. You are able to edit some Xslt files or write your own. You may also use Xslt with the original Xml to create a dynamic output. In my eyes it is easier for me to create the packages-list from something like
[html]
Sorry, code is gone because Wordpress was eating it …
[/html]So there is an internal pre-processing of the original Xml. My knowledge about Xslt and especially XPath is just not enough for some better methods. But this way is now also much faster. I hope you like it and give me some days to finish this tool.
There was one great tool to create a documentation for AS2. It was called BLDoc from Bline-Express. The only problem with this tool is that it does not work with Actionscript3. So I started working on a AS3 documentation tool called AS3toXML because it is only analyzing the code and creates a Xml without any nice visual output. That will be the next tool I will create. XMLtoHTML or something like that. Now back to the first application which is nearly finished.
I need your whishes and suggestions!
Yeah, thats true! I want you to help me to have a powerful tool to create Actionscript3 documentations. So here we go. I will post feature lists and Xml output. I wish you to use the comment function to tell me about possible mistakes since I do not know very much about Xml. I want you to tell me how things can be done better and feature requests.
Updated:
- Tags like @deceprated. I should have got all common tags now. If you know a tag you would like go ahead and leave a comment
- Support for the new namespace feature that AS3 offers (access of class members can be public/private/internal/protected or defined by namespace)
- Design changes. @see, @link, @throws and @req (requires) are now using same layout as multi-tags that can be used several times
- Fixed code-analyzer to work with very screwed code and multiline declarations/values
Pending:
- XSLT to format the output since the XMLtoHTML application is also finished now
- Support for meta-tags (still need a list of all that tags)



