JavaDoc once more

hopefully final one