.TH SEL 1 "FEBRUARY 2001"
.UC 4

.SH NAME
sel \- Fullscreen file-selection and execution tool

.SH SYNOPSIS
.B sel
[
.I options
]
[
.I File-list
]

.SH DESCRIPTION
sel displays a listing of files like a file-manager. You can move around
using the arrow-keys and run a command given on the command-line on the
selected file with the <RETURN> - key. If you've installed the terminfo-
library delivered with ncurses, sel will use colors.

.SH OPTIONS
Short Options can be combined and strings like -aflq are allowed. An option
that requires an argument has to be the last option in the string and the
argument must follow (-aflqm "*.c"). Available command line options are the
following:

.TP
-a
Ask before executing a command

.TP
-b headline
Text-string to display as headline. This might be useful when you use sel
as file-selector in a shell-script to tell the user what to do. Use inverted
commas, for example -b "Choose filename".

.TP
-c command
Command to execute. '%' will be replaced by selected entry. You will need
to set this command into "" if it consists of more than one word, e.g.
"ls -l"

.TP
-C Filename-Substitutor (default is "%")

.TP
-d path
Start directory

.TP
-f
Use complete (absolute) filename with full path in executed commands

.TP
-h
Display some help about availiable commandline-options

.TP
-l
Long file-listing with uid, gid, size, date and permissions

.TP
-m mask
Filemask to limit the display to a certain group of files. For example,
-m "*.c" displays only your c-sources. Don't forget the inverted commas
("") to protect the mask from the shell!

.TP
-t type
File-type filter-string. Combinations such as -t fdl are allowed. The
following filetypes are availiable:
.RS

.IP f
regular file
.IP d
directory
.IP l
symbolic link
.IP b
block device
.IP c
character device
.IP p
named pipe (FIFO)
.IP s
socket
.RE

.TP
-w
Wait after executing a command

.TP
-s
Blank screen before executing a command

.TP
-q
Quit after executing a command

.TP
-u
Update directory after executing a command

.TP
--no-tagging
Don't allow tagging of files

.TP
--no-command-entry
Don't allow changing the command to be executed

.TP
--color-status_fg color-value
Set foreground-color of statusline. See list of availiable color-values below.

.TP
--color-status_bg color-value
Set background-color of statusline. See list of availiable color-values below.

.TP
--color-pointer-fg color-value
Set foreground-color of pointer. See list of availiable color-values below.

.TP
--color-pointer-bg color-value
Set background-color of pointer. See list of availiable color-values below.

.TP
--color-backgnd-fg color-value
Set background-color of file-list. See list of availiable color-values below.

.TP
--color-backgnd-bg color-value
Set foreground-color of file-list. See list of availiable color-values below.

.TP
--color-msg-fg color-value
Set foreground-color of warnings. See list of availiable color-values below.

.TP
--color-msg-bg color-value
Set background-color of warnings. See list of availiable color-values below.

.TP
--color-backgnd-tag-fg color-value
Set foreground-color of tagged file. See list of availiable color-values below.

.TP
--color-backgnd-tag-bg color-value
Set background-color of tagged file. See list of availiable color-values below.

.TP
--color-pointer-tag-fg color-value
Set foreground-color of tagged pointer. See list of availiable color-values below.

.TP
--color-pointer-tag-bg color-value
Set background-color of tagged pointer. See list of availiable color-values below.

.TP
Availiable color-values are:

.RS
.IP black
.IP red
.IP green
.IP yellow
.IP blue
.IP magenta
.IP cyan
.IP white
.RE

.SH KEYBOARD COMMANDS
While running sel, you can use the following keyboard-commands. When there
is listed more than one keystroke, you can choose one of them.
.NF

.TP
Enter
Select an entry and execute command. If selected entry is a directory, cd there

.TP
Blank
Select an entry and execute command. Don't cd to directories but execute
command on it

.TP
+
Tag marked file

.TP
-
Untag marked file

.TP
*
Select all files

.TP
#
Unselect all files

.TP
!
Invert Selection

.TP
x
Run command on tagged files (file by file)

.TP
X
Run command on tagged files (all in a single run)

.TP
c
Enter a new command

.TP
C
Enter a new character as filename-substitution (default %)

.TP
Left
cd ..

.TP
Right
cd to selected directory, no reaction on selected files

.TP
Up p
One up (previous entry)

.TP
PageUp P
One page up (previous page)

.TP
Down n
One down (next entry)

.TP
PageDown N
One page down (next page)

.TP
t
Jump to the top

.TP
b
Jump to the bottom

.TP
d
Go back to start-directory

.TP
r
Return to last directory

.TP
R
Change to root-directory

.TP
H ~
Go to your home-directory

.TP
U
Update current directory immediately

.TP
/
Find file (Simple Substring search)

.TP
a
Toggle ask before executing a command (Default off)

.TP
l
Toggle long/short listing (Default short)

.TP
Q
Toggle exit after executing a command (Default off)

.TP
s
Toggle blank screen before executing a command (Default off)

.TP
u
Toggle update directory after executing a command (Default off)

.TP
w
Toggle wait after executing a command (Default off)

.TP
h
Show help

.TP
?
Display current settings

.TP
q
Exit sel

.SH RETURN CODES
.TP
0
Ok, executed the given command

.TP
1
Ok, leaving without having executed the command (hit q)

.TP
10
Ooops, internal error

.TP
11
Terminal error

.TP
20
Commandline-error

.TP
30
Error initializing signal-handler

.SH AUTHOR
.NF
Thomas Kluge <thomas@darkstar.rhein-neckar.de>
.PP
Web-Site: http://www.rhein-neckar.de/~darkstar/
.FI

.SH BUGS
.NF
That's alpha-software, so be warned that there may still be bugs. Be sure
to have it tested carefully before you use it to submit "dangerous" commands
like rm, mv, chmod etc. If you find a bug, please report it to
<thomas@darkstar.rhein-neckar.de> as i'll try to fix it immediately.
.FI

.SH COPYRIGHT
.NF
Copyright 1997, 1998 by Thomas Kluge.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.FI