This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 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: 1) Added ability to also use the Syntax::Highlight::Engine::Kate highlighing engine and thus now supporting the many, many languages it supports. 2) Tk::Text::SuperText - like bracket highlighting / matching with vi-like jump-to-matching bracket (Ctrl-p). 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. 4) Fixed TextUndo-related bug to allow user to see text as he types past right-edge of screen. 5) Added "setRule()" method to allow altering of individual rules by the programmer. 6) Modified right-click menu to allow saving of modified rules. 7) 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 #8 and behaves as original CodeText. 8) Fixed small bug w/auto-indenting. 9) Fixed small bug w/rules-initialization when no .rules file present. 10) Created a "Readonly" version called ROTextHighlight that works the same way but is based on Tk::ROText and is read-only. The highlight mechanism however, is of a plugin-type. Adding additional languages should be a matter of writing Tk::TextHighlight::MyLanguage modules. 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. 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. 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. Not that you didn't know, but you install it like this: perl Makefile.PL make make test and then as root make install This software comes with no warranty whatsoever. Original CodeText: February 2003, Hans Jeuken (haje@toneel.demon.nl) TextHighlight: August 2007 turnerjw784@yahoo.com