Changes to gnats/doc/gnats.texi

[Yngve Svendsen]

Index: gnats/doc/gnats.texi
diff -c gnats/doc/gnats.texi:1.36 gnats/doc/gnats.texi:1.37
*** gnats/doc/gnats.texi:1.36   Thu Oct 24 07:44:37 2002
--- gnats/doc/gnats.texi        Thu Oct 24 08:39:52 2002
***************
*** 123,131 ****
  @itemize @bullet
  @item
  Chapter 1 @emph{Introducing @sc{gnats}} 
! @*Version 4 complete, except for mention of the Cases, Keywords, Quarter
! and Release Note fields which may or may not make it into final version
! 4.
  
  @item
  Chapter 2 @emph{The @sc{gnats} User Tools}
--- 123,129 ----
  @itemize @bullet
  @item
  Chapter 1 @emph{Introducing @sc{gnats}} 
! @*Version 4 complete.
  
  @item
  Chapter 2 @emph{The @sc{gnats} User Tools}
***************
*** 2132,2137 ****
--- 2130,2181 ----
  }
  @end verbatim
  
+ @anchor{release-based support}
+ @subsubheading Supporting @sc{gnats} ``release-based'' fields
+ 
+ When installing @sc{gnats} version 3.x, it was possible to choose
+ whether to enable three optional fields: @code{Quarter}, @code{Keywords}
+ and @code{Date-Required}.  Default installations had these fields
+ switched off, and installations which had them were called
+ ``release-based''.
+ 
+ The default @file{dbconfig} shipped with @sc{gnats} version 4 or newer
+ does not have these fields, so if you are upgrading from an old
+ release-based system, you need to add the following field definitions to
+ your @file{dbconfig} file:
+ 
+ @verbatim
+ field "Quarter" {
+     description "What quarter does the PR fall into?"
+     text
+     query-default inexact-regexp
+     textsearch
+ }
+ 
+ field "Keywords" {
+     description "Keywords used to index this PR"
+     text
+     query-default inexact-regexp
+     textsearch
+ }
+ 
+ field "Date-Required" {
+     description "Date that the PR must be fixed by"
+     date
+ }
+ @end verbatim
+ 
+ A side note: Pre-release versions of @sc{gnats} 4 also had a field
+ named @code{Cases}.  For those who may need it, here is the field
+ definition of @code{Cases}:
+ 
+ @verbatim
+ field "Cases" {
+     text
+     query-default inexact-regexp
+     textsearch
+ }
+ @end verbatim
  @c ===============================================================
  
  @node Support