Re: [flexcoders] Re: ASDoc now available on Labs
On Friday 18 August 2006 22:17, Brian Deitte wrote: I have an idea on the issue. When you use doc-sources, the compiler point to the main MXML class that you would compile in order to document all of the AS and MXML classes in that application. This idea is That is great ! Just point asdoc at index.mxml and it documents everything you use :-) -- Tom Chiverton Helping to collaboratively negotiate robust customers This email is sent for and on behalf of Halliwells LLP. Halliwells LLP is a limited liability partnership registered in England and Wales under registered number OC307980 whose registered office address is at St James's Court Brown Street Manchester M2 2JF. A list of members is available for inspection at the registered office. Any reference to a partner in relation to Halliwells LLP means a member of Halliwells LLP. Regulated by the Law Society. CONFIDENTIALITY This email is intended only for the use of the addressee named above and may be confidential or legally privileged. If you are not the addressee you must not read it and must not use any information contained in nor copy it nor inform any person other than Halliwells LLP or the addressee of its existence or contents. If you have received this email in error please delete it and notify Halliwells LLP IT Department on 0870 365 8008. For more information about Halliwells LLP visit www.halliwells.com. -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
[flexcoders] Re: ASDoc now available on Labs
I was seeing the same problem and I think I found a workaround and the possible cause of this problem. In my application we are using the code behind methodology and at the same time we have the typical com package stucture. Here is the general layout of our project: com/site/project -- API views/code -- AS files that extend Canvas (code behind) views/layout -- MXML files that implement the extended classes app.mxmml now, when I use ASDoc and set the doc-locations to the root app folder I get the circular reference error that everyone is seeing. But, if I just point to the folder com.site.project, views.code, or views.layout it compiles fine. If I add more then one directory it blows up again. It seems that the cause is that I have MXML files that reference AS files that reference com and extend the base MX classes (but no circular ref). I haven't narrowed it down farther yet, but I hope this gets you in the right direction. On the workaround side, I found if I just point to the root app mxml file as my doc-location then all is well and I get the full docs. J. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: Thanks. I'd love to dig into this more and figure out what's happening. -Brian From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Paul BH Sent: Monday, August 14, 2006 4:29 PM To: flexcoders@yahoogroups.com Subject: Re: [flexcoders] Re: ASDoc now available on Labs I'm getting the same too - I seem to be getting in particularly on interface definitions - I'll try and make a simple reproducable case when I get a spare minute or two... ta PBH On 8/14/06, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com [mailto:flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com ] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com , Brian Deitte bdeitte@ wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
RE: [flexcoders] Re: ASDoc now available on Labs
I have an idea on the issue. When you use doc-sources, the compiler doesn't have a base directory reference to determine the the package names of MXML files. So a/MyMXML.mxml and b/MyMXML.mxml look like the same class name. Perhaps this also happens with AS names, I'm not sure, which would explain it. I'll be looking into this more the next release, especially now that I have an idea of where to look and how to fix it. Your workaround brings up a good thing to mention, something that I didn't emphasize in the examples or the documentation. You only have to point to the main MXML class that you would compile in order to document all of the AS and MXML classes in that application. This idea is mentioned on the Using ASDoc page, but it's a bit hidden. It's in the Excluded Classes section: Unless exclude-dependencies is set to true, classes that are found when compiling the given classes are also documented. In other words, any classes that would normally be compiled are documented. For instance, say that class A is specified in doc-classes. If class A imports class B, then both A and B are documented. Class B must also not be in the exclude-classes list and must not be found in a SWC in order to be documented. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of james_dhap Sent: Friday, August 18, 2006 2:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs I was seeing the same problem and I think I found a workaround and the possible cause of this problem. In my application we are using the code behind methodology and at the same time we have the typical com package stucture. Here is the general layout of our project: com/site/project -- API views/code -- AS files that extend Canvas (code behind) views/layout -- MXML files that implement the extended classes app.mxmml now, when I use ASDoc and set the doc-locations to the root app folder I get the circular reference error that everyone is seeing. But, if I just point to the folder com.site.project, views.code, or views.layout it compiles fine. If I add more then one directory it blows up again. It seems that the cause is that I have MXML files that reference AS files that reference com and extend the base MX classes (but no circular ref). I haven't narrowed it down farther yet, but I hope this gets you in the right direction. On the workaround side, I found if I just point to the root app mxml file as my doc-location then all is well and I get the full docs. J. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: Thanks. I'd love to dig into this more and figure out what's happening. -Brian From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Paul BH Sent: Monday, August 14, 2006 4:29 PM To: flexcoders@yahoogroups.com Subject: Re: [flexcoders] Re: ASDoc now available on Labs I'm getting the same too - I seem to be getting in particularly on interface definitions - I'll try and make a simple reproducable case when I get a spare minute or two... ta PBH On 8/14/06, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com [mailto:flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com ] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com mailto:flexcoders%40yahoogroups.com , Brian Deitte bdeitte@ wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian
[flexcoders] Re: ASDoc now available on Labs
Hi Brian, I found out what was causing this strange error. There was an invalid attribute in the class comment that causes this error. There was an @description just like in the example : /** * Comments * @description * Comments */ I removed the @description and everthing is working fine now. thanks, Ricardo. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: Hi Ricardo, that looks like a different issue. Can you remove your package parameters and see if this fixes it? Do you have any special characters used with a package parameter? -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of ricardopettine Sent: Tuesday, August 15, 2006 2:34 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Hi, I was getting the same error The definition is in circular inheritance when using the doc-sources option. I tried to use the doc-classes and I got the following error for some classes: Loading configuration file D:\Java\Adobe\Flex Builder 2 Plug- in\Flex SDK 2\frame works\flex-config.xml An unexpected error occurred. Error #1085: The element type shortDescription must be terminated by the match ing end-tag /shortDescription. XSLT Error (javax.xml.transform.TransformerException): java.io.FileNotFoundException: output pathtoplevel_classes.xml Any ideas? thanks, Ricardo. --- In flexcoders@yahoogroups.com, Brian Deitte bdeitte@ wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte bdeitte@ wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
[flexcoders] Re: ASDoc now available on Labs
Hi, I was getting the same error The definition is in circular inheritance when using the doc-sources option. I tried to use the doc-classes and I got the following error for some classes: Loading configuration file D:\Java\Adobe\Flex Builder 2 Plug-in\Flex SDK 2\frame works\flex-config.xml An unexpected error occurred. Error #1085: The element type shortDescription must be terminated by the match ing end-tag /shortDescription. XSLT Error (javax.xml.transform.TransformerException): java.io.FileNotFoundException: output pathtoplevel_classes.xml Any ideas? thanks, Ricardo. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte bdeitte@ wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
RE: [flexcoders] Re: ASDoc now available on Labs
Hi Ricardo, that looks like a different issue. Can you remove your package parameters and see if this fixes it? Do you have any special characters used with a package parameter? -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of ricardopettine Sent: Tuesday, August 15, 2006 2:34 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Hi, I was getting the same error The definition is in circular inheritance when using the doc-sources option. I tried to use the doc-classes and I got the following error for some classes: Loading configuration file D:\Java\Adobe\Flex Builder 2 Plug-in\Flex SDK 2\frame works\flex-config.xml An unexpected error occurred. Error #1085: The element type shortDescription must be terminated by the match ing end-tag /shortDescription. XSLT Error (javax.xml.transform.TransformerException): java.io.FileNotFoundException: output pathtoplevel_classes.xml Any ideas? thanks, Ricardo. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte bdeitte@ wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
[flexcoders] Re: ASDoc now available on Labs
Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
RE: [flexcoders] Re: ASDoc now available on Labs
Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links * To visit your group on the web, go to: http://groups.yahoo.com/group/flexcoders/ * To unsubscribe from this group, send an email to: [EMAIL PROTECTED] * Your use of Yahoo! Groups is subject to: http://docs.yahoo.com/info/terms/
Re: [flexcoders] Re: ASDoc now available on Labs
I'm getting the same too - I seem to be getting in particularly on interface definitions - I'll try and make a simple reproducable case when I get a spare minute or two...taPBH On 8/14/06, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure why you'd get that with doc-sources. The compiler believes that you have something similar to a class A which extends B which extends A. If you could send me the files you use to reproduce this or a smaller test case, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:flexcoders@yahoogroups.com] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, Brian Deitte [EMAIL PROTECTED] wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links __._,_.___ -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com YAHOO! GROUPS LINKS Visit your group "flexcoders" on the web. To unsubscribe from this group, send an email to:[EMAIL PROTECTED] Your use of Yahoo! Groups is subject to the Yahoo! Terms of Service. __,_._,___
RE: [flexcoders] Re: ASDoc now available on Labs
Thanks. I'd love to dig into this more and figure out what's happening. -Brian From: flexcoders@yahoogroups.com [mailto:[EMAIL PROTECTED] On Behalf Of Paul BHSent: Monday, August 14, 2006 4:29 PMTo: flexcoders@yahoogroups.comSubject: Re: [flexcoders] Re: ASDoc now available on Labs I'm getting the same too - I seem to be getting in particularly on interface definitions - I'll try and make a simple reproducable case when I get a spare minute or two...taPBH On 8/14/06, Brian Deitte [EMAIL PROTECTED] wrote: Hi, I would just stick to doc-classes then. :) Well, I'm not sure whyyou'd get that with doc-sources. The compiler believes that you havesomething similar to a class A which extends B which extends A. If youcould send me the files you use to reproduce this or a smaller testcase, I can look into this for a later release. -Brian -Original Message- From: flexcoders@yahoogroups.com [mailto:flexcoders@yahoogroups.com] On Behalf Of Geoffrey Williams Sent: Monday, August 14, 2006 3:24 PM To: flexcoders@yahoogroups.com Subject: [flexcoders] Re: ASDoc now available on Labs Any Idea what would fire off the following: Error: The definition is in circular inheritance. I can get it going by specifying individual classes but when I use - doc-sources I get an output of a few of those errors. --- In flexcoders@yahoogroups.com, "Brian Deitte" [EMAIL PROTECTED] wrote: And I'll be trying to awaken myself from my hibernation on flexcoders, so if you have any questions about it, fire away. -Brian -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com Yahoo! Groups Links __._,_.___ -- Flexcoders Mailing List FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com YAHOO! GROUPS LINKS Visit your group "flexcoders" on the web. To unsubscribe from this group, send an email to:[EMAIL PROTECTED] Your use of Yahoo! Groups is subject to the Yahoo! Terms of Service. __,_._,___