File Shell v0.7
---------------

File Shell is a purposely minimalistic file manager which
lets you browse directories, copy, move, delete and execute
files and some other things. You will need Tcl 7.6/tk 4.2
or later.

It is invoked by typing "fs [dir1] [dir2]".

"dir1" and "dir2" are names of optional startup directories
to use for the two windows in File Shell. If not supplied,
the default will be the current working directory for both
windows.

-----------------------------------------------------------------

You may specify a desired starting size for the windows by 
setting options in your .Xresources or .Xdefaults, whichever 
you may be using. Below is the syntax:

FileShell.lwidth: <width>
FileShell.lheight: <height>

The width represents characters/line.
The height setting is somewhat obscure, due to the internal
geometry management of tk. It represents the number of lines
in each window times 2 minus 1 ;).
So, if you want each window to show 8 lines, the height value
will be 8*2-1 = 15.

Of course you can change a lot of other stuff if you like.
If you for example want to set the background color to
something other than the default, just put a line like the
one below in your .Xresources/.Xdefaults:

FileShell*background: pink

-----------------------------------------------------------------

If a file ".fs.ext" exists in your home directory, it
will be used to map filename patterns to commands to invoke
for files matching that pattern. It has a simple format:

<pattern><whitespace><command [options]>

Any blank lines or lines starting with '#' are ignored.
Look at the enclosed "fs.ext" for an example.

-----------------------------------------------------------------

File Shell is mainly keyboard-driven. The mouse has only effect
when marking selections.

The commands in File Shell are as follows:


<Tab>		Move between windows.

<Home>		Move to the first entry.

<End>		Move to the last entry.

<Insert>	Expand the selection.

<+>		Set a selection filter.

</>		Go to the root directory (/).

<$>		Go to your home directory.

<=>		Make the active window show the same
		directory as the other one.

<a-z>		Go to the filename whose first character
		matches the key entered.

<Alt-f>		Set a filter for which files to show.
		Directories are always shown ;)

<Alt-r>		Refresh the current window.

<Alt-i>		Get extended information on the selected
		entry.

<Alt-x>		Invoke an xterm.

<Return>	If the selected entry is executable, run it,
		else if it is a directory, change to it,
		else if it matches any pattern in .fshell.ext,
		invoke the command for it using the entry as 
		its filename, else view it with less.

<F3>		View the selected entry with less.

<F4>		Edit the selected entry with vi.

<F5>		Copy the selected entry to a new file in the 
		current directory.

<Ctrl-F5>	Copy the selected entry/entries to the other
		window's directory.

<F6>		Rename the selected entry/entries.

<Ctrl-F6>	Move the selected entry/entries to the other
		window's directory.

<F7>		Create a new directory.

<F8>		Delete the selected entry/entries.

<q>		Quit File Shell.


------------------------------------------------------------------


That's it folks :)
If there's any problem, give me a note.

Mats Petersson

E-mail: mats.petersson@mbox301.swipnet.se
