update: document and functional code

[gaukas]

This PR adds documentation to newly added functions, types, and predefined variables/constants.

It also includes some other minor improvements for code style and function structure/naming.