flex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alex Harui <aha...@adobe.com>
Subject Re: AW: Another little problem with Falcon and Flexmojos
Date Mon, 06 Oct 2014 04:31:07 GMT
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.


On 10/5/14, 9:36 AM, "Gordon Smith" <gsmithsf@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" <aharui@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.dutz@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:aharui@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.dutz@c-ware.de>
>>> 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

View raw message