Differences between revisions 2 and 3
Revision 2 as of 2018-02-27 12:55:36
Size: 2286
Editor: ccts
Comment: this page probably isn't just about syntax but a general help (in particular list of tags is handy)
Revision 3 as of 2018-03-01 02:32:47
Size: 2302
Editor: PaulWise
Comment: add missing words
Deletions are marked like this. Additions are marked like this.
Line 16: Line 16:
This section describes the query syntax supported by the . This section describes the query syntax supported by the search interface.

Help with Debtags search

You can perform searches with Debtags using the search form of its web interface.

For that you will need to know :

The classification of packages is still work in progress, this means you might not find every corresponding software within their categories. You can help us improving it.

Syntax

This section describes the query syntax supported by the search interface. The syntax is the one of Xapian's QueryParser and is designed to be similar to other web based search engines.

Operators

AND: expression AND expression matches documents which are matched by both of the subexpressions.

OR: expression OR expression matches documents which are matched by either of the subexpressions.

NOT: expression NOT expression matches documents which are matched by only the first subexpression. This can also be written as expression AND NOT expression. NOT expression matches documents which don't match the subexpression.

XOR: expression XOR expression matches documents which are matched by one or other of the subexpressions, but not both. XOR is probably a bit esoteric.

Bracketed expressions

You can control the precedence of the boolean operators using brackets. In the query one OR two AND three the AND takes precedence, so this is the same as one OR (two AND three). You can override the precedence using (one OR two) AND three.

The default precedence from highest to lowest is:

  • +, - (equal)
  • AND, NOT (equal)
  • XOR
  • OR
  • '+' and '-'

A group of terms with some marked with + and - will match documents containing all of the + terms, but none of the - terms. Terms not marked with + or - contribute towards the document rankings. You can also use + and - on phrases and on bracketed expressions.

Prefixes

tag:tag matches the Debtags tag by tag name. For example: tag:use::editing.

sec:section matches the Debian package section. For example: sec:mail.