Hurrah !
As of Flex 2.0.1 hotfix 2 the 'asdoc' tool now works on Linux. This means the people who I think care most about having code-level docs ([node:1359]) can now get them.
Oh, and there are some bug and memory leak fixes too :-)
There is one little tweak needed though - if you use the --footer, --window-title or --main-title arguments, it throws an error complaing about "command line: Error: default arguments may not be interspersed with other options".
What you need to do is edit the SDK's bin/asdoc file so that the very last line reads:
java $VMARGS -classpath "$FLEX_HOME/lib/asdoc.jar" flex2.tools.ASDoc flexlib="$FLEX_HOME/frameworks" "$@"
i.e. replace the $* with "$@"
This makes the shell expand the 'all arguments string' correctly.
Sections