Archive for the ‘Uncategorized’ Category

RSyntaxTextArea 1.5.0 Released!

Monday, March 7th, 2011

Just a belated note that RSyntaxTextArea 1.5.0 was released a little bit ago on SourceForge.  Updates to the AutoComplete library are included as well, not to mention a (still Subversion-access only) new, 0.7-release of RSTALanguageSupport.  Download ‘em today!

Some highlights of the improvements include:

There are a couple of very minor things that might spur a 1.5.1 release pretty quickly, but this is a worthy upgrade from 1.4.x in and of itself.

Expect a new RText release pretty soon to showcase all of these new features!

“TokenMakerMaker” – Easy creation of custom syntax highlighters for RSTA

Saturday, August 22nd, 2009

I’ve gotten several requests asking for the ability to add syntax highlighting for custom languages to RSyntaxTextArea.  Because of the way it is designed, RSTA doesn’t lend itself well to this type of thing.  Creating a highlighter that just read through a properties file (or XML) and highlighted stuff via regular expressions would probably not perform well enough for most people.  But the learning curve for how to hack at JFlex-generated output so that RSTA is happy with it is also rather high.

So I’m working on a new tool, called, for lack of a better name, “TokenMakerMaker” (name suggestions are welcome!).  RSTA has uses a TokenMaker class to know how to highlight for a given language, such as Perl or Java.  TokenMakerMaker is a GUI program that allows you to enter the specifications for your language – keywords, comment delimiters, data types, etc.  It can take that input and generate the JFlex input file for your TokenMaker, as well as the actual Java source for your TokenMaker (it’s hooked into JFlex).  Further, if you’re running TokenMakerMaker with a JDK, as opposed to a JRE, it can compile the Java source generated and allow you to test it out in an RSyntaxTextArea instance, at design time!

This tool is nice because the generated scanners will be extremely fast (optimized by JFlex).  In fact, they should be every bit as fast as the scanners that come built into RSTA.  The key will be making the UI give as many options as possible so that what a generated scanner can do isn’t too rigid.

To test it out, I’m using it to generate a (simplified) TokenMaker for Java.  How is it looking so far?  Well…

Here’s a screenshot of the panel allowing you to define the comment delimiters:

Defining the comment delimiters for Java in TMM

Defining the comment delimiters for Java in TMM

And the panel allowing you to define the data types:

Defining the data types for Java

Defining the data types for Java

And here’s the testing window you get after clicking “Generate”:

Testing our generated Java TokenMaker scanner

Testing our generated Java TokenMaker scanner

It’s still early on but I hope to have a few people test it out soon.  Here’s what’s left to be done:

  1. Flesh out the UI
  2. Add panel for defining standard library functions
  3. Add more configurability for Strings (escapes allowed or not, etc.)
  4. Allow saving TokenMaker definition to XML.  Create batch tool to generate .flex/.java directly from XML to facilitate automation of the process

If you’d like to try this tool out early and provide feedback, let me know!

RSTA SpellChecker Add-on

Wednesday, July 29th, 2009

Due to popular request, I’ve started working on a simple spell checker add-on for RSyntaxTextArea.  The work has been pretty straightforward so far, and there is already even a project in SVN for it.  The add-on will be a small jar you put on your classpath, and with a couple of calls you can hook it into any RSyntaxTextArea instance.

It’ll spell-check comments in source code, or the entire file if you are editing plain text.  Spelling errors are squiggle-underlined with the color of your choice, and tooltips are available offering any spelling suggestions.  Here’s a teaser screenshot:

SpellChecker Add-on Preview

The actual spell checking functionality is handled by Jazzy, an open-source spell checking engine for Java.  Luckily Jazzy is LGPL just like RSyntaxTextArea, and so that’s also the license this add-on will be released under.

If you download the preview from SVN, please keep in mind that it should be considered an alpha release.  I already have some more changes I’ve yet to push, and the API may change slightly before being officially released.  But feel free to play with it and offer suggestions!  It probably doesn’t work with the 1.3.4 release of RSTA, it probably requires the latest in the trunk for that project as well.

