Currently, we use the flags junit, jikes and doc quite pervasively. I propose we also add the following USE flags whenever possible: 1) gcj - compile the package with gcj also; will install a .so in addition to the jar. This means compiling a package twice, once with a regular javac/jikes and a second with gcj. 2) examples - include source code examples into /usr/share/doc/${PF}. This is not the javadoc api documentation, but rather auxiliary examples that sometimes come with bigger libraries. 3) source - include the complete source code in a .zip file into /usr/share/doc/${PF}/source, for ease of debugging using Eclipse, NetBeans or other IDE. We should of course also strive to support compile-time unit testing with junit, support compilation with jikes instead of javac whenever possible and *always* generate and install the javadoc API docs for all library packages.
we're already integrating these useflags into ebuilds and the policy is updated. marking as fixed.