tkquerypr

." $Id: tkquerypr.1,v 1.3 1993/11/16 22:19:43 jason Exp $

NAME
tkquerypr - X Window query interface to the GNATS problem report database

SYNOPSIS
tkquerypr

DESCRIPTION
tkquerypr is an X Window query interface to the GNATS problem report database. It allows you:

    - Query the GNATS database

    - Edit items returned from a query.

    - Print items returned from a query.

    - Print a summary report of all items returned from a query

USER INTERFACE
tkquerypr Has four sections arranged from top to bottom. They are:

    - A message bar.

    - The query specification section.

    - The query list menubar

    - The query list output box
    The message bar

    The message bar is at the top of the tkquerypr window. The left half is a message button that spins when a query is in process. Right half is a message widget that prints out various status messages generated by tkquerypr. Clicking on the mesage button will read the current selection and try to retrieve the PR included in the selection. A common use of this button is to cut a PR number out of a mail item and query for it with the working button.
    The query list output box

    The query list output box is at the bottom of the tkquerypr window. It is a scrolling list that contains the output of any query initiated by the query list menubar. Double clicking on a list entry will bring up the configured editor (see tkconfig.cf.t) for that PR. The default editor is the tkeditpr.

    The <Right> and <Left> Keys scroll the listbox left and right to left and right halves of the listbox. <Control-l> and <Control-r> performs the same operations for you touch typists out there.
    The query list menu bar box

    The query list menu bar is used to initiate queries and to perform various operations on lists already generated. What follows is a description of each pull down menu available on the menu bar

        The folder menuTO BE DONE...

        The print menu TO BE DONE...

        The query menu TO BE DONE...

        The selection menu TO BE DONE...
    The Query Specification section

    This section allows the user to define what should be returned by a query performed in the menu bar section. It is subdivided into three parts. The first part of this section is comprised of rows of check buttons. Each Row corresponds to an enumerated field in GNATS PR. Each button in a row describes one of the possible values for the PR field. If you turn on a check button if forms an or clause for that particular PR field. Take the State: checkbutton row for example. If you click on the analyzed and feedback buttons and then execute the query-->perform_query menu item you will get back all PR's in the database that have a State of analyzed or feedback. The second part of this section contains a pair of listboxes that are used to select what Categories to select. The left listbox contains all available unselected categories. The right listbox contains what categories are currently selected. LeftButton Clicking on any item in either of the boxes moves the item from it's current place in one listbox to the end of the other listbox. Note: Tkquerypr ignores categories that start with an underscore '_'. This is so you can have have categories that are hidden from TkGnats if you desire. The third part is some text entry fields. The Responsible: field allows you to define a list of values the query should be restricted to in terms of the GNATS Responsible field. For example, if you type mh,andy into this field then only queries that have mh OR andy in the Responsible field will be returned.
        The Synopsis: field allows you to define a list of values the query should be restricted to in terms of the GNATS Synopsis field. the text expected is a comma seperated list if csh pattern matching strings.
        For example, if you type *sun*,*sparc* into this field then only entries that have sun AND sparc somewhere in the Synopsis field will be returned.

REQUIREMENTS
Tkquerypr assumes the following programs are present somewhere within the users search $PATH.

    (g)tbl - For producing PostScript format printed reports

    (g)roff - For producing PostScript format printed reports

    query-pr - For querying the GNATS database with

    tkeditpr - tkgnats PR editor

    tkviewpr - tkgnats PR viewer

    msgDialog - tkgnats utility display information dialogs

Many of these required programs can be redefined to something functionally similar by editing the tkgnats.cf.t configuration file that is part of the tkgnats release.

SEE ALSO
gnats(l), query-pr(l), The GNATS info file

BUGS
No doubt they exist. You can send mail to the author if you have a bug to report

TODO

Allow user to define their own report processing

Finish the save_query facility

Allow the user to define how queries are sorted

AUTHOR
Mike Hoegeman

CORRESPONDENCE
Email can be sent to the author at the following address.

mh@wx.gtegsc.com