Add WithUser docs

Author: dylanhitt

command_darwin.go

@@ -10,6 +10,14 @@ func createBaseCommand(c *Command) *exec.Cmd {
 	return cmd
 }
 
+// WithUser allows the command to be run as a different
+// user.
+//
+// Example:
+//
+//	cred := syscall.Credential{Uid: 1000, Gid: 1000}
+//	c := NewCommand("echo hello", cred)
+//	c.Execute()
 func WithUser(credential syscall.Credential) func(c *Command) {
 	return func(c *Command) {
 		c.baseCommand.SysProcAttr = &syscall.SysProcAttr{

command_linux.go

@@ -10,6 +10,14 @@ func createBaseCommand(c *Command) *exec.Cmd {
 	return cmd
 }
 
+// WithUser allows the command to be run as a different
+// user.
+//
+// Example:
+//
+//	cred := syscall.Credential{Uid: 1000, Gid: 1000}
+//	c := NewCommand("echo hello", cred)
+//	c.Execute()
 func WithUser(credential syscall.Credential) func(c *Command) {
 	return func(c *Command) {
 		c.baseCommand.SysProcAttr = &syscall.SysProcAttr{

command_windows.go

@@ -10,6 +10,14 @@ func createBaseCommand(c *Command) *exec.Cmd {
 	return cmd
 }
 
+// WithUser allows the command to be run as a different
+// user.
+//
+// Example:
+//
+//	token := syscall.Token(handle)
+//	c := NewCommand("echo hello", token)
+//	c.Execute()
 func WithUser(token syscall.Token) func(c *Command) {
 	return func(c *Command) {
 		c.baseCommand.SysProcAttr = &syscall.SysProcAttr{