gnats2mantis v0.3 
12-04-2006

Scripts to easily switch from GNATS to Mantis. 

***********
* License *
***********

The contents of this file are subject to the General Public License 
Version 2 (the "License"); you may not use this file except in compliance 
with the License. You may obtain a copy of the License at 
http://www.gnu.org/licenses/gpl.html

**************
* Disclaimer *
**************

Software distributed under the License is distributed on an "AS IS" 
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the 
License for the specific language governing rights and limitations under 
the License.

***********
* Credits *
***********

The initial developer of the original code is Colin Pitrat 
(colin.pitrat@gmail.com).

Contributor(s): 

****************
* Instructions *
****************

Usage procedure:
  1) Regenerate the GNATS index file.  It sometimes has inconsistencies,
     and this script relies on it being correct.  Use the GNATS command:
       gen-index --numeric --outfile=$GNATS_DIR/gnats-db/gnats-adm/index
  2) Modify to GNATS database directory in config.pm to fit your needs.
  3) Run list-status.pl to list all the status existing in GNATS
  4) Modify variables in config.pm to fit your needs. Use the result of
     step 3 to fill in the %status variable
  5) Run gnats2mantis.pl and cross your fingers.
  6) If you meet some problems, try to identify it, solve it (either in
     the GNATS database or in the produced SQL file). If you find a bug 
     or add a feature, please mail me to let me know.
  7) Import the SQL file in your Mantis database. 
  8) Check if it's OK in Mantis.

Important notes:
  Some data may be lost during import as all fields of all files are not 
  mapped

Known lacks :
   * Does not import global config (users)
   * Does not import aliases
   * Does not import classes
   * Does not import responsibles
   * Does not import custom states (you should create states you need at 
   step 4 and map them to the right name in %status variable)
   * Does not import submitters
   * Bug numbers are modified so if you used it as references elsewhere,
   it will certainly break it.
   * Does not import the following bug fields : 
      - submitter-id 
      - responsible (responsibles list is not imported either)
      - closed-date
      - class 
      - originator
      - organization
      - environment
   * Only import file in the database. Doesn't work (for now) if you use
   Mantis with FTP or DISK file upload support.
