SYNOPSIS

       query-pr
              [ -c category | --category=category ]
              [ -s state | --state=state ]
              [ -r responsible | --responsible=responsible ]
              [ -S submitter | --submitter=submitter ]
              [ -x | --skip-closed ]
              [ -C [yes|no] | --confidential[=yes|no] ]
              [ -e severity | --severity=severity ]
              [ -p priority | --priority=priority ]
              [ -O name | --originator=name ]
              [ -t text | --text=text ]
              [ -m text | --multitext=text ]
              [ -R | --restricted ] [ -E | --entire ]
              [ -F | --full ] [ -q | --summary ] [ -i | --sql ]
              [ -P | --print-path ]
              [ -d directory | --directory=directory ]
              [ -o outfile | --output=outfile ]
              [ -V | --version ]
              [ -h | --help ]
              [ gnats-id ...  ]

DESCRIPTION

       Queries  the  GNATS  database according to options and displays Problem
       Reports on standard output.  If you specify particular PR numbers (with
       the  gnats-id...   arguments),  query-pr  restricts  its search to only
       those PRs.  Using query-pr with the -E or --entire options  displays  a
       summary of every PR in the database.

       All options are connected with a logical AND.  For example,
              query-pr --category=category --responsible=responsible
       only  prints  PRs  which have a >Category: field of category and a >Re-
       sponsible: field of responsible.

OPTIONS

       -c category, --category=category
            Search only for PRs with a >Category: field of category.

       -s state, --state=state
            Search only for PRs with a >State: field of state.

       -x, --skip-closed
            Search only for PRs in states other than closed.

       -r responsible, --responsible=responsible
            Search only for PRs with a >Responsible: field of responsible.

       -S submitter, --submitter=submitter
            Search only for PRs with a >Submitter-Id: field of submitter.

       -C [yes|no], --confidential[=yes|no]
            other  search  option (e.g.  --state), to speed the search.  Using
            -O by itself can be slow with a large database.  You must  enclose
            the name with double-quotes to make sure your shell passes it as a
            single string, and not as separate arguments to query-pr.

       -t text, --text=text
            Search single-line text fields in all PRs for the regular  expres-
            sion text.

       -m text, --multitext=text
            Search  multiple-line  text  fields in all PRs for the regular ex-
            pression text.

       -R, --restricted
            Omit from the search any PR marked >Confidential:  yes.   This  is
            equivalent  to  specifying --confidential=no.  This also disallows
            the use of the options
            --outfile=outfile and --directory=directory.

       -F, --full
            Prints the full Problem Report rather than just a summary.

       -q, --summary
            Give a short summary line for PRs.

       -i, --sql
            Prints data in a format readable by a relational database (see the
            GNATS manual Keeping Track for a full explanation).

       -P, --print-path
            Print the path used to find each PR.

       -d directory, --directory=directory
            Changes the search directory to directory.

       -o outfile, --output=outfile
            Print all output to outfile rather than to the standard output.

       -V, --version
            Prints the version number of query-pr.

       -h, --help
            Prints a brief usage summary.

QUERY BY MAIL

       query-pr  can  also  be accessed by electronic mail, if your version of
       GNATS is configured for this.  To use this feature, simply send mail to
       the  address  query-pr@your-site with command line arguments or options
       in the Subject: line of the mail header.  GNATS replies  to  your  mail
       with  the results of your query.  The default settings for the query-pr
       mail server are shown below; to override the --state parameter, specify
       --state=state  in  the  Subject:  line of the mail header.  You can not

       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

       Permission  is granted to copy and distribute modified versions of this
       manual under the conditions for verbatim copying, provided that the en-
       tire resulting derived work is distributed under the terms of a permis-
       sion notice identical to this one.

       Permission is granted to copy and distribute translations of this manu-
       al  into another language, under the above conditions for modified ver-
       sions, except that this permission notice may be included  in  transla-
       tions approved by the Free Software Foundation instead of in the origi-
       nal English.



GNATS 3.96                       October 1993                      query-pr(1)