Re: [FLEXJS] ASDoc Issues

2017-06-30 Thread Peter Ent
Ah, I misunderstood which asdoc-config file. On 6/30/17, 1:31 PM, "Alex Harui" wrote: >The asdoc target doesn't work because we've extended ActionScript for >FlexJS. We only care about the ASDoc Example. I guess we should comment >out the asdoc target for now.

Re: [FLEXJS] ASDoc Issues

2017-06-30 Thread Alex Harui
The asdoc target doesn't work because we've extended ActionScript for FlexJS. We only care about the ASDoc Example. I guess we should comment out the asdoc target for now. Also, it looks like the ASDoc example uses its own asdic-config.xml file in its src/main/config folder. -Alex

[FLEXJS] ASDoc Issues

2017-06-30 Thread Peter Ent
I'm running the asdoc target in flex-asjs and it has rejected a couple of things in Core/main/flex/Promise.as such as: [asdoc] /Users/pent/dev/flex-asjs/frameworks/projects/Core/src/main/flex/Promise.as(270): col: 19 Error: Syntax error: expecting identifier before catch. [

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-15 Thread Alex Harui
OK, I removed the Flex SDK ASDoc part of the build. Next build is probably less than 2 hours away. -Alex On 3/15/17, 11:21 PM, "piotrz" wrote: >Alex, > >I think we have enough agreed on switching it to FlexJS ASDoc. We have >failing build on jenkins [1] for a long time,

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-15 Thread piotrz
Alex, I think we have enough agreed on switching it to FlexJS ASDoc. We have failing build on jenkins [1] for a long time, which means that none can try the fresh changes through the installer. [1] http://apacheflexbuild.cloudapp.net:8080/job/flex-asjs/ Piotr - Apache Flex PMC

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-09 Thread Christofer Dutz
M, "piotrz" wrote: >Hi Alex, > > +1 for switching. > >I can spent some time to try make your ADoc visually similar to the old >one.- But for sure it won't be fast. My reference will be >http://flex.apache.org/asdoc/ > >It

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-09 Thread yishayw
-development.247.n4.nabble.com/FlexJS-ASDoc-was-Re-FlexJS-maven-faling-WeakMap-tp60325p60335.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-09 Thread Alex Harui
On 3/9/17, 9:45 PM, "piotrz" wrote: >Hi Alex, > > +1 for switching. > >I can spent some time to try make your ADoc visually similar to the old >one.- But for sure it won't be fast. My reference will be >http://flex.apache.org/asdoc/ > >It can be nice

