Flesh out comment on important func that has potential to be ...

the source of many future bugs due to side effects and assumed
behaviors.