== Choosing good keywords for tickets ==

Trac can search the full text of tickets, so adding a keyword that already occurs in another field doesn't help for general searching. If we standardise the use of certain keywords, however, it could make finding certain specific types of ticket much easier. This, then, is a suggested list of keywords that we might like to standardise.

Tickets only applicable to the indicated OS release(s):

  * [query:status=!closed&keywords=~tiger tiger]
  * [query:status=!closed&keywords=~leopard leopard]
  * [query:status=!closed&keywords=~snowleopard snowleopard]
  * [query:status=!closed&keywords=~lion lion]
  * [query:status=!closed&keywords=~mountainlion mountainlion]
  * [query:status=!closed&keywords=~mavericks mavericks]
  * [query:status=!closed&keywords=~yosemite yosemite]
  * [query:status=!closed&keywords=~elcapitan elcapitan]
  * [query:status=!closed&keywords=~elcapitan sierra]

Tickets only applicable when using the indicated `build_arch`:

  * [query:status=!closed&keywords=~i386 i386]
  * [query:status=!closed&keywords=~x86_64 x86_64]
  * [query:status=!closed&keywords=~powerpc powerpc]
  * [query:status=!closed&keywords=~powerpc64 powerpc64]
  * [query:status=!closed&keywords=~LP64 LP64] \\
    The ticket describes a problem caused by the size of variables of type int, long or pointers on a 64-bit arch.

Tickets only applicable with patches:

  * [query:status=!closed&keywords=~haspatch haspatch] \\
    The ticket has a patchfile attached that may be ready to apply.
  * [query:"status=!closed&keywords=~haspatch maintainer" haspatch maintainer] \\
    The ticket has a patchfile attached that was approved or supplied by the port maintainer that may be ready to apply.

Tickets that depend on others:

  * [query:status=!closed&keywords=~upstream upstream] \\
    The problem report was escalated to upstream and is waiting for response or the next release.

The ticket is only applicable when running port in `trace mode` (-t):

  * [query:status=!closed&keywords=~tracemode tracemode]

{{{
#!comment
TODO: find out how to do a query for "leopard" that does NOT also include "snowleopard", for "lion" that does NOT also include "mountainlion", and for "ppc" that does NOT also include "ppc64"
}}}