Document some confusing functions.

They're still confusing, but such is life.