Improve docstrings

While reading the source code, I've polished the description of functions and macros to deepen my understanding. I hope you like these corrections.