yapo(8)                                                                yapo(8)

       yapo - Yet Another Ports Overview


       yapo  is  a  small  ncurses application which lists the ports currently
       available for the CRUX Linux distribution in a comprehensive, scrolling

       A  second  window  with  all  meta-information  about  the current port
       (including the contents of the README and  pre/post-install  files,  if
       they exists) is easily accessible from the main list view.

       A  filter  function  is provided to facilitate searching for a specific
       port or a list of ports. Only ports matching the filter will be  listed
       when  it  is  in  use.  A filter is a regular expression applied to the
       concatenation of all list fields. These fields are:

       · Name of the port
       · Installation flag (yes, no, diff)
       · Description of the port
       · Path/Collection of the port
       · Maintainer of the port
       · Packager of the port

       yapo can be used to install/update/remove ports as well.

       External functions, used by yapo, can be configured in  the  configura-
       tion file /usr/etc/yapo.conf which is well documented.

       yapo  is  written  in  ruby  and  makes use of the ncurses-ruby wrapper
       library. It is built on top of Johannes Winkelmann's prt-get utility.

       Navigation through the list window is possible with  the  usual  cursor
       keys, the left/right cursor keys scrolling horizontally and the up/down
       keys scrolling vertically. Within any input prompt the  cursor  up/down
       keys can be used to scroll through the global readline history.

       q      Exits the program.

       space  Toggles between list view and meta-information view.

       g or / Moves  the  cursor  to  the  first  record  matching the entered

       f      Applies a filter to the view. Use a regular expression for this;
              e.g.  the  filter '^[ab]' will show only ports with names in the
              range a..b; the filter 'diff '  limits  the  view  to  installed
              ports  with versions different than those available in the ports

       F      Applies a flag filter to the view. Use a regular expression  for
              this.   This  regex  isn't  build with the main ports window, as
              with the key f, but with the flags shown on the  statusline.   A
              filter 'ir' will show all installed ports with a README, 'd' all
              different ports, for example.  See the statusline section  below
              for more information about the available flags.

       d      Limits the view to ports the currently selected port depends on.
              This function make use of 'prt-get depends <port>', thus  direct
              and indirect dependencies will be shown.

       D      Limits the view to ports which depends on the currently selected
              one.   This  function  make  use  of  'prt-get  dependent  --all

       s      Change  the  sort  order of the list. All visible columns can be
              used as sort keys. Default order is the name of the port.  Sort-
              ing  is  not possible in one of the dependency views. Valid keys

              · 1  Name of the port
              · 2  Installation flag
              · 3  Description of the port
              · 4  Path/Collection of the ports
              · 5  Maintainer of the ports
              · 6  Packager of the port

       a      Show all available ports, removing filter or dependency  delimi-

       i      Installs  the  currently  selected  port  using 'prt-get install
              <port>' or 'prt-get  update  <port>'  if  the  port  is  already

       I      Installs  the currently selected port with all it's dependencies
              using 'prt-get depinst --install-scripts <port>'.

       m      Removes the currently selected port using 'pkgrm <port>'.

       r      Rereads the ports data from disk.

       :      Runs an  arbitrary  shell  command.  The  working  directory  is
              changed to the directory of the currently selected port. A empty
              response opens a sub-shell. Type exit to return to yapo.

       ?      Simple help function, shows the yapo man-page.

       Below a list of function key, which are defined  in  the  default  yapo
       configuration  file /usr/etc/yapo.conf.  See there how to map arbitrary
       commands to function keys.

       F2     Lists version mismatches between the installed packages and  the
              ports  tree  using  'prt-get diff'. This is an example of how to
              run external programs from within yapo. Feel free to  add  addi-
              tional functions to the source code.

       F3     Updates the ports tree using 'ports -u'

       F5     Lists the Pkgfile of the currently selected port using less

       F6     Lists the .footprint of the currently selected port using less

       F7     List  all  files in the directory of the currently selected port
              using 'prt-get ls <port>'.

       The Statusline at the bottom of the screen is  divided  into  5  fields
       which gives some information about:
       · current sort order
       · applied filter or the name of the port in dependency mode
       · name of the currently selected port
       · install/readme/{pre,post}install flags
       · current port number and the sum of all visible ports


       prt-get(8), ports(8), pkgmk(8), pkgadd(8)

       Jürgen Daubert <juergen.daubert@t-online.de>

yapo 0.3.0                       Jan 10, 2006                          yapo(8)