Add documentation for both the raw syscall and its high-level wrapper

Add documentation for both the raw syscall and its high-level wrapper #2389