Improve functional comments and add TODO points

Also add back in some code which was unnecessarily removed during the
original process to create this component.

Open-webOS-DCO-1.0-Signed-off-by: Roger Stringer <roger.stringer@palm.com>

Change-Id: Id24fe68b9044a3f35d8abe408d492bb2c74707c4