This is basically a cleanup patch, improving the comments for each
function.

While here, do a few cleanups.
Signed-off-by: NMauro Carvalho Chehab <mchehab@redhat.com>