Talk:ASDoc
From Adobe Labs
| Table of contents |
|
|
Welcome!
Welcome to the ASDoc discussion page on Adobe Labs. Please enter your comments regarding this technology here. To help identify the author of comments, please create a new section and use ~~~~ at the end of your talk entries to automatically create a signature.
Comments should be added in list format, but feel free to add your comment under an existing comment to follow a thread structure. If you are responding to a thread, please use the H3 style for your subject (=== TEXT ===) so that the page is easier to read.
Daniel T 15:40, 21 Aug 2006 (PDT)
BUG: Circular Reference
There is a known bug in the ASDoc documentation tool since a few releases and I wonder when this will be fixed, because it makes the usage of this tool very complicated when documenting library projects.
regards, Gunar L. 10:37, 9 Sep 2006 (PDT)
Re: BUG: Circular Reference
We plan to fix this bug the next time we update ASDoc, but unfortunately it will be awhile before we do this. You should use doc-classes or doc-namespaces for now to get around this issue.
bdeitte 17:33, 10 Sep 2006 (PDT)
Workaround?
I am trying to document a huge amount of classes that i have in a library project with a large namespace structure. Is there any chance to do that without handing over every not-referenced class to the asdoc.exe?
regards Gunar L. 06:09, 11 Sep 2006 (PDT)
Re: Workaround?
If all of the files are in or referenced by the namespace, then you can use the namespace as the input with doc-namespaces. You could also use doc-namespaces in combination with doc-classes. Otherwise, sorry, but there's nothing to do for now but to use doc-classes.
bdeitte 13:38, 20 Sep 2006 (PDT)
Embed / External Resource Errors?
My team has recently introduced MDM Zinc into our application to access the user's local filesystem. I am not sure how to tell ASDoc to either import or ignore the MDM references. Because of this, I can no longer document our project. (I tried using the -exclude-dependencies flag, but that didn't seem to do much.)
We have had similar difficulties with external embedded resources such as fonts.
cheers! brian vaughn 10:12, 6 Nov 2006 (EST)
Removing Commercial Content
I removed a link to AS2Doc, which had been listed as the recommended solution for generating AS2 documentation. As there are several projects (many open-source) that will do this, why should one be promoted above the others? If anything, if one is going to be listed as an alternative, then there should be several alternatives listed.