Re: [FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-09 Thread piotrz
Hi Alex, +1 for switching. I can spent some time to try make your ADoc visually similar to the old one.- But for sure it won't be fast. My reference will be http://flex.apache.org/asdoc/ It can be nice excercises. Piotr - Apache Flex PMC piotrzarzyck...@gmail.com -- View this me

[FlexJS] ASDoc (was Re: [FlexJS] maven faling (WeakMap)

2017-03-09 Thread Alex Harui
Renaming this thread to get more attention as well. The Ant build is trying to generate ASDoc and failing because it uses the Flex SDK compiler to generate ASDoc and it can't handle the new compiler features we've added to Falcon. So again, see my questions below. The ASDoc example i

[FlexJS] First round of the asdoc generation in the flexjs-maven-plugin

2016-12-25 Thread Christofer Dutz
Hi, I just pushed some changes that add a new goal to the flexjs-maven-plugin. I added a configuration using this to the Core module in frameworks. You should see the output in the target/asdoc directory. Here the swf directory contains the output if the compilation is set to SWF and the js

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-22 Thread Alex Harui
On 12/22/16, 12:28 AM, "Christofer Dutz" wrote: >Ok ... yesterday I completely refactored the compiler to work without the >SharedData. Thanks for doing that. >The only thing no longer working is the ASDoc generation. > >Right now it’s probably even relate

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-22 Thread Christofer Dutz
ASDoc generation. Unfortunately I now have to go and do a major refactoring of my new house (tear off the seiling insulation) ... probably I’ll have the time to finish this this evening or tomorrow. Right now it’s probably even related to ASDoc using a custom FlexJSASDocProject class ... must be

Re: [FLEXJS] ASDoc App

2016-12-21 Thread Alex Harui
. Thanks, -Alex On 12/14/16, 9:38 AM, "Alex Harui" wrote: >Hi, > >Today I finally got enough of a FlexJS ASDoc app running to mention it on >the list, in hope that other folks can pitch in to help us finish it and >help prove that FlexJS can help folks do something useful, as we

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Alex Harui
n the COMPILE::SWF, but we need to do that for the ASDoc app itself. -Alex On 12/21/16, 3:52 AM, "Christofer Dutz" wrote: >Hi, > >Ok now I managed to get things up and running. Having a look at the way >the asdocs are generated from ANT I can see that they are generated wi

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Christofer Dutz
existing tool will be able to do that. Regarding IntelliJ ... I know that in the Maven world IntelliJ provides the content assist by automatically downloading the „sources“ and the „javadoc“ artifacts for an artifact it is using. I know that „javadoc“ is a silly name for something containing ASdoc

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Christofer Dutz
Hi Alex, I’ll have a look at that ... would be great to resolve this as then I could mark the maven plugin as threadsafe and we could speed up build times by utilizing paralell builds. Chris Am 21.12.16, 16:28 schrieb "Alex Harui" : On 12/21/16, 12:41 AM, "Christofer Dutz" wrot

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Christofer Dutz
Hi Alex, I simply removed the JS version of CSSTextField as this wasn’t referenced anywhere and with that change I managed to proceed. I am still struggling with a static bleed issue as the compiler state seems to be shared between the differenct compiler types, but I think I’ll manage to fix t

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Alex Harui
mail.com >-- >View this message in context: >http://apache-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reas >on-for-additional-config-options-tp57486p57504.html >Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread piotrz
lexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57504.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Alex Harui
On 12/20/16, 10:48 PM, "Christofer Dutz" wrote: >Hi, > >I’m currently workin on Maven support of the ASDoc output. Now I’m sort >of wondering, why we need these „doc-namespaces“ and „doc-sources“ config >options? Shouldn’t the normal sources and namespaces be enough?

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Alex Harui
On 12/21/16, 12:41 AM, "Christofer Dutz" wrote: > >Unfortunately the JSSharedData is byting me at the moment ... I’m having >static stuff bleeding into one execution from another ... we should >generally address that sooner than later ☹ In a quick look, JSSharedData appears to be used in place

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Alex Harui
On 12/21/16, 3:52 AM, "Christofer Dutz" wrote: >So far so good. The SWF xml outupt looks gread, even if I don’t know why >classes, index and tags are Json files, but I’ll fix that later. Basically, I did JSON output first, and was only half-way through the DITA output when I put it down to de

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread piotrz
rong understand it ? Piotr - Apache Flex PMC piotrzarzyck...@gmail.com -- View this message in context: http://apache-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57499.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Christofer Dutz
properties that only exist in SWF or JS, so I think a real api documentation should contain both and point out if an element is available in SWF, JS or both. I am trying to do this in the compie-asdoc maven mojo by doing a compilation for SWF and outputting things to „target/asdoc/swf“ and a

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-21 Thread Christofer Dutz
PMC piotrzarzyck...@gmail.com -- View this message in context: http://apache-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57489.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-20 Thread piotrz
e Flex PMC piotrzarzyck...@gmail.com -- View this message in context: http://apache-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57489.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-20 Thread Christofer Dutz
hint ? It will be an html output ? Piotr - Apache Flex PMC piotrzarzyck...@gmail.com -- View this message in context: http://apache-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57487.html Sen

Re: [FlexJS] ASDoc: Any reason for additional config options?

2016-12-20 Thread piotrz
-flex-development.247.n4.nabble.com/FlexJS-ASDoc-Any-reason-for-additional-config-options-tp57486p57487.html Sent from the Apache Flex Development mailing list archive at Nabble.com.

[FlexJS] ASDoc: Any reason for additional config options?

2016-12-20 Thread Christofer Dutz
Hi, I’m currently workin on Maven support of the ASDoc output. Now I’m sort of wondering, why we need these „doc-namespaces“ and „doc-sources“ config options? Shouldn’t the normal sources and namespaces be enough? Chris

Re: [FLEXJS] ASDoc App

2016-12-18 Thread Justin Mclean
Hi, > Is this true? The article Om posted seems to disagree. While Google can index content from JS apps [4] they may not index all content or may not give it equal weight / ranking to other static content. It’s complicated, for instance see [1][2] (answered by a Google employee). And exactly

Re: [FLEXJS] ASDoc App

2016-12-18 Thread OmPrakash Muppirala
SDK, build a custom library and generate the ASDocs for it without also getting the regular Flex SDK. I have already written enough code in Falcon and FlexJS to produce this ASDoc app. Next step would be DITA files to do ASDoc in code hinting for FB and FDT and maybe other IDEs. Up above you men

Re: [FLEXJS] ASDoc App

2016-12-18 Thread Alex Harui
it without also getting the regular Flex SDK. I have already written enough code in Falcon and FlexJS to produce this ASDoc app. Next step would be DITA files to do ASDoc in code hinting for FB and FDT and maybe other IDEs. Last is a way to convert DITA to HTML via XSLT. Which I don't know

Re: [FLEXJS] ASDoc App

2016-12-18 Thread Alex Harui
On 12/18/16, 5:27 AM, "Christofer Dutz" wrote: >Google doesn’t index JS applications Is this true? The article Om posted seems to disagree. >I think HTML is best for that usecase. >Displaying help in IDEs ususally works by looking for a file with the >same name and relative path as the class

Re: [FLEXJS] ASDoc App

2016-12-18 Thread Christofer Dutz
wrote: > >> > > >> >Or could our framework dump out the resulting DOM and generate the > >>static > >> >HTML that way? > >> > > >> > > >> >You are probably the only person who could build and maintain this

Re: [FLEXJS] ASDoc App

2016-12-18 Thread OmPrakash Muppirala
> >>static > >> >HTML that way? > >> > > >> > > >> >You are probably the only person who could build and maintain this :-) > >> >I would say, XSLT sounds easier than this. > >> > > >> > >> Maybe I&#

Re: [FLEXJS] ASDoc App

2016-12-17 Thread Alex Harui
d and maintain this :-) >> >I would say, XSLT sounds easier than this. >> > >> >> Maybe I'm not understanding something, but IMO, XSLT is an alternative >>for >> ASDoc, but isn't an alternative for all other FlexJS applications. > > >X

