== SENTIMENT ==
I'm fairly new to IntelliJ IDEA. I feel lost. I've spent hours trying to get this working. I've mostly been trying different combinations of linking my module swc dependencies to documentation in different folder locations.... it's been kind of a blur, I guess.
== PROBLEM ==
My goal is to have these 2 conveniences (which seem currently mutually exclusive) available to me when working on ActionScript/Flex projects:
A) When I press F4 over a class, I can view its implementation.
B) When I press Shift+F1 over a class, I can view its complete external documentation (I'm using HTML ASDocs because that's all I know to work with IntelliJ).
=== Scenario 1: 'A' works, 'B' doesn't ===
'A' works when I'm compiling with AS files in a directory marked as source root.
'B' doesn't work with AS files because it seems the only way to specify external documentation is via the swc.
=== Scenario 2: 'B' works, 'A' doesn't ===
'B' works when I'm compiling with SWCs that have been added with the "Configure Library" dialog (shown below).
'A' doesn't work now because SWC source code is compressed in an unviewable form.
==== SIDE NOTE ====
I just noticed a difference between a project structure created by selecting "Create module from scratch" versus "Import module from external model"...
There seems to be a discrepancy between the "Configure Library" UI...
Project was created "from scratch". Its Flex module icon is outside of any folder:
Also, only SWC files can be added:
Project was created "from external model"-- an actual module folder is created for the Flex icon, and classes can be added to the library:
<-- (Please excuse the fiddling I was doing with the module directories here.)
== REMEDIES ==
- Maybe having multiple modules would solve the problem?
- I've read about potential solutions involving Ant tasks (one of them is shown below) , but these have escaped my grasp.
"There are a few other ways to exclude files from mxmlc. This article shows one method using the compiler options -link-report and -load-externs and it seems pretty clever. So if you are comfortable hand-crafting your own xml exclude file then -load-externs could work for you too.
"The other compiler options that allow you to omit the symbols include: -externs and -compiler.external-library-path.
I'm okay with keeping two versions of each library (SWC & AS files) in my source path. Ideally, I could just use AS files, though.