docstring cleanup in map()
many comment fixes
the rest of dataframe output (see the previous commit too)