Docs: Avoid duplication of macro docstings
Created by: cmft
Documentation of the macros in the macro catalogue is duplicated.
Refactor the structure to be according with the Sardana API. Use automodule sphinx directive to generate the macro docs. Fix minor issues in the macro modules.