adding some docs on m4 macro. This info is for users and because README is merely on how to build and install the library, I decided to put this text within doxygen generated stuff (which should be more accessible for a user) - refs #283.