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. Also, it looks like the ASDoc ex
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
On 6/30/17,
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, which means that none c
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
piotrzarzy
+1 For switching, because everything is better than having a legacy dependency
on the old FDK.
+1 For adding a marker to implement something to produce static content as soon
as we have the time.
Chris
Am 10.03.17, 07:12 schrieb "Alex Harui" :
On 3/9/17, 9:45 PM, "piotrz" wrot
+1
Sencha docs are eating their own dog food and doing fancy filtering. It
looks nice [1] for Sencha Touch 2.3, but gets slow for ExtJS 6.2 [2].
[1] http://docs.sencha.com/touch/2.3.1/#!/api
[2] http://docs.sencha.com/extjs/6.2.0/
--
View this message in context:
http://apache-flex-developmen
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 excercises.
I suppose it won't ever be as f
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 message i
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 related to ASDoc using a custom
>FlexJSASDo
Ok ... yesterday I completely refactored the compiler to work without the
SharedData.
In general this required me to update quite a lot of classes. Right now it
compiles nicely, all unit-tests pass and the resulting JS and SWF output seems
to be ok.
The only thing no longer working is the ASDo
I added two checkboxes to filter for just top-level components, or just
view beads. A better filtering UI is needed for filtering on dozens of
keyword, not two. Suggestions are welcome.
But I think it shows that filtering may really help customers wade through
the tons of FlexJS classes.
Thanks
One more thought on this. A simpler first cut of DITA output wouldn't
need a merge of COMPILE::SWF and COMPILE::JS since the differences are
platform-specific API differences and the initial big payoff of doc is
documenting just the APIs that cross-compile. Might require hiding some
APIs in the CO
Have to admit that I don’t even really know DITA ... as far as I know it’s just
an XML format to describe an API.
The maven plugin seems to be lost and I couldn’t even find what it should be
doing. Don’t know if it generates HTML from DITA, DITA from Java or whatever.
But I read it’s a thin wra
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
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
The playerglobal.swc and spark.swc I just looked at doesn't have DITA
files in it. IIRC, code-assist for playerglobal and MX and Spark swcs are
special-cased in Flash Builder, so I'm not surprised you have to do
something to make it work in IntelliJ. I've seen indications that FDT and
FB can hand
Alex,
If I correct understand DITA is the format which is understandable by Flash
Builder ?
I think in Intellij IDEA it is working differently. Every time when I wanted
to see comments for native Flash player methods - I have to add to Intellij
this link [1] - It's HTML, so in theory if Chris pr
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?
Don't know for sure. I th
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
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
Chris,
I thought about that a bit different. When I'm working on something I'm
adding comments only to SWF version, cause it's probably only SWF version of
comments will be visible in IDE.
/**
* Comments
*/
COMPILE::SWF
calss MyClass
{
}
COMPILE::JS
class MyClass
{
}
Am I wrong understand i
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 with „SWF“
turned on and „JS“ turned off. This will only generate the Flash version of the
documentation. We have quite a lot of classes, methods and p
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 ☹
Chris
Am 21.12.16, 08:15 schrieb "piotrz" :
It's about half past 8 AM and I'm in a Zombie Mode, so doing
It's about half past 8 AM and I'm in a Zombie Mode, so doing weird and
unpredictable things! I hope my code will be ok at half past 1 PM when other
guys from my Team will start doing Code Inspections. :D
Thanks Chris!
Looking forward to the results. :)
Piotr
-
Apache Flex PMC
piotrzarzyck
Hi Piotr,
Yes it will be static html content as we know it from all other API docs for
all other languages I have come across. It’s packaged as self-sufficient
„{artifactid}-version-javadoc.jar“
files together with the artifact and the artifacts sources in typical Maven
style.
And how on ear
Hi Chris,
What will be the results of your work ? I mean I will get documentation from
source code AS and Java and I will see this documentation as code hint ? It
will be an html output ?
Piotr
-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context:
http://apache-flex
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
On Dec 18, 2016 7:32 AM, "Alex Harui" wrote:
>
>
>> So my line of thinking is: folks have limited time to contribute, so
>> spending that limited resource on static site generation of data is a
>>bit
>> contradictory.
>
>
>Don't we already generate HTML from asdocs? What more do you think we
>ne
>
>
>> So my line of thinking is: folks have limited time to contribute, so
>> spending that limited resource on static site generation of data is a
>>bit
>> contradictory.
>
>
>Don't we already generate HTML from asdocs? What more do you think we
>need
>to do on this. Other than maintenance? Ho
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
To add my oppinion to this topic:
I too think it’s a great idea to have some cool FlexJS tool to display our
documentation. No doubt about that.
But on the other side I think there are well established standards and there is
great benefit in supporting these too.
Google doesn’t index JS applica
On Sat, Dec 17, 2016 at 11:41 PM, Alex Harui wrote:
>
>
> On 12/16/16, 11:28 PM, "omup...@gmail.com on behalf of OmPrakash
> Muppirala" wrote:
>
> >On Fri, Dec 16, 2016 at 9:45 PM, Alex Harui wrote:
> >
> >>
> >>
> >> On 12/16/16, 7:05 PM, "omup...@gmail.com on behalf of OmPrakash
> >>Muppirala
On 12/16/16, 11:28 PM, "omup...@gmail.com on behalf of OmPrakash
Muppirala" wrote:
>On Fri, Dec 16, 2016 at 9:45 PM, Alex Harui wrote:
>
>>
>>
>> On 12/16/16, 7:05 PM, "omup...@gmail.com on behalf of OmPrakash
>>Muppirala"
>> wrote:
>>
>> >On Dec 16, 2016 3:15 PM, "Alex Harui" wrote:
>> >
>>
On Fri, Dec 16, 2016 at 9:45 PM, Alex Harui wrote:
>
>
> On 12/16/16, 7:05 PM, "omup...@gmail.com on behalf of OmPrakash Muppirala"
> wrote:
>
> >On Dec 16, 2016 3:15 PM, "Alex Harui" wrote:
> >
> >Or could our framework dump out the resulting DOM and generate the static
> >HTML that way?
> >
>
On 12/16/16, 7:05 PM, "omup...@gmail.com on behalf of OmPrakash Muppirala"
wrote:
>On Dec 16, 2016 3:15 PM, "Alex Harui" 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 :
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
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
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 really
>> static pages behind Home Depot and
On 12/16/16, 1:14 PM, "Justin Mclean" wrote:
>HI,
>
>> OK, but you have said elsewhere you have little time to contribute.
>
>I actually said that the amount of time I have to contribute to this
>project varies over time. It's currently summer and Xmas holidays here in
>the southern hemisphere
On Fri, Dec 16, 2016 at 12:13 PM, Alex Harui wrote:
>
>
> On 12/16/16, 11:58 AM, "omup...@gmail.com on behalf of OmPrakash
> Muppirala" wrote:
>
> >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
> >> Muppir
HI,
> OK, but you have said elsewhere you have little time to contribute.
I actually said that the amount of time I have to contribute to this project
varies over time. It's currently summer and Xmas holidays here in the southern
hemisphere from now until mid January. People get a minimum of 4
On 12/16/16, 11:58 AM, "omup...@gmail.com on behalf of OmPrakash
Muppirala" wrote:
>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
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:
> On Fri, Dec 16
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
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
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
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
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
On 12/16/16, 2:06 AM, "Justin Mclean" wrote:
>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 impo
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
I’m talking about using XSLT in the Maven plugin to convert the XML to HTML.
You don’t even need a dependency to anything, because XSLT is so standard, that
it’s part oft he JDK.
XML, XSL and HTML are everything but rocket-science ... you can do some crazy
stuff with XSL, but that’s not what I’
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, you are welcome to
On 12/15/16, 2:59 AM, "Christofer Dutz" wrote:
>Hi Alex,
>
>great to hear that ... being someone who still thinks the static API
>documentation is important, I would like to work on a maven site mojo to
>generate that static stuff. I am very experienced with XSLT, so that
>shouldn’t be a proble
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" :
On 12/14/16,
Hi Alex,
great to hear that ... being someone who still thinks the static API
documentation is important, I would like to work on a maven site mojo to
generate that static stuff. I am very experienced with XSLT, so that shouldn’t
be a problem. You mentioned, that the Falcon compiler outputs XML
One of the reasons I like this idea is that it gives a chance to easily see
bugs in FlexJS.
Two things that popped up:
1) Scrolling in SWF version is slow to the point of not working.
2) Loading HTML version in Edge takes forever.
I think we should leverage this and add it as a component on whic
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/F
On 12/14/16, 10:00 AM, "carlos.rov...@gmail.com on behalf of Carlos
Rovira" wrote:
>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) :)
Yeah, the simple part of adding the pom to compile the sou
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 list, in hope that o
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 it? I think ASDoc jus
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 build an app. One thing
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
>Falcon work?
ASDoc from Falcon has ne
Peter said in May that it builds. I never really tried to get it to build
myself.
Having the docs built and pushed out automatically would be great though.
Having a special build from the nightly would be cool too.
On Aug 1, 2016, at 3:57 PM, Christofer Dutz wrote:
> Hi,
>
>
> as I have jus
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/16, 2:38 PM, "Peter Ent" wrote:
>No, it is not, once I grabbed his stuff. I'm looking at something else,
>bu
I just fixed it.
On May 10, 2016, at 9:38 PM, Peter Ent wrote:
> No, it is not, once I grabbed his stuff. I'm looking at something else,
> but I will see if I can determine what's going on.
> —peter
>
> On 5/10/16, 1:46 PM, "Harbs" wrote:
>
>> I have not been able to get the asjs repo to buil
No, it is not, once I grabbed his stuff. I'm looking at something else,
but I will see if I can determine what's going on.
—peter
On 5/10/16, 1:46 PM, "Harbs" wrote:
>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, a
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, 10:48 AM, "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:
>
>>Oh.
>>
>>Does the link work for you? I just get two
Hi,
I'll take a look at this and see what I can find.
‹peter
On 5/10/16, 9:51 AM, "Harbs" wrote:
>Oh.
>
>Does the link work for you? I just get two blank frames.
>
>Should the ASDocs be built locally when I build the SDK?
>
>On May 10, 2016, at 4:31 PM, Alex Harui wrote:
>
>> Docs are posted h
Oh.
Does the link work for you? I just get two blank frames.
Should the ASDocs be built locally when I build the SDK?
On May 10, 2016, at 4:31 PM, Alex Harui wrote:
> Docs are posted here [1]
>
>
> [1] http://s.apache.org/NightlyFlexJSASDoc
> [1]
> http://apacheflexbuild.cloudapp.net:8080/j
Docs are posted here [1]
[1] http://s.apache.org/NightlyFlexJSASDoc
[1]
http://apacheflexbuild.cloudapp.net:8080/job/flex-asjs/lastSuccessfulBuild/
artifact/out/asdoc/index.html
On 5/10/16, 4:28 AM, "Harbs" wrote:
>What is the status of ASDoc for FlexJS? I haven’t seen docs anywhere. Is
>
I heard it is a painful to post the ASDoc via our CMS so I am choosing to
not spend time doing it. Volunteers are welcome to do it though.
-Alex
On 12/14/15, 3:46 PM, "Justin Mclean" wrote:
>Hi,
>
>Any way you could publish the current release versions well that may be
>of more use to users an
Hi,
Any way you could publish the current release versions well that may be of more
use to users and potentially cause less confusion?
Thanks,
Justin
Good catch. I'll find a way to change it.
On 12/14/15, 3:11 PM, "omup...@gmail.com on behalf of OmPrakash Muppirala"
wrote:
>It says "Apache Flex 4.15.0 API Reference". We should probably fix that?
>
>Thanks,
>Om
>
>On Mon, Dec 14, 2015 at 3:04 PM, Alex Harui wrote:
>
>> I think I got the bui
It says "Apache Flex 4.15.0 API Reference". We should probably fix that?
Thanks,
Om
On Mon, Dec 14, 2015 at 3:04 PM, Alex Harui wrote:
> I think I got the build machine to build the ASDoc for FlexJS. You can
> access it here [1]
> Of course, it may evolve to be a bit newer than what is releas
On 5/14/15, 12:27 PM, "Michael Schmalle" wrote:
>As you probably know, the asdoc build file is messed up since you did that
>big refactor I guess.
Oh, sorry. I generally don’t look at ASDoc until we get closer to
release. Thanks for working on it.
>
>If I can get that fixed, this could be my
Hi,
A copy is available here:
http://people.apache.org/~pent/asdoc-flexjs/index.html
However, there isn't much in the way of actual documentation. This is
being worked on.
Peter Ent
On 1/28/14 12:13 PM, "Mark Shen" wrote:
>what is the url to access the asdoc? do you have a public url?
>
>
>O
what is the url to access the asdoc? do you have a public url?
On Fri, Jan 24, 2014 at 3:30 PM, Peter Ent wrote:
> Hi,
>
> I've checked in changes to the build script for FlexJS that enables asdoc.
> You'll find the asdoc-output directory at the top, flex-asjs, level.
>
> There is a dearth of c
78 matches
Mail list logo