new package + updated JavaDoc