documentation

modified the doc and updated the .h files (my part)