You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@flex.apache.org by OmPrakash Muppirala <bi...@gmail.com> on 2014/09/12 21:30:51 UTC
[FlexJS] [FalconJX] Feature request - Preserve ASDoc style comments
Is it possible to copy over the ASDoc styled comments when cross-compiling
from AS to JS?
My AS function looks like this:
/**
* Draw the path.
* @param data A string containing a compact represention of the
path segments.
* The value is a space-delimited string describing each path
segment. Each
* segment entry has a single character which denotes the segment
type and
* two or more segment parameters.
*
* If the segment command is upper-case, the parameters are
absolute values.
* If the segment command is lower-case, the parameters are
relative values.
*
* @langversion 3.0
* @playerversion Flash 10.2
* @playerversion AIR 2.6
* @productversion FlexJS 0.0
*/
public function drawPath(data:String):void {
But, when I cross-compile it, the JS function looks like this:
/**
* @expose
* @param {string} data
*/
org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
function(data) {
Is there any way to preserve the comments from the AS3 version?
Thanks,
Om
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style comments
Posted by Erik de Bruin <er...@ixsoftware.nl>.
Please note that the JSDoc that is currently there is essential for the
Closure Compiler to do its work. Simply replacing it with the ASDoc will
cause cross compilation to fail.
EdB
On Monday, September 15, 2014, OmPrakash Muppirala <bi...@gmail.com>
wrote:
> On Mon, Sep 15, 2014 at 2:38 PM, Alex Harui <aharui@adobe.com
> <javascript:;>> wrote:
>
> > OK, looks like it could be late this week before I get to it. Is that
> ok?
> >
>
> No worries. This is a nice to have feature, not very urgent.
>
> Thanks,
> Om
>
>
> >
> > On 9/15/14 2:18 PM, "OmPrakash Muppirala" <bigosmallm@gmail.com
> <javascript:;>> wrote:
> >
> > >Thanks Alex. I have created a JIRA ticket to track this feature
> request:
> > >https://issues.apache.org/jira/browse/FLEX-34544
> > >
> > >Om
> > >
> > >On Fri, Sep 12, 2014 at 1:38 PM, Alex Harui <aharui@adobe.com
> <javascript:;>> wrote:
> > >
> > >> I would call my self a guru, but I think some portion of Falcon is
> > >> intended to replace the SDK's ASDoc compiler, so I'm think ASDoc
> > >>comments
> > >> are being tracked. I'll be poking around Falcon next week, so I'll
> look
> > >> into it.
> > >>
> > >> -Alex
> > >>
> > >> On 9/12/14 1:04 PM, "Erik de Bruin" <erik@ixsoftware.nl
> <javascript:;>> wrote:
> > >>
> > >> >Short answer: no.
> > >> >
> > >> >Slightly longer answer - and I'm not pretending to actually know what
> > >>I'm
> > >> >talking about - Falcon doesn't preserve comments in the AST, so
> > >>FalconJX
> > >> >can't pick them up to put them in the JS output.
> > >> >
> > >> >Maybe the compiler gurus can give some input if it would be possible
> to
> > >> >implement at all?
> > >> >
> > >> >EdB
> > >> >
> > >> >
> > >> >
> > >> >On Friday, September 12, 2014, OmPrakash Muppirala
> > >><bigosmallm@gmail.com <javascript:;>>
> > >> >wrote:
> > >> >
> > >> >> Is it possible to copy over the ASDoc styled comments when
> > >> >>cross-compiling
> > >> >> from AS to JS?
> > >> >>
> > >> >> My AS function looks like this:
> > >> >>
> > >> >> /**
> > >> >> * Draw the path.
> > >> >> * @param data A string containing a compact represention
> of
> > >> >>the
> > >> >> path segments.
> > >> >> * The value is a space-delimited string describing each
> > >>path
> > >> >> segment. Each
> > >> >> * segment entry has a single character which denotes the
> > >> >>segment
> > >> >> type and
> > >> >> * two or more segment parameters.
> > >> >> *
> > >> >> * If the segment command is upper-case, the parameters
> are
> > >> >> absolute values.
> > >> >> * If the segment command is lower-case, the parameters
> are
> > >> >> relative values.
> > >> >> *
> > >> >> * @langversion 3.0
> > >> >> * @playerversion Flash 10.2
> > >> >> * @playerversion AIR 2.6
> > >> >> * @productversion FlexJS 0.0
> > >> >> */
> > >> >> public function drawPath(data:String):void {
> > >> >>
> > >> >>
> > >> >> But, when I cross-compile it, the JS function looks like this:
> > >> >>
> > >> >> /**
> > >> >> * @expose
> > >> >> * @param {string} data
> > >> >> */
> > >> >> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath
> =
> > >> >> function(data) {
> > >> >>
> > >> >> Is there any way to preserve the comments from the AS3 version?
> > >> >>
> > >> >> Thanks,
> > >> >> Om
> > >> >>
> > >> >
> > >> >
> > >> >--
> > >> >Ix Multimedia Software
> > >> >
> > >> >Jan Luykenstraat 27
> > >> >3521 VB Utrecht
> > >> >
> > >> >T. 06-51952295
> > >> >I. www.ixsoftware.nl
> > >>
> > >>
> >
> >
>
--
Ix Multimedia Software
Jan Luykenstraat 27
3521 VB Utrecht
T. 06-51952295
I. www.ixsoftware.nl
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style comments
Posted by OmPrakash Muppirala <bi...@gmail.com>.
On Mon, Sep 15, 2014 at 2:38 PM, Alex Harui <ah...@adobe.com> wrote:
> OK, looks like it could be late this week before I get to it. Is that ok?
>
No worries. This is a nice to have feature, not very urgent.
Thanks,
Om
>
> On 9/15/14 2:18 PM, "OmPrakash Muppirala" <bi...@gmail.com> wrote:
>
> >Thanks Alex. I have created a JIRA ticket to track this feature request:
> >https://issues.apache.org/jira/browse/FLEX-34544
> >
> >Om
> >
> >On Fri, Sep 12, 2014 at 1:38 PM, Alex Harui <ah...@adobe.com> wrote:
> >
> >> I would call my self a guru, but I think some portion of Falcon is
> >> intended to replace the SDK's ASDoc compiler, so I'm think ASDoc
> >>comments
> >> are being tracked. I'll be poking around Falcon next week, so I'll look
> >> into it.
> >>
> >> -Alex
> >>
> >> On 9/12/14 1:04 PM, "Erik de Bruin" <er...@ixsoftware.nl> wrote:
> >>
> >> >Short answer: no.
> >> >
> >> >Slightly longer answer - and I'm not pretending to actually know what
> >>I'm
> >> >talking about - Falcon doesn't preserve comments in the AST, so
> >>FalconJX
> >> >can't pick them up to put them in the JS output.
> >> >
> >> >Maybe the compiler gurus can give some input if it would be possible to
> >> >implement at all?
> >> >
> >> >EdB
> >> >
> >> >
> >> >
> >> >On Friday, September 12, 2014, OmPrakash Muppirala
> >><bi...@gmail.com>
> >> >wrote:
> >> >
> >> >> Is it possible to copy over the ASDoc styled comments when
> >> >>cross-compiling
> >> >> from AS to JS?
> >> >>
> >> >> My AS function looks like this:
> >> >>
> >> >> /**
> >> >> * Draw the path.
> >> >> * @param data A string containing a compact represention of
> >> >>the
> >> >> path segments.
> >> >> * The value is a space-delimited string describing each
> >>path
> >> >> segment. Each
> >> >> * segment entry has a single character which denotes the
> >> >>segment
> >> >> type and
> >> >> * two or more segment parameters.
> >> >> *
> >> >> * If the segment command is upper-case, the parameters are
> >> >> absolute values.
> >> >> * If the segment command is lower-case, the parameters are
> >> >> relative values.
> >> >> *
> >> >> * @langversion 3.0
> >> >> * @playerversion Flash 10.2
> >> >> * @playerversion AIR 2.6
> >> >> * @productversion FlexJS 0.0
> >> >> */
> >> >> public function drawPath(data:String):void {
> >> >>
> >> >>
> >> >> But, when I cross-compile it, the JS function looks like this:
> >> >>
> >> >> /**
> >> >> * @expose
> >> >> * @param {string} data
> >> >> */
> >> >> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
> >> >> function(data) {
> >> >>
> >> >> Is there any way to preserve the comments from the AS3 version?
> >> >>
> >> >> Thanks,
> >> >> Om
> >> >>
> >> >
> >> >
> >> >--
> >> >Ix Multimedia Software
> >> >
> >> >Jan Luykenstraat 27
> >> >3521 VB Utrecht
> >> >
> >> >T. 06-51952295
> >> >I. www.ixsoftware.nl
> >>
> >>
>
>
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style
comments
Posted by Alex Harui <ah...@adobe.com>.
OK, looks like it could be late this week before I get to it. Is that ok?
On 9/15/14 2:18 PM, "OmPrakash Muppirala" <bi...@gmail.com> wrote:
>Thanks Alex. I have created a JIRA ticket to track this feature request:
>https://issues.apache.org/jira/browse/FLEX-34544
>
>Om
>
>On Fri, Sep 12, 2014 at 1:38 PM, Alex Harui <ah...@adobe.com> wrote:
>
>> I would call my self a guru, but I think some portion of Falcon is
>> intended to replace the SDK's ASDoc compiler, so I'm think ASDoc
>>comments
>> are being tracked. I'll be poking around Falcon next week, so I'll look
>> into it.
>>
>> -Alex
>>
>> On 9/12/14 1:04 PM, "Erik de Bruin" <er...@ixsoftware.nl> wrote:
>>
>> >Short answer: no.
>> >
>> >Slightly longer answer - and I'm not pretending to actually know what
>>I'm
>> >talking about - Falcon doesn't preserve comments in the AST, so
>>FalconJX
>> >can't pick them up to put them in the JS output.
>> >
>> >Maybe the compiler gurus can give some input if it would be possible to
>> >implement at all?
>> >
>> >EdB
>> >
>> >
>> >
>> >On Friday, September 12, 2014, OmPrakash Muppirala
>><bi...@gmail.com>
>> >wrote:
>> >
>> >> Is it possible to copy over the ASDoc styled comments when
>> >>cross-compiling
>> >> from AS to JS?
>> >>
>> >> My AS function looks like this:
>> >>
>> >> /**
>> >> * Draw the path.
>> >> * @param data A string containing a compact represention of
>> >>the
>> >> path segments.
>> >> * The value is a space-delimited string describing each
>>path
>> >> segment. Each
>> >> * segment entry has a single character which denotes the
>> >>segment
>> >> type and
>> >> * two or more segment parameters.
>> >> *
>> >> * If the segment command is upper-case, the parameters are
>> >> absolute values.
>> >> * If the segment command is lower-case, the parameters are
>> >> relative values.
>> >> *
>> >> * @langversion 3.0
>> >> * @playerversion Flash 10.2
>> >> * @playerversion AIR 2.6
>> >> * @productversion FlexJS 0.0
>> >> */
>> >> public function drawPath(data:String):void {
>> >>
>> >>
>> >> But, when I cross-compile it, the JS function looks like this:
>> >>
>> >> /**
>> >> * @expose
>> >> * @param {string} data
>> >> */
>> >> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
>> >> function(data) {
>> >>
>> >> Is there any way to preserve the comments from the AS3 version?
>> >>
>> >> Thanks,
>> >> Om
>> >>
>> >
>> >
>> >--
>> >Ix Multimedia Software
>> >
>> >Jan Luykenstraat 27
>> >3521 VB Utrecht
>> >
>> >T. 06-51952295
>> >I. www.ixsoftware.nl
>>
>>
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style comments
Posted by OmPrakash Muppirala <bi...@gmail.com>.
Thanks Alex. I have created a JIRA ticket to track this feature request:
https://issues.apache.org/jira/browse/FLEX-34544
Om
On Fri, Sep 12, 2014 at 1:38 PM, Alex Harui <ah...@adobe.com> wrote:
> I would call my self a guru, but I think some portion of Falcon is
> intended to replace the SDK's ASDoc compiler, so I'm think ASDoc comments
> are being tracked. I'll be poking around Falcon next week, so I'll look
> into it.
>
> -Alex
>
> On 9/12/14 1:04 PM, "Erik de Bruin" <er...@ixsoftware.nl> wrote:
>
> >Short answer: no.
> >
> >Slightly longer answer - and I'm not pretending to actually know what I'm
> >talking about - Falcon doesn't preserve comments in the AST, so FalconJX
> >can't pick them up to put them in the JS output.
> >
> >Maybe the compiler gurus can give some input if it would be possible to
> >implement at all?
> >
> >EdB
> >
> >
> >
> >On Friday, September 12, 2014, OmPrakash Muppirala <bi...@gmail.com>
> >wrote:
> >
> >> Is it possible to copy over the ASDoc styled comments when
> >>cross-compiling
> >> from AS to JS?
> >>
> >> My AS function looks like this:
> >>
> >> /**
> >> * Draw the path.
> >> * @param data A string containing a compact represention of
> >>the
> >> path segments.
> >> * The value is a space-delimited string describing each path
> >> segment. Each
> >> * segment entry has a single character which denotes the
> >>segment
> >> type and
> >> * two or more segment parameters.
> >> *
> >> * If the segment command is upper-case, the parameters are
> >> absolute values.
> >> * If the segment command is lower-case, the parameters are
> >> relative values.
> >> *
> >> * @langversion 3.0
> >> * @playerversion Flash 10.2
> >> * @playerversion AIR 2.6
> >> * @productversion FlexJS 0.0
> >> */
> >> public function drawPath(data:String):void {
> >>
> >>
> >> But, when I cross-compile it, the JS function looks like this:
> >>
> >> /**
> >> * @expose
> >> * @param {string} data
> >> */
> >> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
> >> function(data) {
> >>
> >> Is there any way to preserve the comments from the AS3 version?
> >>
> >> Thanks,
> >> Om
> >>
> >
> >
> >--
> >Ix Multimedia Software
> >
> >Jan Luykenstraat 27
> >3521 VB Utrecht
> >
> >T. 06-51952295
> >I. www.ixsoftware.nl
>
>
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style
comments
Posted by Alex Harui <ah...@adobe.com>.
I would call my self a guru, but I think some portion of Falcon is
intended to replace the SDK's ASDoc compiler, so I'm think ASDoc comments
are being tracked. I'll be poking around Falcon next week, so I'll look
into it.
-Alex
On 9/12/14 1:04 PM, "Erik de Bruin" <er...@ixsoftware.nl> wrote:
>Short answer: no.
>
>Slightly longer answer - and I'm not pretending to actually know what I'm
>talking about - Falcon doesn't preserve comments in the AST, so FalconJX
>can't pick them up to put them in the JS output.
>
>Maybe the compiler gurus can give some input if it would be possible to
>implement at all?
>
>EdB
>
>
>
>On Friday, September 12, 2014, OmPrakash Muppirala <bi...@gmail.com>
>wrote:
>
>> Is it possible to copy over the ASDoc styled comments when
>>cross-compiling
>> from AS to JS?
>>
>> My AS function looks like this:
>>
>> /**
>> * Draw the path.
>> * @param data A string containing a compact represention of
>>the
>> path segments.
>> * The value is a space-delimited string describing each path
>> segment. Each
>> * segment entry has a single character which denotes the
>>segment
>> type and
>> * two or more segment parameters.
>> *
>> * If the segment command is upper-case, the parameters are
>> absolute values.
>> * If the segment command is lower-case, the parameters are
>> relative values.
>> *
>> * @langversion 3.0
>> * @playerversion Flash 10.2
>> * @playerversion AIR 2.6
>> * @productversion FlexJS 0.0
>> */
>> public function drawPath(data:String):void {
>>
>>
>> But, when I cross-compile it, the JS function looks like this:
>>
>> /**
>> * @expose
>> * @param {string} data
>> */
>> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
>> function(data) {
>>
>> Is there any way to preserve the comments from the AS3 version?
>>
>> Thanks,
>> Om
>>
>
>
>--
>Ix Multimedia Software
>
>Jan Luykenstraat 27
>3521 VB Utrecht
>
>T. 06-51952295
>I. www.ixsoftware.nl
Re: [FlexJS] [FalconJX] Feature request - Preserve ASDoc style comments
Posted by Erik de Bruin <er...@ixsoftware.nl>.
Short answer: no.
Slightly longer answer - and I'm not pretending to actually know what I'm
talking about - Falcon doesn't preserve comments in the AST, so FalconJX
can't pick them up to put them in the JS output.
Maybe the compiler gurus can give some input if it would be possible to
implement at all?
EdB
On Friday, September 12, 2014, OmPrakash Muppirala <bi...@gmail.com>
wrote:
> Is it possible to copy over the ASDoc styled comments when cross-compiling
> from AS to JS?
>
> My AS function looks like this:
>
> /**
> * Draw the path.
> * @param data A string containing a compact represention of the
> path segments.
> * The value is a space-delimited string describing each path
> segment. Each
> * segment entry has a single character which denotes the segment
> type and
> * two or more segment parameters.
> *
> * If the segment command is upper-case, the parameters are
> absolute values.
> * If the segment command is lower-case, the parameters are
> relative values.
> *
> * @langversion 3.0
> * @playerversion Flash 10.2
> * @playerversion AIR 2.6
> * @productversion FlexJS 0.0
> */
> public function drawPath(data:String):void {
>
>
> But, when I cross-compile it, the JS function looks like this:
>
> /**
> * @expose
> * @param {string} data
> */
> org.apache.flex.core.graphics.GraphicsContainer.prototype.drawPath =
> function(data) {
>
> Is there any way to preserve the comments from the AS3 version?
>
> Thanks,
> Om
>
--
Ix Multimedia Software
Jan Luykenstraat 27
3521 VB Utrecht
T. 06-51952295
I. www.ixsoftware.nl