Comments on: How to set up ASDoc in Flex Builder

By: Atarsh

Atarsh — Thu, 01 Jul 2010 09:29:31 +0000

great article, thanks
I have a project which uses the swc of a library project in the same workspace, added via “add swc” in the Library path window.
when I try to run the ASDoc tool it insists on trying to create documentation for the lib project as well. I know I can explicitly exclude this library project using -external-library-path, but since I create the external-tool for the whole workspace and would like to use the same one with different projects, I’m trying to find a way to automatically exclude all “referenced libraries”. they are not all necessarily under the same folder, and definitely not under “libs” folder.
any ideas on that?

By: Flash Builder 4 ASDoc Configuration « Flexuous

Flash Builder 4 ASDoc Configuration « Flexuous — Mon, 28 Jun 2010 16:25:24 +0000

[...] This is based on a this post by jason madsen and this post by Seb Lee-Delisle [...]

By: John Bailey

John Bailey — Sun, 04 Apr 2010 15:06:47 +0000

@Beppino,

I have the same issue with you on this machine using dang near ever version of 3.x available. Did you ever find a solution?

By: Gurpreet

Gurpreet — Mon, 22 Feb 2010 08:52:10 +0000

Thanks for the @Embed slash tip. Saved me a lot of effort of probing around.

By: trilok

trilok — Mon, 15 Feb 2010 12:55:00 +0000

very rare concept i h have found on blogs

thanks for sharing

By: Chris

Chris — Tue, 02 Feb 2010 14:10:13 +0000

Thanks for the blog, it really helped. As usual though, things never work straight off, so here’s the problems I had and how I fixed them.

First, I followed these instructions above as Seb describes.
I use many external swc libraries in the ‘libs folder so I added ALL of them.
Then I suppressed the strictness and warnings, and finally the Embed paths to my image assets throughout the source code had to be changed from
source=”@Embed(source=’assets/icon-arrow-down.png’)” to
source=”@Embed(source=’/assets/icon-arrow-down.png’)” so notice the pre-pended slash.

The final arguments block in FlexBuilder external tools looks like this:

-source-path src -doc-sources src
-strict=false
-warnings=false
-external-library-path=libs/AdvancedAutoComplete.swc
-external-library-path=libs/as3corelib.swc
-external-library-path=libs/flexlib.swc
-external-library-path=libs/FlexSpy.swc
-external-library-path=libs/ilog-elixir.swc
-external-library-path=libs/ilog-elixir_rb.swc
-external-library-path=libs/Mate_08_9.swc
-external-library-path=libs/ModuleLoader.swc

Make sure you have the project selected in Flexbuilder before running the asdoc tool (something I tripped up on very easily).

If you are still getting those red errors, just work through them and think about why they could be failing. Good luck.

By: Juan Mendez

Juan Mendez — Thu, 28 Jan 2010 23:55:45 +0000

this blog was just awesome. 1000 thanks..

By: How to exclude classes from being documented by ASDoc 3.0.0? | do IT!

How to exclude classes from being documented by ASDoc 3.0.0? | do IT! — Sat, 07 Nov 2009 17:05:02 +0000

[...] The best way seems to be to exclude all classes from included SWC libraries, as shown in “How to set up ASDoc in Flex Builder“. [...]

By: Beppino

Beppino — Wed, 28 Oct 2009 11:01:19 +0000

Just a note: all seems to be correct if I use the asdoc command from the sdk 3.3 bin folder instead…
Thanks if someone can help me.
-g

By: Beppino

Beppino — Mon, 26 Oct 2009 09:53:07 +0000

Great post, Seb!
But using Flash Builder 4 beta 2, skd 3.4.1 I have this error:

Error: ” is not a directory
Use ‘asdoc -help’ for information about using the command line.

also if I use it as a command line.
Maybe some error in flex-config.xml (I’ve the default)… but I did’nt found it.
Can You please help me?
Thanks