jEdit

jEdit (http://jedit.org/) is a programmer's text editor written in Java. It's currently my primary text editor. jEdit was written primarily by Slava Pestov.

Customizations/keyboard shortcuts
Color scheme
Plugins
Macro documentation
Macro modifications

Customizations/keyboard shortcuts

Lines

Cd: delete line (or all lines on which there is a selection - to do)
CSd: duplicate line or selection.
CAd: delete to end of line
Cj: join lines (should work with selected lines (if they're contiguous), but doesn't. I may have to write a macro, or send a patch to the jEdit developers)
CSj: format paragraph (CSj because it's sort of the opposite of joining all the lines together - it's separating them into lines of similar length)
Cl: go to line
Cx: cut selection or line (macro) - this replaces normal cut
Cc: copy selection or line (macro) - this replaces normal copy
CA↓: move line down
CA↑: move line up
A→: indent current line
A←: de-indent current line

Files/Buffers

F12: switch to most recent buffer
CF12: show switch buffer plugin
Cs: save file
CSs: save all files
Cn: new buffer
CAn: close buffer
C tab: next dirty buffer

Markers

CF4: add marker
F4: go to next marker
SF4: go to previous marker

Macros

Cmm: record temporary macro
Cms: stop recording (I wish Cmm could do both)
A1: run temporary macro

Search

Cf: find+replace
Cg: find next
CSg: find prev
C/: incremental search
CSf: next char (macro) (like VI's fx)

Program

Cq: quit

Other

Cz: undo
CSz: redo
CSl: lowercase
CSu: uppercase
Cw: toggle word wrap (I wish it would automatically wrap at the screen width, not at 80 (default) chars - update: the next version (4.3) will allow wrapping at screen width)
CAa: insert date

Keyboard shortcuts/features that I expect any editor to have

C→, C←: move forward/back a "word" (though, "word" tends to be defined slightly differently)
END, C-END, HOME, C-HOME: end/beginning of line/document. The Mac doesn't do this
Holding down shift when moving the cursor should select
Ca: select all
Both backspace and shift+backspace should delete the previous character. I never realized this was an issue until I used jEdit and found that it didn't do it.

Color scheme

(Applicable to any editor)

Comments: green (italic if possible)
keywords/operators: blue
built-in functions: red
strings: pink
variables: some shade of brown

Plugins

SwitchBuffer
FTP
BufferList
Console
JDiff
TextTools
FindFile

Macro documentation

pre-defined variables

http://www.jedit.org/42docs/users-guide/predefined-variables.html

buffer
view
editPane
textArea
wm
scriptPath
For a single-execution macro:
- line - current line number from start of buffer (0-based)
- index - current line number from start of selection (0-based)
- text - text of the current line

Methods in the Macros class

message(Component comp, String message)
error(Component comp, String message)
input(Component comp, String prompt)
input(Component comp, String prompt, String default)
confirm(Component comp, String prompt, int buttons)

Automatically imported packages

java.awt
java.awt.event
java.net
java.util
java.io
java.lang
javax.swing
javax.swing.event
org.gjt.sp.jedit
org.gjt.sp.jedit.browser
org.gjt.sp.jedit.buffer
org.gjt.sp.jedit.gui
org.gjt.sp.jedit.help
org.gjt.sp.jedit.io
org.gjt.sp.jedit.msg
org.gjt.sp.jedit.options
org.gjt.sp.jedit.pluginmgr
org.gjt.sp.jedit.print
org.gjt.sp.jedit.search
org.gjt.sp.jedit.syntax
org.gjt.sp.jedit.textarea
org.gjt.sp.util

Macro modifications

These are modifications I've made to some of the included macros.

cutSelectionOrLine and copySelectionOrLine

The selection lines were replaced with:

textArea.selectLine();

textArea.goToNextCharacter(true);

insertDate

The entire method was replaced with just:

import java.text.SimpleDateFormat;

//http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html

textArea.setSelectedText( //looks like Jan 04, 2005 5:51:43 -0500 (Tue)

    new SimpleDateFormat("MMM dd, yyyy H:mm:ss Z (E)").format(new Date())

);

duplicateLine

Replaced with:

if(buffer.isReadOnly()){         

    Macros.error(view, "This file is read only.");

    return;

}

lines = textArea.getSelectedLines();

c = lines.length;

text = new StringBuffer();

for(int n=0; n<c; n++)

    text.append("\n").append(textArea.getLineText(lines[n]));

offsetline = textArea.getCaretLine();

if(lines[c-1] != offsetline) offsetline--; //be left on the current line

buffer.insert(textArea.getLineEndOffset(offsetline)-1, text.toString());

textArea.goToNextLine(false);

Now it does "duplicate line or selection", not just "duplicate line", and it works with multiple selection, though it's a little dodgy about where it leaves you afterwards. I'm not even sure what the most appropriate behavior is for the new cases, but the behavior is the same for the original case.

Notes for self: what should happen: normal behavior is to copy the current line and leave you on the new line at the same character position. With multiple selection, you should be left on the first of the duplicated lines at the current character position, or if the character position is longer than the first duplicated line, start at position 0 of that line. Alternatively, start at the end, but I think the beginning is more useful.

Keith Devens .com