improved code comments

Signed-off-by: Izhar ul Hassan <ezhaar@gmail.com>