Javadocs updated.

The new comments have been added to an udated version of the javadocs.

Change-Id: I74d4d17c5c3b8e32bdfa32523f655cdde43d11e0
Signed-off-by: Dan Griffin <dcompgriff@gmail.com>