Update assorted TOAST-related documentation.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 19 Feb 2015 03:33:39 +0000 (22:33 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 19 Feb 2015 03:33:39 +0000 (22:33 -0500)
commit9bb955c8286c20474b5462eea3e3cf76c694d88f
tree15165717f12f167f617144d51f9a28f2b2bd452e
parent56a79a869bedc4bf6c35853642694cc0b0594dd2
Update assorted TOAST-related documentation.

While working on documentation for expanded arrays, I noticed a number of
details in the TOAST-related documentation that were already inaccurate or
obsolete.  This should be fixed independently of whether expanded arrays
get in or not.  One issue is that the already existing indirect-pointer
facility was not documented at all.  Also, the documentation says that you
only need to use VARSIZE/SET_VARSIZE if you've made your variable-length
type TOAST-aware, but actually we've forced that business on all varlena
types even if they've opted out of TOAST by setting storage = plain.
Wordsmith a few other things too, like an amusingly archaic claim that
there are few 64-bit machines.

I thought about back-patching this, but since all this doco is oriented
to hackers and C-coded extension authors, fixing it in HEAD is probably
good enough.
doc/src/sgml/ref/create_type.sgml
doc/src/sgml/storage.sgml
doc/src/sgml/xtypes.sgml