refactoring javadocs and added logtalk docs