Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GPICKER(1)		     General Commands Manual		      GPICKER(1)

NAME
     gpicker - fast (file)name chooser

SYNOPSIS
     gpicker [options] directory-path

DESCRIPTION
     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 or-
     ders 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  in-
     vokes  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/su-
     permegadoc uses gpicker to pick names from documentation system index.

OPTIONS
     This program follows the usual GNU command line syntax. A	summary  of  op-
     tions 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 di-
	    rectory  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 di-
	    rectories 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).  Inter-
	    prets \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

LICENSE
     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 Pub-
     lic License can be found in /usr/share/common-licenses/GPL-3.

SEE ALSO
     gpicker-simple(1)

     The README file that comes with gpicker.

AUTHOR
     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		      GPICKER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gpicker&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help