add missing docstrings, get rid of tabs, specify MACHTYPE