HPCC-8352 Update comments to clarify the code

Signed-off-by: Gavin Halliday <gavin.halliday@lexisnexis.com>