Thanks Colin, My library is not a .swc - it's a work-in-progress and other coders contribute to it, though I suppose I could try and compile as .swc and try that. The third party classes are things like Papervision and TweenLite - they aren't going to offer me up a .swc most likely :) I don't think they exist for those. The problem would remain for the main library .swc though with the third party libraries being imported into some of those classes thought, right?
>>another option might be to explicitly list all your own classes in the >>doc-classes, then set -exclude-dependencies to true. I have tried various forms of adding -exclude-dependencies in FlashDevelop's Actionscript Documentation Generator, but keep getting this error: Error: exclude-dependencies can not be used with doc-sources. And honestly, I'm not even sure how to use that flag correctly (if that's even the right flag at all). I tried adding a class name right after it but it couldn't find the class. Searching online for an hour has done no good. The documentation really stinks for ASDoc and so does the help system you can call with a -help flag. But listing out all 50 or so classes - yeech! :) I'll try some of your examples out and report back - thanks so much for your reply. Anyone know of any documentation generators that play better with AS libraries (and ideally, though not necessarily, work with FlashDevelop)? I've had the AS3 adapter for ZenDocs and NaturalDocs suggested to me from someone on Flexcoders but haven't had time to try those out yet. Jason Merrill Bank of America Global Learning Learning & Performance Solutions Join the Bank of America Flash Platform Community and visit our Instructional Technology Design Blog (note: these are for Bank of America employees only) -----Original Message----- From: flashcoders-boun...@chattyfig.figleaf.com [mailto:flashcoders-boun...@chattyfig.figleaf.com] On Behalf Of co...@moock.org Sent: Tuesday, April 13, 2010 11:29 AM To: Flash Coders List Subject: Re: [Flashcoders] ASDoc & third party libraries if your library is a .swc file, you should be able to just include it in the -library-path without it being documented, like this: -source-path ${build.working_root}/src -library-path+=${build.working_root}/libs in the case of source-based libraries, you could compile a .swc and link to that in your code instead, then use the library-path for your docs. (you also could ask the library developer to offer a .swc...seems like a good thing to do.) lower-level -doc-sources entries might do the trick too. e.g., -doc-sources /src/com/yourpackageA/ /src/com/yourpackageB/ instead of: -doc-sources /src/ another option might be to explicitly list all your own classes in the doc-classes, then set -exclude-dependencies to true. i don't believe there's a way to exclude a package from docs. sadly, asdoc is pretty primitive. i have a laundry list of feature requests that i'll post here when i've entered bugs so people can help vote them up. colin Merrill, Jason wrote: > Those of you who use ASDoc I'm sure have come across this before. If you > use FlashDevelop and ASDoc - then even better as that is my setup. > > How do you handle running ASDoc on a Flash or Flex project where you are > also using other third party libraries? If you run ASDoc on a project > that uses a third party library like Greensock's TweenLite or > Papervision3D, as I am, you can get all kinds of compiler errors because > it tries to include those in the documentation as well (since they are > imported into your classes), and those are not necessarily set up for > ASDoc. I know in FlashDevelop, the Actionscript Documentation Generator > has a field for classes to exclude - but it would be impossible to list > out all those third party classes - is there a way to exclude an entire > package? > > Thanks, > > Jason Merrill > > Bank of America Global Learning > Learning & Performance Solutions > > Join the Bank of America Flash Platform Community > <http://sharepoint.bankofamerica.com/sites/tlc/flash/default.aspx> and > visit our Instructional Technology Design Blog > <http://sharepoint.bankofamerica.com/sites/SDTeam/itdblog/default.aspx> > (note: these are for Bank of America employees only) > > > > > > > _______________________________________________ > Flashcoders mailing list > Flashcoders@chattyfig.figleaf.com > http://chattyfig.figleaf.com/mailman/listinfo/flashcoders _______________________________________________ Flashcoders mailing list Flashcoders@chattyfig.figleaf.com http://chattyfig.figleaf.com/mailman/listinfo/flashcoders _______________________________________________ Flashcoders mailing list Flashcoders@chattyfig.figleaf.com http://chattyfig.figleaf.com/mailman/listinfo/flashcoders
