*** empty log message ***

Author: Richard Jones

doc/admin_guide.txt

@@ -2,7 +2,7 @@
 Administration Guide
 ====================
 
-:Version: $Revision: 1.8 $
+:Version: $Revision: 1.10 $
 
 .. contents::
 
@@ -100,35 +100,34 @@ Software Upgrade
 Always make a backup of your tracker before upgrading software. Steps you may
 take:
 
-1. Ensure that the unit tests run on your system:
+1. Ensure that the unit tests run on your system::
 
     python run_tests.py
 
 2. If you're using an RDBMS backend, make a backup of its contents now.
-3. Copy your tracker home to a new directory.
-
-Now, working in that copied tracker home:
-
-1. Follow the steps in the `upgrading documentation`_ for the new version of
+3. Make a backup of the tracker home itself.
+4. Stop the tracker web and email frontends.
+5. Follow the steps in the `upgrading documentation`_ for the new version of
    the software in the copied.
-2. Test each of the admin tool, web interface and mail gateway using the new
-   version of the software. To do this, invoke the scripts directly in the
-   source directory with::
+6. You may test each of the admin tool, web interface and mail gateway using
+   the new version of the software. To do this, invoke the scripts directly
+   in the source directory with::
 
     PYTHONPATH=. python roundup/scripts/roundup_server.py <normal arguments>
     PYTHONPATH=. python roundup/scripts/roundup_admin.py <normal arguments>
     PYTHONPATH=. python roundup/scripts/roundup_mailgw.py <normal arguments>
 
-Once you're comfortable that the upgrade will work using that copy, you
-should upgrade the live version:
+   Note that on Windows, this would read::
+
+    C:\sources\roundup-0.7.4> SET PYTHONPATH=.
+    C:\sources\roundup-0.7.4> python roundup/scripts/roundup_server.py <normal arguments>
 
-1. Stop the production web and email frontends.
-2. Perform the upgrade steps on the existing tracker directory.
-3. Upgrade the software::
+7. Once you're comfortable that the upgrade will work using that copy, you
+   should the installed software::
 
     python setup.py install
 
-4. Restart your tracker.
+8. Restart your tracker web and email frontends.
 
 If something bad happens, you may reinstate your backup of the tracker and
 reinstall the older version of the sofware using the same install command::