So if I understood it correctly: Currently Falcon can't generate ASDoc output and therefore there shouldn't be a need for the template data. But ASDoc support is coming and then it would probably need templates?
Well then as soon as that's coming, will falcon have its own set of templates or would it rely on the templates of the FDK it overlays? Chris ________________________________________ Von: Alex Harui <aha...@adobe.com> Gesendet: Montag, 6. Oktober 2014 06:31 An: dev@flex.apache.org Betreff: Re: AW: Another little problem with Falcon and Flexmojos FWIW, the FalconJX compiler does retain the ASDoc info and uses it in the JSDoc, so it isn’t too hard to collect the information. The parser does seem to know about the entire comment block. I didn’t see any code that handles the directives. -Alex On 10/5/14, 9:36 AM, "Gordon Smith" <gsmit...@hotmail.com> wrote: >I'm not aware of this feature getting completed. There are some classes >and interfaces for accessing ASDoc comments on APIs but I don't think >they work. I think all comments are getting dropped by the lexer, so that >no comments, or even their start/end positions, are present in the AST. > >Ideally, the AST would retain enough info about the source to >pretty-format it, but that's not the case now. In addition to dropping >//, /*, and /** comments, I think semicolons are also unrecorded. > >- Gordon > >> On Oct 5, 2014, at 8:24 AM, "Alex Harui" <aha...@adobe.com> wrote: >> >> Afaict, there is no asdoc output code in Falcon today. Gordon might >>know for sure. It looks like there were plans to add it but it hasn't >>happened yet. >> Sent via the PANTECH Discover, an AT&T 4G LTE smartphone. >> >> Christofer Dutz <christofer.d...@c-ware.de> wrote: >> >> >> In the old compiler the ASDoc tool seems to use static template stuff >>in asdoc/templates to generate its output. That's why flexmojos uses a >>template zip artifact, that it downloads and extracts in the local >>repository. I saw in the Falcon Sourcecode that there is code for ASDoc >>... are you claiming that Falcon wouldn't support ASDoc? Think this >>should be added or we would be using some pretty important part of a >>Maven release, as Api Documentation is pretty important (At least I >>think it is). >> >> Chris >> >> >> -----Ursprüngliche Nachricht----- >> Von: Alex Harui [mailto:aha...@adobe.com] >> Gesendet: Sonntag, 5. Oktober 2014 05:43 >> An: dev@flex.apache.org >> Betreff: Re: Another little problem with Falcon and Flexmojos >> >> >> >>> On 10/4/14, 8:59 AM, "Christofer Dutz" <christofer.d...@c-ware.de> >>>wrote: >>> >>> Hi, >>> >>> another thing I just stumbled upon ist hat Falcon probably needs the >>> ASDoc templates from the SDK. Am I correct with this? >> I¹m not sure what you mean by templates. I don¹t know the ASDoc >>compiler that well. I do think I discovered that Falcon doesn¹t have >>the ASDoc compiler feature like MXMLC does. But it is set up to >>eventually be the ASDoc compiler, we just have to implement handling the >>ASDoc nodes correctly. >> >> So short term, you may need to mix and match, but long-term in theory >>Falcon should be able to generate ASDoc. >> >> -Alex >>
