@@ -1767,7 +1767,8 @@ typedef struct
17671767 <para>
17681768 Finally, all variable-length types must also be passed
17691769 by reference. All variable-length types must begin
1770- with a length field of exactly 4 bytes, and all data to
1770+ with an opaque length field of exactly 4 bytes, which will be set
1771+ by SET_VARSIZE; never set this field directly! All data to
17711772 be stored within that type must be located in the memory
17721773 immediately following that length field. The
17731774 length field contains the total length of the structure,
@@ -1833,7 +1834,7 @@ memcpy(destination->data, buffer, 40);
18331834]]>
18341835</programlisting>
18351836
1836- <literal>VARHDRSZ</> is the same as <literal>sizeof(int4 )</>, but
1837+ <literal>VARHDRSZ</> is the same as <literal>sizeof(int32 )</>, but
18371838 it's considered good style to use the macro <literal>VARHDRSZ</>
18381839 to refer to the size of the overhead for a variable-length type.
18391840 Also, the length field <emphasis>must</> be set using the