# HG changeset patch
# User Denis Laxalde <denis.laxalde@logilab.fr>
# Date 1380545339 -7200
# Node ID e7c94121ce9d5cbb792c881e3690d19f2f9fec9d
# Parent  4c37808fd284ef872212b6e4eb5ae1ea27285ed7
[book] Improve PostgreSQL configuration section

* Do not advice for specific PostgreSQL version (point to meta-packages if
  available in Linux distros);
* First mention packages from Linux distros, put the link to official postgres
  documentation at the end;

Closes #2725302.

diff -r 4c37808fd284 -r e7c94121ce9d doc/book/en/admin/config.rst
--- a/doc/book/en/admin/config.rst	Tue Oct 08 14:02:28 2013 +0200
+++ b/doc/book/en/admin/config.rst	Mon Sep 30 14:48:59 2013 +0200
@@ -57,19 +57,28 @@
 PostgreSQL
 ~~~~~~~~~~
 
-For installation, please refer to the `PostgreSQL project online documentation`_.
-
-.. _`PostgreSQL project online documentation`: http://www.postgresql.org/
+Many Linux distributions ship with the appropriate PostgreSQL packages.
+Basically, you need to install the following packages:
 
-You need to install the three following packages: `postgresql-8.X`,
-`postgresql-client-8.X`, and `postgresql-plpython-8.X`. If you run postgres
-version prior to 8.3, you'll also need the `postgresql-contrib-8.X` package for
-full-text search extension.
+* `postgresql` and `postgresql-client`, which will pull the respective
+  versioned packages (e.g. `postgresql-9.1` and `postgresql-client-9.1`) and,
+  optionally,
+* a `postgresql-plpython-X.Y` package with a version corresponding to that of
+  the aforementioned packages (e.g. `postgresql-plpython-9.1`).
+
+If you run postgres version prior to 8.3, you'll also need the
+`postgresql-contrib-8.X` package for full-text search extension.
 
 If you run postgres on another host than the |cubicweb| repository, you should
 install the `postgresql-client` package on the |cubicweb| host, and others on the
 database host.
 
+For extra details concerning installation, please refer to the `PostgreSQL
+project online documentation`_.
+
+.. _`PostgreSQL project online documentation`: http://www.postgresql.org/docs
+
+
 Database cluster
 ++++++++++++++++