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 let-
       ters of file name (typically from the start of words) and gpicker  pro-
       vides  you  with	a list of files	you most likely	mean to	pick. The pro-
       gram 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 stan-
       dard 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 doc-
       umentation system index.

OPTIONS
       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).	Inter-
	      prets \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  re-
	      turn, \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	 Public	  License   can	  be  found  in	 /usr/share/common-li-
       censes/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 use-
       ful 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.0>

home | help