pgsql: Make citext's equality and hashing functions collation-insensiti

Make citext's equality and hashing functions collation-insensitive.

This is an ugly hack to get around the fact that significant parts of the
core backend assume they don't need to worry about passing collation to
equality and hashing functions. That's true for the core string datatypes,
but citext should ideally have equality behavior that depends on the
specified collation's LC_CTYPE. However, there's no chance of fixing the
core before 9.2, so we'll have to live with this compromise arrangement for
now. Per bug #6053 from Regina Obe.

The code changes in this commit should be reverted in full once the core
code is up to speed, but be careful about reverting the docs changes:
I fixed a number of obsolete statements while at it.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/3ebc061c18fcf9447977d232280793e27baf71ff

Modified Files
--------------
contrib/citext/citext.c | 23 ++++++++++++++------
doc/src/sgml/citext.sgml | 50 +++++++++++++++++++++++++++++++++------------
2 files changed, 52 insertions(+), 21 deletions(-)