Add note about what the method does.
bug-fix per shahar taite