improve commemnts and variable names
Signed-off-by: Mike Day <ncmike@ncultra.org>