docs: Clarify server behavior on read failures
authorEric Blake <eblake@redhat.com>
Mon, 25 Jul 2022 21:19:30 +0000 (16:19 -0500)
committerEric Blake <eblake@redhat.com>
Mon, 25 Jul 2022 21:36:29 +0000 (16:36 -0500)
commit15cac433346613a73cb3c290d9c31114c02086ae
treee4bcae6759c3b7db3a0e3452d66c000be770a4a5
parent050d753ac3adc7bb6cd1a3dca09a392ed3d4133a
docs: Clarify server behavior on read failures

Back in 3.14, we clarified the documentation to state that a read
error detected before the header is sent must use a 0-length payload
to keep the connection alive, to match most existing server and client
implementations, rather than initiating a hard disconnect or sending a
full length payload of garbage.  We then tweaked another spot in the
docs to match in 3.17 (commit e5474502), but then regressed when
merging in support for structured replies shortly after, since that
was developed in parallel.

Fixes: d1fcc84b ("Merge branch 'origin' into extension-structured-reply", 3.17)
doc/proto.md