add DocBlock and a test for clamp()