javadoc fixes
require non-null sub-key always