gnats2mantis v0.6 
28-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 the 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.

***************
* Known lacks *
***************

   * Does not import aliases
   * Does not import classes
   * 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.
   * Only import file in the database. Doesn't work (for now) if you use
   Mantis with FTP or DISK file upload support.
   * Does not import the following bug fields from GNATS : 
      - submitter-id 
      - responsible (responsibles list is not imported either)
      - closed-date
      - class 
      - originator
      - organization
      - environment
   * Does not fill the following bug fields in mantis :
      - resolution (do not exist in GNATS, default = open)
      - reproducibility (do not exist in GNATS, default = always)
      - projection
      - platform 
      - os
      - os version
      - product build
      - ETA

********************
* Bugs/Improvement *
********************

   * MD5 of attachment files should be calculated using a Perl method,
not MySQL, it would reduce queries' sizes and therefore reduce execution
time, import time and max_allowed_packet could be lower.
