rpc_util: improve comment for the option function

Author: hueypark

dialoptions.go

@@ -648,8 +648,9 @@ func WithResolvers(rs ...resolver.Builder) DialOption {
 	})
 }
 
-// WithSharedRecvBufferPool returns a DialOption that specifies shared buffer pool
-// for parsing. Setting this will reduce the memory allocation in the parser.
+// WithSharedRecvBufferPool returns a DialOption that configures the ClientConn
+// to use the provided shared buffer pool for parsing incoming messages. Depending
+// on the application's workload, this could result in reduced memory allocation.
 //
 // # Experimental
 //

server.go

@@ -554,8 +554,9 @@ func NumStreamWorkers(numServerWorkers uint32) ServerOption {
 	})
 }
 
-// SharedRecvBufferPool returns a DialOption that specifies shared buffer pool
-// for parsing. Setting this will reduce the memory allocation in the parser.
+// SharedRecvBufferPool returns a ServerOption that configures the server
+// to use the provided shared buffer pool for parsing incoming messages. Depending
+// on the application's workload, this could result in reduced memory allocation.
 //
 // # Experimental
 //