Re: [FLEXJS] ASDoc App

2016-12-16 Thread OmPrakash Muppirala
esulting DOM and generate the static > >HTML that way? > > > > > >You are probably the only person who could build and maintain this :-) > >I would say, XSLT sounds easier than this. > > > > Maybe I'm not understanding something, but IMO, XSLT is an a

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
person who could build and maintain this :-) >I would say, XSLT sounds easier than this. > Maybe I'm not understanding something, but IMO, XSLT is an alternative for ASDoc, but isn't an alternative for all other FlexJS applications. Is the only way FlexJS apps can work with

Re: [FLEXJS] ASDoc App

2016-12-16 Thread OmPrakash Muppirala
On Dec 16, 2016 3:15 PM, "Alex Harui" wrote: On 12/16/16, 3:06 PM, "Alex Harui" wrote: >I am surprised by the complexity of [1]. But because we have a tool >chain, I wonder if the tool chain should somehow help. Should we have a >tool that calls PhantomJS or some equivalent? Or could our f

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
On 12/16/16, 3:06 PM, "Alex Harui" wrote: >I am surprised by the complexity of [1]. But because we have a tool >chain, I wonder if the tool chain should somehow help. Should we have a >tool that calls PhantomJS or some equivalent? Or could our framework dump out the resulting DOM and generat

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
On 12/16/16, 1:36 PM, "omup...@gmail.com on behalf of OmPrakash Muppirala" wrote: > >IMO, this problem >> needs to be made easy for all FlexJS applications and that's one reason >>to >> make ASDoc a RIA. So we can show folks how to do it. Are there r

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
] and is well supported, for instance all modern >browsers support XSLT. Others who know XSLT and can help support its use for ASDoc, please speak up now. If we don't get more names, then it effectively makes you two gatekeepers of an important feature, which is, IMO, not a good idea for any Apa

