Package Torello.JavaDoc.SyntaxHiLite

This does syntax hiliting. This is a work in progress.

For many years - READ: 2019 - 2024 - much of the Torello.JavaDoc project seemed (at least to me) like a cute little subsidiary of the larger http://pygments.org Umbrella Web-Site. The Python-Tool pygmentize continues to be the sole provider of all that is HTML Syntax-HiLiting that's done inside of the Java-Doc Upgrader Tool. To me, it has always done a reasonable job. I do notice minor "mistakes" here and there, every once in a while, but it is a very powerful too that can hilited just about anything you shove at it.

There is a "proprietay" (READ: I'm did start one!) Syntax HiLiter that I began. It isn't going to be difficult to writer Hi-Liter's for HTML, Java & CSS. I spent a week or 2 on the native hiliting code that is here, but is a big "To Do". I need, probably, another 2 weeks to finish it! The only catch is, I have so many other things to work on, and the Pygments stuff has worked so exceptionally well for such a long time, that writing my own is literally at the very bottom of my priorities stack.

Furthermore, no matter how hard I work, I'll never EVER devote time to writing a Hi-Liter for languages other than HTML, CSS or Java. I have parser inside this JAR Library that will make Hi-Liting those language easy. I do not have anything in my library for parsing Java-Script or SQL, and for that reason alone, I don't think there will ever be a native, "non-stub based" Syntax Hi-Liter for anything that isn't Java, HTML or CSS.

Anyway, the Pygmentize class works really well for me. I've tried to document it as best as I can. There is more stuff I have to add to the documentation, but it is going to have to wait until my other priorities are completed. In order to run the Pygmentize class, the Python based Tool must be in your class path. Just ask Chat-GPT for help on downloading 'pygmentize' and installing it, if you do not know how to do so.