document units *everywhere*

[slosar]

See e.g. ccl_background.h:

double ccl_luminosity_distance(ccl_cosmology * cosmo, double a);
ok, I can guess what this is, but you need to document the units, possibly in the header file.

[elisachisari]

Units documented and extensive documentation added in branch unit_consistency, to be merged.