Mostly moving the existing macro docs over from the standard library docs to the C API docs where they belong. Patch by Kushal Das.