aharui commented on issue #233: ASDoc comments are not available after making 
an @externs SWC
URL: https://github.com/apache/royale-asjs/issues/233#issuecomment-392124897
 
 
   The Flex compiler would output DITA, but I don't think it ever parsed it.  I 
think there were XSLT transforms to generate the HTML for ASDoc web pages and I 
suspect that Flash Builder had its own parser written in Java when pulling DITA 
files from a Fat SWC.  I don't know if the format is documented.  You can 
generate a pile of DITA files by using the Flex MXMLC on the Flex SDK sources 
with the -keep-xml="true" option.
   
   Generating DITA looked painful so in Royale we opted for JSON.  Also, Royale 
organizes the JSON files a bit differently to optimize for lazy downloading at 
startup for the Royale ASDoc app.  And because the Royale ASDoc app is written 
in AS, I figured JSON might be faster than XML parsing.  So, if you can get 
VSCode to handle JSON in Fat SWCs that would be helpful since the Royale 
compiler can generate JSON for ASDoc.  The Royale ASDoc app and JSON files are 
in the royale-website repo.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to