docs updates

--HG--
branch : beta
extra : amend_source : 2d2b25b00cd3b8a0ff8a46e1aa04f4eb731d2e70

3 files changed, 20 insertions, 4 deletions

diff --git a/docs/setup.rst b/docs/setup.rst
index 4fb970e6..504c8c6c 100755
--- a/docs/setup.rst
+++ b/docs/setup.rst
@@ -689,8 +689,8 @@ Here is a sample excerpt from an Apache Virtual Host configuration file::
    into above configuration
 
 .. note::
-   RhodeCode cannot be runned in multiprocess mode in apache, make sure
-   you don't specify `processes=num` directive in the config
+   Running RhodeCode in multiprocess mode in apache is not supported,
+   make sure you don't specify `processes=num` directive in the config
 
 
 Example wsgi dispatch script::
diff --git a/docs/upgrade.rst b/docs/upgrade.rst
index ea5a1570..12c8c334 100644
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -75,6 +75,14 @@ This will upgrade the schema and update some of the defaults in the database,
 and will always recheck the settings of the application, if there are no new
 options that need to be set.
 
+
+.. note::
+   DB schema upgrade library has some limitations and can sometimes fail if you try to
+   upgrade from older major releases. In such case simply run upgrades sequentially, eg.
+   upgrading from 1.2.X to 1.5.X should be done like that: 1.2.X. > 1.3.X > 1.4.X > 1.5.X
+   You can always specify what version of RhodeCode you want to install for example in pip
+   `pip install RhodeCode==1.3.6`
+
 You may find it helpful to clear out your log file so that new errors are
 readily apparent::
 
diff --git a/docs/usage/general.rst b/docs/usage/general.rst
index 612fd774..ac642791 100644
--- a/docs/usage/general.rst
+++ b/docs/usage/general.rst
@@ -13,7 +13,15 @@ delete a repository from filesystem, it renames it in a special way so it's
 not possible to push,clone or access repository. It's worth a notice that,
 even if someone will be given administrative access to RhodeCode and will
 delete a repository You can easy restore such action by restoring `rm__<date>`
-from the repository name, and internal repository storage (.hg/.git)
+from the repository name, and internal repository storage (.hg/.git). There
+is also a special command for cleaning such archived repos::
+
+    paster cleanup-repos --older-than=30d production.ini
+
+This command will scan for archived repositories that are older than 30d,
+display them and ask if you want to delete them (there's a --dont-ask flag also)
+If you host big amount of repositories with forks that are constantly deleted
+it's recommended that you run such command via crontab.
 
 Follow current branch in file view
 ----------------------------------
@@ -31,7 +39,7 @@ Checkboxes in compare view allow users to view combined compare view. You can
 only show the range between the first and last checkbox (no cherry pick).
 Clicking more than one checkbox will activate a link in top saying
 `Show selected changes <from-rev> -> <to-rev>` clicking this will bring
-compare view
+compare view. In this view also it's possible to switch to combined compare.
 
 Compare view is also available from the journal on pushes having more than
 one changeset