added better comments to source

latest commit 4e53d021ed
@xretsim authored