README

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

Based on Tk NotePad 0.5.0 by Joseph Acosta
and "textedit.tcl" by Eric Foster-Johnson

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


WISH Supernotepad 2009 is a fairly simple, moderately powerful text and HTML editor with a stripped-down, "Notepad-like" menu interface and mini-toolbar. It is designed to be totally accessible to the ordinary computer user, while incorporating some features not often found in simple programs written for ordinary users. WISH Supernotepad 2009 requires Tcl and Tk 8.5 (or greater, when there is an even greater version).

In addition to standard text and HTML editing functions (including file insertion, quick list and table creation in HTML, and more), WISH Supernotepad 2009 can perform the following functions, among others:

* Single-click HTML display in browser of your choice
* "Supercut, Supercopy, Superpaste": selection, retention, and insertion of multiple text blocks
* Quick search through large numbers of previously invoked filenames and previously selected text blocks
* Individual or global search and replace of single or multiple expressions; single-expression search and replace can use simple wild-card substitutes as well as "AND" and "OR" connectors.
* Single-click insertion of special characters (e.g.,    ) in text and HTML
* Color selection and insertion of hexadecimal color codes into text or HTML
* Tcl/Tk program code creation (with automatic indentation), editing, and instant test-running
* Unlimited undo and redo
* Printing with word wrap and specified margin width (on Unix-type systems only)
* Conversion of plain text to simple HTML
* Line number identification and word count
* Display of "Save?" indicator on title bar when unsaved text exists


To install the program, if you're running Puppy Linux, just open ROX-Filer, click the icon for the "supernotepad-2009.pet" package, and follow the instructions. If you're not running Puppy Linux:

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

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


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 "./supernotepad_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 that says the same thing near the top of the "./usr/local/bin/supernotepad" 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, enter "supernotepad &" (without the quotes) to open it blank, or "supernotepad <insert name of file you want to view> &" to open it with a file already displayed. It's been reported to work on Windows too, except for the printing and Palm Doc conversion.


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

David McClamrock <mcclamrock@locl.net>
November 2008

