Move documentation of the various built-ins to the source code

Currently, this is mostly separated and the bulk of the documentation of the API is in the `regression_test_api.rst` file, but we could use the `autofunction` etc. functionality of Sphinx to make it pull the documentation from the source code.