DragonFly On-Line Manual Pages

xps(1)                 DragonFly General Commands Manual                xps(1)

NAME
       xps - eXquisite Port Seeker

SYNOPSIS
       xps [options] terms

DESCRIPTION
       xps is a tool that searches the ports INDEX file and prints all ports
       whose names contain the given terms and match the specified criterias.

       The default mode prints a line for each port found. The brackets in the
       beginning of each line show the port's status:

       'i'    the port is installed

       'u'    the port is installed and can be updated

EXAMPLES
       Show all ports whose names contain 'firefox' and print verbose
       descriptions:

              xps -v firefox

       Show all ports in category 'devel' with exact name 'python'.

              xps -e -c devel python

       Show all ports whose names contain 'glib' and are installed:

              xps -i yes glib

       Show all ports maintained by <author> in category <category>:

              xps -m <author> -c <category>

       Show all ports that contain 'pdf' in thier short description:

              xps -D pdf

       Show ports whose name starts with 'gnome':

              xps -E '^gnome'

OPTIONS
       -c <category>
              Show ports only from this category.

       -e     Exact match. Show only ports that their name is an exact match
              of the given term.

       -i yes/no
              Show only installed/non-installed ports.

       -u yes/no
              Show ports that are installed and can/cannot be updated.

       -m <maintainer>
              Show only ports maintained by <maintainer>.

       -v     Show verbose descriptions.

       -E <regex>
              Show ports that thier name matches given regular expression.

       -D <string>
              Show ports whose short description contain given string.

       -DE <regex>
              Show ports whose short description match given regular
              expression.

       -s     Print port statistics and exit.

       --version
              Show program version and exit.

BUGS
       * The code that matches installed packages with indexed ports needs a
       lot of work, expect bugs in this area.

       * xps is broken in systems migrated to pkgng. Expect this to be solved
       in a newer version.

AUTHOR
       Antonios Anastasiadis (anastasiadis@datalive.gr)

0.5.2                          04 December 2008                         xps(1)