javadoc improvements, removed guessing of alternate Id expression by PojoConverter.java

Signed-off-by: gburgett <gordon.burgett@gmail.com>