README

WISH Binary Viewer 2009
by David McClamrock <mcclamrock@locl.net>

Inspired by "A Little Hex Editor Widget"
by George Peter Staplin

Available for download at "Pa Penguin's Icebox"
<http://www.geocities.com/pa_mcclamrock>


WISH Binary Viewer 2009 is an ultra-light, super-simple binary file viewer. It can open and display a file in any combination of hexadecimal codes, binary codes, decimal codes, and text content (ASCII or ISO Latin-1). There are simple copy, search, and save functions too.

To install the program, if you're running Puppy Linux and you have the .PET package for this program, simply open ROX-Filer, click on the package icon, and follow the directions you'll get to install it as a downloaded program. Otherwise:

1. Running as root, change directory (cd) to the directory containing the .tar.gz package, and unpack it into a new "wishbinvu-2009" directory by running this command: tar -zxvf ./wishbinvu-2009.tar.gz .

2. Change directory to the "wishbinvu-2009" directory and run this command: ./wishbinvu_install.tcl . As well as installing the program and related files, this will automatically create an uninstallation script (.wishbinvu_uninstall.tcl) that you can run from the same directory if you ever wish to uninstall WISH Binary Viewer.

By default, files will be installed under the /usr/local directory as follows.
/usr/local/bin : program script and any other executable files
/usr/local/doc/wishes : documentation and license
/usr/local/lib/wishes : all other files

If you don't like /usr/local, just do this:

1. Edit the line near the top of the "./wishbinvu_install.tcl" file, where it says "set topdir /usr/local" -- change "/usr/local" to the top-level directory you want.

2. Do the same to the line near the top of the "./usr/local/bin/wishbinvu" program file. (You have to do both, or the program won't find all the files it needs!)

To run the program from the Linux/Unix command line, just enter "wishbinvu &" (without the quotes).

If you try this program out, please let me know if you (1) like it, (2) find any bugs, or (3) both!


David McClamrock <mcclamrock@locl.net>
November 2008

