Tag Archive for 'as3doc'

Disappointment No. 3

Published on Oct 1, 2010 in Flash, news, personal and projects. 20 Comments Tags: , , , , , , .

I created a couple of programs like AS3doc and AS3V. Both have never really gotten any adoption because I canceled their development. The reason was that Adobe shortly before or after I finished my tool released a competitive tool. Given the fact that I work fulltime on audiotool.com it is hard for me to find some time off to develop those applications. Some of them are even not written for myself — like the FlexMojos code coverage.

However it happened again. I write a tool that is not even fully released yet and there comes Adobe around the corner with something that must have been in development for a while. Enough time to tell us that we can decide if we want to continue working on it or not.

I have no problem with Adobe developing such products. In fact I second that they have a Flex QA team which develops tools like FlexPMD and the recent coverage plug-in. However the way this process happens really frustrates me. Why would I want to work on something that Adobe is already developing somewhere silently and release it without giving anyone notice? But they do not owe me an explanation for what they do. It would also be arrogant to say that I demand to know upfront.

I am just sad that there is no dialog at all. This happened three times now. I will not continue doing this.

That does not mean I will stop working on Apparat and JITB. Only no more enterprise releated open source software.

This is an outrage!

Published on Aug 6, 2009 in Flash, news and personal. 49 Comments Tags: , , , , , , , .

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!’

Good bye AS3Doc – Hi ASDoc

Published on Aug 21, 2006 in as3, Flash, news, personal and projects. 4 Comments Tags: , .

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!

AS3 Doc dying?

Published on Jul 19, 2006 in as3, personal and projects. 1 Comment Tags: .

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.

As3 Documentation Tool Preview

Published on Jun 17, 2006 in as3, Flash, personal and projects. 0 Comments Tags: , .

Screenshot of Html outputHere 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.

  1. Start creation of Xml using “as3toxml input classpath output title”
  2. Walk through every file and directory.
  3. Analyze the code and safe the structure in outpu Xml
  4. Start creation of Html using “xmltohtml skin input output”
  5. Load input Xml (which is output of as3toxml) and parse it
  6. 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

Sorry, code is gone because WordPress was eating it ...

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.

AS3 Documentation Tool AS3toXML

Published on Jun 15, 2006 in as3, Flash, news, personal and projects. 7 Comments Tags: , , .

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)

Continue reading ‘AS3 Documentation Tool AS3toXML’