added comments for set-like API