housekeeping

doxigen documentation:
all files description added
all functions description added