- README documentation updated

git-svn-id: http://piwigo.org/svn/trunk@673 68402e56-0260-453c-a942-63ccdbb3a9ee

2 files changed, 106 insertions, 26 deletions

diff --git a/doc/README_en.txt b/doc/README_en.txt
index c14caa909..c949389b7 100644
--- a/doc/README_en.txt
+++ b/doc/README_en.txt
@@ -1,20 +1,44 @@
                                PhpWebGallery
-                          http://phpwebgallery.net
-                       http://forum.phpwebgallery.net
+
+official website   : http://phpwebgallery.net
+documentation      : http://doc.phpwebgallery.net
+forum              : http://forum.phpwebgallery.net
 
 +-----------------------------------------------------------------------------+
 |                        Installation instructions                            |
 +-----------------------------------------------------------------------------+
 
 1. extract files from the downloaded file (using tar or unzip command, or
-   softwares like powerarchiver or winzip)
+   softwares like 7-zip or winzip)
 
 2. place de source files on your website in the directory of your choice
    ("gallery" for example)
 
-3. go to the URL http://your.domain/gallery/install.php
+3. go to the URL http://your.domain/gallery/install.php and follow the
+   instructions of installation
+
++-----------------------------------------------------------------------------+
+|                           Upgrade instructions                              |
++-----------------------------------------------------------------------------+
+
+1. elements to save :
+
+ - file "include/mysql.inc.php"
+ - directory "galleries"
+ - your database (create a dump, using PhpMyAdmin for instance)
+
+2. delete all files and directories of your previous installation (but not
+   the previous listed elements)
+
+3. extract files from the downloaded file (using tar or unzip command, or
+   softwares like 7-zip or winzip)
 
-4. follow the instructions of installation
+4. upload all the new version files to your website but the previous listed
+   elements. The only elements coming from the previous installed version
+   are the elements listed above.
+
+5. go to the URL http://your.domain/gallery/upgrade.php and follow the
+   instructions
 
 +-----------------------------------------------------------------------------+
 |                               Newsletter                                    |
@@ -22,16 +46,31 @@
 
 It is *highly* recommended to subscribe to PhpWebGallery newsletter. This is
 extremely low-traffic, but will provide you with announcements of new
-PhpWebGallery releases and serious bug notification. You can subscribe at
-this URL :
+PhpWebGallery releases and serious bug notification. You will find available
+mailing lists at this URL :
 
-         http://www.phpwebgallery.net/eng/index.php?rub=newsletter
+                 https://gna.org/mail/?group=phpwebgallery
 
