It would be nice if javadoc matched javac in its ability to access and process sources stored in archive files. If it did, we could access the source archives that RE stores, which contains generated sources and stubs, as well as edited source files. That would make it possible to create JCP diffs, for example, by running the javadoc against archived source hierarchies.