Re: [FLEXJS] ASDoc App

2016-12-16 Thread OmPrakash Muppirala
; > > > >Also, for SEO we need pre-formatted HTML whichever way you decide to do > >it. > > Are you sure about this? I was under the impression that all RIAs, > whether written in Flex or not, had to simply return HTML for some URL. The file didn't actually have

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Justin Mclean
I have been working on this project regularly for around 5 years so the risk is low. There should also be other people who know some XSLT, it been around a while (1999+) [2] and is well supported, for instance all modern browsers support XSLT. > Let's first discuss this one point: Sho

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
o simply return HTML for some URL. The file didn't actually have to exist statically. IMO, this problem needs to be made easy for all FlexJS applications and that's one reason to make ASDoc a RIA. So we can show folks how to do it. Are there really static pages behind Home Depot and Amazon's stores? -Alex

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Josh Tynjala
If IDEs show docs on hover or in completion while you're coding, it's usually from parsing the original ASDoc or some intermediate format (I think SWCs can include that DITA format that Alex was talking about). - Josh On Fri, Dec 16, 2016 at 11:58 AM, OmPrakash Muppirala wrote: >

Re: [FLEXJS] ASDoc App

2016-12-16 Thread OmPrakash Muppirala
On Fri, Dec 16, 2016 at 11:54 AM, Alex Harui wrote: > > > On 12/16/16, 11:42 AM, "omup...@gmail.com on behalf of OmPrakash > Muppirala" wrote: > > >I think we don't need to decide one way or the other right now. We need > >simple html docs for sure. > > I'm not sure what you mean by this. What

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
On 12/16/16, 11:42 AM, "omup...@gmail.com on behalf of OmPrakash Muppirala" wrote: >I think we don't need to decide one way or the other right now. We need >simple html docs for sure. I'm not sure what you mean by this. What does "simple html" mean and why do we need it? -Alex

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Josh Tynjala
The Angular docs actually aren't static HTML. It looks like an Angular app! https://docs.angularjs.org/api/ng/function/angular.forEach If you view source on the page above, you can see that there's a Loading... placeholder and the real content is loaded dynamically. - Josh On Fri, Dec 16, 2016

Re: [FLEXJS] ASDoc App

2016-12-16 Thread OmPrakash Muppirala
I think we don't need to decide one way or the other right now. We need simple html docs for sure. I think having the docs as an RIA as pretty cool as well. For example, AngularJS docs is available as mostly static content here: https://docs.angularjs.org/api For this kind of doc, we just need s

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
On 12/16/16, 1:51 AM, "Christofer Dutz" wrote: > >What do I have to do to get the XML files? I’ll have a look at what I >find. In flex-falcon/compiler-jx there is a org.apache.flex.compiler.clients.ASDOCJSC.java It works just like MXMLC and COMPC. If you specify -js-output-type=FLEXJS_DITA yo

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Alex Harui
think would be most people. OK, but you have said elsewhere you have little time to contribute. The fewer things folks have to know to contribute the better. Honestly, I've always wanted to replace the XSLT in the regular Flex ASDoc. We know folks have to know AS to participate. What happen

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Justin Mclean
Hi, > I have the beginnings of a DITA emitter, but it needs finishing. You are > welcome to finish it. IMO, the project is better off not having new > dependencies on XSLT. It is great that you are an expert at it, but it is > more important that we have redundancy in the community I also know

Re: [FLEXJS] ASDoc App

