So, I tried to ignore what Adobe say on their web site about Windows and OSX only.
Downloaded the zip and unpack over the top of the SDK, as per the official instructions. And:
#/opt/fds2_sdk/bin/asdoc -doc-sources com/YYYY/as3/utils/
Loading configuration file /opt/fds2_sdk/frameworks/flex-config.xml Error: Could not create toplevel.xml: java.lang.RuntimeException: Currently ASDoc only runs on Windows and Mac OS X.
POS :-(
Edit the following day: There is a great follow up post from Adobe's Brian Deitte on the FlexCoders mailing list - an extract reads:
"a big chunk of code that isn't easily switched to Linux. And there's a lot of it. And it contains code that from other products, where we can't quickly make the decision to release this in the open. So now we're stuck in the current situation. Again, as this was always thought to be for internal use, and since ASDoc usually only runs on a Windows build machine, we only ran into this problem when I started to put together things for an external release. So what's being done about this? As a long term plan, we're hoping (and starting to plan) to move the executable code over to Java. As a short term plan, we want to get this working on Linux for the next full release."
I don't want to even think about what they may have in there, but I am glad that it is being worked on, and sounds like it will be fixed.
In my very humble experience, the people who care about developer level documentation are the people using frameworks, continuous integration, Scrum etc. and they also tend to be on Linux or at least GNU / Java.
[node:1452]
Tom