e93 version 1.2r7 (X Windows version)
10/17/1996

Todd Squires
Core Technologies
270 Ambria Drive
Mundelein, Il 60060
(squirest@wwa.com)

What is e93?
---- -- ---

e93 is a portable window based text editor oriented to the needs of
programmers. It was begun in 1993 (thus the name). It uses the mouse,
selections, cut/copy/paste, and closely follows the model of editors
on the Macintosh and NeXT platforms.

e93 is portable to environments other than Unix/X Windows -- as long as
those environments support virtual memory.

e93 supports columnar selection. It achieves this by allowing multiple
pieces of the text to be selected simultaneously (this is perhaps its
most unique feature).

e93 imposes no limits on the line length, file length, or number of
simultaneous files which it can edit.

e93 is able to handle all 8-bit binary codes without complaint, or
confusion.

e93 is highly configurable without recompiling because scripts which
control the editor can be written in Tcl.


To Install
-- -------

Please read "LICENSE.TXT" if you agree with it, follow
the instructions given in the file "INSTALL."


What's the deal with those version numbers?
------ --- ---- ---- ----- ------- --------

The version numbers in e93 work as follows:

e93 1.2r7X means:

Major version: 1    If it is ever rewritten, this will increment, and the
                    numbers below will be reset to 0.
Minor version: 2    If really significant changes are made, this will increment.
Revision:      7    Any change will cause this will increment.
Machine:       X    X windows implementation.


Additional Information
---------- -----------

The material README.regex is taken from The GNU Emacs Manual, 9th edition.
Copyright 1985, 1986, 1987, 1993 Free Software Foundation, Inc.
and from the GNU regex library version 0.11.
Copyright 1992 Free Software Foundation, Inc.

The Free Software Foundation gives permission for the use of this
material in e93, with different distribution terms from those stated
in the Emacs manual, because e93 is free software, and thus worthy
of cooperation.


Bugs
----

Please send all bug reports to squirest@wwa.com. (Todd Squires)


Changes Since 1.2r6
------- ----- -----

The fallback font list (fonts e93 looks for when it cannot locate the
one it really wants) has been changed. This was done to make e93
behave better on machines that do not have b&h fonts.

Opening and closing of e93's menus has been made slightly more
efficient. This was done to make it faster with some window managers
(like fvwm) which tend to behave very slowly when e93 changes the size
of its menu window.

The open and save dialogs have been changed slightly to make them
more friendly.

The startup procedure which reads the .e93rc file has been improved to
handle some error cases in a more friendly way.

4 new Tcl commands have been added:

	buffervariables
	setbuffervariable
	unsetbuffervariable
	getbuffervariable

These allow variables to be created which are local to any given buffer.
This will make it much easier for Tcl scripts to hang information off
of a buffer, and reference it later.

Finally, .e93rc has been changed in the following way:

Checks were added to see if the modification time of a file has
changed while the file was being edited. (Warning you that another
application did something to the file).

Capitalization of function names has been standardized.

The open selection command has been improved to handle globbing, and
selecting the cursor line to open if no selections exist.

Open Clipboard was added to the Edit/Clipboards menu.

Changes Since 1.2r5
------- ----- -----

Some minor cleanup to code calling Tcl.

Some bugs related to reporting errors at inopportune times were
located and removed. These usually showed themselves during very low
memory conditions.

Double click timer is now reset in the file dialog boxes. Clicking
rapidly on the file list now works as expected.

The initial delay before repeated scrolling/paging with scroll bars
has been lengthened slightly.

The allowable delay between consecutively typed characters in list
boxes has been lengthened slightly.

A bug in the menu code was removed. The bug was caused by clicking
multiple mouse buttons at the same time while tracking menu items.

The directory dialog has been modified to show only directories.
Previously it also showed files.

Color handling has been altered so that named colors are now
recognized. Previous to this, all colors had to be specified as 6 hex
digits RRGGBB. Now, if a machine supports color names, e93 will also
accept them.

.e93rc was modified:
	Strip EOL Whitespace and line termination functions were added.
	Align Left was added.
	"About" was slightly modified.
	Color names were added.
	Line Wrap functions were added.

Characters with diacritical marks such as umlauts and other special
characters which are contained in the upper half of the character set
will now be displayed properly by e93. Previously, any character above
0x7F would have been displayed as its hexidecimal equivalent. e93 will
now use the character contained in the current font (as long as it is
not of 0 width, in which case, it will display the hex equivalent as
before).

Two new relative cursor movement modes have been defined:
STARTPARAGRAPH and ENDPARAGRAPH which will move the cursor to the
start or end of a paragraph. These modes can be used with the
following commands:

movecursor
delete
expandselection
reduceselection


Changes Since 1.1r4
------- ----- -----

.e93rc was modified:
	Mark, Directory and C menus were added. Some more cleanup.
	Views menu became Windows menu. Printing menus were added.

All dialogs were modified to handle error conditions more
consistently.

