GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
GPICKER(1) FreeBSD General Commands Manual GPICKER(1)

gpicker - fast (file)name chooser

gpicker [options] directory-path

This manual page documents briefly the gpicker program.

gpicker is a gtk+ program that allows you to quickly and conveniently pick file in a (possibly very large) project. You type significant letters of file name (typically from the start of words) and gpicker provides you with a list of files you most likely mean to pick. The program filters and orders project's list of files in real-time as you type. It prints selected item (or items in multi-select mode) on standard output.

You can use also gpicker to filter & sort arbitrary list of names by piping that list of names to it's stdin and passing '-' instead of path.

gpicker has a concept of project type which allows it to skip files that are ignored by project's version control system. Default project type invokes find to gather list of files. You can change find command line via GPICKER_FIND environment variable.

gpicker is typically used from programmer's editors or IDEs. VIM and Emacs integration is included in gpicker package. See gpicker.el and gpicker.vim correspondingly. There's also NetBeans plugin at http://github.com/avsej/gpicker-netbeans and gedit plugin at http://github.com/yltsrc/gedit-gpicker

gpicker can be used from other programs as well. http://github.com/alk/supermegadoc uses gpicker to pick names from documentation system index.

This program follows the usual GNU command line syntax. A summary of options is included below.
-h, --help
Show help options and quit
--version
show version
-t, --project-type
respect ignored files for given kind of VCS (default, git, bzr, hg, guess, script). mlocate project type is used for loading file list from mlocate database.

Type script will use .gpicker-script script located in project dir to read all relevant filenames. Script must separate entries with zero character. It will be run with project directory as current directory and should normally output relative path. Not however that gpicker doesn't care if items output from script are files and do exist.

Type guess will try to guess project type based on presence of directories and files (such as .gpicker-script or .git ).

--disable-bzr
disable autodetection of Bazaar project type
--disable-hg
disable autodetection of Mercurial project type
-n, --name-separator
Set separator of filenames from stdin (\0 is default). Interprets \0 as zero byte, \n as new line, \r as carriage return, \t as tab character.
-d, --dir-separator
Sets separator of directory names from stdin (/ is default). Interprets \0 as zero byte, \n as new line, \r as carriage return, \t as tab character.
--eat-prefix
eat this prefix from names (./ is default)
-m, --multiselect
enable multiselect
-l, --left-align
left align gpicker entries (default is right-align)
-p, --print-pattern
print pattern if nothing matched
-S, --dont-sort
dont sort result list
-i, --init-filter
initial filter value
--load-stdin-too
read additional filenames from stdin
-I, --output-index
print selection index instead of value (implies -S)
--display=DISPLAY
X display to use

The gpicker is distributed under the GPLv3 license. See COPYING file that comes with it. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3.

gpicker-simple(1)

The README file that comes with gpicker.

The gpicker was written by Aliaksey Kandratsenka <alk@tut.by> with useful input and patches from folks in Ruby department of Altoros Systems, Inc. http://www.altoros.com/ruby_on_rails.html
January 2, 2010

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.