• Presentation
• Options
• Feedback

Presentation

The main feature of White Space is to highlight spaces and tabs (which are normally invisible).

When highlighted,

• Spaces are represented by a
• Tabs are represented by a

White Space has also some other useful features:

• Paragraph separators: a paragraph separator is displayed when two blocks of code are separated by at least two empty lines. E.g.

 1:public class BlockHighlight implements TextAreaHighlight
 2:{
 3:    private BlockHighlight() {}
 4:
 5:    
 6:    public void init(JEditTextArea textArea, TextAreaHighlight next) {
 7:        this.textArea = textArea;
 8:        this.next = next;
 9:    }
10:
11:    
12:    ...
13:}

• Fold guides show the different levels of indentations of your code by displaying vertical grey (default) lines
• Fold tooltips are displayed when the beginning of a block is not visible and your mouse cursor is near a fold guide.
• On save actions:
  • Remove trailing whitespaces
  • Tabify/untabify leading whitespaces

The highlighting of spaces, tabs and paragraph separators are independent. Use the following toggle actions to obtain your favorite combination:

• Plugins -> White Space -> Show spaces
• Plugins -> White Space -> Show tabs
• Plugins -> White Space -> Show paragraph separators
• Plugins -> White Space -> Show fold guides
• Plugins -> White Space -> Show fold tooltips

At last, some jEdit actions are related to spaces and tabs handling:

• Edit -> Text -> Spaces To Tabs
• Edit -> Text -> Tabs To Spaces

Options

White Space options are available under: Utilities -> Global Options -> Plugin Options -> White Space.

Display options

• Show spaces by default
• Space color
• Show tabs by default
• Tab color
• Show paragraph separators by default
• Paragraph separators respect indentation
• Paragraph separator color
• Show fold guides by default
• Show fold tooltips by default
• Fold guide color

"On save" options

When chosen, these actions are performed when a buffer is saved:

Remove trailing whitespaces

All trailing tabs and spaces are removed, except those preceded by one of the given escape characters. The default escape character is \ (backslash). E.g.
Sometext:\
will be replaced by
Sometext:\

Tabify leading whitespaces

Leading whitespaces are replaced by a sequence of tabs possibly followed by at most tabSize - 1 spaces (the expanded length of leading whitespaces remains the same).

Untabify leading whitespaces

All tabs are removed from the leading whitespaces and replaced by an equivalent number of spaces (the expanded length of leading whitespaces remains the same)

Feedback

The preferred way to send bug reports or feature requests is to use the jEdit Bug Tracker at http://sourceforge.net/bugs/?group_id=588.
You can also write to:

• André Kaplan <akaplan@users.sourceforge.net>;
• or jEdit-users mailing-list <jedit-users@lists.sourceforge.net>;
• or jEdit-devel mailing.list <jedit-devel@lists.sourceforge.net>.