some doxygen documentation for mapping.{c,h}. Existing comments are...

some doxygen documentation for mapping.{c,h}. Existing comments are doxygenified by they remain where they were. New comments are added in the header file

Rev: src/mapping.c:1.184
Rev: src/mapping.h:1.61