JavaDoc and failproofing