[book] Improve PostgreSQL configuration section
authorDenis Laxalde <denis.laxalde@logilab.fr>
Mon, 30 Sep 2013 14:48:59 +0200
changeset 9285 e7c94121ce9d
parent 9284 4c37808fd284
child 9286 02a491f6fa92
[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.
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
 ++++++++++++++++