More documentation work.
* Split off the "hints" part into a separate file.
* Added information on the utility subroutines to API.txt.