document new function in b3b76bfc3587ccc08226394997aeadf9ca137194