Use doxygen format for file documentation and move parameters to be part of the function comments. Change-Id: I01c0614e7cd3ef4c689d2aec3aa3e52e0d21ffcd Signed-off-by: Anas Nashif <anas.nashif@intel.com>