resolved comments

src/safeposix/syscalls/net_calls.rs

@@ -3086,10 +3086,10 @@ impl Cage {
 
     /// ## ------------------GETSOCKOPT SYSCALL------------------
     /// ### Description
-    /// "getsockopt_syscall()" get the option specified by the optname argument,
-    /// at the protocol level specified by the level argument for the socket
-    /// associated with the file descriptor specified by the fd argument and
-    /// store to the optval argument.
+    /// "getsockopt_syscall()" retrieves the option specified by the optname
+    /// argument at the protocol level specified by the level argument for
+    /// the socket associated with the file descriptor specified by the fd
+    /// argument, and stores the result in the optval argument.
     ///
     /// ### Function Arguments
     /// The `getsockopt_syscall()` receives four arguments:
@@ -3242,8 +3242,8 @@ impl Cage {
                             // the data to the protocol (SO_SNDLOWAT) or
                             // the user on receiving (SO_RCVLOWAT).
 
-                            // SO_REUSEPORT: Permits multiple AF_INET or AF_INET6 sockets to be bound
-                            // to an identical socket address.
+                            // SO_REUSEPORT: Permits multiple AF_INET or AF_INET6 sockets to be
+                            // bound to an identical socket address.
 
                             // SO_REUSEADDR: Indicates that the rules used in validating addresses
                             // supplied in a bind call should allow reuse of local addresses.
@@ -3328,10 +3328,12 @@ impl Cage {
 
     /// ## ------------------SETSOCKOPT SYSCALL------------------
     /// ### Description
-    /// "setsockopt_syscall()" shall set the option specified by the optname
-    /// argument, at the protocol level specified by the level argument, to the
-    /// value pointed to by the optval argument for the socket associated with
-    /// the file descriptor specified by the fd argument.
+    /// "setsockopt_syscall()" sets a socket option. It configures the option
+    /// specified by the optname argument, at the protocol level specified
+    /// by the level argument, to the value pointed to by the optval argument.
+    /// This is done for the socket associated with the file descriptor provided
+    /// in the fd argument.
+    ///
     ///
     /// ### Function Arguments
     /// The `setsockopt_syscall()` receives four arguments: