Tk::TextHighlight

<P>This package is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.</P>

<P>Tk::TextHighlight.pm is a modified / derived version of the no longer maintained 
Tk::CodeText module, by Hans Jeuken.  Thank you Hans for doing the hard work in 
creating a really cool module.  CodeText was built on the Tk::TextUndo 
widget with capabilities of syntax highlighting.  Several formats are supported, namely 
Perl, HTML, Javascript, and Bash.  I (Jim Turner), have added several features:</P>

<UL>
<LI>1)  Added ability to also use the Syntax::Highlight::Engine::Kate highlighing 
engine and thus now supporting the many, many languages it supports.

<LI>2)  Tk::Text::SuperText - like bracket highlighting / matching with vi-like 
jump-to-matching bracket (Ctrl-p).

<LI>3)  Added feature to auto-change rules-colors for rules whose color is the same as 
the background color of the widget (to avoid invisible text).  The color is set to 
either black or white depending on the brightness of the background color.

<LI>4)  Fixed TextUndo-related bug to allow user to see text as he types past right-edge 
of screen.

<LI>5)  Added "setRule()" method to allow altering of individual rules by the programmer.

<LI>6)  Modified right-click menu to allow saving of modified rules.

<LI>7)  Added new option:  -indentchar for specifying something other than "\t" for 
indenting and insertion when the [Tab] key is pressed, ie. several spaces.  Default 
is "\t".

<LI>8)  Added new option:  -highlightInBackground.  If set, Tk::TextHighlight will 
do most highlighting/rehighlighting in the background so that most keyboard / mouse 
events are not blocked during highlighting (Experimental).  Default is 0 (off).

<LI>9)  Added new options:  -noRulesMenu (dont show rules-menu in right-click menu), 
-noSyntaxMenu, -noRulesEditMenu, -noSaveRulesMenu to prevent the corresponding items 
from appearing in the right-click menu.  -noPlugInit - disables new feature #9 and 
behaves as original CodeText.

<LI>10) Fixed small bug w/auto-indenting.

<LI>11) Fixed small bug w/rules-initialization when no .rules file present.

<LI>12) Created a "Readonly" version called ROTextHighlight that works the same way but 
is based on Tk::ROText and is read-only.

</UL>

<P>The highlight mechanism however, is of a plugin-type. Adding additional 
languages should be a matter of writing Tk::TextHighlight::MyLanguage modules 
or adding plugins to Kate.</P>

<P>The perl syntax module is based on and requires either 
Syntax::Highlight::Perl or Syntax::Highlight::Perl::Improved.  It will attempt 
to use Perl::Improved first if it is available, failing that, 
Syntax::Highlight::Perl will be used.</P>

<P>The PerlCool module was written by Jim Turner and is derived from the Perl 
syntax module, but uses mustly "cool" colors, ie. blues, greens, violets, etc.
instead of the "warm" colors that the "Perl" syntax module uses.</P>

<P>This is the initial release. It has been written and tested on a
linux machine, though I have used it on some earlier versions on some 
m$-based machines.  Please try it out on those machines and report your 
findings back to me.</P>

<P>Not that you didn't know, but you install it like this:</P>

<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;perl Makefile.PL
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make test
	
<BR><BR>and then as root

<BR><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make install

<P>This software comes with no warranty whatsoever.</P>

<BR>Original CodeText:  February 2003,
<BR>Hans Jeuken (haje@toneel.demon.nl)

<BR><BR>TextHighlight:  August 2007,
<BR>turnerjw784@yahoo.com