2016-12-16 Thread Christofer Dutz
dependencies on XSLT. It is great that you are an expert at it, but it is more important that we have redundancy in the community, so relying on languages most of us know is better. If you want to modify the ASDoc app to generate HTML pages that's great as well, but I don&

Re: [FLEXJS] ASDoc App

2016-12-15 Thread Alex Harui
On 12/15/16, 3:02 AM, "Christofer Dutz" wrote: >If there now is a „asdoc.jar“ created by the ant build, the proper way to >do this in Maven would be to create a „asdoc“ module. Creating multiple >jars from one codebase is usually an indicator for the need to refactor. Well,

Re: [FLEXJS] ASDoc App

2016-12-15 Thread Alex Harui
off not having new dependencies on XSLT. It is great that you are an expert at it, but it is more important that we have redundancy in the community, so relying on languages most of us know is better. If you want to modify the ASDoc app to generate HTML pages that's great as well, but I don&#

Re: [FLEXJS] ASDoc App

2016-12-15 Thread Christofer Dutz
If there now is a „asdoc.jar“ created by the ant build, the proper way to do this in Maven would be to create a „asdoc“ module. Creating multiple jars from one codebase is usually an indicator for the need to refactor. Chris Am 14.12.16, 19:10 schrieb "Alex Harui" : O

Re: [FLEXJS] ASDoc App

2016-12-15 Thread Christofer Dutz
XML ... where is that output to and what do I need to do to make him generate that? Chris Am 14.12.16, 18:38 schrieb "Alex Harui" : Hi, Today I finally got enough of a FlexJS ASDoc app running to mention it on the list, in hope that other folks can pitch in to help us

Re: [FLEXJS] ASDoc App

2016-12-14 Thread yishayw
which Jira issues can be filed. It's nice to have simple code that demonstrates the problem in a self-contained app, but a lot of people will find it easier to just reference the docs app. -- View this message in context: http://apache-flex-development.247.n4.nabble.com/FLEXJS-ASDo

Re: [FLEXJS] ASDoc App

2016-12-14 Thread yishayw
This is a great idea. Here are thr proper links (not broken by newlines) [1] SWF version: http://apacheflexbuild.cloudapp.net:8080/job/FlexJS%20ASDoc%20Example/lastSuccessfulBuild/artifact/examples/flexjs/ASDoc/bin-debug/ASDoc.html [2] JS version: http://apacheflexbuild.cloudapp.net:8080/job

Re: [FLEXJS] ASDoc App

2016-12-14 Thread Alex Harui
of adding the pom to compile the sources I know how to do. There are two pieces that I would rather someone else do: 1) There is now an asdoc.jar from flex-falcon/compiler-jx. This needs to be integrated into the Maven build for flex-falcon and the jar deployed as a Maven artifact 2) The Ant script

Re: [FLEXJS] ASDoc App

2016-12-14 Thread Carlos Rovira
Hi Alex, great work! :) I updated the pom.xml and uploaded, but doesn't has any content yet at the momento (but compilation is working in js) :) 2016-12-14 18:38 GMT+01:00 Alex Harui : > Hi, > > Today I finally got enough of a FlexJS ASDoc app running to mention it on > the l

[FLEXJS] ASDoc App

2016-12-14 Thread Alex Harui
Hi, Today I finally got enough of a FlexJS ASDoc app running to mention it on the list, in hope that other folks can pitch in to help us finish it and help prove that FlexJS can help folks do something useful, as well as make it easier for folks to write code with FlexJS. Normally, our ASDoc is

RE: Re: [FalconJX] Generating ASDoc

2016-10-14 Thread Kessler CTR Mark J
Oh another thing. We have some split documentation for our Adobe SDK and Apache SDK ASDocs. What did we come up with before for merging the two in some fashion? -Mark

AW: Re: [FalconJX] Generating ASDoc

2016-10-14 Thread Christofer Dutz
etreff: RE: Re: [FalconJX] Generating ASDoc > flex.apache.org/docs/flexjs/com.example.SomeComponent/ > flex.apache.org/docs/flexsdk/com.example.SomeComponent/ This would be great for be a great format for IDE's to be able to load documentation specific to the component you have selected. -Mark

