Document behavior of addr/address/real_addr fields
As examined in #33898 (closed), the address-related fields on our
connection_t objects are a big mess.
We came up with a plan there to make progress on the situation. The first step is to document how the fields are used and modified today, and suggest alternatives to direct use and inspection of those fields.