The Ok dialog was modified to wrap text instead of drawing it off the
edge.

Open/save file dialogs were modified to handle more cases. Also a "/"
was added after all items in the dialogs which point to directories.

A new Path selection dialog was written, and a Tcl command
(pathdialog) was added.

Menus were modified so that you do not have to hold the mouse button
down while making menu selections. You can now click on the various
submenus one at a time to make a selection. This is more consistent
with most window managers, and easier to use.

Text routines were sped up by adding a cache mechanism that allows e93
to locate positions in the text more quickly. The speed increase
should be especially noticeable when editing large files (>1MB).
Assuming you have enough virtual memory, e93 should now be able to
edit very large (<2GB) files without a noticeable slow down.

When treating replacement text as a Tcl script, 10 new variables (in
addition to $found) are available if the search string was a selection
expression: $0 - $9 are now set to the \0 through \9 matches of the
selection expression.

A bug that caused a rare memory leak related to search and replace was
found and fixed.

A bug in realpath2 that caused extra '/' characters to appear in its
output was fixed.

The clipboard interface with X windows has changed. Previously, e93
used the clipboard mechanism to import/export to the X windows
environment. However, most X windows applications do not use the
clipboard. Instead, they use the X selection mechanism. Users
complained that they could not easily communicate with programs that
used only the selection mechanism (most programs). So, e93 now does
the following to support communication with other X applications:
Whenever text is copied into e93's current clipboard, e93 takes
ownership of the current selection. If another application does a
"paste selection" (many use the middle mouse button for this) while
e93 owns the selection, the application will get the text in e93's
current clipboard. Conversely, If another application owns the current
selection, attempts to paste from the current clipboard within e93
will cause it to copy the selected text from the current selection
owner into the current clipboard before pasting. This all seems
somewhat convoluted, but since e93 supports multiple selections
simultaneously across multiple windows, and X does not, this is the
best solution I can currently offer.

The editor startup scheme was modified so that it looks for the .e93rc
file in your home directory first, but if it is not found, it will now
also look through the path given by $PATH in its environment. As soon
as it locates a .e93rc file that it can open, it will execute it and
stop looking. A Tcl global variable SCRIPTPATH is set to the path of
the script that is executed.

The font selection dialog was written. It is better than what it
replaces (a dialog that made you type in the font you wanted) but it
still could use some work.

Changes Since 1.0r3
------- ----- -----

The increment of the minor version number (1.0->1.1) indicates lots
of changes.

.e93rc was modified:
	Some new functions added, some old ones cleaned up slightly. The
	"unknown" function was modified so that if it launches a task that
	wants input from stdin, it will get an EOF, instead of hanging
	e93.

README.e93 was written, as a first cut at a manual. Read it, if you
have suggestions, let me know. There is a lot more to do in this
arena, but I hate writing documentation, so this is it for a while.

A proper open/save file dialog was written. It is kind of different.
Let me know how you like it.

There is also a new listdialog function which allows choices from a
Tcl list. This dialog was used to implement the new "Windows..." menu
function.

Dialog management has changed significantly.

Color handling was improved, so the editor should not just quit if it
cannot get colors at startup. The new behavior is to just get either
black, or white depending on which color is closer to the one asked
for.

Tasks are now hung off of buffers, instead of windows as they were
previously. This allows for tasks to be running in buffers which do
not have associated windows.

EOF can now be sent to a task by closing the input pipe.

Task error handling has been improved.

A speed governor was installed on all scrolling items so you folks
with screaming fast machines will not have things scrolling so fast as
to be annoying. This should not slow down slow machines.

LOTS of minor source code changes.

Changes Since 1.0r2
------- ----- -----

.e93rc was modified:
	Some defaults were made easier to change.
	Error reporting during file save functions was improved.
	Menu names were made more consistent.
	Some features were added to the "Misc" menu.

The call to the library function "realpath" in xgui/misc.c was
replaced by a call to a new internal routine "realpath2" which does
the same thing. This was done for those machines that do not include
"realpath" in their libraries.

Changes Since 1.0r1
------- ----- -----

xgui/includes.h was modified to include <sys/time.h> because some
machines require it.

Two bugs in keybind.c were found and corrected.

Error reporting at init time was enhanced so that users would know if
e93 failed to start up because of a lack of available colors.

Startup script execution has been changed so that the editor will not
startup if it cannot locate the startup script.

The default .e93rc was slightly modified to change the colors of some
windows.

guidefs.h was modified to get rid of an array of 0 length that
offended some compilers.

Changes Since 1.0r0
------- ----- -----

The makefile was altered to get rid of -L$(LIB) in the link line which
was causing trouble.

killpg in xgui/tasks.c was modified to kill(-pid...) because some
systems do not have killpg.

xgui/events.c was modified to make sigaction a little more portable.

The clipboard is now imported when the editor starts.

A new Tcl command called "version" was added to allow users to find
out which version of the editor they are using.
