this app is huge !!!
I experience a problem very new : i’ve been using asdocr for weeks with no problem, but since this morning i get this message :
Loading configuration file /Applications/Adobe Flex Builder 3/sdks/flex_sdk_3.5.0.12683/frameworks/flex-config.xml
An unexpected error occurred.
Error #1083: The prefix “throws” for element “throws:” is not bound.
I wish Adobe would have just done something like this from the beginning. Generating documentation without using asdocr is a nightmare and I love your application. I have run into one problem though. After I installed blazeds on 2 machines and added a JAVA_HOME environment variable (which is correct) asdocr won’t load jvm.dll and I’m not sure why. The path is correct, but it won’t load it. I just get:
Error loading: C:\Program Files\Java\jdk1.6.0_24\jre\bin\server\jvm.dll
Anyway, still love the application. If you have time and don’t mind even pointing me in the right direction to resolve this would be awesome!
I’m sorry for the double comment. I now know that ASDocr is looking for the bin directory in the JAVA_HOME environment but JAVA_HOME should be the java install directory for tomcat to run on my machine and I’m not savvy enough to know how to fix this! Setting JAVA_HOME in my catalina file doesn’t work. Once again thank you!
Nice kinematic grass in the footer!
Does anyone know where the configuration file for ASDocr is stored on your machine? I’m on a Mac and I’ve scoured a ton of directories looking for references to my configuration name, but have been unable to locate a config file.
I’m hoping to export my settings so that my other team members can work from my config.
Thanks!
@andre – not sure exactly what you’re asking is possible, but you can use @inheritDoc in your ASDOC to pull from the headers of overridden functions. That’s the best compromise I can offer, 🙂
@Burton We maintain a single config file for the entire application, and it is possible to copy that file to another computer. However since all the paths will be absolute to your machine, I’m not how useful that will be to you. If you want to try, the file is located in the air app-storage:/ directory, look for the ASdocr folder. On mac its stored in /Users//Library/Preferences/ASDocr/
@wes Thank you so much. I anticipated the links would be absolute, but at least they’ll have my giant list of exclusions and other settings to get started from.
This is awesome. ASDOC generation is a pain in the ass (ant file? a giant command right in the terminal? cut the crap!). ASDocr is just perfect. I owe you a beer!
Is there any way to get this GUI to work with asdoc below version 4? We have some components that are built using 3.5 and unfortunately some styles and other functions are blowing up and exclude doesn’t seem to work.
the program runs to the end and then says “ethority.com” needs an ending tag. Where does this come from? i did not specific these words in the documentation tags.
[Fatal Error] toplevel.xml:11728:14: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
org.xml.sax.SAXParseException: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
at javax.xml.parsers.DocumentBuilder.parse(Unknown Source)
at flex2.compiler.asdoc.AsDocHelper.createTopLevelClasses(AsDocHelper.java:66)
at flex2.compiler.asdoc.AsDocAPI.createTopLevelClassesXML(AsDocAPI.java:401)
at flex2.tools.ASDoc.asdoc(ASDoc.java:94)
at flex2.tools.ASDoc.main(ASDoc.java:35)
Error: Could not create toplevel.xml: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
Error loading: C:\Program Files\Java\jdk1.6.0_24\jre\bin\server\jvm.dll
means your are using x64 Java version to solve this use the x86 Version
@mike
I have had similar errors when I used vector syntax in my asdoc it was like:
/**
* this function returns Vector.
*/
asdoc breaks on the “” thinking it is a xml tag that is not closed causing the Fatal error .. must be followed by ..
I changed Vector. to Vector of type Something and then the tool works like a charm.
Have wasted a day getting asdocs to work properly and this tool solved everything for me.
Many thanks.
Thanks!
Great work!
I just noticed that there is no scrolling on the text when an error occurred. You can’t read the full error message.
Thank you guys for this fantastic tool!
How did you do your installation without the adobe gloom and doom look. Is it difficult to do?
Thanks Carl
Hello,when I selected the AsDoc.exe,the lovely green ball is rounding for longlonglong time…
Could you tell what’s wrong with this guide?
My msn yanxingyang@hotmail.com
When I used my pc of my compony,it’s fine.
But there is some problem
C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.1.0\bin\asdoc -source-path “C:\WorkStation\FlashBuilder\TestDoc\src” -output “C:\WorkStation\FlashBuilder\TestDoc\doc” -doc-sources “C:\WorkStation\FlashBuilder\TestDoc\src” -main-title “Keith” -window-title “KeithLab” -footer “2010-7” -templates-path “C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.1.0\asdoc\templates” -package “Just” “for” -package “a” “test” -lenient
ÕýÔڼÓÔØÅäÖÃÎļþ¡¡ãC:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.1.0\frameworks\flex-config.xml¡¡À
¾¯¸æ: ÕҲ»µ½ÒÔÏ packages: a Just
Îĵµ´´½¡§Ôڡ¡ãC:\WorkStation\FlashBuilder\TestDoc\doc\¡¡ÀÖÐ
Oh,yes,It’ fine now
Could you tell me how rename th configation file name?
This has saved my sanity.
I tried setting up asdoc myself using ant and I failed due to a java environment problem I could not solve.
Also I tried to set up asdoc through flex builder but it reported errors during generation that the compiler said didnt exist.
So now I can just use your app 🙂
exactly what i was looking for. hawt.
Finally I got it working. Thanks a lot, Grant!
Hi Grant,
this app is huge !!!
I experience a problem very new : i’ve been using asdocr for weeks with no problem, but since this morning i get this message :
Loading configuration file /Applications/Adobe Flex Builder 3/sdks/flex_sdk_3.5.0.12683/frameworks/flex-config.xml
An unexpected error occurred.
Error #1083: The prefix “throws” for element “throws:” is not bound.
I cannot find how to fix it… any iputs ?
Thanks so much for the great tool,
Gilles
I wish Adobe would have just done something like this from the beginning. Generating documentation without using asdocr is a nightmare and I love your application. I have run into one problem though. After I installed blazeds on 2 machines and added a JAVA_HOME environment variable (which is correct) asdocr won’t load jvm.dll and I’m not sure why. The path is correct, but it won’t load it. I just get:
Error loading: C:\Program Files\Java\jdk1.6.0_24\jre\bin\server\jvm.dll
Anyway, still love the application. If you have time and don’t mind even pointing me in the right direction to resolve this would be awesome!
I’m sorry for the double comment. I now know that ASDocr is looking for the bin directory in the JAVA_HOME environment but JAVA_HOME should be the java install directory for tomcat to run on my machine and I’m not savvy enough to know how to fix this! Setting JAVA_HOME in my catalina file doesn’t work. Once again thank you!
Nice kinematic grass in the footer!
Is it possible to generate the ASDocs with the Flash Native Classes?
For example if I have a subclass of Sprite it would be nice if the docs included it…
Does anyone know where the configuration file for ASDocr is stored on your machine? I’m on a Mac and I’ve scoured a ton of directories looking for references to my configuration name, but have been unable to locate a config file.
I’m hoping to export my settings so that my other team members can work from my config.
Thanks!
@andre – not sure exactly what you’re asking is possible, but you can use @inheritDoc in your ASDOC to pull from the headers of overridden functions. That’s the best compromise I can offer, 🙂
@Burton We maintain a single config file for the entire application, and it is possible to copy that file to another computer. However since all the paths will be absolute to your machine, I’m not how useful that will be to you. If you want to try, the file is located in the air app-storage:/ directory, look for the ASdocr folder. On mac its stored in /Users//Library/Preferences/ASDocr/
@wes Thank you so much. I anticipated the links would be absolute, but at least they’ll have my giant list of exclusions and other settings to get started from.
You guys rock!
This is awesome. ASDOC generation is a pain in the ass (ant file? a giant command right in the terminal? cut the crap!). ASDocr is just perfect. I owe you a beer!
Is there any way to get this GUI to work with asdoc below version 4? We have some components that are built using 3.5 and unfortunately some styles and other functions are blowing up and exclude doesn’t seem to work.
This is awesome!
Feature request: ability to export configuration to share across multiple machines.
Thanks!
the program runs to the end and then says “ethority.com” needs an ending tag. Where does this come from? i did not specific these words in the documentation tags.
[Fatal Error] toplevel.xml:11728:14: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
org.xml.sax.SAXParseException: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
at javax.xml.parsers.DocumentBuilder.parse(Unknown Source)
at flex2.compiler.asdoc.AsDocHelper.createTopLevelClasses(AsDocHelper.java:66)
at flex2.compiler.asdoc.AsDocAPI.createTopLevelClassesXML(AsDocAPI.java:401)
at flex2.tools.ASDoc.asdoc(ASDoc.java:94)
at flex2.tools.ASDoc.main(ASDoc.java:35)
Error: Could not create toplevel.xml: Element type “ethority.com” must be followed by either attribute specifications, “>” or “/>”.
Thanks a lot, Grant!
@micheal
Error loading: C:\Program Files\Java\jdk1.6.0_24\jre\bin\server\jvm.dll
means your are using x64 Java version to solve this use the x86 Version
@mike
I have had similar errors when I used vector syntax in my asdoc it was like:
/**
* this function returns Vector.
*/
asdoc breaks on the “” thinking it is a xml tag that is not closed causing the Fatal error .. must be followed by ..
I changed Vector. to Vector of type Something and then the tool works like a charm.
Have wasted a day getting asdocs to work properly and this tool solved everything for me.
Many thanks.
thanks, it help me too much