add missing JavaDoc

Change-Id: I1450fde889eba81b82b3d5ee3ee9fa1305b23056
Merge pull request #41 from mikeyman77/logic/javadoc

add missing JavaDoc