diff options
| author | Peter Eisentraut <peter_e@gmx.net> | 2012-08-31 23:28:14 -0400 |
|---|---|---|
| committer | Peter Eisentraut <peter_e@gmx.net> | 2012-08-31 23:28:14 -0400 |
| commit | 5cad02452457d7f6f29404411dfe13e6fe8accb7 (patch) | |
| tree | 4bc6c6421f69d575173674fda298b8422dd686e8 /doc/src | |
| parent | ef58b87df2afe91189e9ffb81b65c1127d53bc88 (diff) | |
| download | postgresql-5cad02452457d7f6f29404411dfe13e6fe8accb7.tar.gz postgresql-5cad02452457d7f6f29404411dfe13e6fe8accb7.zip | |
psql: Reduce compatibility warning
Only warn when connecting to a newer server, since connecting to older
servers works pretty well nowadays. Also update the documentation a
little about current psql/server compatibility expectations.
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/ref/psql-ref.sgml | 26 |
1 files changed, 18 insertions, 8 deletions
diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index 4b5e5274e5a..0675a8e17b1 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -3505,14 +3505,24 @@ PSQL_EDITOR_LINENUMBER_ARG='--line ' </listitem> <listitem> - <para><application>psql</application> is only guaranteed to work smoothly - with servers of the same version. That does not mean other combinations - will fail outright, but subtle and not-so-subtle problems might come - up. Backslash commands are particularly likely to fail if the - server is of a newer version than <application>psql</> itself. However, - backslash commands of the <literal>\d</> family should work with - servers of versions back to 7.4, though not necessarily with servers - newer than <application>psql</> itself. + <para><application>psql</application> works best with servers of the same + or an older major version. Backslash commands are particularly likely + to fail if the server is of a newer version than <application>psql</> + itself. However, backslash commands of the <literal>\d</> family should + work with servers of versions back to 7.4, though not necessarily with + servers newer than <application>psql</> itself. The general + functionality of running SQL commands and displaying query results + should also work with servers of a newer major version, but this cannot + be guaranteed in all cases. + </para> + <para> + If you want to use <application>psql</application> to connect to several + servers of different major versions, it is recommended that you use the + newest version of <application>psql</application>. Alternatively, you + can keep a copy of <application>psql</application> from each major + version around and be sure to use the version that matches the + respective server. But in practice, this additional complication should + not be necessary. </para> </listitem> |