RE: Re: [FalconJX] Generating ASDoc

2016-10-14 Thread Kessler CTR Mark J
> flex.apache.org/docs/flexjs/com.example.SomeComponent/ > flex.apache.org/docs/flexsdk/com.example.SomeComponent/ This would be great for be a great format for IDE's to be able to load documentation specific to the component you have selected. -Mark

Re: AW: AW: [FalconJX] Generating ASDoc

2016-10-12 Thread Alex Harui
On 10/12/16, 10:34 AM, "Christofer Dutz" wrote: >Hi Alex, > > >Well I know IntelliJ uses the javadoc modules automatically. So that >would be one :-) I didn't know the Flex SDK came with javadoc modules. Is that something FlexMojos provides? > > >And if the dita XML contains all the importan

AW: AW: [FalconJX] Generating ASDoc

2016-10-12 Thread Christofer Dutz
endet: Mittwoch, 12. Oktober 2016 18:43:55 An: dev@flex.apache.org Betreff: Re: AW: [FalconJX] Generating ASDoc On 10/12/16, 5:53 AM, "Christofer Dutz" wrote: >Just to join in on the discussion ... I was consumed by the Website task >for the last few days and couldn't find th

Re: AW: [FalconJX] Generating ASDoc

2016-10-12 Thread Alex Harui
On 10/12/16, 5:53 AM, "Christofer Dutz" wrote: >Just to join in on the discussion ... I was consumed by the Website task >for the last few days and couldn't find the time to participate here. > > >Are you talking about a cool bells&whistles version of ASDoc f

AW: [FalconJX] Generating ASDoc

2016-10-12 Thread Christofer Dutz
Just to join in on the discussion ... I was consumed by the Website task for the last few days and couldn't find the time to participate here. Are you talking about a cool bells&whistles version of ASDoc for which still the static version will be generated? Or are you thinking about

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Alex Harui
Hi Jason, That's a pretty good assessment of the problem. Whether XML or JSON, the data set is pretty much the same: It will look like a subset of ObjectUtil.getClassInfo or describeTypeJSON. Each class and each of its members has not only the ASDoc that annotates it, but also a set of

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Jason Guild
t; being discussed right now could have some UI that allows the user to toggle what or how documentation is seen based on selection of these kinds of facets. That's something the old static ASDoc output could never do: it was static and one-size-fits-all. I always wanted to know about / re

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Josh Tynjala
According to MDN and caniuse, IE 10 supports the history API. https://developer.mozilla.org/en-US/docs/Web/API/History_API http://caniuse.com/#feat=history On caniuse, sometimes supported versions are hidden because they aren't widely used anymore. It may look like IE 11 is the minimum version wh

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Alex Harui
On 10/11/16, 1:10 PM, "Josh Tynjala" wrote: >Anchors could probably be acceptable as a starting point in a minimum >viable product. That wouldn't need the server-side integration. However, >you don't need to use anchors with the HTML history API. Calling >pushState() changes the address bar wit

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Josh Tynjala
t;from Google, it's not very useful. I guess Google's crawler will run > >JavaScript, though. With that in mind, maybe a non-static app can be used > >for the API reference and still be indexed. > > I completely agree that ASDoc must be searchable. I don't know how

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Alex Harui
ll run >JavaScript, though. With that in mind, maybe a non-static app can be used >for the API reference and still be indexed. I completely agree that ASDoc must be searchable. I don't know how folks solve this problem, but IMO, it isn't limited to ASDoc. Any RIA, written in Flex

Re: [FalconJX] Generating ASDoc

2016-10-11 Thread Josh Tynjala
ct 11, 2016 at 11:23 AM, Alex Harui wrote: > Hi, > > FlexJS currently has its ASDoc generated by calling the ASDoc tool in the > flex-sdk repo. That's because the Falcon compiler code we got from Adobe > had no implementation of ASDoc support. We could probably go on like thi

