yapo(8) yapo(8) NAME yapo - Yet Another Ports Overview SYNOPSIS yapo DESCRIPTION yapo is a small ncurses application which lists the ports currently available for the CRUX Linux distribution in a comprehensive, scrolling window. 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. USAGE 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 string. 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 tree. 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 <port>'. 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 are: · 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- tation. i Installs the currently selected port using 'prt-get install <port>' or 'prt-get update <port>' if the port is already installed. 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. FUNCTION KEYS 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>'. STATUSLINE 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 FILES /usr/etc/yapo.conf SEE ALSO prt-get(8), ports(8), pkgmk(8), pkgadd(8) AUTHOR Jürgen Daubert <juergen.daubert@t-online.de> yapo 0.3.0 Jan 10, 2006 yapo(8)