core: errors in javadoc

removed empty parts in javadoc
fixed bad links, parameter names in javadoc

Change-Id: I334d7080989d679fa27082547f1a5950fb530645
Signed-off-by: Martin Mucha <mmucha@redhat.com>