added API documentation for core smooth functions