Changes to gnats/doc/p-usage.texi

[Yngve Svendsen]

Index: gnats/doc/p-usage.texi
diff -c gnats/doc/p-usage.texi:1.5 gnats/doc/p-usage.texi:1.6
*** gnats/doc/p-usage.texi:1.5  Sun Feb 10 13:27:06 2002
--- gnats/doc/p-usage.texi      Sun Mar 31 11:13:12 2002
***************
*** 267,275 ****
  query-pr [--debug | -D] [--help | -h] [--version | -V]
           [--output @var{file} | -o @var{file}] [--list-databases]
           [--list-fields] [--list-input-fields]
!          [--responsible-address @var{address}] [--field-type @var{type}]
!          [--field-description @var{description}]
!          [--valid-values @var{values}] [--format @var{format} | -f 
@var{format}]
           [--full | -F] [--summary | -q]
           [--database @var{database} | -d @var{database}] [--and | -&]
           [--or | -|] [--expr @var{expr}] [PR Number]
--- 267,279 ----
  query-pr [--debug | -D] [--help | -h] [--version | -V]
           [--output @var{file} | -o @var{file}] [--list-databases]
           [--list-fields] [--list-input-fields]
!          [--responsible-address @var{name}] [--field-type @var{field}]
!          [--field-description @var{field}]
!          [--field-flags @var{field}]
!          [--adm-field @var{field}] [--adm-subfield @var{subfield}]
!          [--adm-key @var{key}]
!          [--valid-values @var{field}]
!          [--format @var{format} | -f @var{format}]
           [--full | -F] [--summary | -q]
           [--database @var{database} | -d @var{database}] [--and | -&]
           [--or | -|] [--expr @var{expr}] [PR Number]
***************
*** 375,387 ****
  would make sense when used in a template or form.
  
  @item --field-type @var{field}
! Returns the data type contained in PR field field.  The current set of
! data types includes @samp{text}, @samp{multitext}, @samp{enum},
! @samp{multienum}, @samp{integer}, @samp{date}, and
! @samp{text-with-regex-qualifier}.
  
  @item --field-description @var{field}
  Returns a human-readable description of the intended purpose of @var{field}.
  
  @item --valid-values @var{field}
  For fields of type @samp{enum}, a list of valid values (one per line) is
--- 379,415 ----
  would make sense when used in a template or form.
  
  @item --field-type @var{field}
! Returns the data type contained in PR field @var{field}.  The current
! set of data types includes @samp{text}, @samp{multitext}, @samp{enum},
! @samp{multienum}, @samp{enumerated-in-file},
! @samp{multi-enumerated-in-file}, @samp{date} and @samp{integer}.
  
  @item --field-description @var{field}
  Returns a human-readable description of the intended purpose of @var{field}.
+ 
+ @item --field-flags @var{field}
+ Returns the flags set for the field in the @file{dbconfig} file
+ associated with the database, such as @code{textsearch} and
+ @code{readonly}.  @xref{Individual field configuration}.
+ 
+ @item --adm-field @var{field}
+ Used together with the @code{--adm-key} option, this returns a record
+ from the administrative file (if any) associated with the field.  For
+ more material on administrative files, see @ref{administrative
+ files,,Enumerated field administrative files}.
+ 
+ @item --adm-subfield @var{subfield}
+ Used together with the @code{--adm-field} and @code{--adm-key} options,
+ this returns the contents of a particular subfield from the record
+ specified by @code{--adm-field} and @code{--adm-key}.  Subfields are
+ treated in @ref{administrative files,,Enumerated field administrative
+ files}.
+ 
+ @item --adm-key @var{key}
+ Used together with @code{--adm-field} to select a record from the
+ administrative file associated with the field specified by
+ @code{--adm-field}.  @xref{administrative
+ files,,Enumerated field administrative files}.
  
  @item --valid-values @var{field}
  For fields of type @samp{enum}, a list of valid values (one per line) is