
Upgrading From Previous Version of GNATS (QuickStart)
=====================================================

   The GNATS index changed in release 3.106 and again in release
   3.107.  The following steps will help update you. They assume that
   your GNATS_ROOT is /usr/local/share/gnats/gnats-db and you've built
   the sources in /usr/local/src/gnats/gnats-3.107-beta. Change for
   own own situation.

   Run these steps logged in as the GNATS_USER!!!

   From any prior version of GNATS prior to 3.106 (even the ancient
   3.2) to GNATS 3.107:

        $ cd /usr/local/share/gnats
        $ cp -pR gnats-db gnats-db.BACKUP
        $ cd gnats-db/gnats-adm
        $ /usr/local/src/gnats/gnats-3.107-beta/gnats/gen-closed-date --test
        $ /usr/local/src/gnats/gnats-3.107-beta/gnats/gen-closed-date
        $ gen-index > index

   From GNATS 3.106 to GNATS 3.107:

        $ cd /usr/local/share/gnats/gnats-db/gnats-adm
        $ mv index index-3.106
        $ gen-index > index


"gen-closed-date" for upgrading from versions prior to gnats-3.106
==================================================================

   - run gen-closed-date logged in as the GNATS_USER!!!
   - adds Closed-Date field for all existing PRs, with time set for PRs 
     with a State that is of type "closed".
   - changes the Audit-Trail from "oldstate-newstate" to "oldstate->newstate".
   - it restores the original PR file timestamp after each PR is rewritten.
   - run with "--test" arg to see what it will do without actually making
     any updates.

   Running make will build this program but it doesn't get installed because
   you should only need to run it once. Running it repeatedly does no harm.
   You may decide after running it once that you want the "suspended" state to
   be type "closed". Just update the states file and rerun gen-closed-date.