Regular Expression Content Assist in RText

Wednesday, June 17th, 2009

I’ve finally gotten around to adding regular expression content assist (aka AutoCompletion) to the RText search dialogs.  This of course takes advantage of the AutoComplete library I’ve blogged about previously. There was a sticky issue with window focus, but I’ve managed to fix that up.

The functionality is similar to that found in Eclipse. When the “Regular Expressions” checkbox is checked, a little light bulb icon is displayed beside the “Find” or “Replace” text fields whenever they are focused. This means you can hit Ctrl+Space and get a list of regex constructs available at the current caret position:

Regex Content Assist

Regex Content Assist

In other news, AutoComplete has been improved to better support right-to-left languages, such as Arabic. It detects if the text component it’s installed on has an RTL ComponentOrientation; if it does, the completion popup and optional description window will also be RTL.

Improved Mark Occurrences Behavior

Sunday, April 26th, 2009

Commit 97 in SVN improved Mark Occurrences support behavior in RSyntaxTextArea. Previously, there were two issues with it that were kind of annoying:

  1. The Mark Occurrences highlights were always painted “on top of” the selection. This was because of how Swing highlighting support is implemented – highlights are always painted from most-recently added to least-recently added. Since text selection is actually a highlight, if you selected text after say some occurrences of a variable were marked in the document, the variable occurrences’ highlights get painted on top of the selection’s highlight.
  2. When typing characters at the end of a Mark Occurrences highlight, those chars got “absorbed” into the highlight. Again, this is because of Swing’s highlight implementation. All Highlights have this behavior in Swing.

These issues are fairly simple to work around, but require writing a little more code (much of which unfortunately has to be duplicated from Swing classes, since the Swing text package is keen on keeping useful things package private).

This change will be in 1.3.3, which will hopefully be released soon.

AutoCompletion site now up

Saturday, January 17th, 2009

AutoCompletion has enough features now where I’d really like other people to start trying out.  So I’ve added a little space for it on fifesoft.com describing what it is and (soon) how to use it. There’s a nice WebStart example there of an editor for C with code completion for the C standard library.  The Javadoc is up as well. All that is needed now is a couple of examples to get people started.

I also can’t decide if AutoComplete warrants its own SourceForge project, or if it can just be a subproject of RSyntaxTextArea. While the library can be used on any JTextComponent, auto-completion is usually used in IDE’s and programmer’s editors, and AutoComplete does come with special hooks to work better with RSTA. On the other hand, being a separate project may allow it to be discovered and used by a larger audience. Decisions, decisions…

Function Parameter Assistance

Monday, January 12th, 2009

Newly added to the AutoComplete library is parameter assistance… I’m not sure what you should actually call this feature, but it’s the one where typing a ( character causes a little tooltip to pop up describing the parameters for the function you’re entering:

param_complete1

Parameters are entered with default values. You can use tab and shift+tab to navigate through the parameters (ala Eclipse or NetBeans). The parameter you’re entering (separated by commas, for example) is highlighted in bold in the tooltip, and (if available), a short description of the currently active parameter is displayed.

This feature is configurable, just like the other autocomplete options, and can be turned off if you don’t have time to enter descriptive information about everything available to auto-complete.

I plan on making a very early release available on SourceForge this week. I’m interested in getting as much feedback as possible! As far as I know, RSTA and the AutoComplete library is the simplest way to get easy and powerful IDE-style features into Swing applications.

A minor update to RSyntaxTextArea will also be released, fixing a couple of minor bugs that have been reported by users.

More Autocompletion progress

Tuesday, December 23rd, 2008

There’s been more autocompletion progress. It’s been mostly dirty work (making the API flexible, etc.), but there have been some cool new features added as well. First off, the rendering of autocompletion choices is now completely configurable, using standard ListCellRenderers. There will be a standard renderer that will try to nice things up a little for standard procedural and OO languages. Also, the completion and description windows are now resizable! This is a big usability improvement.

Here’s an updated screenshot of how things are looking now:

Autocompletion preview 2

Autocompletion preview 2