[FalconJX] Generating ASDoc

2016-10-11 Thread Alex Harui
Hi, FlexJS currently has its ASDoc generated by calling the ASDoc tool in the flex-sdk repo. That's because the Falcon compiler code we got from Adobe had no implementation of ASDoc support. We could probably go on like this forever, but it would be nicer to be able to have FlexJS/FalconJ

Re: FlexJS asdoc Top Level classes

2016-09-15 Thread Josh Tynjala
Using flex-typedefs is a good idea! I don't have time at the moment, but if I remember in a few weeks, I'll try to take a look. If anyone else can jump in sooner, feel free. - Josh On Thu, Sep 15, 2016 at 3:53 PM, Alex Harui wrote: > Josh, > > Do you have time to work on

Re: FlexJS asdoc Top Level classes

2016-09-15 Thread Alex Harui
Josh, Do you have time to work on it? I think ASDoc just processes a set of source paths. It might be possible to point a source path to the .as files from flex-typedefs. -Alex On 9/15/16, 9:06 AM, "Josh Tynjala" wrote: >I was talking to someone who is using FlexJS to buil

FlexJS asdoc Top Level classes

2016-09-15 Thread Josh Tynjala
I was talking to someone who is using FlexJS to build an app. One thing they mentioned is that they found it confusing that top level classes like String, Array, etc. were not in the FlexJS asdoc, but others like QName and Namespace were. Now, I understand that we have custom implementations of

Re: AW: AW: AW: [FlexJS] ASDoc?

2016-08-02 Thread Alex Harui
se this ... I'll dig a little deeper ... and >I don't think having API documentation is a small fish ... I think it's >essential. Ok ... you could continue to use the old ASDoc but this just >makes things more complicated for new users (and existing ones) FalconJX doesn't

AW: AW: AW: [FlexJS] ASDoc?

2016-08-02 Thread Christofer Dutz
entually I could use this ... I'll dig a little deeper ... and I don't think having API documentation is a small fish ... I think it's essential. Ok ... you could continue to use the old ASDoc but this just makes things more complicated for new users (and existing ones) Chris ___

Re: AW: AW: [FlexJS] ASDoc?

2016-08-01 Thread Alex Harui
I think there are past discussions about ASDoc and Falcon in the archives. I think FalconJX does keep the asdoc around in the AST nodes. I think you are probably right that Falcon doesn't. Some folks think that writing an ASDoc Emitter for FalconJX will be the fastest way for us to get

AW: AW: [FlexJS] ASDoc?

2016-08-01 Thread Christofer Dutz
to be written asdoc parser, that doesn't seem to exist yet. I remember the old asdoc having problems so it might be better to write a new one. Is the format described anywhere? I'd like to write an antlr4 grammar from that. Chris Von meinem Samsung Galaxy Smartphone gesendet. ---

Re: AW: [FlexJS] ASDoc?

2016-08-01 Thread Josh Tynjala
I think Adobe still uses the older asdoc in their AIR SDK with ASC 2.0 too. - Josh On Aug 1, 2016 7:52 AM, "Alex Harui" wrote: > > > On 8/1/16, 7:42 AM, "Christofer Dutz" wrote: > > >S ... any ideas/suggestions/whatever? Hope I didn't stum

AW: [FlexJS] ASDoc?

2016-08-01 Thread Christofer Dutz
cratch. Chris Von: Christofer Dutz Gesendet: Montag, 1. August 2016 16:42:47 An: dev@flex.apache.org Betreff: AW: [FlexJS] ASDoc? Oh gee ... I can confirm it not no work ;-) I had a look at ant and was surprised to see it using the antTasks from the normal FDK. I used the asdoc-template.xml fo

Re: AW: [FlexJS] ASDoc?

2016-08-01 Thread Alex Harui
On 8/1/16, 7:42 AM, "Christofer Dutz" wrote: >S ... any ideas/suggestions/whatever? Hope I didn't stumble over a >"TODO: This feature has to be implemented" :-( I got lost reading your email. ASDoc generation works from the flex-sdk for generating ASDoc f