-Being myself very disturbed because of spam, be sure that the mail address
-you are going to give for newsletter is completely unreadable by someone
-else than PhpWebGallery team and not present on any web page (a web search
-engine won't find it).
+Be sure that the mail address you are going to give for newsletter is
+completely unreadable by someone else than PhpWebGallery team and not
+present on any web page (a web search engine won't find it).
 
 PhpWebGallery also assure you that your mail address will NEVER be used for
-something else than PhpWebGallery newsletter.
+something else than PhpWebGallery informations.
+
++-----------------------------------------------------------------------------+
+|                             Discussion forum                                |
++-----------------------------------------------------------------------------+
+
+A forum is available and recommended for any question (installation, bug
+reports, new feature requests) :
+
+                     http://forum.phpwebgallery.net
+
+Before asking any question on the forum, do not hesitate to search for
+related topics... other users may have found same bugs, had same requests.
 
+PhpWebGallery forum is a place open to every one. Please be always
+respectful in this place. Consider also that clear messages (with simple and
+direct subjects) are always prefered. It is forbidden (and useless) to say
+that your question is "urgent", you won't be answered in priority.
diff --git a/doc/README_fr.txt b/doc/README_fr.txt
index a748c0d37..3e4bec528 100644
--- a/doc/README_fr.txt
+++ b/doc/README_fr.txt
@@ -1,10 +1,12 @@
                                PhpWebGallery
-                          http://phpwebgallery.net
-                       http://forum.phpwebgallery.net
 
--------------------------------------------------------------------------------
---               Instructions d'installation de PhpWebGallery                --
--------------------------------------------------------------------------------
+site officel   : http://phpwebgallery.net
+documentation  : http://doc.phpwebgallery.net
+forum          : http://forum.phpwebgallery.net
+
++-----------------------------------------------------------------------------+
+|                              installation                                   |
++-----------------------------------------------------------------------------+
 
 1. décompresser à l'aide de winzip par exemple (winrar, winace et beaucoup
    d'autres le permettent également) le fichier téléchargé.
@@ -12,21 +14,43 @@
 2. placer les fichiers décompressés sur votre serveur web dans le répertoire
    de votre choix ("galerie" par exemple)
 
-3. aller à l'URL http://votre.domaine/galerie/install.php
+3. se rendre à l'URL http://votre.domaine/galerie/install.php et suivre les
+   instructions
+
++-----------------------------------------------------------------------------+
+|                               mise à jour                                   |
++-----------------------------------------------------------------------------+
+
+1. éléments à sauvegarder :
+
+ - fichier "include/mysql.inc.php"
+ - répertoire "galleries"
+ - votre base de données (en créant un dump, avec PhpMyAdmin par exemple)
+
+2. supprimer tous les fichiers et répertoires de la précédente installation
+   (sauf les éléments listés ci-dessus)
+
+3. décompresser à l'aide de winzip par exemple (winrar, winace et beaucoup
+   d'autres le permettent également) le fichier téléchargé.
 
-4. suivre les instructions d'installation
+4. placer tous les fichiers de la nouvelle version sur votre site web sauf
+   pour les élements listés ci-dessus. Les seuls éléments venant de la
+   précédente installation sont ceux listés ci-dessus.
 
--------------------------------------------------------------------------------
---                               Newsletter                                  --
--------------------------------------------------------------------------------
+5. se rendre à l'URL http://votre.domaine/galerie/upgrade.php et suivre les
+   instructions
+
++-----------------------------------------------------------------------------+
+|                               newsletter                                    |
++-----------------------------------------------------------------------------+
 
 Il est *fortement* recommandé de souscrire à la newsletter de
 PhpWebGallery. Très peu de mails sont envoyés, mais les informations sont
 importantes : nouvelles versions de l'application, notification de bugs
-importants (relatifs à la sécurité). Vous pouvez souscrire à cette
-newsletter en vous rendant sur la page suivante :
+importants (relatifs à la sécurité). Vous trouverez les listes de
+discussions disponibles sur la page suivante :
 
-         http://www.phpwebgallery.net/fre/index.php?rub=newsletter
+         https://gna.org/mail/?group=phpwebgallery
 
 Etant moi-même très dérangé par le spam (courrier non solicité), je peux
 vous assurer que le mail que vous allez donner à l'équipe de PhpWebGallery
@@ -37,3 +61,20 @@ un moteur de recherche).
 L'équipe de PhpWebGallery vous assure également que JAMAIS l'adresse qui
 nous a été confiée ne sera utilisée dans un autre cadre que la newsletter de
 PhpWebGallery.
+
++-----------------------------------------------------------------------------+
+|                            forum de discussion                              |
++-----------------------------------------------------------------------------+
+
+Un forum est disponible et recommandé pour toutes vos questions
+(installation, rapport de bugs, demandes de nouvelles fonctionnalités) :
+
+                     http://forum.phpwebgallery.net
+
+Avant le poser une question, assurez-vous qu'elle n'a pas déjà sa réponse en
+effectuant une recherche.
+
+Le forum est ouvert à tous. Merci d'y faire preuve de respect. Rappelez-vous
+que les messages clairs (avec un sujet direct et un énoncé du problème
+précis) sont toujours préférés. Il est interdit (et surtout inutile) de dire
+que votre question est "urgente", on ne vous répondra pas en priorité.