[PATCH 6 of 6] docs: upgrade: misc. clarification on upgrade from 0.3.x to 0.4

[Thomas De Schampheleire]

# HG changeset patch
# User Thomas De Schampheleire <thomas.de_schampheleire at nokia.com>
# Date 1546031500 -3600
#      Fri Dec 28 22:11:40 2018 +0100
# Node ID 049c4b45dc0dbb0a013612d42cd2825a8b3d81ef
# Parent  39dc6a4916af3d6f1b5e559e64749c79bbc55c32
docs: upgrade: misc. clarification on upgrade from 0.3.x to 0.4

diff --git a/docs/upgrade.rst b/docs/upgrade.rst
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -55,7 +55,8 @@ If using MySQL, please consult the docum
 utility.
 
 Look for ``sqlalchemy.url`` in your configuration file to determine
-database type, settings, location, etc.
+database type, settings, location, etc. If you were running Kallithea 0.3.x or
+older, this was ``sqlalchemy.db1.url``.
 
 
 3. Activate the Kallithea virtual environment (if any)
@@ -101,7 +102,8 @@ Run the following command to create a ne
 
     kallithea-cli config-create new.ini
 
-Then compare it with your old config file and see what changed.
+Then compare it with your old config file and copy over the required
+configuration values from the old to the new file.
 
 .. note::
     Please always make sure your ``.ini`` files are up to date. Errors
@@ -197,6 +199,11 @@ 9. Start the Kallithea web application
 This step once again depends entirely on the web server software used to
 serve Kallithea.
 
+If you were running Kallithea 0.3.x or older and were using ``paster serve
+my.ini`` before, then the corresponding command in Kallithea 0.4 and later is::
+
+    gearbox serve -c new.ini
+
 Before starting the new version of Kallithea, you may find it helpful to
 clear out your log file so that new errors are readily apparent.