[doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
--- a/doc/book/en/B0011-schema-stdlib.en.txt Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/B0011-schema-stdlib.en.txt Mon Mar 30 19:38:25 2009 -0700
@@ -34,8 +34,8 @@
(The first 'E' in some of the names is the first letter of 'Erudi',
`CubicWeb`'s old name; it might be changed/removed some day.)
- Cubes available
- ```````````````
+Cubes available
+```````````````
An application is based on several basic cubes. In the set of available
basic cubes we can find for example :
--- a/doc/book/en/C011-installation.en.txt Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/C011-installation.en.txt Mon Mar 30 19:38:25 2009 -0700
@@ -109,6 +109,11 @@
Postgres configuration
----------------------
+.. note::
+ If you already have an existing cluster and postgres server
+ running you do not require to execute the initilization step
+ of your Postgres database.
+
* First you have to initialize the database Postgres with the command ``initdb``.
::
@@ -125,15 +130,26 @@
$ chown username /path/to/pgsql
-* Create a superuser for `CubicWeb` instance (**root**) ::
-
- createuser -s username
+* Create a superuser for `CubicWeb` instance: ::
+
+ $ su
+ $ su - postgres
+ $ createuser -s username
- Initialize the password of the superuser you just created with
- ``su - postgres`` and ``psql``.
+ Initialize the password of the superuser you just created for your
+ database: ::
+
+ $ su
+ $ su - postgres
+ $ psql
- This password will be asked to you later on where you will create an
- instance with `cubicweb-ctl create`
+ And then execute de following query: ::
+
+ ALTER USER username WITH PASSWORD `password`
+
+ This login/password will be requested when you will create an
+ instance with `cubicweb-ctl create` to initialize the database of
+ your application.
.. [XXX] Est-ce que ces etapes sont vraiment necessaires? sand : lors de l'installation de ma bdd cela n'a pas ete fait et il semble que tout aille bien. Doit etre verifie avec les experts.
--- a/doc/book/en/C012-create-instance.en.txt Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/C012-create-instance.en.txt Mon Mar 30 19:38:25 2009 -0700
@@ -62,6 +62,13 @@
at the time the base is created (import_erschema('MyCube') will
not properly work otherwise).
+.. note::
+ Please note that if you do not wish to use default directory
+ for your cubes library, then you want to use the option
+ --directory to specify where you would like to place
+ the source code of your cube:
+ ``cubicweb-ctl newcube --directory=/path/to/cubes/library cube_name``
+
Instance creation
-----------------