
		-----------------------------------------
			nls_sort for PostgreSQL
		-----------------------------------------

This is the INSTALL file for the nls_sort collating function
for the PostgreSQL database server.

------------
Installation:

You have to compile the nls_sort.c to a shared library first. Please,
check your current PostgreSQL documentation, or

  http://www.postgresql.org/docs/7.4/static/xfunc-c.html#DFUNC

for details about your platform. The command

  $ gcc -I/usr/include/pgsql/server -fPIC -shared -o nls_sort.so nls_sort.c


After you have compiled the shared library, place it to a location
close and dear to your heart. Now, in an SQL client, you have to tell
the database about the library and about the function. Run command

  create function nls_sort(text, text) returns text as
	'/path/to/the/library/nls_sort' language C strict ;

Adjust the path to the library to the actual location. Or use relative
path or path starting with string $libdir, if you've placed the shared
library to a well known location. Check your current PostgreSQL
documentation, or

  http://www.postgresql.org/docs/7.4/static/xfunc-c.html#XFUNC-C-DYNLOAD

