[NUCMAVEN-48] "Fix" javadocs so they pass (with warnings). 
No idea of how you avoid the "XXX is an unknown tag" since Maven plugins
need to have them to work. Go figure, so I turned off the silly
"doclint" feature.