chore: add some comments on DialContext

client_test.go

@@ -333,15 +333,15 @@ func startGnetClient(t *testing.T, cli *Client, ev *clientEvents, network, addr
 		var netConn net.Conn
 		netConn, err = NetDial(network, addr)
 		require.NoError(t, err)
-		c, err = cli.EnrollWithContext(netConn, handler)
+		c, err = cli.EnrollContext(netConn, handler)
 	} else {
-		c, err = cli.DialWithContext(network, addr, handler)
+		c, err = cli.DialContext(network, addr, handler)
 	}
 	require.NoError(t, err)
 	defer c.Close()
 	err = c.Wake(nil)
 	require.NoError(t, err)
-	var rspCh = handler.rspCh
+	rspCh := handler.rspCh
 	duration := time.Duration((rand.Float64()*2+1)*float64(time.Second)) / 2
 	t.Logf("test duration: %dms", duration/time.Millisecond)
 	start := time.Now()

client_unix.go

@@ -140,23 +140,25 @@ func (cli *Client) Stop() (err error) {
 
 // Dial is like net.Dial().
 func (cli *Client) Dial(network, address string) (Conn, error) {
-	return cli.DialWithContext(network, address, nil)
+	return cli.DialContext(network, address, nil)
 }
 
-func (cli *Client) DialWithContext(network, address string, ctx interface{}) (Conn, error) {
+// DialContext is like Dial but also accepts an empty interface ctx that can be obtained later via Conn.Context.
+func (cli *Client) DialContext(network, address string, ctx interface{}) (Conn, error) {
 	c, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return cli.EnrollWithContext(c, ctx)
+	return cli.EnrollContext(c, ctx)
 }
 
 // Enroll converts a net.Conn to gnet.Conn and then adds it into Client.
 func (cli *Client) Enroll(c net.Conn) (Conn, error) {
-	return cli.EnrollWithContext(c, nil)
+	return cli.EnrollContext(c, nil)
 }
 
-func (cli *Client) EnrollWithContext(c net.Conn, ctx interface{}) (Conn, error) {
+// EnrollContext is like Enroll but also accepts an empty interface ctx that can be obtained later via Conn.Context.
+func (cli *Client) EnrollContext(c net.Conn, ctx interface{}) (Conn, error) {
 	defer c.Close()
 
 	sc, ok := c.(syscall.Conn)

client_windows.go

@@ -118,10 +118,10 @@ func unixAddr(addr string) string {
 }
 
 func (cli *Client) Dial(network, addr string) (Conn, error) {
-	return cli.DialWithContext(network, addr, nil)
+	return cli.DialContext(network, addr, nil)
 }
 
-func (cli *Client) DialWithContext(network, addr string, ctx interface{}) (Conn, error) {
+func (cli *Client) DialContext(network, addr string, ctx interface{}) (Conn, error) {
 	var (
 		c   net.Conn
 		err error
@@ -139,14 +139,14 @@ func (cli *Client) DialWithContext(network, addr string, ctx interface{}) (Conn,
 			return nil, err
 		}
 	}
-	return cli.EnrollWithContext(c, ctx)
+	return cli.EnrollContext(c, ctx)
 }
 
 func (cli *Client) Enroll(nc net.Conn) (gc Conn, err error) {
-	return cli.EnrollWithContext(nc, nil)
+	return cli.EnrollContext(nc, nil)
 }
 
-func (cli *Client) EnrollWithContext(nc net.Conn, ctx interface{}) (gc Conn, err error) {
+func (cli *Client) EnrollContext(nc net.Conn, ctx interface{}) (gc Conn, err error) {
 	switch v := nc.(type) {
 	case *net.TCPConn:
 		if cli.opts.TCPNoDelay == TCPNoDelay {