From 66376db094434403b340fa21545b98bf97a40a83 Mon Sep 17 00:00:00 2001 From: Ingo Schommer Date: Tue, 3 Sep 2019 15:22:14 +1200 Subject: [PATCH] DOCS Known issue about collations Moving from https://docs.silverstripe.org/en/4/getting_started/server_requirements/ since it's too much noise there. Also removing the maintainer contact, that's an outdated concept. --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 82b290d..5000b06 100644 --- a/README.md +++ b/README.md @@ -3,16 +3,11 @@ [![Build Status](https://travis-ci.org/silverstripe/silverstripe-postgresql.png?branch=master)](https://travis-ci.org/silverstripe/silverstripe-postgresql) [![SilverStripe supported module](https://img.shields.io/badge/silverstripe-supported-0071C4.svg)](https://www.silverstripe.org/software/addons/silverstripe-commercially-supported-module-list/) -## Maintainer Contact - - * Sam Minnee (Nickname: sminnee) - ## Requirements * SilverStripe 4.0 * PostgreSQL 8.3.x or greater must be installed * PostgreSQL <8.3.0 may work if T-Search is manually installed -* Known to work on OS X Leopard, Windows Server 2008 R2 and Linux ## Installation @@ -30,6 +25,12 @@ See docs/en for more information about configuring the module. All column and table names must be double-quoted. PostgreSQL automatically lower-cases columns, and your queries will fail if you don't. +Collations have known issues when installed on Alpine, MacOS X and BSD derivatives +(see [PostgreSQL FAQ](https://wiki.postgresql.org/wiki/FAQ#Why_do_my_strings_sort_incorrectly.3F)). +We do not support such installations, although they still may work correctly for you. +As a workaround for PostgreSQL 10+ you could manually switch to ICU collations (e.g. und-x-icu). +There are no known workarounds for PostgreSQL <10. + Ts_vector columns are not automatically detected by the built-in search filters. That means if you're doing a search through the CMS on a ModelAdmin object, it will use LIKE queries which are very slow. If you're writing your