AW: [FlexJS] ASDoc?

2016-08-01 Thread Christofer Dutz
Oh gee ... I can confirm it not no work ;-) I had a look at ant and was surprised to see it using the antTasks from the normal FDK. I used the asdoc-template.xml form framework to create a new template and used that in a new ASDoc mojo. It turned out the compiler doesn't understand

Re: [FlexJS] ASDoc?

2016-08-01 Thread Alex Harui
On 8/1/16, 5:57 AM, "Christofer Dutz" wrote: >Hi, > > >as I have just added the JavaDoc generation to the Java side of the >build, now I thought ... hey, how about adding ASDoc too. But >unfortunately I don't recall the latest state of that. Does ASDoc in >

AW: [FlexJS] ASDoc?

2016-08-01 Thread Christofer Dutz
Well I would probably create a mojo for generating the asdocs and create a reporting plugin. So the ASDoc would be handled equally to the JavaDocs in Maven (I would like to name the artifacts "javadoc" though, cause I know this way Eclipse and IntelliJ should be able to auto-detect an

Re: [FlexJS] ASDoc?

2016-08-01 Thread Harbs
t; as I have just added the JavaDoc generation to the Java side of the build, > now I thought ... hey, how about adding ASDoc too. But unfortunately I don't > recall the latest state of that. Does ASDoc in Falcon work? > > > Chris

[FlexJS] ASDoc?

2016-08-01 Thread Christofer Dutz
Hi, as I have just added the JavaDoc generation to the Java side of the build, now I thought ... hey, how about adding ASDoc too. But unfortunately I don't recall the latest state of that. Does ASDoc in Falcon work? Chris

AW: [FlexJS]ASDoc

2016-05-10 Thread Christofer Dutz
r Ent Gesendet: Dienstag, 10. Mai 2016 20:47:12 An: dev@flex.apache.org Betreff: Re: [FlexJS]ASDoc Harbs - Just saw your commit. That's one way to do it! I was just going through the files, one by one to see the ramifications of changing them back. Beat me to it. Thanks, Peter On 5/10/1

Re: [FlexJS]ASDoc

2016-05-10 Thread Peter Ent
10, 2016, at 8:20 PM, Peter Ent wrote: >> >>> Hi, >>> >>> Found a couple of issues and repaired them; the asdoc builds cleanly >>>for >>> me now. >>> —peter >>> >>> On 5/10/16, 10:48 AM, "Peter En

Re: [FlexJS]ASDoc

2016-05-10 Thread Harbs
I have not been able to get the asjs repo to build at all since Chris’ >> last commit. Is it working for you? >> >> On May 10, 2016, at 8:20 PM, Peter Ent wrote: >> >>> Hi, >>> >>> Found a couple of issues and repaired them; the asdoc builds cle

Re: [FlexJS]ASDoc

2016-05-10 Thread Peter Ent
or you? > >On May 10, 2016, at 8:20 PM, Peter Ent wrote: > >> Hi, >> >> Found a couple of issues and repaired them; the asdoc builds cleanly for >> me now. >> —peter >> >> On 5/10/16, 10:48 AM, "Peter Ent" wrote: >> >>>

Re: [FlexJS]ASDoc

2016-05-10 Thread Harbs
I have not been able to get the asjs repo to build at all since Chris’ last commit. Is it working for you? On May 10, 2016, at 8:20 PM, Peter Ent wrote: > Hi, > > Found a couple of issues and repaired them; the asdoc builds cleanly for > me now. > —peter > > On 5/10/16,

Re: [FlexJS]ASDoc

2016-05-10 Thread Peter Ent
Hi, Found a couple of issues and repaired them; the asdoc builds cleanly for me now. —peter On 5/10/16, 10:48 AM, "Peter Ent" wrote: >Hi, > >I'll take a look at this and see what I can find. >‹peter > >On 5/10/16, 9:51 AM, "Harbs" wrote: > >>

  1   2   3   4   >