commit e13d3f6ef8070929b2144ec2eb5c9cb76541bc7e
from: Omar Polo <op@omarpolo.com>
date: Sat Jan 22 16:12:27 2022 UTC

use consistently Ar for request params; add paragraph for write

commit - cab30d8aa7b54656ecc26710b5942cd9578d909c
commit + e13d3f6ef8070929b2144ec2eb5c9cb76541bc7e
blob - a30af2e7bb46c697b5b8db733565c6ffaa240cd4
blob + 3a36e6056c03bf9efa1b4ac5626ea4cfb65283db
--- kamid/9p.7
+++ kamid/9p.7
@@ -91,15 +91,15 @@ The
 .Ic version
 request must be the first message sent, and the client cannot issue
 further requests until receiving the Rversion reply.
-.Cm tag
+.Ar tag
 should be
 .Dv NOTAG
 .Pq \-1 or 255 .
 The client suggest a
-.Cm msize
+.Ar msize
 .Pq the maximum size for packets
 and the protocol version used, the server replies with a
-.Cm msize
+.Ar msize
 smaller or equal to the one proposed by the client.
 The version string must always begin with the two character
 .Dq 9P .
@@ -127,7 +127,7 @@ specifies a fid previously established by an auth mess
 special
 .Dv NOFID
 value
-.Pq defined as (u32int)~0
+.Pq defined as (u32int_t)~0
 if the authentication is not required.
 .It Ic clunk
 Close fids.
@@ -158,7 +158,7 @@ ename[s]
 The Rerror message is used to return an error string describing the
 failure of a request.
 The
-.Cm tag
+.Ar tag
 indicates the failed request.
 .Pp
 Note that there isn't a
@@ -318,6 +318,17 @@ Write data at offset
 fid[4] offset[8] count[4] data[count]
 count[4]
 .Ed
+.Pp
+.Ar fid
+must have been prepared for I/O with a previous
+.Ic open
+or
+.Ic create
+call.
+The returned
+.Ar count
+is the amount of data actually written and may differ from the one in
+the request.
 .It Ic stat
 get file status
 .Bd -literal
@@ -357,8 +368,8 @@ name of the user who last modified the file.
 .El
 .Pp
 Note that the
-.Sq size
-field is always present, even in the
+.Ar size
+is always present, even in the
 .Ic wstat
 call.
 While it may be considered redundant, it's kept to simplify the
@@ -371,12 +382,12 @@ fid[4] stat[n]
 .Ed
 .Pp
 The
-.Sq stat
+.Ar stat
 structure is the same described in
 .Ic stat .
 .Pp
 The
-.Sq stat
+.Ar stat
 structure sent reflect what changes the client wishes to make to the
 given fid.
 To leave some fields as unchanged, use empty string or the maximum