tkgnats 4.0-alpha1 vs. 3.0.18

[Keith McDuffee]

I'm in the process of finally upgrading our extensive gnats bug database from 
the ancient 3.2 format to 3.999.2.  So far it has seemed pretty trivial as far 
as converting the index file and being able to submit queries through gnatsd 
using gnatsweb, but then again I really just started.

In the process of the conversion, we first "upgraded" to gnats version 3.113.1 and were 
able to use tkgnats and gnatsweb right away.  The problem came when we then upgraded to 3.999.2.  
When using tkgnats, we started to get errors on our queries that stated we had 16 fields in our 
database, when tkgnats was expecting 19 fields.  In comparing version 3.0.18 of tkgnats (that comes 
with gnats 3.113.1) with 4.0-alpha1 (with gnats 3.999.2), we found the following line differing in 
the tkquerypr.tcl file (note the "set len #" line):


# diff -C 10 src/gnats-3.113.1/contrig/tkgnats/tkquerypr.tcl 
src/gnats-3.999.2/contrib/tkgnats/tkquerypr.tcl

--- snip ---
*** 1418,1438 ****
                     "Have the GNATS administrator check the index file for bogus 
entries."
           continue
       }
         
       #
       # XXX TBD BUG XXX there is a problemo here if the synopsis
       # has a '|' character in it..
       #
       set l    [split $ln "|"]
       set llen [llength $l]
!         set len  16
         if {$TkGnats(ReleaseBased)} {
             incr len 3
         }
       if {$llen != $len} {
             Msg "tkquerypr: Line $ln has $llen fields. It should have $len 
fields.\n" \
                     "Have the GNATS administrator check the index file for 
bogus entries. (Especially fo
r |'s in any of the text fields)"
           continue
       }
 
         if {$Query(query_mode) == "sql2"} {
--- 1334,1354 ----
                     "Have the GNATS administrator check the index file for bogus 
entries."
           continue
       }
         
       #
       # XXX TBD BUG XXX there is a problemo here if the synopsis
       # has a '|' character in it..
       #
       set l    [split $ln "|"]
       set llen [llength $l]
!         set len  19
         if {$TkGnats(ReleaseBased)} {
             incr len 3
         }
       if {$llen != $len} {
             Msg "tkquerypr: Line $ln has $llen fields. It should have $len 
fields.\n" \
                     "Have the GNATS administrator check the index file for 
bogus entries. (Especially fo
r |'s in any of the text fields)"
           continue
       }
 
         if {$Query(query_mode) == "sql2"} {
--- snip ---

In order to get rid of the error we were seeing, we changed the "19" to "16", 
and tkgnats worked.  So my question is, what are the 16 fields required in 3.113.1 (and below) and 
the 19 fields in 3.999.2?  Also, what does one do if they happen to add/subtract a field from the 
default installation of gnats 3.999.2?  Do you actually have to resort to editing the tkquerypr.tcl 
file?  That just doesn't seem right to me.

I noted that in the included TECHNOTES file for gnats 3.999.2, they specify:

o TkGnats(ReleaseBased) 
       
   - set automatically in tkpr_library.tcl (get_gnats_config / check_release_based)
   - used throughout to determine if the Keywords field is used

In our current database, we are not using the Keywords field.  Are we to take 
that this line means we *have* to have the Keywords field if we're running 
gnats 3.999.2?

We're mainly concerned that we may be breaking something by changing the 
default # of fields from 19 to 16.

Thanks for any help,

Keith