added JavaDoc as requested by review