javadoc provides a Sun-supported API in com.sun.tools.javadoc.Main. This provides 4 "execute" methods, which take a selection of arguments, all of which end in an array of Strings. It would be good to change these String arguments to be String... arguments. This is a binary compatible change.
minor convenience feature, useful to get right in conjunction with adding more, similar API