*Modified makesyscalls.sh to strip out SAL annotations.
-fixed kevent annotation -removed cheri relavent comment -fixed incorrect syscall type droped |STD from call 460, error picked up from translating stuff over from cheribsd.
added missing annotations for send and recv.
added annotatations for gethostname, sethostname, revoke, pathconf.
Added a note about SAL annotations to header comments re: emaste and jhb's comments.
Added documentation for annotations to header comment block.
-added annotations for remaining calls of type COMPAT and STD for consistency/completeness.
fixed incorrect annotation for cpuset_getdomain.
tiny wording change in documentation.
replaced tab with spaces for uniform formatting.