NXP-12534: better javadoc