Fix and update javadocs in KieBase

Fixed copy & paste errors in javadocs.
Minor updates to the javadocs:
 - using @link when appropriate
 - multiple small updates/enhancements
Merge pull request #32 from psiroky/patch-1

Fix and update javadocs in KieBase