[2767] added since 3.1 annotation and comment to new public method