ncurses dialog for Kindle Touch
====================================================
Dialog version: 1.1-20120706 http://invisible-island.net/dialog/
Compiled for Kindle Touch by Fvek from mobileread.com: 1.0.2

----------------------------------------------------
WHAT IS THIS:
----------------------------------------------------
Wikipedia: "Dialog is an application used in shell scripts which displays text user interface widgets. It uses the curses or ncurses library. The latter provides users with the ability to use a mouse, e.g., in an xterm."

This version is compiled for use on the Kindle Touch (for which there's an xterm port available). It may well work for other ARM based things, but I haven't tried.

Because the Touch is touch-based, I've altered the way dialog's file selector (--fselect & --dselect) works. Touching a file name or directory will now make it the active selection, not just highlighted. No need to hit the space key anymore, just tap the file and tap OK.

I've also inverted the mono display colors so the dialog window is now black print on white background, as this looks better on epaper.

Included are the altered source files fselect.c and util.c. The rest of the source is available at the dialog site (http://invisible-island.net/dialog/)

----------------------------------------------------
INSTALLATION:
----------------------------------------------------
The root of your Kindle's USB drive (what you see when you plug it into your computer) is actually located at "/mnt/us/" inside the Kindle's filesystem. Assume they are the same below for brevity...

1) Create a folder called "bin" in /mnt/us. If it's already there, good.

2) Copy the files "dialog" and ".dialogrc" into it.

----------------------------------------------------
UNINSTALL:
----------------------------------------------------
Just remove the stuff you added.

----------------------------------------------------
USING IT:
----------------------------------------------------
I'm not going over general use. Google it. Kindle specific details only...

You have to explicitly state the .dialogrc path in your script as the Kindle's system partition is read only. Just add the following line before invoking it:

	export DIALOGRC=/mnt/us/bin/.dialogrc

You should also add /mnt/us/bin/ to your PATH in the script that starts xterm, if it isn't there already. Add this before the last two lines in /mnt/us/extensions/xterm/bin/xterm.sh:

	export PATH=$PATH:/mnt/us/bin

The included .dialogrc file just sets it to black and white mode. Color can sometimes do ugly things with the epaper display. You can experiment with the settings to find what you like best.

----------------------------------------------------
CHANGES:
----------------------------------------------------
1.0.0 - first release - adds touch select behavior
1.0.1 - inverted mono colors, forgot to include altered source files
1.0.2 - fixed seg fault if blank area of file/dir list tapped