harden runtime config and docs

2026-06-27 20:58:07 +00:00
parent c148c1b36b
commit 991a0f62b4
13 changed files with 147 additions and 62 deletions
@@ -2,7 +2,7 @@
 u64 socket_connect(String host, u16 port)

 :params
-host : host name
+host : IPv4 address (for example `127.0.0.1`), as a dotted-quad string
 port : port number
 return value : the socket handle

@@ -12,7 +12,7 @@ return value : the socket handle
 :content
 Opens a socket connection to the given `host` and `port`.

-The returned socket handle is then used with `socket_read()`, `socket_write()`, and `socket_close()`.
+The returned socket handle is then used with `socket_read()`, `socket_write()`, and `socket_close()`. Currently this helper accepts IPv4 dotted-quad addresses in socket calls and does not perform hostname resolution.

 :example
 u64 fd = socket_connect("127.0.0.1", 80);