comment on an interesting -- and potentially confusing -- area of the code