Adds variable docs for Sphinx autodoc.
Adds extra comments to the lastclobber return since the format is non-standard.