source: trunk/j/doc/commands.html @ 4494

Last change on this file since 4494 was 4494, checked in by piso, 19 years ago

dropBookmark: added link to dropTemporaryMarker.

File size: 159.7 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2
3<html>
4
5<head>
6<title>J User's Guide - Commands</title>
7<LINK REL="stylesheet" HREF="j.css" TYPE="text/css">
8</head>
9
10<body link=blue vlink=blue>
11
12<a href="contents.html">Top</a>
13
14<hr>
15
16<h1>Commands</h1>
17
18<hr>
19
20<ul>
21    <li><a href="commands.html#about">about</a></li>
22    <li><a href="commands.html#alias">alias</a></li>
23    <li><a href="commands.html#alignStrings">alignStrings</a></li>
24    <li><a href="commands.html#apropos">apropos</a></li>
25    <li><a href="commands.html#archiveOpenFile">archiveOpenFile</a></li>
26    <li><a href="commands.html#attachFile">attachFile</a></li>
27    <li><a href="commands.html#backspace">backspace</a></li>
28    <li><a href="commands.html#backwardSexp">backwardSexp</a></li>
29    <li><a href="commands.html#backwardUpList">backwardUpList</a></li>
30    <li><a href="commands.html#binaryMode">binaryMode</a></li>
31    <li><a href="commands.html#bob">bob</a></li>
32    <li><a href="commands.html#bol">bol</a></li>
33    <li><a href="commands.html#bottom">bottom</a></li>
34    <li><a href="commands.html#bounceMessage">bounceMessage</a></li>
35    <li><a href="commands.html#browseFileAtDot">browseFileAtDot</a></li>
36    <li><a href="commands.html#ccGroup">ccGroup</a></li>
37    <li><a href="commands.html#centerTag">centerTag</a></li>
38    <li><a href="commands.html#changes">changes</a></li>
39    <li><a href="commands.html#checkPath">checkPath</a></li>
40    <li><a href="commands.html#clearRegister">clearRegister</a></li>
41    <li><a href="commands.html#closeAll">closeAll</a></li>
42    <li><a href="commands.html#closeOthers">closeOthers</a></li>
43    <li><a href="commands.html#closeParen">closeParen</a></li>
44    <li><a href="commands.html#commentRegion">commentRegion</a></li>
45    <li><a href="commands.html#compile">compile</a></li>
46    <li><a href="commands.html#compose">compose</a></li>
47    <li><a href="commands.html#copyAppend">copyAppend</a></li>
48    <li><a href="commands.html#copyLink">copyLink</a></li>
49    <li><a href="commands.html#copyPath">copyPath</a></li>
50    <li><a href="commands.html#copyRegion">copyRegion</a></li>
51    <li><a href="commands.html#copyXPath">copyXPath</a></li>
52    <li><a href="commands.html#cppFindMatch">cppFindMatch</a></li>
53    <li><a href="commands.html#cvs">cvs</a></li>
54    <li><a href="commands.html#cvsAdd">cvsAdd</a></li>
55    <li><a href="commands.html#cvsCommit">cvsCommit</a></li>
56    <li><a href="commands.html#cvsDiff">cvsDiff</a></li>
57    <li><a href="commands.html#cvsDiffDir">cvsDiffDir</a></li>
58    <li><a href="commands.html#cvsLog">cvsLog</a></li>
59    <li><a href="commands.html#cycleIndentSize">cycleIndentSize</a></li>
60    <li><a href="commands.html#cyclePaste">cyclePaste</a></li>
61    <li><a href="commands.html#cycleTabWidth">cycleTabWidth</a></li>
62    <li><a href="commands.html#decodeRegion">decodeRegion</a></li>
63    <li><a href="commands.html#defaultMode">defaultMode</a></li>
64    <li><a href="commands.html#defaultKeyMaps">defaultKeyMaps</a></li>
65    <li><a href="commands.html#delete">delete</a></li>
66    <li><a href="commands.html#deleteWordLeft">deleteWordLeft</a></li>
67    <li><a href="commands.html#deleteWordRight">deleteWordRight</a></li>
68    <li><a href="commands.html#describeKey">describeKey</a></li>
69    <li><a href="commands.html#detabRegion">detabRegion</a></li>
70    <li><a href="commands.html#diff">diff</a></li>
71    <li><a href="commands.html#diffGotoFile">diffGotoFile</a></li>
72    <li><a href="commands.html#dir">dir</a></li>
73    <li><a href="commands.html#dirBack">dirBack</a></li>
74    <li><a href="commands.html#dirBrowseFile">dirBrowseFile</a></li>
75    <li><a href="commands.html#dirCopyFile">dirCopyFile</a></li>
76    <li><a href="commands.html#dirCycleSortBy">dirCycleSortBy</a></li>
77    <li><a href="commands.html#dirDeleteFiles">dirDeleteFiles</a></li>
78    <li><a href="commands.html#dirDoShellCommand">dirDoShellCommand</a></li>
79    <li><a href="commands.html#dirForward">dirForward</a></li>
80    <li><a href="commands.html#dirHome">dirHome</a></li>
81    <li><a href="commands.html#dirHomeDir">dirHomeDir</a></li>
82    <li><a href="commands.html#dirLimit">dirLimit</a></li>
83    <li><a href="commands.html#dirMoveFile">dirMoveFile</a></li>
84    <li><a href="commands.html#dirOpenFile">dirOpenFile</a></li>
85    <li><a href="commands.html#dirOpenFileAndKillDirectory">dirOpenFileAndKillDirectory</a></li>
86    <li><a href="commands.html#dirRescan">dirRescan</a></li>
87    <li><a href="commands.html#dirTagFile">dirTagFile</a></li>
88    <li><a href="commands.html#dirUnlimit">dirUnlimit</a></li>
89    <li><a href="commands.html#dirUpDir">dirUpDir</a></li>
90    <li><a href="commands.html#doShellCommandOnRegion">doShellCommandOnRegion</a></li>
91    <li><a href="commands.html#down">down</a></li>
92    <li><a href="commands.html#downList">downList</a></li>
93    <li><a href="commands.html#dropBookmark">dropBookmark</a></li>
94    <li><a href="commands.html#dropTemporaryMarker">dropTemporaryMarker</a></li>
95    <li><a href="commands.html#editRegister">editRegister</a></li>
96    <li><a href="commands.html#electricCloseAngleBracket">electricCloseAngleBracket</a></li>
97    <li><a href="commands.html#electricCloseBrace">electricCloseBrace</a></li>
98    <li><a href="commands.html#electricColon">electricColon</a></li>
99    <li><a href="commands.html#electricOpenBrace">electricOpenBrace</a></li>
100    <li><a href="commands.html#electricPound">electricPound</a></li>
101    <li><a href="commands.html#electricSemi">electricSemi</a></li>
102    <li><a href="commands.html#electricStar">electricStar</a></li>
103    <li><a href="commands.html#end">end</a></li>
104    <li><a href="commands.html#entabRegion">entabRegion</a></li>
105    <li><a href="commands.html#eob">eob</a></li>
106    <li><a href="commands.html#escape">escape</a></li>
107    <li><a href="commands.html#evalDefunLisp">evalDefunLisp</a></li>
108    <li><a href="commands.html#evalRegionLisp">evalRegionLisp</a></li>
109    <li><a href="commands.html#executeCommand">executeCommand</a></li>
110    <li><a href="commands.html#expand">expand</a></li>
111    <li><a href="commands.html#find">find</a></li>
112    <li><a href="commands.html#findFirstOccurrence">findFirstOccurrence</a></li>
113    <li><a href="commands.html#findInFiles">findInFiles</a></li>
114    <li><a href="commands.html#findMatchingChar">findMatchingChar</a></li>
115    <li><a href="commands.html#findNext">findNext</a></li>
116    <li><a href="commands.html#findNextWord">findNextWord</a></li>
117    <li><a href="commands.html#findOccurrenceAtDot">findOccurrenceAtDot</a></li>
118    <li><a href="commands.html#findPrev">findPrev</a></li>
119    <li><a href="commands.html#findPrevWord">findPrevWord</a></li>
120    <li><a href="commands.html#findTag">findTag</a></li>
121    <li><a href="commands.html#findTagAtDot">findTagAtDot</a></li>
122    <li><a href="commands.html#findTagAtDotOtherWindow">findTagAtDotOtherWindow</a></li>
123    <li><a href="commands.html#finish">finish</a></li>
124    <li><a href="commands.html#fold">fold</a></li>
125    <li><a href="commands.html#foldMethods">foldMethods</a></li>
126    <li><a href="commands.html#foldRegion">foldRegion</a></li>
127    <li><a href="commands.html#forwardSexp">forwardSexp</a></li>
128    <li><a href="commands.html#gotoBookmark">gotoBookmark</a></li>
129    <li><a href="commands.html#gotoTemporaryMarker">gotoTemporaryMarker</a></li>
130    <li><a href="commands.html#gotoFile">gotoFile</a></li>
131    <li><a href="commands.html#help">help</a></li>
132    <li><a href="commands.html#home">home</a></li>
133    <li><a href="commands.html#htmlBold">htmlBold</a></li>
134    <li><a href="commands.html#htmlElectricEquals">htmlElectricEquals</a></li>
135    <li><a href="commands.html#htmlEndTag">htmlEndTag</a></li>
136    <li><a href="commands.html#htmlFindMatch">htmlFindMatch</a></li>
137    <li><a href="commands.html#htmlInsertMatchingEndTag">htmlInsertMatchingEndTag</a></li>
138    <li><a href="commands.html#htmlInsertTag">htmlInsertTag</a></li>
139    <li><a href="commands.html#htmlStartTag">htmlStartTag</a></li>
140    <li><a href="commands.html#httpShowHeaders">httpShowHeaders</a></li>
141    <li><a href="commands.html#hyperspec">hyperspec</a></li>
142    <li><a href="commands.html#iList">iList</a></li>
143    <li><a href="commands.html#imageCycleBackground">imageCycleBackground</a></li>
144    <li><a href="commands.html#imageFit">imageFit</a></li>
145    <li><a href="commands.html#imageRestore">imageRestore</a></li>
146    <li><a href="commands.html#imageZoomIn">imageZoomIn</a></li>
147    <li><a href="commands.html#imageZoomOut">imageZoomOut</a></li>
148    <li><a href="commands.html#inbox">inbox</a></li>
149    <li><a href="commands.html#incrementalFind">incrementalFind</a></li>
150    <li><a href="commands.html#indentLine">indentLine</a></li>
151    <li><a href="commands.html#indentLineOrRegion">indentLineOrRegion</a></li>
152    <li><a href="commands.html#indentRegion">indentRegion</a></li>
153    <li><a href="commands.html#insertBraces">insertBraces</a></li>
154    <li><a href="commands.html#insertByte">insertByte</a></li>
155    <li><a href="commands.html#insertChar">insertChar</a></li>
156    <li><a href="commands.html#insertKeyText">insertKeyText</a></li>
157    <li><a href="commands.html#insertParentheses">insertParentheses</a></li>
158    <li><a href="commands.html#insertRegister">insertRegister</a></li>
159    <li><a href="commands.html#insertString">insertString</a></li>
160    <li><a href="commands.html#insertTab">insertTab</a></li>
161    <li><a href="commands.html#jdb">jdb</a></li>
162    <li><a href="commands.html#jdkHelp">jdkHelp</a></li>
163    <li><a href="commands.html#jlisp">jlisp</a></li>
164    <li><a href="commands.html#jmips">jmips</a></li>
165    <li><a href="commands.html#jumpToColumn">jumpToColumn</a></li>
166    <li><a href="commands.html#jumpToLine">jumpToLine</a></li>
167    <li><a href="commands.html#jumpToOffset">jumpToOffset</a></li>
168    <li><a href="commands.html#killAppend">killAppend</a></li>
169    <li><a href="commands.html#killBuffer">killBuffer</a></li>
170    <li><a href="commands.html#killFrame">killFrame</a></li>
171    <li><a href="commands.html#killLine">killLine</a></li>
172    <li><a href="commands.html#killRegion">killRegion</a></li>
173    <li><a href="commands.html#killWindow">killWindow</a></li>
174    <li><a href="commands.html#killWordLeft">killWordLeft</a></li>
175    <li><a href="commands.html#killWordRight">killWordRight</a></li>
176    <li><a href="commands.html#left">left</a></li>
177    <li><a href="commands.html#lisp">lisp</a></li>
178    <li><a href="commands.html#lispFindMatchingChar">lispFindMatchingChar</a></li>
179    <li><a href="commands.html#lispSelectSyntax">lispSelectSyntax</a></li>
180    <li><a href="commands.html#listBindings">listBindings</a></li>
181    <li><a href="commands.html#listFiles">listFiles</a></li>
182    <li><a href="commands.html#listIncludes">listIncludes</a></li>
183    <li><a href="commands.html#listOccurrences">listOccurrences</a></li>
184    <li><a href="commands.html#listOccurrencesOfPatternAtDot">listOccurrencesOfPatternAtDot</a></li>
185    <li><a href="commands.html#listRegisters">listRegisters</a></li>
186    <li><a href="commands.html#listTags">listTags</a></li>
187    <li><a href="commands.html#loadSession">loadSession</a></li>
188    <li><a href="commands.html#lowerCaseRegion">lowerCaseRegion</a></li>
189    <li><a href="commands.html#mailboxCreateFolder">mailboxCreateFolder</a></li>
190    <li><a href="commands.html#mailboxDelete">mailboxDelete</a></li>
191    <li><a href="commands.html#mailboxDeleteFolder">mailboxDeleteFolder</a></li>
192    <li><a href="commands.html#mailboxExpunge">mailboxExpunge</a></li>
193    <li><a href="commands.html#mailboxFlag">mailboxFlag</a></li>
194    <li><a href="commands.html#mailboxGetNewMessages">mailboxGetNewMessages</a></li>
195    <li><a href="commands.html#mailboxLastMessage">mailboxLastMessage</a></li>
196    <li><a href="commands.html#mailboxLimit">mailboxLimit</a></li>
197    <li><a href="commands.html#mailboxMarkRead">mailboxMarkRead</a></li>
198    <li><a href="commands.html#mailboxMarkUnread">mailboxMarkUnread</a></li>
199    <li><a href="commands.html#mailboxMoveToFolder">mailboxMoveToFolder</a></li>
200    <li><a href="commands.html#mailboxReadMessage">mailboxReadMessage</a></li>
201    <li><a href="commands.html#mailboxSaveToFolder">mailboxSaveToFolder</a></li>
202    <li><a href="commands.html#mailboxStop">mailboxStop</a></li>
203    <li><a href="commands.html#mailboxTag">mailboxTag</a></li>
204    <li><a href="commands.html#mailboxTagPattern">mailboxTagPattern</a></li>
205    <li><a href="commands.html#mailboxToggleRaw">mailboxToggleRaw</a></li>
206    <li><a href="commands.html#mailboxUndelete">mailboxUndelete</a></li>
207    <li><a href="commands.html#mailboxUnlimit">mailboxUnlimit</a></li>
208    <li><a href="commands.html#mailboxUntagAll">mailboxUntagAll</a></li>
209    <li><a href="commands.html#makeTagFile">makeTagFile</a></li>
210    <li><a href="commands.html#man">man</a></li>
211    <li><a href="commands.html#manFollowLink">manFollowLink</a></li>
212    <li><a href="commands.html#messageDelete">messageDelete</a></li>
213    <li><a href="commands.html#messageFlag">messageFlag</a></li>
214    <li><a href="commands.html#messageForward">messageForward</a></li>
215    <li><a href="commands.html#messageIndex">messageIndex</a></li>
216    <li><a href="commands.html#messageMoveToFolder">messageMoveToFolder</a></li>
217    <li><a href="commands.html#messageNext">messageNext</a></li>
218    <li><a href="commands.html#messageNextInThread">messageNextInThread</a></li>
219    <li><a href="commands.html#messagePrevious">messagePrevious</a></li>
220    <li><a href="commands.html#messagePreviousInThread">messagePreviousInThread</a></li>
221    <li><a href="commands.html#messageReplyToGroup">messageReplyToGroup</a></li>
222    <li><a href="commands.html#messageReplyToSender">messageReplyToSender</a></li>
223    <li><a href="commands.html#messageSaveAttachment">messageSaveAttachment</a></li>
224    <li><a href="commands.html#messageToggleHeaders">messageToggleHeaders</a></li>
225    <li><a href="commands.html#messageToggleRaw">messageToggleRaw</a></li>
226    <li><a href="commands.html#messageToggleWrap">messageToggleWrap</a></li>
227    <li><a href="commands.html#messageViewAttachment">messageViewAttachment</a></li>
228    <li><a href="commands.html#mode">mode</a></li>
229    <li><a href="commands.html#mouseFindOccurrence">mouseFindOccurrence</a></li>
230    <li><a href="commands.html#mouseFindTag">mouseFindTag</a></li>
231    <li><a href="commands.html#mouseMoveDotToPoint">mouseMoveDotToPoint</a></li>
232    <li><a href="commands.html#mousePaste">mousePaste</a></li>
233    <li><a href="commands.html#mouseSelect">mouseSelect</a></li>
234    <li><a href="commands.html#mouseShowContextMenu">mouseShowContextMenu</a></li>
235    <li><a href="commands.html#movePastCloseAndReindent">movePastCloseAndReindent</a></li>
236    <li><a href="commands.html#newBuffer">newBuffer</a></li>
237    <li><a href="commands.html#newFrame">newFrame</a></li>
238    <li><a href="commands.html#newline">newline</a></li>
239    <li><a href="commands.html#newlineAndIndent">newlineAndIndent</a></li>
240    <li><a href="commands.html#nextBuffer">nextBuffer</a></li>
241    <li><a href="commands.html#nextChange">nextChange</a></li>
242    <li><a href="commands.html#nextComment">nextComment</a></li>
243    <li><a href="commands.html#nextError">nextError</a></li>
244    <li><a href="commands.html#nextFrame">nextFrame</a></li>
245    <li><a href="commands.html#offset">offset</a></li>
246    <li><a href="commands.html#openFile">openFile</a></li>
247    <li><a href="commands.html#openFileInOtherFrame">openFileInOtherFrame</a></li>
248    <li><a href="commands.html#openFileInOtherWindow">openFileInOtherWindow</a></li>
249    <li><a href="commands.html#openMailbox">openMailbox</a></li>
250    <li><a href="commands.html#otherWindow">otherWindow</a></li>
251    <li><a href="commands.html#p4">p4</a></li>
252    <li><a href="commands.html#pageDown">pageDown</a></li>
253    <li><a href="commands.html#pageUp">pageUp</a></li>
254    <li><a href="commands.html#paste">paste</a></li>
255    <li><a href="commands.html#pasteColumn">pasteColumn</a></li>
256    <li><a href="commands.html#pastePrimarySelection">pastePrimarySelection</a></li>
257    <li><a href="commands.html#playbackMacro">playbackMacro</a></li>
258    <li><a href="commands.html#popPosition">popPosition</a></li>
259    <li><a href="commands.html#prevBuffer">prevBuffer</a></li>
260    <li><a href="commands.html#previousChange">previousChange</a></li>
261    <li><a href="commands.html#previousComment">previousComment</a></li>
262    <li><a href="commands.html#previousError">previousError</a></li>
263    <li><a href="commands.html#print">print</a></li>
264    <li><a href="commands.html#properties">properties</a></li>
265    <li><a href="commands.html#pushPosition">pushPosition</a></li>
266    <li><a href="commands.html#quit">quit</a></li>
267    <li><a href="commands.html#recompile">recompile</a></li>
268    <li><a href="commands.html#recordMacro">recordMacro</a></li>
269    <li><a href="commands.html#redo">redo</a></li>
270    <li><a href="commands.html#reloadKeyMaps">reloadKeyMaps</a></li>
271    <li><a href="commands.html#renumberRegion">renumberRegion</a></li>
272    <li><a href="commands.html#replace">replace</a></li>
273    <li><a href="commands.html#replaceInFiles">replaceInFiles</a></li>
274    <li><a href="commands.html#resetDisplay">resetDisplay</a></li>
275    <li><a href="commands.html#resetLisp">resetLisp</a></li>
276    <li><a href="commands.html#revertBuffer">revertBuffer</a></li>
277    <li><a href="commands.html#right">right</a></li>
278    <li><a href="commands.html#save">save</a></li>
279    <li><a href="commands.html#saveAll">saveAll</a></li>
280    <li><a href="commands.html#saveAllExit">saveAllExit</a></li>
281    <li><a href="commands.html#saveAs">saveAs</a></li>
282    <li><a href="commands.html#saveCopy">saveCopy</a></li>
283    <li><a href="commands.html#saveSession">saveSession</a></li>
284    <li><a href="commands.html#saveToRegister">saveToRegister</a></li>
285    <li><a href="commands.html#selectAll">selectAll</a></li>
286    <li><a href="commands.html#selectBob">selectBob</a></li>
287    <li><a href="commands.html#selectDown">selectDown</a></li>
288    <li><a href="commands.html#selectEnd">selectEnd</a></li>
289    <li><a href="commands.html#selectEob">selectEob</a></li>
290    <li><a href="commands.html#selectHome">selectHome</a></li>
291    <li><a href="commands.html#selectLeft">selectLeft</a></li>
292    <li><a href="commands.html#selectPageDown">selectPageDown</a></li>
293    <li><a href="commands.html#selectPageUp">selectPageUp</a></li>
294    <li><a href="commands.html#selectRight">selectRight</a></li>
295    <li><a href="commands.html#selectSyntax">selectSyntax</a></li>
296    <li><a href="commands.html#selectToMarker">selectToMarker</a></li>
297    <li><a href="commands.html#selectUp">selectUp</a></li>
298    <li><a href="commands.html#selectWord">selectWord</a></li>
299    <li><a href="commands.html#selectWordLeft">selectWordLeft</a></li>
300    <li><a href="commands.html#selectWordRight">selectWordRight</a></li>
301    <li><a href="commands.html#send">send</a></li>
302    <li><a href="commands.html#sendMailBackTab">sendMailBackTab</a></li>
303    <li><a href="commands.html#sendMailTab">sendMailTab</a></li>
304    <li><a href="commands.html#setEncoding">setEncoding</a></li>
305    <li><a href="commands.html#shellCommand">shellCommand</a></li>
306    <li><a href="commands.html#shellEscape">shellEscape</a></li>
307    <li><a href="commands.html#shellHome">shellHome</a></li>
308    <li><a href="commands.html#shellTab">shellTab</a></li>
309    <li><a href="commands.html#showMessage">showMessage</a></li>
310    <li><a href="commands.html#sidebarListBuffers">sidebarListBuffers</a></li>
311    <li><a href="commands.html#sidebarListTags">sidebarListTags</a></li>
312    <li><a href="commands.html#slideIn">slideIn</a></li>
313    <li><a href="commands.html#slideOut">slideOut</a></li>
314    <li><a href="commands.html#sortLines">sortLines</a></li>
315    <li><a href="commands.html#source">source</a></li>
316    <li><a href="commands.html#splitWindow">splitWindow</a></li>
317    <li><a href="commands.html#stamp">stamp</a></li>
318    <li><a href="commands.html#tab">tab</a></li>
319    <li><a href="commands.html#thisError">thisError</a></li>
320    <li><a href="commands.html#toCenter">toCenter</a></li>
321    <li><a href="commands.html#toggleGroupByThread">toggleGroupByThread</a></li>
322    <li><a href="commands.html#toggleSidebar">toggleSidebar</a></li>
323    <li><a href="commands.html#toggleWrap">toggleWrap</a></li>
324    <li><a href="commands.html#top">top</a></li>
325    <li><a href="commands.html#toTop">toTop</a></li>
326    <li><a href="commands.html#uncommentRegion">uncommentRegion</a></li>
327    <li><a href="commands.html#undo">undo</a></li>
328    <li><a href="commands.html#unfold">unfold</a></li>
329    <li><a href="commands.html#unfoldAll">unfoldAll</a></li>
330    <li><a href="commands.html#unsplitWindow">unsplitWindow</a></li>
331    <li><a href="commands.html#unwrapParagraph">unwrapParagraph</a></li>
332    <li><a href="commands.html#up">up</a></li>
333    <li><a href="commands.html#upperCaseRegion">upperCaseRegion</a></li>
334    <li><a href="commands.html#visibleTabs">visibleTabs</a></li>
335    <li><a href="commands.html#whatChar">whatChar</a></li>
336    <li><a href="commands.html#whereIs">whereIs</a></li>
337    <li><a href="commands.html#windowDown">windowDown</a></li>
338    <li><a href="commands.html#windowUp">windowUp</a></li>
339    <li><a href="commands.html#wordLeft">wordLeft</a></li>
340    <li><a href="commands.html#wordRight">wordRight</a></li>
341    <li><a href="commands.html#wrapComment">wrapComment</a></li>
342    <li><a href="commands.html#wrapParagraph">wrapParagraph</a></li>
343    <li><a href="commands.html#wrapRegion">wrapRegion</a></li>
344    <li><a href="commands.html#writeGlobalKeyMap">writeGlobalKeyMap</a></li>
345    <li><a href="commands.html#writeLocalKeyMap">writeLocalKeyMap</a></li>
346    <li><a href="commands.html#xmlElectricEquals">xmlElectricEquals</a></li>
347    <li><a href="commands.html#xmlElectricSlash">xmlElectricSlash</a></li>
348    <li><a href="commands.html#xmlFindCurrentNode">xmlFindCurrentNode</a></li>
349    <li><a href="commands.html#xmlFindMatch">xmlFindMatch</a></li>
350    <li><a href="commands.html#xmlInsertEmptyElementTag">xmlInsertEmptyElementTag</a></li>
351    <li><a href="commands.html#xmlInsertMatchingEndTag">xmlInsertMatchingEndTag</a></li>
352    <li><a href="commands.html#xmlInsertTag">xmlInsertTag</a></li>
353    <li><a href="commands.html#xmlParseBuffer">xmlParseBuffer</a></li>
354    <li><a href="commands.html#xmlValidateBuffer">xmlValidateBuffer</a></li>
355</ul>
356
357<a name="about">about</a><dl><dd>
358<p>
359Displays the about box.
360<br><br>
361<b>Default key mapping:</b> None
362<br><br>
363</dl><!--<hr>-->
364
365<a name="alias">alias</a><dl><dd>
366<p>
367Sets or modifies an alias. See <a href="aliases.html">Aliases</a>.
368<p>
369<b>Default key mapping:</b> None
370<br><br>
371</dl><!--<hr>-->
372
373<a name="alignStrings">alignStrings</a><dl><dd>
374<p>
375Prompts for a regular expression and aligns the first occurrence of the
376specified regular expression in each line of the selected region.
377<p>
378For example, suppose you start with a region that looks like this:
379<pre>
380        private static final int STATE_VARIABLE = STATE_LAST + 1;
381        private static final int STATE_HERE_DOCUMENT = STATE_LAST + 2;
382        private static final int STATE_POD = STATE_LAST + 3;
383        private static final int STATE_REGEXP_DELIMITER = STATE_LAST + 4;
384        private static final int STATE_REGEXP = STATE_LAST + 5;
385        private static final int STATE_SUBST = STATE_LAST + 6;
386</pre>
387If you specify "=" as the regular expression, alignStrings will reformat the
388region like this:
389<pre>
390        private static final int STATE_VARIABLE         = STATE_LAST + 1;
391        private static final int STATE_HERE_DOCUMENT    = STATE_LAST + 2;
392        private static final int STATE_POD              = STATE_LAST + 3;
393        private static final int STATE_REGEXP_DELIMITER = STATE_LAST + 4;
394        private static final int STATE_REGEXP           = STATE_LAST + 5;
395        private static final int STATE_SUBST            = STATE_LAST + 6;
396</pre>
397<p>
398<b>Default key mapping:</b> None
399<br><br>
400</dl><!--<hr>-->
401
402<a name="apropos">apropos</a><dl><dd>
403<p>
404Displays a list of commands and preferences that contain a specified pattern.
405<p>
406<b>Default key mapping:</b> None
407<br><br>
408</dl><!--<hr>-->
409
410<a name="archiveOpenFile">archiveOpenFile</a><dl><dd>
411<p>
412Opens the file at the location of the caret or mouse click.
413<p>
414<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1, or Mouse-2 in Archive mode
415<br><br>
416</dl><!--<hr>-->
417
418<a name="attachFile">attachFile</a><dl><dd>
419<p>
420Attaches a file to the message in the current mail composition buffer.
421<br><br>
422<b>Default key mapping:</b> None
423<br><br>
424<b>See also:</b> <a href="mail.html">Mail</a>
425<br><br>
426</dl><!--<hr>-->
427
428<a name="backspace">backspace</a><dl><dd>
429<p>
430If a region is marked, deletes it.  Otherwise, deletes the character to the
431left of the caret.
432<br><br>
433<b>Default key mapping:</b> Backspace, Shift Backspace
434<br><br>
435</dl><!--<hr>-->
436
437<a name="backwardSexp">backwardSexp</a><dl><dd>
438<p>
439Moves backward across one balanced syntactic expression, if possible.
440<p>
441<b>Default key mapping:</b> Ctrl Alt B in Lisp mode
442<p>
443<b>See also:</b> <a href="#forwardSexp">forwardSexp</a>,
444<a href="#downList">downList</a>, <a href="#backwardUpList">backwardUpList</a>
445<br><br>
446</dl><!--<hr>-->
447
448<a name="backwardUpList">backwardUpList</a><dl><dd>
449<p>
450Moves the caret backward out of one level of parentheses.
451<br><br>
452<b>Default key mapping:</b> Ctrl Alt U in Lisp mode
453<p>
454<b>See also:</b> <a href="#downList">downList</a>,
455<a href="#forwardSexp">forwardSexp</a>,
456<a href="#backwardSexp">backwardSexp</a>
457<br><br>
458</dl><!--<hr>-->
459
460<a name="binaryMode">binaryMode</a><dl><dd>
461<p>
462Reloads the current buffer in binary mode.
463<br><br>
464<b>Default key mapping:</b> None
465<br><br>
466<b>See also:</b> <a href="#defaultMode">defaultMode</a>
467<br><br>
468</dl><!--<hr>-->
469
470<a name="bob">bob</a><dl><dd>
471<p>
472Moves to the beginning of the buffer.
473<br><br>
474<b>Default key mapping:</b> Ctrl Home
475<br><br>
476</dl><!--<hr>-->
477
478<a name="bol">bol</a><dl><dd>
479<p>
480Moves the caret to the beginning of the line.
481<br><br>
482<b>Default key mapping:</b> None
483<br><br>
484</dl><!--<hr>-->
485
486<a name="bottom">bottom</a><dl><dd>
487<p>
488Moves the caret to the bottom line of the display, keeping it in the same column.
489<br><br>
490<b>Default key mapping:</b> Ctrl Page Down
491<br><br>
492</dl><!--<hr>-->
493
494<a name="bounceMessage">bounceMessage</a><dl><dd>
495<p>
496Resends the current message to one or more specified addresses.
497<br><br>
498<b>Default key mapping:</b> 'b' in message buffers
499<br><br>
500<b>See also:</b> <a href="mail.html">Mail</a>
501<br><br>
502</dl><!--<hr>-->
503
504<a name="browseFileAtDot">browseFileAtDot</a><dl><dd>
505<p>
506Uses the default browser to view the file at the location of the caret.
507<p>
508For this command to work, you need to specify the properties
509<a href="preferences.html#browser">browser</a> and (optionally)
510<a href="preferences.html#browserOpts">browserOpts</a> in your
511<a href="preferences.html">preferences</a> file.
512<p>
513<b>Default key mapping:</b> Ctrl Shift B
514<br><br>
515</dl><!--<hr>-->
516
517<a name="ccGroup">ccGroup</a><dl><dd>
518<p>
519This command is available in mail composition buffers when you're replying to
520a message. It adds all of the recipients of the original message
521to the "Cc:" header of your reply, just as if you had initiated the reply with
522<a href="#messageReplyToGroup">messageReplyToGroup</a> instead of
523<a href="#messageReplyToSender">messageReplyToSender</a>.
524<p>
525<b>Default key mapping:</b> None
526<br><br>
527</dl><!--<hr>-->
528
529<a name="centerTag">centerTag</a><dl><dd>
530<p>
531Centers the current function vertically in the edit window.
532<br><br>
533<b>Default key mapping:</b> None
534<br><br>
535</dl><!--<hr>-->
536
537<a name="changes">changes</a><dl><dd>
538<p>
539Runs diff to show the unsaved changes to the current buffer (if any). In the
540resulting output buffer, you can use <a href="#diffGotoFile">diffGotoFile</a>,
541mapped by default to Enter, to jump to the location of a particular change.
542<p>
543Because it uses diff, this command will not work unless diff is installed and
544in your path, which is more likely to be the case on Unix than on Windows.
545<p>
546<b>Default key mapping:</b> None
547<br><br>
548</dl><!--<hr>-->
549
550<a name="checkPath">checkPath</a><dl><dd>
551<p>
552Examines all the lines in the current buffer that start with "#include" and
553reports which included files can't be found in your
554<a href="preferences.html#includePath">include path</a> (or in the current
555directory, if the filename is enclosed in quotes rather than in angle
556brackets). This command also recursively checks all the included files that it
557can find, and reports which (if any) of the files included by those files
558can't be found.
559<p>
560<b>Default key mapping:</b> None
561<p>
562<b>See also:</b> <a href="preferences.html#includePath">includePath</a>,
563<a href="#listIncludes">listIncludes</a>, <a href="#iList">iList</a>
564<br><br>
565</dl><!--<hr>-->
566
567<a name="clearRegister">clearRegister</a><dl><dd>
568<p>
569Prompts for a register name and erases the contents of the specified register.
570<p>
571Register names must be lower case letters (a-z). The contents of registers
572persist automatically from one j session to the next.
573<p>
574<b>Default key mapping:</b> None
575<p>
576<b>See also:</b>
577<a href="#editRegister">editRegister</a>,
578<a href="#insertRegister">insertRegister</a>,
579<a href="#listRegisters">listRegisters</a>,
580<a href="#saveToRegister">saveToRegister</a>
581<br><br>
582</dl><!--<hr>-->
583
584<a name="closeAll">closeAll</a><dl><dd>
585<p>
586Closes all open buffers, leaving a directory buffer looking at the current
587directory.
588<p>
589<b>Default key mapping:</b> None
590<p>
591<b>See also:</b> <a href="#closeOthers">closeOthers</a>
592<br><br>
593</dl><!--<hr>-->
594
595<a name="closeOthers">closeOthers</a><dl><dd>
596<p>
597Closes all open buffers except the current one.
598<br><br>
599<b>Default key mapping:</b> None
600<br><br>
601</dl><!--<hr>-->
602
603<a name="closeParen">closeParen</a><dl><dd>
604<p>
605Inserts a closing parenthesis and briefly moves the caret to the matching
606opening parenthesis.
607<br><br>
608<b>Default key mapping:</b> ')' in Java mode
609<br><br>
610</dl><!--<hr>-->
611
612<a name="commentRegion">commentRegion</a><dl><dd>
613<p>
614Comments out each line in the selected region, or the current line if no region is selected.
615<br><br>
616<b>Default key mapping:</b> F11
617<br><br>
618<b>See also:</b> <a href="#uncommentRegion">uncommentRegion</a>
619<br><br>
620</dl><!--<hr>-->
621
622<a name="compile">compile</a><dl><dd>
623<p>
624Compiles the source file in the current buffer. You will be prompted for the
625compile command. (On Windows, this command is only supported for Windows 2000
626and Windows XP.)
627<p>
628<b>Default key mapping:</b>
629<p>
630<b>See also:</b> <a href="#recompile">recompile</a>,
631<a href="compilation.html">Compilation Buffers</a>
632<br><br>
633</dl><!--<hr>-->
634
635<a name="compose">compose</a><dl><dd>
636<p>
637Opens a new mail composition buffer.
638<br><br>
639<b>Default key mapping:</b> 'c' in Mailbox mode
640<br><br>
641<b>See also:</b> <a href="mail.html">Mail</a>
642<br><br>
643</dl><!--<hr>-->
644
645<a name="copyAppend">copyAppend</a><dl><dd>
646<p>
647Appends the selected region (or the current line if no region is selected)
648to last entry in the <a href="killring.html">kill ring</a>.
649<br><br>
650<b>Default key mapping:</b> Ctrl Shift C
651<br><br>
652<b>See also:</b> <a href="#copyRegion">copyRegion</a>,
653<a href="#killAppend">killAppend</a>
654<br><br>
655</dl><!--<hr>-->
656
657<a name="copyLink">copyLink</a><dl><dd>
658<p>
659In web mode, copies to the <a href="killring.html">kill ring</a> (and to the
660system clipboard) the link at the location of the caret.
661<p>
662<b>Default key mapping:</b> None
663<br><br>
664</dl><!--<hr>-->
665
666<a name="copyPath">copyPath</a><dl><dd>
667<p>
668In directory buffers, copies to the <a href="killring.html">kill ring</a> (and
669to the system clipboard) the full pathname of the file on the line containing
670the caret.
671<br><br>
672<b>Default key mapping:</b> None
673<br><br>
674</dl><!--<hr>-->
675
676<a name="copyRegion">copyRegion</a><dl><dd>
677<p>
678Copies the contents of the selected region (or the current line if no region
679is selected). For normal regions, the copied text is placed in the
680<a href="killring.html">kill ring</a>. If the selected region is a column, the
681text is saved but not placed in the kill ring; it can be retrieved with the
682command <a href="#pasteColumn">pasteColumn</a>.
683<p>
684<b>Default key mapping:</b> Ctrl C
685<p>
686<b>See also:</b> <a href="#copyAppend">copyAppend</a>,
687<a href="#killRegion">killRegion</a>, <a href="#paste">paste</a>,
688<a href="columns.html">Columns</a>
689<br><br>
690</dl><!--<hr>-->
691
692<a name="copyXPath">copyXPath</a><dl><dd>
693<p>
694In XML mode, copies to the <a href="killring.html">kill ring</a> (and to the
695system clipboard) the path of the element at the current location of the caret.
696<p>
697<b>Default key mapping:</b> None
698<br><br>
699</dl><!--<hr>-->
700
701<a name="cppFindMatch">cppFindMatch</a><dl><dd>
702<p>
703If the caret is on a line that starts with <code>#if</code>,
704<code>#else</code>, <code>#elif</code> or <code>#endif</code>, finds the
705matching expression. Otherwise, finds the match of the brace, parenthesis or
706bracket at the location of the caret.
707<br><br>
708<b>Default key mapping:</b> Ctrl M in C++ mode
709<br><br>
710</dl><!--<hr>-->
711
712<a name="cvs">cvs</a><dl><dd>
713<p>
714Executes an arbitrary CVS command. The CVS command, together with any required
715flags, must be supplied as an argument. The name of the file associated with
716the current buffer is automatically appended to the command line, unless the
717argument you supply begins with "-H". For example:
718<pre>
719        cvs status -v
720</pre>
721<p>
722or:
723<pre>
724        cvs -H admin
725</pre>
726<p>
727<b>Default key mapping:</b> None
728<p>
729<b>See also:</b> <a href="cvs.html">CVS Support</a>
730<br><br>
731</dl><!--<hr>-->
732
733<a name="cvsAdd">cvsAdd</a><dl><dd>
734<p>
735Adds the file associated with the current buffer to CVS. The file is not
736actually placed in the CVS repository until you use
737<a href="#cvsCommit">cvsCommit</a> to make the change permanent.
738<p>
739<b>Default key mapping:</b> None
740<p>
741<b>See also:</b> <a href="cvs.html">CVS Support</a>
742<br><br>
743</dl><!--<hr>-->
744
745<a name="cvsCommit">cvsCommit</a><dl><dd>
746<p>
747Opens a checkin buffer in which you can compose a CVS checkin comment for the
748file associated with the current buffer.
749<p>
750When your comment is ready, you can use the command
751<a href="commands.html#finish">finish</a>, mapped by default to Ctrl Enter in
752the checkin buffer, to complete the checkin operation.
753<p>
754The file associated with the current buffer must already have been registered
755with CVS using <a href="#cvsAdd">cvsAdd</a> or the CVS "add" command.
756<p>
757<b>Default key mapping:</b> None
758<p>
759<b>See also:</b> <a href="cvs.html">CVS Support</a>
760<br><br>
761</dl><!--<hr>-->
762
763<a name="cvsDiff">cvsDiff</a><dl><dd>
764<p>
765Opens a diff output buffer showing the changes between the checked-in version
766of the file associated with the current buffer and your local copy.
767<p>
768<b>Default key mapping:</b> None
769<p>
770<b>See also:</b> <a href="cvs.html">CVS Support</a>
771<br><br>
772</dl><!--<hr>-->
773
774<a name="cvsDiffDir">cvsDiffDir</a><dl><dd>
775<p>
776Opens a diff output buffer showing the changes between the checked-in version
777and your local copy for all the files in the current directory and its
778subdirectories.
779<p>
780<b>Default key mapping:</b> None
781<p>
782<b>See also:</b> <a href="cvs.html">CVS Support</a>
783<br><br>
784</dl><!--<hr>-->
785
786<a name="cvsLog">cvsLog</a><dl><dd>
787<p>
788Runs the CVS "log" command on the file associated with the current buffer. The
789output is displayed in a transient output buffer.
790<p>
791<b>Default key mapping:</b> None
792<p>
793<b>See also:</b> <a href="cvs.html">CVS Support</a>
794<br><br>
795</dl><!--<hr>-->
796
797<a name="cycleIndentSize">cycleIndentSize</a><dl><dd>
798<p>
799Cycles through the most plausible possibilities for the indent size of the
800current buffer (2, 4 and 8 spaces).  The value that is currently in effect is
801shown in the status bar.
802<br><br>
803If you use cycleIndentSize to set the indent size, j will try to
804remember the setting the next time you open the same file.
805<br><br>
806<b>Default key mapping:</b> Alt I in most programming modes
807<br><br>
808</dl><!--<hr>-->
809
810<a name="cyclePaste">cyclePaste</a><dl><dd>
811<p>
812If the last command to be executed was not paste or cyclePaste, cyclePaste does
813exactly the same thing as <a href="#paste">paste</a>.
814<br><br>
815If the last command to be executed was paste or cyclePaste, cyclePaste fetches
816the next item from the <a href="killring.html">kill ring</a> and inserts it in
817place of the text inserted by the last paste or cyclePaste.
818<br><br>
819What this means in practice is that you can invoke cyclePaste repeatedly to
820cycle through the contents of the kill ring, stopping when you see that the
821text you want has been inserted. If you can't find what you want and
822would like to cancel the operation, use <a href="#undo">undo</a>.
823<br><br>
824<b>Default key mapping:</b> Ctrl Shift V
825<br><br>
826</dl><!--<hr>-->
827
828<a name="cycleTabWidth">cycleTabWidth</a><dl><dd>
829<p>
830Cycles through the most plausible possibilities for the tab width of the
831current buffer (2, 4 and 8 spaces). The value that is currently in effect is
832shown in the status bar.
833<p>
834This is intended to be a quick way to figure out the proper tab width to use
835when you've loaded a file for the first time and the indentation looks goofy.
836Just press Alt T repeatedly until things look right. Of course that may not
837happen; bear in mind that cycleTabWidth only considers the three most common
838possibilities.
839<p>
840If you use cycleTabWidth to set the tab width, j will try to remember the
841setting the next time you open the same file.
842<p>
843<b>Default key mapping:</b> Alt T
844<br><br>
845</dl><!--<hr>-->
846
847<a name="decodeRegion">decodeRegion</a><dl><dd>
848<p>
849Base 64 decodes the selected region (or the line containing the caret if no
850region is selected). If the resulting output is text, it is displayed in a new
851buffer; otherwise, you are prompted for a filename and the output is saved in
852the specified file.
853<p>
854<b>Default key mapping:</b> None
855<br><br>
856</dl><!--<hr>-->
857
858<a name="defaultMode">defaultMode</a><dl><dd>
859<p>
860Reloads the current buffer in its default mode.
861<p>
862<b>Default key mapping:</b> Ctrl Alt B in binary mode
863<p>
864<b>See also:</b> <a href="#binaryMode">binaryMode</a>
865<br><br>
866</dl><!--<hr>-->
867
868<a name="defaultKeyMaps">defaultKeyMaps</a><dl><dd>
869<p>
870Discards all custom key mappings and returns to j's internal defaults.
871<p>
872<b>Default key mapping:</b> None
873<p>
874<b>See also:</b> <a href="#reloadKeyMaps">reloadKeyMaps</a>,
875<a href="keys.html">Key Mappings</a>
876<br><br>
877</dl><!--<hr>-->
878
879<a name="delete">delete</a><dl><dd>
880<p>
881If a region is marked, deletes it.  Otherwise, deletes the character at the
882location of the caret.
883<p>
884<b>Default key mapping:</b> Delete
885<br><br>
886</dl><!--<hr>-->
887
888<a name="detabRegion">detabRegion</a><dl><dd>
889<p>
890Replaces tab characters in the selected region with the appropriate number of
891spaces, based on the tab width of the buffer. Buffer-specific settings such as
892<a href="preferences.html#tabWidth">tabWidth</a> may be inspected and modified
893in the Properties dialog (see <a href="#properties">properties</a>).
894<br><br>
895<b>Default key mapping:</b> None
896<br><br>
897<b>See also:</b> <a href="#entabRegion">entabRegion</a>
898<br><br>
899</dl><!--<hr>-->
900
901<a name="deleteWordLeft">deleteWordLeft</a><dl><dd>
902<p>
903Deletes the word to the left of the caret.
904<br><br>
905<b>Default key mapping:</b> Ctrl Backspace
906<p>
907<b>See also:</b> <a href="#killWordLeft">killWordLeft</a>
908<br><br>
909</dl><!--<hr>-->
910
911<a name="deleteWordRight">deleteWordRight</a><dl><dd>
912<p>
913Deletes the word to the right of the caret.
914<br><br>
915<b>Default key mapping:</b> Ctrl Delete
916<p>
917<b>See also:</b> <a href="#killWordRight">killWordRight</a>
918<br><br>
919</dl><!--<hr>-->
920
921<a name="describeKey">describeKey</a><dl><dd>
922<p>
923Displays information about the command mapped to a particular key or key combination.
924<br><br>
925<b>Default key mapping:</b> Alt K
926<br><br>
927</dl><!--<hr>-->
928
929<a name="diff">diff</a><dl><dd>
930<p>
931Runs diff with the supplied arguments and presents the output in a diff output
932buffer.
933<p>
934When constructing the command line, you can use "%" as a dynamic alias for the
935file associated with the current buffer. For example:
936<pre>
937        diff -ub % ~/backup
938</pre>
939If you don't explicitly specify any command line switches (e.g. "-ub", "-c",
940"--normal"), j will run "diff -u".
941<p>
942If no arguments are provided, this command diffs the file associated with the
943current buffer against its <a href="preferences.html#patchMode">patchMode</a>
944backup file (if it exists).
945<p>
946Because it uses diff, this command will not work unless diff is installed and
947in your path, which is more likely to be the case on Unix than on Windows.
948<p>
949<b>Default key mapping:</b> None
950<p>
951<b>See also:</b> <a href="#changes">changes</a>
952<br><br>
953</dl><!--<hr>-->
954
955<a name="diffGotoFile">diffGotoFile</a><dl><dd>
956<p>
957Jumps to the location in the source buffer corresponding to the current line
958in the diff output buffer.
959<p>
960<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1, or Mouse-2 in
961Diff mode
962<p>
963<b>See also:</b> <a href="#changes">changes</a>
964<br><br>
965</dl><!--<hr>-->
966
967<a name="dir">dir</a><dl><dd>
968<p>
969Opens a directory buffer on the current directory.  The current directory is
970normally the parent directory of the file that is open in the current editor
971window.
972<br><br>
973<b>Default key mapping:</b> Ctrl D
974<br><br>
975<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
976<br><br>
977</dl><!--<hr>-->
978
979<a name="dirBack">dirBack</a><dl><dd>
980<p>
981Changes to the previous directory in the history list for the current directory buffer.
982<br><br>
983<b>Default key mapping:</b> 'b' in directory buffers
984<br><br>
985<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
986<br><br>
987</dl><!--<hr>-->
988
989<a name="dirBrowseFile">dirBrowseFile</a><dl><dd>
990<p>
991Uses the default browser to view the file at the location of the caret.
992<p>
993For this command to work, you need to specify the properties
994<a href="preferences.html#browser">browser</a> and (optionally)
995<a href="preferences.html#browserOpts">browserOpts</a> in your
996<a href="preferences.html">preferences</a> file.
997<p>
998<b>Default key mapping:</b> Ctrl Shift B in directory buffers
999<p>
1000<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1001<br><br>
1002</dl><!--<hr>-->
1003
1004<a name="dirCopyFile">dirCopyFile</a><dl><dd>
1005<p>
1006Copies the file at the current location of the caret to a specified destination.
1007You can specify either a filename or a directory as the destination.
1008<p>
1009<b>Default key mapping:</b> 'c' in directory buffers
1010<p>
1011<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1012<br><br>
1013</dl><!--<hr>-->
1014
1015<a name="dirCycleSortBy">dirCycleSortBy</a><dl><dd>
1016<p>
1017Cycles through the possibilities (name, date, size) for the sort order of the
1018directory listing. The sort order that is currently in effect is displayed in
1019the title bar of the editor window.
1020<br><br>
1021<b>Default key mapping:</b> Ctrl S in directory buffers
1022<br><br>
1023<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1024<br><br>
1025</dl><!--<hr>-->
1026
1027<a name="dirDeleteFiles">dirDeleteFiles</a><dl><dd>
1028<p>
1029Deletes the marked files, or, if no files are marked, deletes the file at the
1030current location of the caret.
1031<br><br>
1032<b>Default key mapping:</b> Delete in directory buffers
1033<br><br>
1034<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1035<br><br>
1036</dl><!--<hr>-->
1037
1038<a name="dirDoShellCommand">dirDoShellCommand</a><dl><dd>
1039<p>
1040Prompts for a shell command and executes the specified command on all the
1041marked files in the current directory buffer.
1042<p>
1043If no files are marked, the command is executed on the file at the current
1044location of the caret.
1045<p>
1046If the command string contains '*', the command runs once, with the list of
1047marked files in place of the '*'. The order of the list is the order of
1048appearance in the directory buffer.
1049<p>
1050If the command string does not contain '*', the command runs separately for
1051each file, with the file name added at the end of the command string.
1052<p>
1053In all cases, the command is executed in the current directory (the directory
1054displayed in the directory buffer).
1055<p>
1056<b>Default key mapping:</b> '!' in directory buffers
1057<p>
1058<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1059<br><br>
1060</dl><!--<hr>-->
1061
1062<a name="dirForward">dirForward</a><dl><dd>
1063<p>
1064Changes to the next directory in the history list for the current directory buffer.
1065<p>
1066<b>Default key mapping:</b> 'f' in directory buffers
1067<p>
1068<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1069<br><br>
1070</dl><!--<hr>-->
1071
1072<a name="dirGetFile">dirGetFile</a><dl><dd>
1073<p>
1074Copies the remote file at the current location of the caret to a specified
1075destination on the local machine. You can specify either a filename or a
1076directory as the destination.
1077<br><br>
1078<b>Default key mapping:</b> G in remote directory buffers
1079<br><br>
1080<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1081<br><br>
1082</dl><!--<hr>-->
1083
1084<a name="dirHome">dirHome</a><dl><dd>
1085<p>
1086If the caret is to the right of the first character of the filename on the
1087current line, moves the caret to the first character of the filename.
1088Otherwise, moves the caret to the beginning of the line.
1089<br><br>
1090<b>Default key mapping:</b> Home in directory buffers
1091<br><br>
1092<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1093<br><br>
1094</dl><!--<hr>-->
1095
1096<a name="dirHomeDir">dirHomeDir</a><dl><dd>
1097<p>
1098If the current buffer is a directory buffer, changes to the home directory of
1099the current user. Otherwise, finds an existing directory buffer or opens a new
1100one on the home directory of the current user.
1101<br><br>
1102<b>Default key mapping:</b> None
1103<br><br>
1104<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1105<br><br>
1106</dl><!--<hr>-->
1107
1108<a name="dirMoveFile">dirMoveFile</a><dl><dd>
1109<p>
1110Moves the file at the current location of the caret to a specified destination.
1111You can specify either a filename or a directory as the destination.
1112<br><br>
1113<b>Default key mapping:</b> 'm' in directory buffers
1114<br><br>
1115<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1116<br><br>
1117</dl><!--<hr>-->
1118
1119<a name="dirOpenFile">dirOpenFile</a><dl><dd>
1120<p>
1121Opens the file or directory at the location of the caret or mouse click in a
1122directory buffer.
1123<p>
1124<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1, or Mouse-2 in directory buffers
1125<p>
1126<b>See also:</b> <a href="#dirOpenFileAndKillDirectory">dirOpenFileAndKillDirectory</a>,
1127<a href="directories.html">Directory Buffers</a>.
1128<br><br>
1129</dl><!--<hr>-->
1130
1131<a name="dirOpenFileAndKillDirectory">dirOpenFileAndKillDirectory</a><dl><dd>
1132<p>
1133Opens the file or directory at the location of the caret or mouse click in a
1134directory buffer and then closes the directory buffer.
1135<p>
1136<b>Default key mapping:</b> Ctrl Enter in directory buffers
1137<p>
1138<b>See also:</b> <a href="#dirOpenFile">dirOpenFile</a>,
1139<a href="directories.html">Directory Buffers</a>.
1140<br><br>
1141</dl><!--<hr>-->
1142
1143<a name="dirRescan">dirRescan</a><dl><dd>
1144<p>
1145Refreshes the directory listing for the current directory buffer and rescans the
1146directory tree.
1147<br><br>
1148<b>Default key mapping:</b> None
1149<br><br>
1150<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1151<br><br>
1152</dl><!--<hr>-->
1153
1154<a name="dirLimit">dirLimit</a><dl><dd>
1155<p>
1156Sets a limit pattern (something like "*.java") to control what files are
1157displayed in the directory listing. Entering a blank string removes the limit,
1158so that all files are displayed.
1159<br><br>
1160<b>Default key mapping:</b> 'l' in directory buffers.
1161<br><br>
1162<b>See also:</b> <a href="#dirUnlimit">dirUnlimit</a>,
1163<a href="directories.html">Directory Buffers</a>.
1164<br><br>
1165</dl><!--<hr>-->
1166
1167<a name="dirTagFile">dirTagFile</a><dl><dd>
1168<p>
1169Tags or untags the file at the current location of the caret.
1170<p>
1171<b>Default key mapping:</b> 't' in directory buffers
1172<p>
1173<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1174<br><br>
1175</dl><!--<hr>-->
1176
1177<a name="dirUnlimit">dirUnlimit</a><dl><dd>
1178<p>
1179Removes any limit pattern that may be in effect for the current directory
1180buffer, so that all files are displayed.
1181<br><br>
1182<b>Default key mapping:</b> 'L' in directory buffers.
1183<br><br>
1184<b>See also:</b> <a href="#dirUnlimit">dirUnlimit</a>,
1185<a href="directories.html">Directory Buffers</a>.
1186<br><br>
1187</dl><!--<hr>-->
1188
1189<a name="dirUpDir">dirUpDir</a><dl><dd>
1190<p>
1191Navigates to the parent of the current directory.
1192<br><br>
1193<b>Default key mapping:</b> 'u' and Backspace in directory buffers
1194<br><br>
1195<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
1196<br><br>
1197</dl><!--<hr>-->
1198
1199<a name="doShellCommandOnRegion">doShellCommandOnRegion</a><dl><dd>
1200<p>
1201Prompts for a shell command and then executes that command, using the selected
1202region as input. The contents of the selected region are replaced by the
1203output of the command. If an error occurs, you can use
1204<a href="commands.html#undo">undo</a> to restore the previous contents.
1205<br><br>
1206<code>doShellCommandOnRegion</code> is an experimental command, not enabled by
1207default. On Windows, you need to have the
1208<a href="http://sources.redhat.com/cygwin/">Cygwin</a> tools installed, and
1209sh.exe must be in your path.
1210<br><br>
1211<b>Default key mapping:</b> None
1212<br><br>
1213</dl><!--<hr>-->
1214
1215<a name="down">down</a><dl><dd>
1216<p>
1217Moves the caret down one line.
1218<br><br>
1219<b>Default key mapping:</b> Down arrow
1220<br><br>
1221</dl><!--<hr>-->
1222
1223<a name="downList">downList</a><dl><dd>
1224<p>
1225Moves forward down one level of parentheses.
1226<p>
1227<b>Default key mapping:</b> Ctrl Alt D in Lisp mode
1228<p>
1229<b>See also:</b> <a href="#backwardUpList">backwardUpList</a>,
1230<a href="#forwardSexp">forwardSexp</a>,
1231<a href="#backwardSexp">backwardSexp</a>
1232<br><br>
1233</dl><!--<hr>-->
1234
1235<a name="dropBookmark">dropBookmark</a><dl><dd>
1236<p>
1237Drops a numbered bookmark at the location of the caret in the current buffer. By
1238default, <code>dropBookmark</code> is mapped to the ten keystrokes Alt 0 through Alt
12399, and <code>gotoBookmark</code> is mapped by default to the ten keystrokes Ctrl 0
1240through Ctrl 9. When you drop a bookmark with Alt n, you can return to it with
1241Ctrl n. It's possible to unmap these keystrokes or map other commands to them,
1242but the current implementation of <code>dropBookmark</code> and <code>gotoBookmark</code>
1243only works with these key mappings.
1244<br><br>
1245You can still return to a bookmark even if the buffer it refers to has been
1246closed (in that case the buffer will be re-opened in the current frame), but
1247bookmarks are not retained from one session to the next.
1248<br><br>
1249<b>Default key mapping:</b> Alt 0 through Alt 9 (bookmarks 0-9)
1250<br><br>
1251<b>See also:</b> <a href="#gotoBookmark">gotoBookmark</a>,
1252<a href="#dropTemporaryMarker">dropTemporaryMarker</a>
1253<br><br>
1254</dl><!--<hr>-->
1255
1256<a name="dropTemporaryMarker">dropTemporaryMarker</a><dl><dd>
1257<p>
1258Drops a temporary marker at the location of the caret in the current buffer.
1259<p>
1260You can use <a href="#gotoTemporaryMarker">gotoTemporaryMarker</a>, mapped by
1261default to Ctrl \, to return to the location of the temporary marker.
1262<p>
1263This command recycles the same temporary marker for each subsequent use, so you
1264can only have one temporary marker at a time.
1265<p>
1266<b>Default key mapping:</b> Alt \
1267<p>
1268<b>See also:</b> <a href="#dropBookmark">dropBookmark</a>,
1269<a href="#gotoTemporaryMarker">gotoTemporaryMarker</a>
1270<br><br>
1271</dl><!--<hr>-->
1272
1273<a name="editRegister">editRegister</a><dl><dd>
1274<p>
1275Prompts for a register name and opens a buffer so you can edit the contents of
1276the specified register.
1277<p>
1278Register names must be lower case letters (a-z). The contents of registers
1279persist automatically from one j session to the next.
1280<p>
1281<b>Default key mapping:</b> None
1282<p>
1283<b>See also:</b>
1284<a href="#clearRegister">clearRegister</a>,
1285<a href="#insertRegister">insertRegister</a>,
1286<a href="#listRegisters">listRegisters</a>,
1287<a href="#saveToRegister">saveToRegister</a>
1288<br><br>
1289</dl><!--<hr>-->
1290
1291<a name="electricCloseAngleBracket">electricCloseAngleBracket</a><dl><dd>
1292<p>
1293Inserts '>' and, if the property
1294<a href="preferences.html#autoIndent">autoIndent</a> is <code>true</code>,
1295re-indents the current line according to context.
1296<br><br>
1297<b>Default key mapping:</b> '>' in HTML and XML modes
1298<br><br>
1299</dl><!--<hr>-->
1300
1301<a name="electricCloseBrace">electricCloseBrace</a><dl><dd>
1302<p>
1303Inserts '}' and re-indents the current line according to context. If
1304the property <a href="preferences.html#autoNewline">autoNewline</a>
1305is <code>true</code>, also inserts a line separator
1306and moves the caret to the appropriate column on the new line.
1307<br><br>
1308<b>Default key mapping:</b> '}' in Java, JavaScript, C and C++ modes
1309<br><br>
1310<b>See also:</b> <a href="#electricOpenBrace">electricOpenBrace</a>
1311<br><br>
1312</dl><!--<hr>-->
1313
1314<a name="electricColon">electricColon</a><dl><dd>
1315<p>
1316Inserts a colon at the current location of the caret and re-indents the current
1317line according to context.  If the property
1318<a href="preferences.html#autoNewline">autoNewline</a> is <code>true</code>,
1319also inserts a line separator and moves the caret to the appropriate column on
1320the new line.
1321<br><br>
1322<b>Default key mapping:</b> ':' in Java mode
1323<br><br>
1324</dl><!--<hr>-->
1325
1326<a name="electricOpenBrace">electricOpenBrace</a><dl><dd>
1327<p>
1328Inserts '{' and re-indents the current line according to context. If
1329the property <a href="preferences.html#autoNewline">autoNewline</a>
1330is <code>true</code>, also inserts a line separator
1331and moves the caret to the appropriate column on the new line.
1332<br><br>
1333<b>Default key mapping:</b> '{' in Java, JavaScript, C and C++ modes
1334<br><br>
1335<b>See also:</b> <a href="#electricCloseBrace">electricCloseBrace</a>
1336<br><br>
1337</dl><!--<hr>-->
1338
1339<a name="electricPound">electricPound</a><dl><dd>
1340<p>
1341Inserts a '#' character at the current location of the caret.  If the line
1342contains only whitespace, the '#' will be forced into the first column.
1343<br><br>
1344<b>Default key mapping:</b> '#' in C and C++ modes
1345<br><br>
1346</dl><!--<hr>-->
1347
1348<a name="electricSemi">electricSemi</a><dl><dd>
1349<p>
1350Inserts a semicolon at the current location of the caret and re-indents the
1351current line according to context.  If the property <a href="preferences.html#autoNewline">autoNewline</a> is
1352<code>true</code>, also inserts a line separator and moves the caret to the
1353appropriate column on the new line.
1354<br><br>
1355<b>Default key mapping:</b> ';' in Java, JavaScript, C and C++ modes
1356<br><br>
1357</dl><!--<hr>-->
1358
1359<a name="electricStar">electricStar</a><dl><dd>
1360<p>
1361Inserts '*' at the current location of the caret and, if the current line is
1362otherwise blank, re-indents the line according to context.
1363<br><br>
1364<b>Default key mapping:</b> '*' in Java, JavaScript, C and C++ modes
1365<br><br>
1366</dl><!--<hr>-->
1367
1368<a name="end">end</a><dl><dd>
1369<p>
1370Moves the caret to the end of the current line.
1371<p>
1372If the preference <a href="preferences.html#extendEnd">extendEnd</a> is true,
1373invoking <b>end</b> repeatedly in quick sequence triggers special behavior
1374after the caret reaches the end of the current line: the caret is first moved
1375to the bottom of the edit window, and then to the end of the buffer. There is
1376a one-second timeout on this operation, meaning that if one second elapses
1377between invocations of <b>end</b>, the second invocation is viewed as an
1378independent event rather than a repetition of the first, and the special
1379behavior is not triggered.
1380<p>
1381<b>Default key mapping:</b> End
1382<p>
1383<b>See also:</b> <a href="#home">home</a>
1384<br><br>
1385</dl><!--<hr>-->
1386
1387<a name="entabRegion">entabRegion</a><dl><dd>
1388<p>
1389Replaces spaces with tab characters in the selected region, based on the tab
1390width of the buffer. Buffer-specific settings such as <code>tabWidth</code> may
1391be inspected and modified in the Properties dialog (see <a href="#properties">properties</a>).
1392<p>
1393<b>Default key mapping:</b> None
1394<p>
1395<b>See also:</b> <a href="#detabRegion">detabRegion</a>
1396<br><br>
1397</dl><!--<hr>-->
1398
1399<a name="eob">eob</a><dl><dd>
1400<p>
1401Moves the caret to the end of the buffer.
1402<br><br>
1403<b>Default key mapping:</b> Ctrl End
1404<br><br>
1405</dl><!--<hr>-->
1406
1407<a name="eol">eol</a><dl><dd>
1408<p>
1409Moves the caret to the end of the line.
1410<br><br>
1411<b>Default key mapping:</b> None
1412<br><br>
1413</dl><!--<hr>-->
1414
1415<a name="evalDefunLisp">evalDefunLisp</a><dl><dd>
1416<p>
1417Sends the definition at the location of the caret in a Lisp source buffer to
1418the active Lisp shell for evaluation.
1419<p>
1420<b>Default key mapping:</b> Ctrl Alt E in Lisp mode
1421<p>
1422<b>See also:</b> <a href="#evalRegionLisp">evalRegionLisp</a>
1423<br><br>
1424</dl><!--<hr>-->
1425
1426<a name="evalRegionLisp">evalRegionLisp</a><dl><dd>
1427<p>
1428Sends the selected region in a Lisp source buffer to the active Lisp shell for
1429evaluation.
1430<p>
1431<b>Default key mapping:</b> Ctrl Alt R in Lisp mode
1432<p>
1433<b>See also:</b> <a href="#evalDefunLisp">evalDefunLisp</a>
1434<br><br>
1435</dl><!--<hr>-->
1436
1437<a name="escape">escape</a><dl><dd>
1438<p>
1439Escapes from the last operation.
1440<p>
1441More specifically, closes the most recently visited transient buffer (and
1442possibly unsplits the window). Transient buffers include help buffers, list
1443occurrencess buffers, and compilation buffers.
1444<p>
1445If no transient buffer is currently displayed, clears the selection
1446(if any) in the current buffer.
1447<p>
1448Otherwise, cancels any background process associated with the current buffer.
1449<p>
1450Each invocation of <code>escape</code> does at most one thing.
1451<p>
1452<b>Default key mapping:</b> Escape
1453<br><br>
1454</dl><!--<hr>-->
1455
1456<a name="executeCommand">executeCommand</a><dl><dd>
1457<p>
1458Executes an editor command by name. The "Command:" textfield in the location
1459bar supports both history (using the up and down arrow keys) and completion
1460(using Tab and Shift Tab).
1461<p>
1462Some commands (for example, <a href="#insertString">insertString</a>,
1463<a href="#help">help</a>, <a href="#jdkHelp">jdkHelp</a>, and
1464<a href="#source">source</a>) require or accept an argument (which in the
1465current implementation is always a string). Such commands can be entered like
1466this:
1467<pre>
1468        insertString this is a test
1469</pre>
1470or like this:
1471<pre>
1472        insertString("this is a test")
1473</pre>
1474<b>Default key mapping:</b> Alt x
1475<br><br>
1476</dl><!--<hr>-->
1477
1478<a name="expand">expand</a><dl><dd>
1479<p>
1480Replaces the text to the left of the caret with a word in the current buffer for
1481which that text is a prefix.
1482<br><br>
1483The expand command takes the sequence of characters you've just typed (more
1484precisely, the sequence of characters that are legal in a Java identifier,
1485beginning immediately to the left of the caret), looks through the entire
1486buffer for words (i.e. legal Java identifiers) that have the sequence in
1487question as a prefix, and replaces the sequence of characters with the first
1488match it finds.
1489<p>
1490If you don't like that particular replacement, you can hit Alt Space (or Alt
1491/) again (and again and again) to cycle through all the possible replacements.
1492If you don't like any of the replacements, you can use
1493<a href="#undo">undo</a>, mapped by default to Ctrl Z, or
1494<a href="#escape">escape</a>, mapped by default to Escape, at any point, and
1495get back where you started.
1496<p>
1497In the header area of a mail composition buffer, expand looks for completions
1498in the global address book, rather than in the text of the buffer, so you can
1499use it to auto-complete mail addresses.
1500<p>
1501This functionality is also available in all of j's textfields (both in dialog
1502boxes and in the location bar), with the same default key mappings. In a
1503textfield, the expansion text is taken from the current buffer, and the
1504expansion can be cancelled by pressing Escape.
1505<p>
1506<b>Default key mapping:</b> Alt Space (except on Windows), Alt /
1507<br><br>
1508</dl><!--<hr>-->
1509
1510<a name="find">find</a><dl><dd>
1511<p>
1512Prompts for a pattern and finds the next occurrence of the specified pattern in
1513the current buffer.
1514<p>
1515The search is case-insensitive if the "Ignore case" checkbox is checked.
1516<p>
1517If the "Whole words only" checkbox is checked, a match is returned only if it
1518is both preceded and followed by a non-word character (i.e. a character not
1519legal in an identifier, based on the mode of the buffer).
1520<p>
1521If the "Regular expression" checkbox is checked, the pattern is interpreted as
1522a <a href="regexp.html">regular expression</a> rather than as a simple string.
1523<p>
1524If the "Multiline pattern" checkbox is checked, the regular expression can
1525contain newline characters ("\n"). Because of the way j handles things
1526internally, a single "\n" should be used to match a newline even if the file
1527being edited uses "\r\n" or "\r" as its line separator string. (The "Multiline
1528pattern" feature is experimental and is not enabled by default.)
1529<p>
1530If the "List occurrences" checkbox is checked, all lines in the current buffer
1531that match the specified pattern are listed.
1532<p>
1533If the "Search from start of document" checkbox is checked, the search begins
1534at the start of the document. Otherwise, the search begins at the current
1535location of the caret.
1536<p>
1537<b>Default key mapping:</b> Ctrl F, Alt F3
1538<p>
1539<b>Note:</b> If you set
1540<a href="preferences.html#useIncrementalFind">useIncrementalFind</a> to true
1541in your <a href="preferences.html">preferences</a> file,
1542<a href="commands.html#incrementalFind">incrementalFind</a> will be mapped by
1543default to Ctrl F.
1544<br><br>
1545</dl><!--<hr>-->
1546
1547<a name="findFirstOccurrence">findFirstOccurrence</a><dl><dd>
1548<p>
1549Finds the first occurrence in the current buffer of the word at the current
1550location of the caret.
1551<p>
1552The search is case-sensitive and is carried out as if the "whole words only"
1553option was specified.
1554<p>
1555<b>Default key mapping:</b> Ctrl Alt Up
1556<p>
1557<b>See also:</b> <a href="#findNextWord">findNextWord</a>,
1558<a href="#findPrevWord">findPrevWord</a>
1559<br><br>
1560</dl><!--<hr>-->
1561
1562<a name="findInFiles">findInFiles</a><dl><dd>
1563<p>
1564Prompts for a pattern and a file specification and generates a list of all
1565occurrences of the specified pattern in files matching the file specification.
1566<p>
1567Several file specifications can be supplied at once, separated by semicolons.
1568If the full path is not given in a file specification, the current directory or
1569the directory last specified by a full path is used.
1570<p>
1571For example, if the file specification is <code>*.c;/usr/src/emacs-20.3/src/*.c;*.h</code>,
1572the search will examine <code>.c</code> files in the current directory and
1573<code>.c</code> and <code>.h</code> files in <code>/usr/src/emacs-20.3/src</code>.
1574<p>
1575The search is case-insensitive if the "Ignore case" checkbox is checked.
1576<p>
1577When the "Whole words only" checkbox is checked, a match is returned only if it
1578is both preceded and followed by a non-word character (i.e. a character not
1579legal in an identifier in the specified mode).
1580<p>
1581If the "Regular expression" checkbox is checked, the pattern is interpreted as
1582a <a href="regexp.html">regular expression</a> rather than as a simple string.
1583<p>
1584If the "Include subdirectories" checkbox is checked, the search examines files
1585in any subdirectories of directories in the file specification. For example,
1586if the file specification is <code>/usr/src/linux/*.c</code>, the search will
1587examine <code>.c</code> files in <code>/usr/src/linux</code> and all of its
1588subdirectories.
1589<p>
1590If the "Search files in memory" checkbox is checked, if a file matching the
1591file specification is currently loaded in a buffer, the contents of the buffer
1592will be searched rather than the file as last saved on disk, so unsaved
1593changes to the buffer will be taken into account.
1594<p>
1595You can use the command <a href="#escape">escape</a>, mapped by default to
1596Escape, to cancel a search in progress.
1597<p>
1598<b>Default key mapping:</b> Ctrl Shift F, F6
1599<p>
1600<b>See also:</b> <a href="#listFiles">listFiles</a>
1601<br><br>
1602</dl><!--<hr>-->
1603
1604<a name="findMatchingChar">findMatchingChar</a><dl><dd>
1605<p>
1606Finds the match of the brace, parenthesis or bracket at the location of the
1607caret.
1608<br><br>
1609<b>Default key mapping:</b> Ctrl M
1610<br><br>
1611</dl><!--<hr>-->
1612
1613<a name="findNext">findNext</a><dl><dd>
1614<p>
1615Finds the next match in the current search (initiated by <a href="#find">find</a>,
1616<a href="#incrementalFind">incrementalFind</a>, <a href="#findNextWord">findNextWord</a>
1617or <a href="#findPrevWord">findPrevWord</a>).
1618<br><br>
1619<b>Default key mapping:</b> F3, Ctrl G
1620<br><br>
1621</dl><!--<hr>-->
1622
1623<a name="findNextWord">findNextWord</a><dl><dd>
1624<p>
1625Finds the next occurrence in the current buffer of the word at the current
1626location of the caret.
1627<p>
1628The search is case-sensitive and is carried out as if the "whole words only"
1629option was specified.
1630<p>
1631<b>Default key mapping:</b> Alt Down
1632<p>
1633<b>See also:</b> <a href="#findFirstOccurrence">findFirstOccurrence</a>,
1634<a href="#findPrevWord">findPrevWord</a>
1635<br><br>
1636</dl><!--<hr>-->
1637
1638<a name="findOccurrenceAtDot">findOccurrenceAtDot</a><dl><dd>
1639<p>
1640Jumps to the line in the source file corresponding to the current line in a
1641List Occurrences buffer.
1642<p>
1643<b>Default key mapping:</b> Enter or Ctrl Shift G in List Occurrences buffers
1644<p>
1645<b>See also:</b> <a href="#mouseFindOccurrence">mouseFindOccurrence</a>
1646<br><br>
1647</dl><!--<hr>-->
1648
1649<a name="findPrev">findPrev</a><dl><dd>
1650<p>
1651Finds the previous match in the current search (initiated by <a href="#find">find</a>,
1652<a href="#incrementalFind">incrementalFind</a>, <a href="#findNextWord">findNextWord</a>
1653or <a href="#findPrevWord">findPrevWord</a>).
1654<br><br>
1655<b>Default key mapping:</b> Shift F3, Ctrl H
1656<br><br>
1657</dl><!--<hr>-->
1658
1659<a name="findPrevWord">findPrevWord</a><dl><dd>
1660<p>
1661Finds the previous occurrence in the current buffer of the word at the current
1662location of the caret.
1663<p>
1664The search is case-sensitive and is carried out as if the "whole words only"
1665option was specified.
1666<p>
1667<b>Default key mapping:</b> Alt Up
1668<p>
1669<b>See also:</b> <a href="#findFirstOccurrence">findFirstOccurrence</a>,
1670<a href="#findNextWord">findNextWord</a>
1671<br><br>
1672</dl><!--<hr>-->
1673
1674<a name="findTag">findTag</a><dl><dd>
1675<p>
1676Prompts for a tag (generally speaking, a tag is a function name) and moves the
1677caret to the definition of the specified function. The current location of the
1678caret is first saved on the marker stack as a temporary bookmark, so you can
1679use <a href="#popPosition">popPosition</a>, mapped by default to Shift F5, to
1680get back where you came from.
1681<p>
1682<b>Default key mapping:</b> Ctrl T
1683<p>
1684<b>See also:</b> <a href="#findTagAtDot">findTagAtDot</a>,
1685<a href="#findTagAtDotOtherWindow">findTagAtDotOtherWindow</a>,
1686<a href="#mouseFindTag">mouseFindTag</a>
1687<br><br>
1688</dl><!--<hr>-->
1689
1690<a name="findTagAtDot">findTagAtDot</a><dl><dd>
1691<p>
1692Jumps to the definition of the function at the current location of the caret.
1693The current location of the caret is first saved on the marker stack as a
1694temporary bookmark, so you can use <a href="#popPosition">popPosition</a>,
1695mapped by default to Shift F5, to get back where you came from.
1696<p>
1697<b>Default key mapping:</b> Alt . (Alt dot) in Java, C, C++, Lisp, Scheme and
1698Perl modes
1699<p>
1700<b>See also:</b> <a href="#findTag">findTag</a>,
1701<a href="#findTagAtDotOtherWindow">findTagAtDotOtherWindow</a>,
1702<a href="#mouseFindTag">mouseFindTag</a>
1703<br><br>
1704</dl><!--<hr>-->
1705
1706<a name="findTagAtDotOtherWindow">findTagAtDotOtherWindow</a><dl><dd>
1707<p>
1708Jumps to the definition of the function at the current location of the caret,
1709using the other window (splitting the current window if necessary). Keyboard
1710focus stays in the original window.
1711<p>
1712<b>Default key mapping:</b> Ctrl Alt . (Ctrl Alt dot) in Java mode and its
1713derivatives
1714<p>
1715<b>See also:</b> <a href="#findTag">findTag</a>,
1716<a href="#findTagAtDot">findTagAtDot</a>,
1717<a href="#mouseFindTag">mouseFindTag</a>
1718<br><br>
1719</dl><!--<hr>-->
1720
1721<a name="finish">finish</a><dl><dd>
1722<p>
1723Completes the CVS checkin operation, using the contents of the current buffer
1724as the checkin comment. This command is only available in CVS checkin buffers.
1725<p>
1726<b>Default key mapping:</b> Ctrl Enter in CVS checkin buffers
1727<p>
1728<b>See also:</b> <a href="cvs.html">CVS Support</a>
1729<br><br>
1730</dl><!--<hr>-->
1731
1732<a name="fold">fold</a><dl><dd>
1733<p>
1734Creates a fold at (or near) the current location of the caret.
1735<br><br>
1736<b>Default key mapping:</b> Ctrl [ in Java, C, C++ and Perl modes
1737<br><br>
1738<b>See also:</b> <a href="#foldMethods">foldMethods</a>,
1739<a href="#unfold">unfold</a>, <a href="#unfoldAll">unfoldAll</a>
1740<br><br>
1741</dl><!--<hr>-->
1742
1743<a name="foldMethods">foldMethods</a><dl><dd>
1744<p>
1745Folds all the methods in the current buffer.
1746<br><br>
1747<b>Default key mapping:</b> None
1748<br><br>
1749<b>See also:</b> <a href="#fold">fold</a>,
1750<a href="#foldRegion">foldRegion</a>, <a href="#unfold">unfold</a>,
1751<a href="#unfoldAll">unfoldAll</a>
1752<br><br>
1753</dl><!--<hr>-->
1754
1755<a name="foldRegion">foldRegion</a><dl><dd>
1756<p>
1757Folds the marked region. The region in question must consist of full lines; in
1758other words, both dot and mark must be in column 1.
1759<br><br>
1760<b>Default key mapping:</b> None
1761<br><br>
1762<b>See also:</b> <a href="#fold">fold</a>,
1763<a href="#foldMethods">foldMethods</a>, <a href="#unfold">unfold</a>,
1764<a href="#unfoldAll">unfoldAll</a>
1765<br><br>
1766</dl><!--<hr>-->
1767
1768<a name="forwardSexp">forwardSexp</a><dl><dd>
1769<p>
1770Moves forward across one balanced syntactic expression, if possible.
1771<p>
1772<b>Default key mapping:</b> Ctrl Alt F in Lisp mode
1773<p>
1774<b>See also:</b> <a href="#backwardSexp">backwardSexp</a>,
1775<a href="#downList">downList</a>, <a href="#backwardUpList">backwardUpList</a>
1776<br><br>
1777</dl><!--<hr>-->
1778
1779<a name="gotoBookmark">gotoBookmark</a><dl><dd>
1780<p>
1781Returns to a previously dropped numbered bookmark. By default,
1782<code>dropBookmark</code> is mapped to the ten keystrokes Alt 0 through Alt 9, and
1783<code>gotoBookmark</code> is mapped by default to the ten keystrokes Ctrl 0 through
1784Ctrl 9. When you drop a bookmark with Alt n, you can return to it with Ctrl n.
1785It's possible to unmap these keystrokes or map other commands to them, but the
1786current implementation of <code>dropBookmark</code> and <code>gotoBookmark</code> only
1787works with these key mappings.
1788<br><br>
1789You can still return to a bookmark even if the buffer it refers to has been
1790closed (in that case the buffer will be re-opened in the current frame), but
1791bookmarks are not retained from one session to the next.
1792<br><br>
1793<b>Default key mapping:</b> Ctrl 0 through Ctrl 9 (bookmarks 0-9)
1794<br><br>
1795<b>See also:</b> <a href="#dropBookmark">dropBookmark</a>
1796<br><br>
1797</dl><!--<hr>-->
1798
1799<a name="gotoFile">gotoFile</a><dl><dd>
1800<p>
1801Opens the file at the location of the caret or mouse click.
1802<p>
1803<b>Default key mapping:</b> Ctrl Shift G (global), Mouse-2 (shell buffers)
1804<br><br>
1805</dl><!--<hr>-->
1806
1807<a name="gotoTemporaryMarker">gotoTemporaryMarker</a><dl><dd>
1808<p>
1809Returns to a previously dropped temporary marker.
1810<p>
1811<b>Default key mapping:</b> Ctrl \
1812<p>
1813<b>See also:</b> <a href="#dropTemporaryMarker">dropTemporaryMarker</a>
1814<br><br>
1815</dl><!--<hr>-->
1816
1817<a name="help">help</a><dl><dd>
1818<p>
1819Displays help.
1820<p>
1821For this command to work, you may need to set the <a href="preferences.html#docPath">docPath</a>
1822property in your <a href="preferences.html">preferences</a> file to point to the
1823directory containing the documentation:
1824<pre>
1825        docPath=/home/peter/j/doc
1826</pre>
1827For Windows, you'll need to use double backslashes, like this:
1828<pre>
1829        docPath=c:\\j\\doc
1830</pre>
1831If you use
1832<a href="#executeCommand">executeCommand</a> to invoke help, you can
1833specify the command you want help on at the same time:
1834<pre>
1835        help executeCommand
1836</pre>
1837or
1838<pre>
1839        help("executeCommand")
1840</pre>
1841<b>Default key mapping:</b> F1
1842<p>
1843<b>See also:</b> <a href="#executeCommand">executeCommand</a>
1844<br><br>
1845</dl><!--<hr>-->
1846
1847<a name="home">home</a><dl><dd>
1848<p>
1849Moves the caret to the beginning of the text on the current line, if the caret
1850is to the right of that location to begin with. If the caret is already at the
1851beginning of the text on the current line or in the whitespace to the left of
1852the text, <b>home</b> moves the caret to column 1 on the same line.
1853<p>
1854If the preference <a href="preferences.html#extendHome">extendHome</a> is
1855true, invoking <b>home</b> repeatedly in quick sequence triggers special
1856behavior after the caret reaches column 1 on the current line: the caret is
1857then moved to the top left corner of the edit window, and then to the
1858beginning of the buffer. There is a one-second timeout on this operation,
1859meaning that if one second elapses between invocations of <b>home</b>, the
1860second invocation is viewed as an independent event rather than a repetition
1861of the first, and the special behavior is not triggered.
1862<p>
1863<a href="preferences.html#extendHome">extendHome</a> is false by default.
1864<p>
1865<b>Default key mapping:</b> Home
1866<p>
1867<b>See also:</b> <a href="#end">end</a>
1868<br><br>
1869</dl><!--<hr>-->
1870
1871<a name="htmlBold">htmlBold</a><dl><dd>
1872<p>
1873Inserts an HTML bold tag ("&lt;B&gt;") before the selected text (or before the location of
1874the caret, if there's no selection) and an HTML end tag ("&lt;/B&gt;") after the selected
1875text (or after the location of the caret).
1876<br><br>
1877The case of the inserted tags is controlled by the property <a href="preferences.html#HtmlMode.upperCaseTagNames">HtmlMode.upperCaseTagNames</a>,
1878which is <code>true</code> by default.
1879<br><br>
1880<b>Default key mapping:</b> Ctrl B in HTML mode
1881<br><br>
1882<b>See also:</b> <a href="#htmlInsertTag">htmlInsertTag</a>
1883
1884<br><br>
1885</dl><!--<hr>-->
1886
1887<a name="htmlElectricEquals">htmlElectricEquals</a><dl><dd>
1888<p>
1889Inserts '=' at the current location of the caret.
1890<br><br>
1891In HTML mode, if the property
1892<a href="preferences.html#HtmlMode.attributesRequireQuotes">HtmlMode.attributesRequireQuotes</a>
1893is true, and if the '=' immediately follows an attribute name, and if the
1894character following the '=' is either whitespace or '>', this command inserts
1895a pair of double quotation marks after the '=' and positions the caret between
1896the quotation marks.
1897<p>
1898The effect of this is to make it possible to enclose attribute values in
1899quotation marks without having to type the quotation marks themselves.
1900<p>
1901<b>Default key mapping:</b> '=' in HTML mode
1902<p>
1903<b>See also:</b> <a href="#xmlElectricEquals">xmlElectricEquals</a>
1904<br><br>
1905</dl><!--<hr>-->
1906
1907<a name="htmlEndTag">htmlEndTag</a><dl><dd>
1908<p>
1909Inserts an empty HTML end tag, with the caret positioned after the opening "&lt;/".
1910<br><br>
1911<b>Default key mapping:</b> Ctrl Shift .
1912<br><br>
1913</dl><!--<hr>-->
1914
1915<a name="htmlFindMatch">htmlFindMatch</a><dl><dd>
1916<p>
1917Finds the match to the HTML tag at the location of the caret.  Nested tags are
1918handled correctly.
1919<br><br>
1920<b>Default key mapping:</b> Ctrl M in HTML mode
1921<br><br>
1922</dl><!--<hr>-->
1923
1924<a name="htmlInsertMatchingEndTag">htmlInsertMatchingEndTag</a><dl><dd>
1925<p>
1926Inserts the HTML end tag corresponding to the last HTML start tag before the
1927location of the caret. Nested tags are not currently supported.
1928<br><br>
1929<b>Default key mapping:</b> Ctrl E in HTML mode
1930<br><br>
1931</dl><!--<hr>-->
1932
1933<a name="htmlInsertTag">htmlInsertTag</a><dl><dd>
1934<p>
1935Inserts an HTML start tag and (if appropriate) the corresponding end tag,
1936enclosing the current selection. If no selection is marked, the start and end
1937tags will enclose the word at the current location of the caret, if any.
1938<br><br>
1939If the property <a href="preferences.html#HtmlMode.fixCase">HtmlMode.fixCase</a>
1940is true, the tag name will be converted to the preferred case (as specified by
1941<a href="preferences.html#HtmlMode.upperCaseTagNames">HtmlMode.upperCaseTagNames</a>
1942when it is inserted in the buffer.
1943<br><br>
1944J will normally insert an end tag unless it is forbidden.  You can customize this
1945behavior by supply a tag customization file; see <a href="preferences.html#HtmlMode.tags">HtmlMode.tags</a>.
1946<br><br>
1947<b>Default key mapping:</b> Ctrl Shift , (Ctrl Shift comma) in HTML mode
1948<br><br>
1949</dl><!--<hr>-->
1950
1951<a name="htmlStartTag">htmlStartTag</a><dl><dd>
1952<p>
1953Inserts an empty HTML start tag, with the caret positioned after the opening angle bracket.
1954<br><br>
1955<b>Default key mapping:</b> None
1956<br><br>
1957</dl><!--<hr>-->
1958
1959<a name="httpShowHeaders">httpShowHeaders</a><dl><dd>
1960<p>
1961Displays the request and response headers for the current HTTP buffer.
1962<p>
1963<b>Default key mapping:</b> None
1964<br><br>
1965</dl><!--<hr>-->
1966
1967<a name="hyperspec">hyperspec</a><dl><dd>
1968<p>
1969Displays the Common Lisp HyperSpec documentation for the symbol at the current
1970location of the caret.
1971<p>
1972The documentation is displayed in another window, splitting the current window
1973if necessary. This transient window can be dismissed using
1974<a href="#escape">escape</a>, mapped by default to Escape.
1975<p>
1976You can also invoke the hyperspec command with Alt X, giving the symbol name as
1977an argument (e.g. Alt X, "hyperspec mapcar", or Alt X, "hs mapcar").
1978<p>
1979The Common Lisp HyperSpec is available here:
1980<pre>
1981        http://www.lispworks.com/reference/HyperSpec/index.html</pre>
1982<p>
1983For this command to work, you may need to add a line to your
1984<a href="preferences.html">preferences</a> file specifying the location of the
1985HyperSpec root directory on your system:
1986<pre>
1987        clhsRoot = /usr/share/doc/hyperspec</pre>
1988<p>
1989<b>Default key mapping:</b> Alt F1 in Lisp mode
1990<p>
1991<b>Abbreviation:</b> hs
1992<p>
1993<b>See also:</b> <a href="preferences.html#clhsRoot">clhsRoot</a>
1994<br><br>
1995</dl><!--<hr>-->
1996
1997<a name="iList">iList</a><dl><dd>
1998<p>
1999Lists all occurrences of the identifier at the location of the caret, both in
2000the current buffer and in any files referenced by a "#include" directive in
2001the current buffer, in the order in which they occur.
2002<p>
2003<b>Default key mapping:</b> Ctrl F6 in C and C++ modes
2004<p>
2005<b>See also:</b> <a href="preferences.html#includePath">includePath</a>,
2006<a href="#checkPath">checkPath</a>, <a href="#listIncludes">listIncludes</a>
2007<br><br>
2008</dl><!--<hr>-->
2009
2010<a name="imageCycleBackground">imageCycleBackground</a><dl><dd>
2011<p>
2012In Image mode, changes the background color of the image. Invoking this command
2013repeatedly cycles through a small number of plausible background colors
2014(currently gray, black and white).
2015<br><br>
2016<b>Default key mapping:</b> 'c' in Image mode
2017<br><br>
2018</dl><!--<hr>-->
2019
2020<a name="imageFit">imageFit</a><dl><dd>
2021<p>
2022Scales the image to fit the current display window. The aspect ratio of the
2023original image is preserved.
2024<br><br>
2025<b>Default key mapping:</b> 'f' in Image mode
2026<br><br>
2027<b>See also:</b> <a href="#imageRestore">imageRestore</a>,
2028<a href="#imageZoomIn">imageZoomIn</a>,
2029<a href="#imageZoomOut">imageZoomOut</a>
2030<br><br>
2031</dl><!--<hr>-->
2032
2033<a name="imageRestore">imageRestore</a><dl><dd>
2034<p>
2035Restores the image to its original size.
2036<br><br>
2037<b>Default key mapping:</b> 'r' in Image mode
2038<br><br>
2039<b>See also:</b> <a href="#imageFit">imageFit</a>,
2040<a href="#imageZoomIn">imageZoomIn</a>,
2041<a href="#imageZoomOut">imageZoomOut</a>
2042<br><br>
2043</dl><!--<hr>-->
2044
2045<a name="imageZoomIn">imageZoomIn</a><dl><dd>
2046<p>
2047Zoom in by a factor of 2.
2048<br><br>
2049<b>Default key mapping:</b> '=' in Image mode
2050<br><br>
2051<b>See also:</b> <a href="#imageFit">imageFit</a>,
2052<a href="#imageRestore">imageRestore</a>,
2053<a href="#imageZoomOut">imageZoomOut</a>
2054<br><br>
2055</dl><!--<hr>-->
2056
2057<a name="imageZoomOut">imageZoomOut</a><dl><dd>
2058<p>
2059Zoom out by a factor of 2.
2060<br><br>
2061<b>Default key mapping:</b> '-' in Image mode
2062<br><br>
2063<b>See also:</b> <a href="#imageFit">imageFit</a>,
2064<a href="#imageRestore">imageRestore</a>,
2065<a href="#imageZoomIn">imageZoomIn</a>
2066<br><br>
2067</dl><!--<hr>-->
2068
2069<a name="inbox">inbox</a><dl><dd>
2070<p>
2071Opens your default inbox.
2072<br><br>
2073To specify your default inbox, add a line like this to your
2074<a href="preferences.html">preferences</a> file:
2075<pre>
2076        inbox = pop://peter@annie</pre>
2077or for IMAP:
2078<pre>
2079        inbox = {peter@annie}inbox</pre>
2080<b>Default key mapping:</b> None
2081<br><br>
2082<b>See also:</b> <a href="#openMailbox">openMailbox</a>,
2083<a href="mail.html">Mail</a>
2084<br><br>
2085</dl><!--<hr>-->
2086
2087<a name="incrementalFind">incrementalFind</a><dl><dd>
2088<p>
2089Prompts for input and finds the string entered, as it is typed in.
2090<br><br>
2091The search is case-insensitive unless (or until) the pattern contains at least
2092one upper case character.
2093<br><br>
2094In the incremental find textfield, any key combination mapped to
2095<code>incrementalFind</code> or <code>findNext</code> can be used to search
2096for the next occurrence of the current pattern, and any key combination mapped
2097to <code>findPrev</code> can be used to search for the previous occurrence of
2098the pattern. (By default, <code>findNext</code> is mapped to F3 and Ctrl G, and
2099<code>findPrev</code> is mapped to Shift F3 and Ctrl H.)
2100<p>
2101Ctrl W can be used to copy text from the buffer into the search pattern. Ctrl
2102W copies the text from the buffer starting at the current location of the
2103caret up until the end of the current word (or the end of the next word, if
2104the caret is already at the end of the current word).
2105<p>
2106Ctrl P and Ctrl N can be used to navigate through the history list of
2107previously used search patterns.
2108<p>
2109If you invoke <a href="#incrementalFind">incrementalFind</a> and then realize
2110you'd rather use <a href="#find">find</a> instead, you can get there by simply
2111pressing Enter (as long as the incremental find textfield is empty).
2112<p>
2113<b>Default key mapping:</b> None
2114<p>
2115<b>Note:</b> If you set
2116<a href="preferences.html#useIncrementalFind">useIncrementalFind</a> to true
2117in your <a href="preferences.html">preferences</a> file,
2118<a href="#incrementalFind">incrementalFind</a> will be mapped by default to
2119Ctrl F.
2120<br><br>
2121</dl><!--<hr>-->
2122
2123<a name="indentLine">indentLine</a><dl><dd>
2124<p>
2125Applies j's idea of correct indentation to the current line.
2126<br><br>
2127<b>Default key mapping:</b> None
2128<p>
2129<b>See also:</b> <a href="#indentRegion">indentRegion</a>,
2130<a href="#indentLineOrRegion">indentLineOrRegion</a>,
2131<a href="preferences.html#indentLineFixWhitespace">indentLineFixWhitespace</a>
2132<br><br>
2133</dl><!--<hr>-->
2134
2135<a name="indentLineOrRegion">indentLineOrRegion</a><dl><dd>
2136<p>
2137Applies j's idea of correct indentation to the marked region, or, if no region is
2138marked, the current line.
2139<p>
2140<b>Default key mapping:</b> None
2141<p>
2142<b>See also:</b> <a href="#indentLine">indentLine</a>,
2143<a href="#indentRegion">indentRegion</a>,
2144<a href="preferences.html#indentLineFixWhitespace">indentLineFixWhitespace</a>
2145<br><br>
2146</dl><!--<hr>-->
2147
2148<a name="indentRegion">indentRegion</a><dl><dd>
2149<p>
2150Applies j's idea of correct indentation to the marked region.
2151<br><br>
2152<b>Default key mapping:</b> None
2153<p>
2154<b>See also:</b> <a href="commands.html#indentLine">indentLine</a>,
2155<a href="#indentLineOrRegion">indentLineOrRegion</a>,
2156<a href="preferences.html#indentLineFixWhitespace">indentLineFixWhitespace</a>
2157<br><br>
2158</dl><!--<hr>-->
2159
2160<a name="insertBraces">insertBraces</a><dl><dd>
2161<p>
2162Inserts an opening brace followed by a closing brace, indented appropriately,
2163leaving the caret positioned between them.
2164<br><br>
2165<b>Default key mapping:</b> Ctrl Shift [ in Java, JavaScript, C and C++ modes
2166<br><br>
2167</dl><!--<hr>-->
2168
2169<a name="insertByte">insertByte</a><dl><dd>
2170<p>
2171Inserts the character that corresponds to the specified byte in the default
2172encoding at the current location of the caret. The byte must be specified as a
2173decimal, hexadecimal or octal number. A leading zero denotes an octal number; a
2174leading "0x" or "0X" denotes a hexidecimal number; otherwise the number is
2175assumed to be decimal.
2176<br><br>
2177<b>Default key mapping:</b> None
2178<br><br>
2179</dl><!--<hr>-->
2180
2181<a name="insertChar">insertChar</a><dl><dd>
2182<p>
2183Inserts the specified Unicode character at the current location of the caret.
2184The character must be specified as a decimal, hexidecimal or octal number. A
2185leading zero denotes an octal number; a leading "0x" or "0X" denotes a
2186hexidecimal number; otherwise the number is assumed to be decimal.
2187<br><br>
2188<b>Default key mapping:</b> None
2189<br><br>
2190</dl><!--<hr>-->
2191
2192<a name="insertKeyText">insertKeyText</a><dl><dd>
2193<p>
2194Inserts the next key combination you type (which can be a single key like Enter
2195or Backspace, or a combination like Ctrl Alt S) as a string (like "Enter" or
2196"Backspace" or "Ctrl Alt S") at the location of the caret in the current
2197buffer. The action mapped to the key combination in question (if any) is not
2198performed. Useful for editing a custom key map. The inserted text is guaranteed
2199(well, not guaranteed, exactly, but extremely likely) to be in a format
2200recognizable by j's key map parser.
2201<br><br>
2202<b>Default key mapping:</b> None
2203<br><br>
2204</dl><!--<hr>-->
2205
2206<a name="insertParentheses">insertParentheses</a><dl><dd>
2207<p>
2208If a region is selected, inserts parentheses around the selected region.
2209Otherwise, inserts an opening parenthesis followed by a closing parenthesis,
2210leaving the caret positioned between them.
2211<br><br>
2212If <b>parensRequireSpaces</b> is <b>true</b>, single space characters are
2213added after the opening parenthesis and before the closing parenthesis.
2214<br><br>
2215<b>Default key mapping:</b> Ctrl Shift ( in Java, JavaScript, C, C++, and Perl modes
2216<br><br>
2217<b>See also:</b> <a href="#movePastCloseAndReindent">movePastCloseAndReindent</a>
2218<br><br>
2219</dl><!--<hr>-->
2220
2221<a name="insertRegister">insertRegister</a><dl><dd>
2222<p>
2223Prompts for a register name and inserts the contents of the selected register
2224at the location of the caret in the current buffer.
2225<p>
2226Register names must be lower case letters (a-z). The contents of registers
2227persist automatically from one j session to the next.
2228<p>
2229<b>Default key mapping:</b> None
2230<p>
2231<b>Abbreviation:</b> ir
2232<p>
2233<b>See also:</b>
2234<a href="#clearRegister">clearRegister</a>,
2235<a href="#editRegister">editRegister</a>,
2236<a href="#listRegisters">listRegisters</a>.
2237<a href="#saveToRegister">saveToRegister</a>
2238<br><br>
2239</dl><!--<hr>-->
2240
2241<a name="insertString">insertString</a><dl><dd>
2242<p>
2243Requires a string argument. The supplied string argument is inserted in the
2244current buffer at the location of the caret. Can be invoked using
2245<a href="#executeCommand">executeCommand</a> or mapped to a key combination in
2246a global or mode-specific key map.
2247<p>
2248For example:
2249<pre>
2250        insertString("e.printStackTrace( );")
2251</pre>
2252<b>Default key mapping:</b> None
2253<p>
2254<b>See also:</b> <a href="#executeCommand">executeCommand</a>
2255<br><br>
2256</dl><!--<hr>-->
2257
2258<a name="insertTab">insertTab</a><dl><dd>
2259<p>
2260If <code>useTabs</code> is <code>true</code> for the current buffer, inserts a
2261tab character at the location of the caret, otherwise inserts the appropriate
2262number of spaces, based on the buffer's <code>indentSize</code>.
2263Buffer-specific settings such as <code>useTabs</code> and
2264<code>indentSize</code> may be inspected and modified in the Properties dialog
2265(see <a href="#properties">properties</a>).
2266<br><br>
2267<b>Default key mapping:</b> Ctrl Tab in Java and HTML modes
2268<br><br>
2269</dl><!--<hr>-->
2270
2271<a name="jdb">jdb</a><dl><dd>
2272<p>
2273Invokes j's built-in Java debugger, or, if the debugger is already running,
2274ensures that the debugger transcript buffer is visible.
2275<p>
2276If an argument is supplied, it is passed as a command to the running instance
2277of the debugger. For example:
2278<pre>
2279        jdb restart</pre>
2280<p>
2281It is an error to use this command with an argument unless the debugger has
2282already been started.
2283<p>
2284<b>Default key mapping:</b> None
2285<p>
2286<b>See also:</b> <a href="jdb.html">The Java Debugger</a>,
2287<a href="jdbcommands.html">Debugger Commands</a>
2288<br><br>
2289</dl><!--<hr>-->
2290
2291<a name="jdkHelp">jdkHelp</a><dl><dd>
2292<p>
2293Displays the JDK HTML help file corresponding to the class name at the
2294location of the caret or mouse click.
2295<p>
2296The help file is displayed in another window, splitting the current window if
2297necessary. The help buffer can subsequently be dismissed using
2298<a href="#escape">escape</a>, mapped by default to Escape.
2299<p>
2300For this to work, you need to add a line to your
2301<a href="preferences.html">preferences</a> file specifying the location of the
2302JDK documentation:
2303<pre>
2304        jdkDocPath=/home/peter/sun/jdk1.3/docs</pre>
2305<p>
2306<b>Default key mapping:</b> Alt F1 in Java mode
2307<p>
2308<b>See also:</b> <a href="preferences.html#jdkDocPath">jdkDocPath</a>
2309<br><br>
2310</dl><!--<hr>-->
2311
2312<a name="jlisp">jlisp</a><dl><dd>
2313<p>
2314Runs Armed Bear Lisp embedded in the running instance of j, with interaction in
2315a Lisp shell buffer.
2316<p>
2317Using this command to run Lisp lets you use the resulting Lisp shell to
2318interact with the running instance of j.
2319<p>
2320If you don't need to interact with the running instance of j, you should use
2321the <a href="#lisp">lisp</a> command instead of this one. The
2322<a href="#lisp">lisp</a> command runs Lisp as a separate process, making it
2323less likely that ensuing anomalies will have a detrimental impact on your
2324editor session.
2325<p>
2326<b>Default key mapping:</b> None
2327<p>
2328<b>See also:</b> <a href="#lisp">lisp</a>
2329<br><br>
2330</dl><!--<hr>-->
2331
2332<a name="jmips">jmips</a><dl><dd>
2333<p>
2334Measures the performance of the underlying Java runtime system (which is, of
2335course, dependent on the performance of the underlying hardware). The result
2336is displayed in the status bar.
2337<p>
2338The first measurement in a given session may be wildly inaccurate, since some
2339just-in-time compilers wait to compile a method until the second time it is called.
2340<p>
2341<b>Default key mapping:</b> None
2342<br><br>
2343</dl><!--<hr>-->
2344
2345<a name="jumpToColumn">jumpToColumn</a><dl><dd>
2346<p>
2347Prompts for a column number and moves the caret to the specified column.
2348<p>
2349The column number can be a simple number ("123"), an arithmetic expression
2350("100+23"), or a positive or negative offset from the current location ("+7",
2351"-12").
2352<p>
2353<b>Default key mapping:</b> None
2354<br><br>
2355</dl><!--<hr>-->
2356
2357<a name="jumpToLine">jumpToLine</a><dl><dd>
2358<p>
2359Prompts for a line number and moves the caret to the beginning of the specified line.
2360<p>
2361The line number can be a simple number ("123"), an arithmetic expression
2362("100+23"), or a positive or negative offset from the current location ("+7",
2363"-12").
2364<p>
2365<b>Default key mapping:</b> Ctrl J
2366<br><br>
2367</dl><!--<hr>-->
2368
2369<a name="jumpToOffset">jumpToOffset</a><dl><dd>
2370<p>
2371Prompts for an absolute offset (the number of characters from the start of the
2372buffer) and moves the caret to the specified location.
2373<p>
2374The offset can be a simple number ("123"), an arithmetic expression
2375("100+23"), or a positive or negative offset from the current location ("+7",
2376"-12").
2377<p>
2378<b>Default key mapping:</b> None
2379<p>
2380<b>See also:</b> <a href="#offset">offset</a>
2381<br><br>
2382</dl><!--<hr>-->
2383
2384<a name="killAppend">killAppend</a><dl><dd>
2385<p>
2386Deletes the selected region (or the current line if no region is selected),
2387appending the deleted text to the most recent entry in the
2388<a href="killring.html">kill ring</a>.
2389<br><br>
2390<b>Default key mapping:</b> Ctrl Shift X
2391<br><br>
2392</dl><!--<hr>-->
2393
2394<a name="killBuffer">killBuffer</a><dl><dd>
2395<p>
2396Closes the current buffer and removes it from the buffer list. If the buffer has
2397unsaved changes, you will be prompted for confirmation before they are discarded.
2398<br><br>
2399<b>Default key mapping:</b> Ctrl W
2400<br><br>
2401</dl><!--<hr>-->
2402
2403<a name="killFrame">killFrame</a><dl><dd>
2404<p>
2405Closes the current frame.
2406<br><br>
2407<b>Default key mapping:</b> Ctrl Shift W
2408<br><br>
2409</dl><!--<hr>-->
2410
2411<a name="killLine">killLine</a><dl><dd>
2412<p>
2413Copies the text from the location of the caret to the end of the current line to
2414the <a href="killring.html">kill ring</a> and then deletes that text. If the
2415text to be deleted is nothing but whitespace, or if the caret is already at the
2416end of the line, the following line separator is copied to the kill ring and
2417deleted too.
2418<br><br>
2419<b>Default key mapping:</b> Ctrl K
2420<br><br>
2421</dl><!--<hr>-->
2422
2423<a name="killRegion">killRegion</a><dl><dd>
2424<p>
2425Deletes the selected region (or the current line if no region is selected).
2426For normal regions, the deleted text is placed in the
2427<a href="killring.html">kill ring</a>. If the selected region is a column, the
2428deleted text is saved but not placed in the kill ring; it can be retrieved
2429with the command <a href="#pasteColumn">pasteColumn</a>.
2430<p>
2431<b>Default key mapping:</b> Ctrl X
2432<p>
2433<b>See also:</b> <a href="#copyRegion">copyRegion</a>,
2434<a href="columns.html">Columns</a>
2435<br><br>
2436</dl><!--<hr>-->
2437
2438<a name="killWindow">killWindow</a><dl><dd>
2439<p>
2440If the current frame contains two edit windows, closes the current edit window,
2441so that the other edit window fills the frame. Equivalent to
2442<a href="#otherWindow">otherWindow</a> followed by
2443<a href="#unsplitWindow">unsplitWindow</a>.
2444<p>
2445<b>Default key mapping:</b> Ctrl Shift F10
2446<p>
2447<b>See also:</b> <a href="#unsplitWindow">unsplitWindow</a>
2448<br><br>
2449</dl><!--<hr>-->
2450
2451<a name="killWordLeft">killWordLeft</a><dl><dd>
2452<p>
2453Deletes the word to the left of the caret, appending the deleted text to the
2454<a href="killring.html">kill ring</a>.
2455<p>
2456<b>Default key mapping:</b> None
2457<p>
2458<b>See also:</b> <a href="#deleteWordLeft">deleteWordLeft</a>
2459<br><br>
2460</dl><!--<hr>-->
2461
2462<a name="killWordRight">killWordRight</a><dl><dd>
2463<p>
2464Deletes the word to the right of the caret, appending the deleted text to the
2465<a href="killring.html">kill ring</a>.
2466<p>
2467<b>Default key mapping:</b> None
2468<p>
2469<b>See also:</b> <a href="#deleteWordRight">deleteWordRight</a>
2470<br><br>
2471</dl><!--<hr>-->
2472
2473<a name="left">left</a><dl><dd>
2474<p>
2475Moves the caret one character to the left.
2476<p>
2477<b>Default key mapping:</b> Left arrow key
2478<br><br>
2479</dl><!--<hr>-->
2480
2481<a name="lisp">lisp</a><dl><dd>
2482<p>
2483Runs Lisp as a separate process, with interaction in a Lisp shell buffer.
2484<p>
2485By default, this command runs Armed Bear Lisp, which comes bundled with j.
2486<p>
2487If you have <a href="building.html#jpty">jpty</a> installed, you can run a
2488different Lisp by supplying an argument to this command. For example, on a
2489normal Debian system, you can run SBCL (if it's installed) with Alt X, "lisp
2490/usr/bin/sbcl".
2491<p>
2492<b>Default key mapping:</b> None
2493<p>
2494<b>See also:</b> <a href="#jlisp">jlisp</a>
2495<br><br>
2496</dl><!--<hr>-->
2497
2498<a name="lispFindMatchingChar">lispFindMatchingChar</a><dl><dd>
2499<p>
2500Finds the match of the parenthesis at the location of the caret.
2501<p>
2502<b>Default key mapping:</b> Ctrl M in Lisp mode
2503<br><br>
2504</dl><!--<hr>-->
2505
2506<a name="lispSelectSyntax">lispSelectSyntax</a><dl><dd>
2507<p>
2508Selects the syntactic expression in the vicinity of the caret. (If a region is
2509already selected, it is extended to the enclosing syntactic expression.)
2510<p>
2511<b>Default key mapping:</b> Ctrl Shift M in Lisp mode
2512<p>
2513<b>See also:</b> <a href="#selectSyntax">selectSyntax</a>
2514<br><br>
2515</dl><!--<hr>-->
2516
2517<a name="listBindings">listBindings</a><dl><dd>
2518<p>
2519Displays a list of the key bindings that are in effect in the current buffer.
2520<br><br>
2521<b>Default key mapping:</b> None
2522<br><br>
2523</dl><!--<hr>-->
2524
2525<a name="listFiles">listFiles</a><dl><dd>
2526<p>
2527Displays the List Occurrences output buffer generated by the last invocation
2528of <a href="#findInFiles">findInFiles</a>.
2529<p>
2530<b>Default key mapping:</b> Ctrl Shift L
2531<br><br>
2532</dl><!--<hr>-->
2533
2534<a name="listIncludes">listIncludes</a><dl><dd>
2535<p>
2536Recursively lists all files referenced by a "#include" directive in the
2537current buffer or in a file so referenced.
2538<p>
2539<b>Default key mapping:</b> None
2540<p>
2541<b>See also:</b> <a href="preferences.html#includePath">includePath</a>,
2542<a href="#checkPath">checkPath</a>, <a href="#iList">iList</a>
2543<br><br>
2544</dl><!--<hr>-->
2545
2546<a name="listOccurrences">listOccurrences</a><dl><dd>
2547<p>
2548Lists all lines in the current buffer that match the last search.
2549<p>
2550<b>Default key mapping:</b> Ctrl L
2551<br><br>
2552</dl><!--<hr>-->
2553
2554<a name="listOccurrencesOfPatternAtDot">listOccurrencesOfPatternAtDot</a><dl><dd>
2555<p>
2556Lists all occurrences in the current buffer of the selected text (if any) or of
2557the word at the current location of the caret.
2558<p>
2559If text is selected on the current line, the selected text is used as the
2560pattern for the search, and the search is carried out as if the "whole words
2561only" option was not specified.
2562<p>
2563If there is no selection on the current line, the word at the current location
2564of the caret is used as the pattern, and the search is carried out as if
2565the "whole words only" option was specified.
2566<p>
2567The search is case-sensitive (in both cases).
2568<p>
2569Multi-line selections are not supported.
2570<br><br>
2571<b>Default key mapping:</b> Ctrl Alt L
2572<br><br>
2573</dl><!--<hr>-->
2574
2575<a name="listRegisters">listRegisters</a><dl><dd>
2576<p>
2577Lists the contents of all registers in use.
2578<p>
2579Register names must be lower case letters (a-z). The contents of registers
2580persist automatically from one j session to the next.
2581<p>
2582<b>Default key mapping:</b> None
2583<p>
2584<b>Abbreviation:</b> lr
2585<p>
2586<b>See also:</b>
2587<a href="#clearRegister">clearRegister</a>,
2588<a href="#editRegister">editRegister</a>,
2589<a href="#insertRegister">insertRegister</a>,
2590<a href="#saveToRegister">saveToRegister</a>
2591<br><br>
2592</dl><!--<hr>-->
2593
2594<a name="listTags">listTags</a><dl><dd>
2595<p>
2596Lists the tags in the current buffer (generally speaking, a tag is a function
2597name). Pressing Enter in the tag list will move the caret to the definition of
2598the selected function. See <a href="tags.html">Tags and Tag Files</a>.
2599<br><br>
2600<b>Default key mapping:</b> None
2601<br><br>
2602<b>See also:</b> <a href="#sidebarListTags">sidebarListTags</a>
2603<br><br>
2604</dl><!--<hr>-->
2605
2606<a name="loadSession">loadSession</a><dl><dd>
2607<p>
2608Loads a previously saved named session. All currently open buffers are closed
2609before the new session is loaded.
2610<p>
2611<b>Default key mapping:</b> None
2612<p>
2613<b>See also:</b> <a href="sessions.html">Sessions</a>,
2614<a href="#saveSession">saveSession</a>
2615<br><br>
2616</dl><!--<hr>-->
2617
2618<a name="lowerCaseRegion">lowerCaseRegion</a><dl><dd>
2619<p>
2620Converts all upper case characters in the selected region to lower case.
2621<br><br>
2622<b>Default key mapping:</b> None
2623<br><br>
2624<b>See also:</b> <a href="#upperCaseRegion">upperCaseRegion</a>
2625<br><br>
2626</dl><!--<hr>-->
2627
2628<a name="mailboxCreateFolder">mailboxCreateFolder</a><dl><dd>
2629<p><b>Default key mapping:</b> None
2630<br><br>
2631<b>See also:</b> <a href="mail.html">Mail</a>
2632<br><br>
2633</dl><!--<hr>-->
2634
2635<a name="mailboxDelete">mailboxDelete</a><dl><dd>
2636<p>
2637Marks for deletion the tagged messages or the message at the current location
2638of the caret.
2639<br><br>
2640<b>Default key mapping:</b> 'd' in Mailbox mode
2641<br><br>
2642<b>See also:</b> <a href="#mailboxUndelete">mailboxUndelete</a>,
2643<a href="mail.html">Mail</a>
2644<br><br>
2645</dl><!--<hr>-->
2646
2647<a name="mailboxDeleteFolder">mailboxDeleteFolder</a><dl><dd>
2648<p>
2649<b>Default key mapping:</b> None
2650<br><br>
2651<b>See also:</b> <a href="mail.html">Mail</a>
2652<br><br>
2653</dl><!--<hr>-->
2654
2655<a name="mailboxExpunge">mailboxExpunge</a><dl><dd>
2656<p>
2657Commits deletions in the current mailbox.
2658<p>
2659<b>Default key mapping:</b> '$' in Mailbox mode
2660<p>
2661<b>See also:</b> <a href="mail.html">Mail</a>
2662<br><br>
2663</dl><!--<hr>-->
2664
2665<a name="mailboxFlag">mailboxFlag</a><dl><dd>
2666<p>
2667Toggles the "important" flag of the current message (or set of tagged messages).
2668<br><br>
2669<b>Default key mapping:</b> 'F' in Mailbox mode
2670<br><br>
2671<b>See also:</b> <a href="#messageFlag">messageFlag</a>,
2672<a href="mail.html">Mail</a>
2673<br><br>
2674</dl><!--<hr>-->
2675
2676<a name="mailboxGetNewMessages">mailboxGetNewMessages</a><dl><dd>
2677<p>
2678Connects to the server and retrieves any new messages (POP) or message headers
2679(IMAP).
2680<br><br>
2681<b>Default key mapping:</b> 'G' in Mailbox mode
2682<br><br>
2683<b>See also:</b> <a href="mail.html">Mail</a>
2684<br><br>
2685</dl><!--<hr>-->
2686
2687<a name="mailboxLastMessage">mailboxLastMessage</a><dl><dd>
2688<p>
2689Moves to the last message in the mailbox.
2690<br><br>
2691<b>Default key mapping:</b> Ctrl End in Mailbox mode
2692<br><br>
2693<b>See also:</b> <a href="mail.html">Mail</a>
2694<br><br>
2695</dl><!--<hr>-->
2696
2697<a name="mailboxLimit">mailboxLimit</a><dl><dd>
2698<p>
2699Prompts for a pattern and limits the messages displayed in the mailbox to
2700those matching the specified pattern.
2701<br><br>
2702If a simple pattern is specified, j looks for a match in the "Subject" and
2703"From" fields.
2704<br><br>
2705A few special patterns are also supported:
2706<pre>
2707    ~C expression       messages with expression in the "To" or "Cc" field
2708    ~D                  deleted messages
2709    ~d date1-date2      messages with date sent in the range date1-date2 (see below)
2710    ~F                  flagged messages
2711    ~N                  new messages
2712    ~R                  read messages
2713    ~T                  tagged messages
2714    ~t expression       messages with expression in the "To" field
2715    ~U                  unread messages
2716</pre>
2717If the expression to be matched contains any upper case letters, the matches
2718are exact; otherwise, case is ignored.
2719<br><br>
2720Dates must be in DD/MM/YY format. Month and year are optional; if omitted,
2721they default to the current month and year. If you omit the first date and
2722specify "-DD/MM/YY", all messages sent from the beginning of time through the
2723specified date will be selected. If you omit the second date and specify
2724"DD/MM/YY-", all messages sent from the specified date through the end of time
2725will be selected. If you specify a single date with no '-', only messages sent
2726on the specified date will be selected.
2727<br><br>
2728<b>Default key mapping:</b> 'l' (lower case 'L') in Mailbox mode
2729<br><br>
2730<b>See also:</b> <a href="#mailboxTagPattern">mailboxTagPattern</a>,
2731<a href="#mailboxUnlimit">mailboxUnlimit</a>, <a href="mail.html">Mail</a>
2732<br><br>
2733</dl><!--<hr>-->
2734
2735<a name="mailboxMarkRead">mailboxMarkRead</a><dl><dd>
2736<p>
2737Marks the current message (or set of tagged messages) read.
2738<br><br>
2739<b>Default key mapping:</b> 'M' in Mailbox mode
2740<br><br>
2741<b>See also:</b> <a href="mail.html">Mail</a>
2742<br><br>
2743</dl><!--<hr>-->
2744
2745<a name="mailboxMarkUnread">mailboxMarkUnread</a><dl><dd>
2746<p>
2747Marks the current message (or set of tagged messages) unread.
2748<br><br>
2749<b>Default key mapping:</b> Ctrl Shift M in Mailbox mode
2750<br><br>
2751<b>See also:</b> <a href="mail.html">Mail</a>
2752<br><br>
2753</dl><!--<hr>-->
2754
2755<a name="mailboxMoveToFolder">mailboxMoveToFolder</a><dl><dd>
2756<p>
2757Moves the current message (or set of tagged messages) to the specified folder.
2758Only supported in IMAP mailboxes.
2759<br><br>
2760<b>Default key mapping:</b> 'm' in Mailbox mode
2761<br><br>
2762<b>See also:</b> <a href="#mailboxSaveToFolder">mailboxSaveToFolder</a>,
2763<a href="mail.html">Mail</a>
2764<br><br>
2765</dl><!--<hr>-->
2766
2767<a name="mailboxReadMessage">mailboxReadMessage</a><dl><dd>
2768<p>
2769Opens a message buffer to read the message at the current location of the caret.
2770<p>
2771<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1, or Mouse-2 in Mailbox mode
2772<p>
2773<b>See also:</b> <a href="mail.html">Mail</a>
2774<br><br>
2775</dl><!--<hr>-->
2776
2777<a name="mailboxSaveToFolder">mailboxSaveToFolder</a><dl><dd>
2778<p>
2779Saves the current message (or set of tagged messages) in the specified folder.
2780Only supported in IMAP mailboxes.
2781<br><br>
2782<b>Default key mapping:</b> 's' in Mailbox mode
2783<br><br>
2784<b>See also:</b> <a href="#mailboxMoveToFolder">mailboxMoveToFolder</a>,
2785<a href="mail.html">Mail</a>
2786<br><br>
2787</dl><!--<hr>-->
2788
2789<a name="mailboxStop">mailboxStop</a><dl><dd>
2790<p>
2791Stops the current background process in a mailbox buffer. Mapped to the Stop
2792button on the toolbar in Mailbox mode.
2793<br><br>
2794<b>Default key mapping:</b> None
2795<br><br>
2796<b>See also:</b> <a href="mail.html">Mail</a>
2797<br><br>
2798</dl><!--<hr>-->
2799
2800<a name="mailboxTag">mailboxTag</a><dl><dd>
2801<p>
2802Tags or untags the message at the current location of the caret.
2803<br><br>
2804<b>Default key mapping:</b> 't' in Mailbox mode
2805<br><br>
2806<b>See also:</b> <a href="#mailboxUntagAll">mailboxUntagAll</a>,
2807<a href="mail.html">Mail</a>
2808<br><br>
2809</dl><!--<hr>-->
2810
2811<a name="mailboxTagPattern">mailboxTagPattern</a><dl><dd>
2812<p>
2813Prompts for a pattern and tags all messages that match the specified pattern.
2814<br><br>
2815If a simple pattern is specified, j looks for a match in the "Subject" and
2816"From" fields.
2817<br><br>
2818A few special patterns are also supported:
2819<pre>
2820    ~C expression       messages with expression in the "To" or "Cc" field
2821    ~D                  deleted messages
2822    ~d date1-date2      messages with date sent in the range date1-date2 (see below)
2823    ~F                  flagged messages
2824    ~N                  new messages
2825    ~R                  read messages
2826    ~t expression       messages with expression in the "To" field
2827    ~U                  unread messages
2828</pre>
2829If the expression to be matched contains any upper case letters, the matches
2830are exact; otherwise, case is ignored.
2831<br><br>
2832Dates must be in DD/MM/YY format. Month and year are optional; if omitted,
2833they default to the current month and year. If you omit the first date and
2834specify "-DD/MM/YY", all messages sent from the beginning of time through the
2835specified date will be selected. If you omit the second date and specify
2836"DD/MM/YY-", all messages sent from the specified date through the end of time
2837will be selected. If you specify a single date with no '-', only messages sent
2838on the specified date will be selected.
2839<br><br>
2840<b>Default key mapping:</b> Ctrl T in Mailbox mode
2841<br><br>
2842<b>See also:</b> <a href="#mailboxLimit">mailboxLimit</a>,
2843<a href="#mailboxUntagAll">mailboxUntagAll</a>, <a href="mail.html">Mail</a>
2844<br><br>
2845</dl><!--<hr>-->
2846
2847<a name="mailboxToggleRaw">mailboxToggleRaw</a><dl><dd>
2848<p>
2849Toggles raw mode for messages in this mailbox. Normally, messages are
2850displayed with only the most important headers shown, and MIME-encoded
2851messages are decoded. In raw mode, the text of the message is displayed
2852exactly as received.
2853<br><br>
2854<b>Default key mapping:</b> 'R' in Mailbox mode
2855<br><br>
2856<b>See also:</b> <a href="mail.html">Mail</a>
2857<br><br>
2858</dl><!--<hr>-->
2859
2860<a name="mailboxUndelete">mailboxUndelete</a><dl><dd>
2861<p>
2862Undeletes the tagged messages or the message at the current location of the
2863caret.
2864<br><br>
2865<b>Default key mapping:</b> 'u' in Mailbox mode
2866<br><br>
2867<b>See also:</b> <a href="#mailboxDelete">mailboxDelete</a>,
2868<a href="mail.html">Mail</a>
2869<br><br>
2870</dl><!--<hr>-->
2871
2872<a name="mailboxUnlimit">mailboxUnlimit</a><dl><dd>
2873<p>
2874Cancels the limit pattern for the current mailbox, so all messages are listed.
2875<br><br>
2876<b>Default key mapping:</b> 'L' in Mailbox mode
2877<br><br>
2878<b>See also:</b> <a href="mail.html">Mail</a>
2879<br><br>
2880</dl><!--<hr>-->
2881
2882<a name="mailboxUntagAll">mailboxUntagAll</a><dl><dd>
2883<p>
2884Untags all messages in the current mailbox.
2885<br><br>
2886<b>Default key mapping:</b> 'T' in Mailbox mode
2887<br><br>
2888<b>See also:</b> <a href="#mailboxTag">mailboxTag</a>,
2889<a href="#mailboxTagPattern">mailboxTagPattern</a>, <a href="mail.html">Mail</a>
2890<br><br>
2891</dl><!--<hr>-->
2892
2893<a name="makeTagFile">makeTagFile</a><dl><dd>
2894<p>
2895Makes a tag file for the current directory. It is normally not necessary to use
2896this command explicitly, since tag files are managed automatically.
2897See <a href="tags.html">Tags and Tag Files</a>.
2898<br><br>
2899<b>Default key mapping:</b> None
2900<br><br>
2901</dl><!--<hr>-->
2902
2903<a name="man">man</a><dl><dd>
2904<p>
2905Prompts for a topic and displays the corresponding man page.
2906<br><br>
2907<b>Default key mapping:</b> None
2908<br><br>
2909</dl><!--<hr>-->
2910
2911<a name="manFollowLink">manFollowLink</a><dl><dd>
2912<p>
2913Invokes <a href="#man">man</a> on the cross reference at the location of the
2914caret or mouse click.
2915<p>
2916<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1, or Mouse-2 in Man mode
2917<br><br>
2918</dl><!--<hr>-->
2919
2920<a name="messageDelete">messageDelete</a><dl><dd>
2921<p>
2922Marks the current message deleted and loads the next undeleted message in the
2923current message buffer.
2924<br><br>
2925<b>Default key mapping:</b> 'd' in Message mode
2926<br><br>
2927<b>See also:</b> <a href="mail.html">Mail</a>
2928<br><br>
2929</dl><!--<hr>-->
2930
2931<a name="messageFlag">messageFlag</a><dl><dd>
2932<p>
2933Toggles the "important" flag of the current message and loads the next
2934undeleted message in the current message buffer.
2935<br><br>
2936<b>Default key mapping:</b> 'F' in Message mode
2937<br><br>
2938<b>See also:</b> <a href="#mailboxFlag">mailboxFlag</a>,
2939<a href="mail.html">Mail</a>
2940<br><br>
2941</dl><!--<hr>-->
2942
2943<a name="messageForward">messageForward</a><dl><dd>
2944<p>
2945Opens a mail composition buffer to forward the current message.
2946<br><br>
2947<b>Default key mapping:</b> 'f' in Message mode
2948<br><br>
2949<b>See also:</b> <a href="mail.html">Mail</a>
2950<br><br>
2951</dl><!--<hr>-->
2952
2953<a name="messageIndex">messageIndex</a><dl><dd>
2954<p>
2955Closes the current message buffer and returns to the parent mailbox.
2956<br><br>
2957<b>Default key mapping:</b> 'i' in Message mode
2958<br><br>
2959<b>See also:</b> <a href="mail.html">Mail</a>
2960<br><br>
2961</dl><!--<hr>-->
2962
2963<a name="messageMoveToFolder">messageMoveToFolder</a><dl><dd>
2964<p>
2965Moves the current message to the specified folder. Currently this command is
2966only implemented for IMAP folders.
2967<br><br>
2968<b>Default key mapping:</b> 'm' in Message mode
2969<br><br>
2970<b>See also:</b> <a href="mail.html">Mail</a>
2971<br><br>
2972</dl><!--<hr>-->
2973
2974<a name="messageNext">messageNext</a><dl><dd>
2975<p>
2976Loads the next undeleted message in the current message buffer.
2977<br><br>
2978<b>Default key mapping:</b> 'n' in Message mode
2979<br><br>
2980<b>See also:</b> <a href="mail.html">Mail</a>
2981<br><br>
2982</dl><!--<hr>-->
2983
2984<a name="messageNextInThread">messageNextInThread</a><dl><dd>
2985<p>
2986Loads the next message in the current thread into the current message buffer.
2987Messages that are marked deleted but not yet expunged are included.
2988<br><br>
2989<b>Default key mapping:</b> 'N' in Message mode
2990<br><br>
2991<b>See also:</b> <a href="mail.html">Mail</a>
2992<br><br>
2993</dl><!--<hr>-->
2994
2995<a name="messagePrevious">messagePrevious</a><dl><dd>
2996<p>
2997Loads the previous undeleted message in the current message buffer.
2998<br><br>
2999<b>Default key mapping:</b> 'p' in Message mode
3000<br><br>
3001<b>See also:</b> <a href="mail.html">Mail</a>
3002<br><br>
3003</dl><!--<hr>-->
3004
3005<a name="messagePreviousInThread">messagePreviousInThread</a><dl><dd>
3006<p>
3007Loads the previous message in the current thread into the current message
3008buffer. Messages that are marked deleted but not yet expunged are included.
3009<br><br>
3010<b>Default key mapping:</b> 'P' in Message mode
3011<br><br>
3012<b>See also:</b> <a href="mail.html">Mail</a>
3013<br><br>
3014</dl><!--<hr>-->
3015
3016<a name="messageReplyToGroup">messageReplyToGroup</a><dl><dd>
3017<p>
3018Opens a mail composition buffer to reply to the current message. The reply is
3019addressed to the sender and addressees of the original message.
3020<br><br>
3021<b>Default key mapping:</b> 'g' in Message mode
3022<br><br>
3023<b>See also:</b> <a href="mail.html">Mail</a>
3024<br><br>
3025</dl><!--<hr>-->
3026
3027<a name="messageReplyToSender">messageReplyToSender</a><dl><dd>
3028<p>
3029Opens a mail composition buffer to reply to the current message. The reply is
3030addressed to the sender of the original message.
3031<br><br>
3032<b>Default key mapping:</b> 'r' in Message mode
3033<br><br>
3034<b>See also:</b> <a href="mail.html">Mail</a>
3035<br><br>
3036</dl><!--<hr>-->
3037
3038<a name="messageSaveAttachment">messageSaveAttachment</a><dl><dd>
3039<p>
3040Prompts for a filename and saves the attachment listed on the line containing
3041the caret to the specified file.
3042<br><br>
3043<b>Default key mapping:</b> 's' in Message mode
3044<br><br>
3045<b>See also:</b> <a href="#messageViewAttachment">messageViewAttachment</a>,
3046<a href="mail.html">Mail</a>
3047<br><br>
3048</dl><!--<hr>-->
3049
3050<a name="messageToggleHeaders">messageToggleHeaders</a><dl><dd>
3051<p>
3052Toggles display of full headers in message buffers.
3053<br><br>
3054<b>Default key mapping:</b> 'h' in Message mode
3055<br><br>
3056<b>See also:</b> <a href="#messageToggleRaw">messageToggleRaw</a>,
3057<a href="mail.html">Mail</a>
3058<br><br>
3059</dl><!--<hr>-->
3060
3061<a name="messageToggleRaw">messageToggleRaw</a><dl><dd>
3062<p>
3063Toggles raw mode for the current message (and all messages in the parent
3064mailbox). Normally, messages are displayed with only the most important
3065headers shown, and MIME-encoded messages are decoded. In raw mode, the text of
3066the message is displayed exactly as received.
3067<br><br>
3068<b>Default key mapping:</b> 'R' in Message mode
3069<br><br>
3070<b>See also:</b> <a href="#mailboxToggleRaw">mailboxToggleRaw</a>,
3071<a href="#messageToggleHeaders">messageToggleHeaders</a>,
3072<a href="#messageToggleWrap">messageToggleWrap</a>,
3073<a href="mail.html">Mail</a>
3074<br><br>
3075</dl><!--<hr>-->
3076
3077<a name="messageToggleWrap">messageToggleWrap</a><dl><dd>
3078<p>
3079Toggles word wrap for the current message. Normally, long lines in mail
3080messages are wrapped to fit the width of the display. This command only affects
3081the rendering of the message; the message itself is not modified.
3082<br><br>
3083<b>Default key mapping:</b> Ctrl F12 in Message mode
3084<br><br>
3085<b>See also:</b> <a href="#messageToggleRaw">messageToggleRaw</a>,
3086<a href="mail.html">Mail</a>
3087<br><br>
3088</dl><!--<hr>-->
3089
3090<a name="messageViewAttachment">messageViewAttachment</a><dl><dd>
3091<p>
3092Opens the attachment listed on the line containing the caret.
3093<p>
3094<b>Default key mapping:</b> Enter or 'v' in Message mode
3095<p>
3096<b>See also:</b> <a href="#messageSaveAttachment">messageSaveAttachment</a>,
3097<a href="mail.html">Mail</a>
3098<br><br>
3099</dl><!--<hr>-->
3100
3101<a name="mode">mode</a><dl><dd>
3102<p>
3103Changes the mode of the current buffer. For example, Alt X, "mode diff", or Alt
3104X, "mode lisp".
3105<p>
3106<b>Default key mapping:</b> None
3107<br><br>
3108</dl><!--<hr>-->
3109
3110<a name="mouseFindOccurrence">mousefindOccurrence</a><dl><dd>
3111<p>
3112Jumps to the line in the source file corresponding to the location of the
3113mouse click in a List Occurrences buffer.
3114<p>
3115<b>Default key mapping:</b> Mouse-2 or Double Mouse-1 in List Occurrences buffers
3116<p>
3117<b>See also:</b> <a href="#findOccurrenceAtDot">findOccurrenceAtDot</a>
3118<br><br>
3119</dl><!--<hr>-->
3120
3121<a name="mouseFindTag">mouseFindTag</a><dl><dd>
3122<p>
3123Jumps to the definition of the function at the location of the mouse click.
3124The location of the mouse click is first saved on the marker stack as a
3125temporary bookmark, so you can use <a href="#popPosition">popPosition</a>,
3126mapped by default to Shift F5, to get back where you came from.
3127<p>
3128<b>Default key mapping:</b> Mouse-2 in Java, C, C++, Lisp, Scheme and Perl modes
3129<p>
3130<b>See also:</b> <a href="#findTag">findTag</a>,
3131<a href="#findTagAtDot">findTagAtDot</a>,
3132<a href="#findTagAtDotOtherWindow">findTagAtDotOtherWindow</a>
3133<br><br>
3134</dl><!--<hr>-->
3135
3136<a name="mouseMoveDotToPoint">mouseMoveDotToPoint</a><dl><dd>
3137<p>
3138Moves the caret to the location of the mouse click.
3139<p>
3140<b>Default key mapping:</b> Mouse-1
3141<p>
3142<b>See also:</b> <a href="#mouseSelect">mouseSelect</a>
3143<br><br>
3144</dl><!--<hr>-->
3145
3146<a name="mousePaste">mousePaste</a><dl><dd>
3147<p>
3148If a selection is marked, the contents of the selected region are copied to
3149the <a href="killring.html">kill ring</a>, and the region is deselected. Then
3150the copied text is inserted at the location of the mouse click.
3151<p>
3152If no selection is marked, mousePaste is equivalent to
3153<a href="#paste">paste</a> at the location of the mouse click.
3154<p>
3155If the text to be inserted ends with a line separator, it is inserted above
3156the line where the mouse click occurred, as if the mouse click were in the
3157first column of the line, even if that is not the case. The intention behind
3158this is to make it easy to paste whole lines of text (or blocks of lines),
3159without having to click exactly at the beginning of the line. If possible, the
3160indentation of the inserted lines is corrected to match their new context.
3161<p>
3162<b>Default key mapping:</b> None
3163<p>
3164<b>See also:</b> <a href="#paste">paste</a>,
3165<a href="#cyclePaste">cyclePaste</a>,
3166<a href="#pasteColumn">pasteColumn</a>
3167<br><br>
3168</dl><!--<hr>-->
3169
3170<a name="mouseSelect">mouseSelect</a><dl><dd>
3171<p>
3172Selects the region from the caret to the location of the mouse click, or
3173adjusts the current selection accordingly.
3174<p>
3175<b>Default key mapping:</b> Mouse-1
3176<p>
3177<b>See also:</b> <a href="#mouseMoveDotToPoint">mouseMoveDotToPoint</a>
3178<br><br>
3179</dl><!--<hr>-->
3180
3181<a name="mouseShowContextMenu">mouseShowContextMenu</a><dl><dd>
3182<p>
3183Displays the context menu (if any) for the current buffer.
3184<p>
3185<b>Default key mapping:</b> Mouse-3
3186<br><br>
3187</dl><!--<hr>-->
3188
3189<a name="movePastCloseAndReindent">movePastCloseAndReindent</a><dl><dd>
3190<p>
3191Moves the caret past the next unmatched closing parenthesis to the right of its
3192current location, inserts a line separator, and indents according to context.
3193<br><br>
3194<b>Default key mapping:</b> Ctrl Shift ) in Java, JavaScript, C and C++ modes
3195<br><br>
3196<b>See also:</b> <a href="#insertParentheses">insertParentheses</a>
3197<br><br>
3198</dl><!--<hr>-->
3199
3200<a name="newBuffer">newBuffer</a><dl><dd>
3201<p>
3202Creates and activates an empty buffer with no associated file.
3203<br><br>
3204<b>Default key mapping:</b> Ctrl N
3205<br><br>
3206</dl><!--<hr>-->
3207
3208<a name="newFrame">newFrame</a><dl><dd>
3209<p>
3210Creates a new frame (top-level editor window) displaying the current buffer.
3211<br><br>
3212<b>Default key mapping:</b> Ctrl Shift N
3213<br><br>
3214</dl><!--<hr>-->
3215
3216<a name="newline">newline</a><dl><dd>
3217<p>
3218Inserts a line separator at the location of the caret.
3219<br><br>
3220<b>Default key mapping:</b> Enter (global default); Ctrl Enter in JavaScript and HTML modes
3221<br><br>
3222</dl><!--<hr>-->
3223
3224<a name="newlineAndIndent">newlineAndIndent</a><dl><dd>
3225<p>
3226Inserts a line separator at the location of the caret and indents according to
3227context..
3228<br><br>
3229<b>Default key mapping:</b> Enter in JavaScript and HTML modes
3230<br><br>
3231</dl><!--<hr>-->
3232
3233<a name="nextBuffer">nextBuffer</a><dl><dd>
3234<p>
3235Switches to the next buffer.
3236<br><br>
3237<b>Default key mapping:</b> Alt Right
3238<br><br>
3239<b>See also:</b> <a href="#prevBuffer">prevBuffer</a>
3240<br><br>
3241</dl><!--<hr>-->
3242
3243<a name="nextChange">nextChange</a><dl><dd>
3244<p>
3245Moves to the next group of changed lines (below the position of the caret in
3246the current buffer).
3247<p>
3248<b>Default key mapping:</b> Ctrl Alt N
3249<p>
3250<b>See also:</b> <a href="#previousChange">previousChange</a>,
3251<a href="preferences.html#showChangeMarks">showChangeMarks</a>
3252<br><br>
3253</dl><!--<hr>-->
3254
3255<a name="nextComment">nextComment</a><dl><dd>
3256<p>
3257Cycles forwards through the history of CVS checkin comments.
3258<p>
3259<b>Default key mapping:</b> Ctrl N in CVS checkin buffers
3260<p>
3261<b>See also:</b> <a href="#previousComment">previousComment</a>,
3262<a href="#cvsCommit">cvsCommit</a>, <a href="#finish">finish</a>,
3263<a href="cvs.html">CVS Support</a>
3264<br><br>
3265</dl><!--<hr>-->
3266
3267<a name="nextError">nextError</a><dl><dd>
3268<p>
3269Jumps to the location in the source file that corresponds to the next
3270compilation error.
3271<p>
3272<b>Default key mapping:</b> F4
3273<p>
3274<b>See also:</b> <a href="#previousError">previousError</a>,
3275<a href="#thisError">thisError</a>,
3276<a href="compilation.html">Compilation Buffers</a>
3277<br><br>
3278</dl><!--<hr>-->
3279
3280<a name="nextFrame">nextFrame</a><dl><dd>
3281<p>
3282Activates the next frame (top-level editor window).
3283<br><br>
3284<b>Default key mapping:</b> Alt N
3285<br><br>
3286</dl><!--<hr>-->
3287
3288<a name="offset">offset</a><dl><dd>
3289<p>
3290Reports the current location of the caret as an absolute offset (the number of
3291characters from the start of the buffer).
3292<br><br>
3293<b>Default key mapping:</b> None
3294<p>
3295<b>See also:</b> <a href="#jumpToOffset">jumpToOffset</a>
3296<br><br>
3297</dl><!--<hr>-->
3298
3299<a name="openFile">openFile</a><dl><dd>
3300<p>
3301Sets focus to the edit control in the location bar of the current window,
3302where you can enter a filename and press Enter to activate the corresponding
3303buffer, if it exists, or else create and activate a new buffer for the
3304specified file.
3305<br><br>
3306If the specified file is not found in the current directory, j will look for it
3307first in the <a href="preferences.html#includePath">include path</a> (if it's a
3308.h file) and then in the <a href="preferences.html#sourcePath">source path</a>.
3309You can define include and source paths in your <a href="preferences.html">preferences</a> file.
3310If j can't find the file you specify, you will be asked if you want to create
3311it.
3312<br><br>
3313The edit control supports both history (using the up and down arrow keys) and
3314completion (using Tab and Shift Tab).
3315<br><br>
3316In addition to normal text files, you can open a directory, a .zip or .gz file,
3317or a URL (like http://armedbear.org).
3318<br><br>
3319If you press Enter with no text in the edit control, you will get a directory
3320buffer on the current directory.
3321<br><br>
3322<b>Default key mapping:</b> Ctrl O
3323<br><br>
3324<b>See also:</b> <a href="directories.html">Directory Buffers</a>.
3325<br><br>
3326</dl><!--<hr>-->
3327
3328<a name="openFileInOtherFrame">openFileInOtherFrame</a><dl><dd>
3329<p>
3330Same as <a href="#openFile">openFile</a>, but the specified file is opened in
3331a different (possibly new) frame (top-level editor window). You will be
3332prompted to enter the filename in a dialog box, rather than in the location
3333bar of the current window.
3334<br><br>
3335<b>Default key mapping:</b> Ctrl Shift O
3336<br><br>
3337</dl><!--<hr>-->
3338
3339<a name="openFileInOtherWindow">openFileInOtherWindow</a><dl><dd>
3340<p>
3341Same as <a href="#openFile">openFile</a>, but the specified file
3342is opened in the other window of the current frame. The current window is
3343split if necessary.
3344<br><br>
3345<b>Default key mapping:</b> Ctrl Alt O
3346<br><br>
3347</dl><!--<hr>-->
3348
3349<a name="openMailbox">openMailbox</a><dl><dd>
3350<p>
3351Prompts for a URL and opens the corresponding mailbox. IMAP and POP are
3352supported.
3353<br><br>
3354IMAP URLs look like this:
3355<pre>
3356    {user@host}folder</pre>
3357For example:
3358<pre>
3359    {peter@annie}inbox
3360    {peter@annie}mail/linux-kernel</pre>
3361POP URLs look like this:
3362<pre>
3363    pop://user@host</pre>
3364For example:
3365<pre>
3366    pop://peter@annie
3367    pop://pgraves@ix.netcom.com</pre>
3368<b>Default key mapping:</b> None
3369<br><br>
3370<b>See also:</b> <a href="#inbox">inbox</a>, <a href="mail.html">Mail</a>
3371<br><br>
3372</dl><!--<hr>-->
3373
3374<a name="otherWindow">otherWindow</a><dl><dd>
3375<p>
3376Selects the other window in the current frame.
3377<br><br>
3378<b>Default key mapping:</b> Alt O
3379<br><br>
3380</dl><!--<hr>-->
3381
3382<a name="p4">p4</a><dl><dd>
3383<p>
3384Executes an arbitrary Perforce command. The Perforce command, together with
3385any required flags and arguments, must be supplied as an argument to this
3386command. You can use "%" to represent the full pathname of the file associated
3387with the current buffer. For example:
3388<pre>
3389        p4 filelog -l %
3390</pre>
3391<p>
3392or:
3393<pre>
3394        p4 help commands
3395</pre>
3396<p>
3397<b>Default key mapping:</b> None
3398<br><br>
3399</dl><!--<hr>-->
3400
3401<a name="pageDown">pageDown</a><dl><dd>
3402<p>
3403Moves the caret down one full screen.
3404<br><br>
3405<b>Default key mapping:</b> Page Down
3406<br><br>
3407</dl><!--<hr>-->
3408
3409<a name="pageUp">pageUp</a><dl><dd>
3410<p>
3411Moves the caret up one full screen.
3412<br><br>
3413<b>Default key mapping:</b> Page Up
3414<br><br>
3415</dl><!--<hr>-->
3416
3417<a name="paste">paste</a><dl><dd>
3418<p>
3419The contents of the system clipboard (if any) are appended to the
3420<a href="killring.html">kill ring</a>, and then the last item from the
3421kill ring (which will be the contents of the system clipboard, if anything was
3422there) is inserted at the current location of the caret.
3423<p>
3424If a block is marked, the inserted text replaces the marked block.
3425<p>
3426By default, if the text to be inserted ends with a line separator, it is
3427inserted above the line containing the caret, as if the caret were in the first
3428column of the line, even if that is not the case. The intention behind this is
3429to make it easy to cut and paste whole lines of text (or blocks of lines),
3430without having to move the caret to the beginning of the line. If possible, the
3431indentation of the inserted lines is corrected to match their new context.
3432<p>
3433You can disable this behavior by setting the property
3434<a href="preferences.html#autoPasteLines">autoPasteLines</a> to false. If
3435<a href="preferences.html#autoPasteLines">autoPasteLines</a> is false, the
3436inserted text is always placed at the exact location of the caret.
3437<p>
3438<b>Default key mapping:</b> Ctrl V
3439<p>
3440<b>See also:</b> <a href="#cyclePaste">cyclePaste</a>,
3441<a href="#pasteColumn">pasteColumn</a>,
3442<a href="#mousePaste">mousePaste</a>
3443<br><br>
3444</dl><!--<hr>-->
3445
3446<a name="pasteColumn">pasteColumn</a><dl><dd>
3447<p>
3448Inserts the last killed or copied column at the current location of the caret.
3449<p>
3450<b>Default key mapping:</b> None
3451<p>
3452<b>See also:</b> <a href="#copyRegion">copyRegion</a>,
3453<a href="#killRegion">killRegion</a>, <a href="#paste">paste</a>,
3454<a href="columns.html">Columns</a>
3455<br><br>
3456</dl><!--<hr>-->
3457
3458<a name="pastePrimarySelection">pastePrimarySelection</a><dl><dd>
3459<p>
3460Inserts the primary X selection at the current location of the caret or mouse
3461click. This command requires Java 1.4 or later and only works on platforms
3462that support a primary X selection (e.g. Linux).
3463<p>
3464<b>Default key mapping:</b> Mouse-2 (on supported platforms)
3465<br><br>
3466</dl><!--<hr>-->
3467
3468<a name="playbackMacro">playbackMacro</a><dl><dd>
3469<p>
3470Plays back previously recorded keystrokes.
3471<br><br>
3472<b>Default key mapping:</b> F8
3473<br><br>
3474<b>See also:</b> <a href="#recordMacro">recordMacro</a>
3475<br><br>
3476</dl><!--<hr>-->
3477
3478<a name="popPosition">popPosition</a><dl><dd>
3479<p>
3480Pops the last position off the marker stack and jumps to that location.
3481<br><br>
3482<b>Default key mapping:</b> Shift F5
3483<br><br>
3484<b>See also:</b> <a href="#pushPosition">pushPosition</a>
3485<br><br>
3486</dl><!--<hr>-->
3487
3488<a name="prevBuffer">prevBuffer</a><dl><dd>
3489<p>
3490Switches to the previous buffer.
3491<p>
3492<b>Default key mapping:</b> Alt Left
3493<p>
3494<b>See also:</b> <a href="#nextBuffer">nextBuffer</a>
3495<br><br>
3496</dl><!--<hr>-->
3497
3498<a name="previousChange">previousChange</a><dl><dd>
3499<p>
3500Moves to the previous group of changed lines (above the position of the caret
3501in the current buffer).
3502<p>
3503<b>Default key mapping:</b> Ctrl Alt P
3504<p>
3505<b>See also:</b> <a href="#nextChange">nextChange</a>,
3506<a href="preferences.html#showChangeMarks">showChangeMarks</a>
3507<br><br>
3508</dl><!--<hr>-->
3509
3510<a name="previousComment">previousComment</a><dl><dd>
3511<p>
3512Cycles backwards through the history of CVS checkin comments.
3513<p>
3514<b>Default key mapping:</b> Ctrl P in CVS checkin buffers
3515<p>
3516<b>See also:</b> <a href="#nextComment">nextComment</a>,
3517<a href="#cvsCommit">cvsCommit</a>, <a href="#finish">finish</a>,
3518<a href="cvs.html">CVS Support</a>
3519<br><br>
3520</dl><!--<hr>-->
3521
3522<a name="previousError">previousError</a><dl><dd>
3523<p>
3524Jumps to the location in the source file that corresponds to the previous
3525compilation error.
3526<p>
3527<b>Default key mapping:</b> Shift F4
3528<p>
3529<b>See also:</b> <a href="#nextError">nextError</a>,
3530<a href="#thisError">thisError</a>,
3531<a href="compilation.html">Compilation Buffers</a>
3532<br><br>
3533</dl><!--<hr>-->
3534
3535<a name="print">print</a><dl><dd>
3536<p>
3537Prints the selected region, or the current buffer if no region is selected.
3538<p>
3539<b>Default key mapping:</b> Ctrl P
3540<br><br>
3541</dl><!--<hr>-->
3542
3543<a name="properties">properties</a><dl><dd>
3544<p>
3545Invokes the Properties dialog, which lets you inspect and modify
3546buffer-specific settings such as tab width, indent size, and mode.
3547<p>
3548<b>Default key mapping:</b> Alt P
3549<br><br>
3550</dl><!--<hr>-->
3551
3552<a name="pushPosition">pushPosition</a><dl><dd>
3553<p>
3554Saves the current location of the caret on the marker stack as a temporary bookmark.
3555<br><br>
3556<b>Default key mapping:</b> F5
3557<br><br>
3558<b>See also:</b> <a href="#popPosition">popPosition</a>
3559<br><br>
3560</dl><!--<hr>-->
3561
3562<a name="quit">quit</a><dl><dd>
3563<p>
3564Shuts down the editor. You will be prompted for confirmation if there are any
3565buffers with unsaved changes.
3566<br><br>
3567<b>Default key mapping:</b> Ctrl Q
3568<br><br>
3569<b>See also:</b> <a href="#saveAllExit">saveAllExit</a>
3570<br><br>
3571</dl><!--<hr>-->
3572
3573<a name="recompile">recompile</a><dl><dd>
3574<p>
3575Compiles the source file in the current buffer, using the last specified
3576compile command. (On Windows, this command is only supported for Windows 2000
3577and Windows XP.)
3578<p>
3579<b>Default key mapping:</b> Ctrl F9
3580<p>
3581<b>See also:</b> <a href="#compile">compile</a>,
3582<a href="compilation.html">Compilation Buffers</a>
3583<br><br>
3584</dl><!--<hr>-->
3585
3586<a name="recordMacro">recordMacro</a><dl><dd>
3587<p>
3588Records keystrokes for later playback. Recording ends when this command is
3589invoked again. While recording is in progress, "REC" is displayed in the
3590status bar (at the right end, after the column number).
3591<br><br>
3592<b>Default key mapping:</b> F7
3593<br><br>
3594<b>See also:</b> <a href="#playbackMacro">playbackMacro</a>
3595<br><br>
3596</dl><!--<hr>-->
3597
3598<a name="redo">redo</a><dl><dd>
3599<p>
3600Undoes the last undo.
3601<br><br>
3602<b>Default key mapping:</b> Ctrl Y
3603<br><br>
3604<b>See also:</b> <a href="#undo">undo</a>
3605<br><br>
3606</dl><!--<hr>-->
3607
3608<a name="reloadKeyMaps">reloadKeyMaps</a><dl><dd>
3609<p>
3610Reloads all configured key maps. If no custom key maps are configured, j's
3611internal default key maps will be used. Ad hoc mappings (including mappings
3612made in <a href="init.lisp.html">init.lisp</a>) are discarded.
3613<br><br>
3614<b>Default key mapping:</b> None
3615<br><br>
3616<b>See also:</b> <a href="#defaultKeyMaps">defaultKeyMaps</a>,
3617<a href="preferences.html#autoReloadKeyMaps">autoReloadKeyMaps</a>,
3618<a href="keys.html">Key Mappings</a>
3619<br><br>
3620</dl><!--<hr>-->
3621
3622<a name="renumberRegion">renumberRegion</a><dl><dd>
3623<p>
3624Changes the first number in each line of the selected region so that the it is
3625one more than the first number in the preceding line. By default, the smallest
3626value in the entire region is used as the value for the first line. The order
3627of the lines is not changed. Only the first number in each line is considered,
3628and lines that don't contain a number at all are ignored.
3629<p>
3630For example, suppose you start with a region that looks like this:
3631<pre>
3632        private static final int DEFUN       = 52;
3633        private static final int DEFVAR      = 6;
3634        private static final int DO          = 17;
3635        private static final int DOLIST      = 81; // Not 82!
3636        private static final int IF          = 9;
3637        private static final int LAMBDA      = 1;
3638        private static final int LET         = 3;</pre>
3639When invoked with no arguments, renumberRegions starts by looking at the first
3640number in each line of the region to find the smallest value (which in this
3641case is 1). The first number in the first line of the region (52) is replaced
3642with this value (1), and the first number in each subsequent line is changed so
3643that it is one more than the first number on the preceding line. So the region
3644ends up looking like this:
3645<pre>
3646        private static final int DEFUN       = 1;
3647        private static final int DEFVAR      = 2;
3648        private static final int DO          = 3;
3649        private static final int DOLIST      = 4; // Not 82!
3650        private static final int IF          = 5;
3651        private static final int LAMBDA      = 6;
3652        private static final int LET         = 7;</pre>
3653You can also explicitly specify what number to start with by providing a
3654numeric argument with the command. For example, if you do Alt X,
3655"renumberRegion 100", the region ends up looking like this:
3656<pre>
3657        private static final int DEFUN       = 100;
3658        private static final int DEFVAR      = 101;
3659        private static final int DO          = 102;
3660        private static final int DOLIST      = 103; // Not 82!
3661        private static final int IF          = 104;
3662        private static final int LAMBDA      = 105;
3663        private static final int LET         = 106;</pre>
3664<p>
3665<b>Default key mapping:</b> None
3666<p>
3667<b>See also:</b> <a href="#sortLines">sortLines</a>
3668<br><br>
3669</dl><!--<hr>-->
3670
3671<a name="replace">replace</a><dl><dd>
3672<p>
3673Replaces one or more occurrences of one pattern with another.
3674<p>
3675If the "Ignore case" checkbox is checked, j tries, paradoxically, to preserve
3676case, if possible, when it makes a replacement. More precisely, if the pattern
3677is all upper case, j will make the replacement all upper case, and if the
3678pattern begins with an upper case letter, j will make the replacement begin
3679with an upper case letter. For example, if the pattern is "javaFormatter" and
3680the replacement is "cppFormatter", "JAVAFORMATTER" will become "CPPFORMATTER",
3681and "JavaFormatter" will  become "CppFormatter". These are the only two
3682situations in which the replacement string is altered to preserve case.
3683Upper-case letters in the replacement string are NEVER converted to lower case.
3684This may seem strange, but in practice, chances are good that this is the
3685behavior you want.
3686<p>
3687If the "Whole words only" checkbox is checked, occurrences of the pattern will
3688be replaced only if they are delimited by characters that cannot appear in a
3689Java identifier. Generally speaking, Java identifiers can contain letters,
3690digits, and the characters '$' and '_'.
3691<p>
3692If the "Regular expressions" checkbox is checked, the pattern will be
3693interpreted as a regular expression rather than as a literal string. In
3694addition, the replacement string can refer to all or part of what is matched by
3695the pattern. "\&amp;" in the replacement string will be replaced with the
3696entire string that matched the pattern. "\<i>n</i>", where <i>n</i> is a digit
3697from 1 to 9, will be replaced by whatever matched the <i>n</i>th
3698parenthesized grouping in the pattern.
3699See <a href="regexp.html">Regular Expressions</a>.
3700<p>
3701For example, if you specify this pattern:
3702<pre>
3703    foo\((.*), (.*)\)
3704</pre>
3705and this replacement:
3706<pre>
3707    foo(\2, \1)
3708</pre>
3709the effect would be to reverse the order of the arguments in every call to the
3710function foo. Note that you need to escape the literal parentheses in the
3711pattern, but not in the replacement.
3712<p>
3713If the "Multiline pattern" checkbox is checked, both the regular expression
3714and the replacement can contain newline characters ("\n"). Because of the way
3715j handles things internally, a single "\n" should be used to match a newline
3716even if the file being edited uses "\r\n" or "\r" as its line separator
3717string. (The "Multiline pattern" feature is experimental and is not enabled by
3718default.)
3719<p>
3720If the "Restrict changes to selected text" checkbox is checked, only those
3721occurrences of the pattern that fall within the current selection are replaced.
3722Otherwise, if a block is marked, replacements are carried out starting at the
3723beginning of the marked block.
3724<p>
3725If the "Confirm changes" checkbox is checked, you will be prompted to confirm
3726each replacement.
3727<br><br>
3728<b>Default key mapping:</b> Ctrl R
3729<br><br>
3730</dl><!--<hr>-->
3731
3732<a name="replaceInFiles">replaceInFiles</a><dl><dd>
3733<p>
3734Replaces one or more occurrences of one pattern with another in multiple files.
3735If a file matching the file specification is already loaded in a buffer, the
3736operation is performed on the contents of the buffer rather than the file as
3737last saved on disk, so unsaved changes to the buffer are never lost. Files that
3738were not previously loaded are saved automatically if any replacements are
3739made. Buffers created specifically for the replace in files operation are
3740deleted when they are no longer needed.
3741<p>
3742Several file specifications can be supplied at once, separated by semicolons.
3743If the full path is not given in a file specification, the current directory or
3744the directory last specified by a full path is used.
3745<p>
3746For example, if the file specification is <code>*.c;/usr/src/emacs-20.3/src/*.c;*.h</code>,
3747the search will examine <code>.c</code> files in the current directory and
3748<code>.c</code> and <code>.h</code> files in <code>/usr/src/emacs-20.3/src</code>.
3749<p>
3750If the "Ignore case" checkbox is checked, j tries, paradoxically, to preserve
3751case, if possible, when it makes a replacement. More precisely, if the pattern
3752is all upper case, j will make the replacement all upper case, and if the
3753pattern begins with an upper case letter, j will make the replacement begin
3754with an upper case letter. For example, if the pattern is "javaFormatter" and
3755the replacement is "cppFormatter", "JAVAFORMATTER" will become "CPPFORMATTER",
3756and "JavaFormatter" will  become "CppFormatter". These are the only two
3757situations in which the replacement string is altered to preserve case.
3758Upper-case letters in the replacement string are NEVER converted to lower case.
3759This may seem strange, but in practice, chances are good that this is the
3760behavior you want.
3761<p>
3762If the "Whole words only" checkbox is checked, occurrences of the pattern will
3763be replaced only if they are delimited by characters that cannot appear in a
3764Java identifier. Generally speaking, Java identifiers can contain letters,
3765digits, and the characters '$' and '_'.
3766<p>
3767If the "Regular expressions" checkbox is checked, the pattern is interpreted
3768as a regular expression rather than as a literal string. In addition, the
3769replacement string can refer to all or part of what is matched by the pattern.
3770"\&amp;" in the replacement string will be replaced with the entire string
3771that matched the pattern. "\<i>n</i>", where <i>n</i> is a digit from 1 to 9,
3772will be replaced by whatever matched the <i>n</i>th parenthesized grouping in
3773the pattern. See <a href="regexp.html">Regular Expressions</a>.
3774<p>
3775For example, if you specify this pattern:
3776<pre>
3777        foo\((.*), (.*)\)
3778</pre>
3779and this replacement:
3780<pre>
3781        foo(\2, \1)
3782</pre>
3783the effect is to reverse the order of the arguments in every call to the
3784function foo. Note that you need to escape the literal parentheses in the
3785pattern, but not in the replacement string.
3786<p>
3787If the "Confirm changes" checkbox is checked, you will be prompted to confirm
3788each replacement.
3789<p>
3790<b>Default key mapping:</b> Ctrl Shift R
3791<p>
3792<b>See also:</b> <a href="#findInFiles">findInFiles</a>, <a href="#replace">replace</a>
3793<br><br>
3794</dl><!--<hr>-->
3795
3796<a name="resetDisplay">resetDisplay</a><dl><dd>
3797<p>
3798Resets and repaints all edit windows.
3799<p>
3800<b>Default key mapping:</b> None
3801<br><br>
3802</dl><!--<hr>-->
3803
3804<a name="resetLisp">resetLisp</a><dl><dd>
3805<p>
3806Resets the current Lisp shell so that it returns to the outermost read-eval-
3807print loop.
3808<p>
3809This command works with Lisp shells running CMUCL, SBCL, CLISP, Allegro Common
3810Lisp, or j's built-in Lisp.
3811<p>
3812<b>Default key mapping:</b> Ctrl R in Lisp Shell mode
3813<br><br>
3814</dl><!--<hr>-->
3815
3816<a name="revertBuffer">revertBuffer</a><dl><dd>
3817<p>
3818Reloads the current buffer. If the buffer has unsaved changes, you will be
3819prompted for confirmation before they are discarded.
3820<p>
3821<b>Default key mapping:</b> None
3822<br><br>
3823</dl><!--<hr>-->
3824
3825<a name="right">right</a><dl><dd>
3826<p>
3827Moves the caret one character to the right.
3828<p>
3829<b>Default key mapping:</b> Right arrow key
3830<br><br>
3831</dl><!--<hr>-->
3832
3833<a name="save">save</a><dl><dd>
3834<p>
3835Saves the current buffer, if it has been modified. If it's a new buffer,
3836<b>saveAs</b> is invoked so you can provide a filename.
3837<p>
3838<b>Default key mapping:</b> Ctrl S
3839<br><br>
3840</dl><!--<hr>-->
3841
3842<a name="saveAll">saveAll</a><dl><dd>
3843<p>
3844Saves all modified buffers. <code>saveAs</code> is invoked for new buffers so
3845you can provide filenames if necessary.
3846<p>
3847<b>Default key mapping:</b> F2
3848<br><br>
3849</dl><!--<hr>-->
3850
3851<a name="saveAllExit">saveAllExit</a><dl><dd>
3852<p>
3853Saves all modified buffers and shuts down the editor. <code>saveAs</code> is
3854invoked for new buffers so you can provide filenames if necessary.
3855<p>
3856<b>Default key mapping:</b> Ctrl Shift Q
3857<p>
3858<b>See also:</b> <a href="#quit">quit</a>
3859<br><br>
3860</dl><!--<hr>-->
3861
3862<a name="saveAs">saveAs</a><dl><dd>
3863<p>
3864Saves the current buffer under a new name. The file (if any) that was
3865previously associated with the buffer is not deleted, but the buffer is
3866henceforth associated with the new file. The buffer's mode is changed, if
3867necessary, to match the new filename.
3868<br><br>
3869<b>Default key mapping:</b> Ctrl Shift S
3870<br><br>
3871</dl><!--<hr>-->
3872
3873<a name="saveCopy">saveCopy</a><dl><dd>
3874<p>
3875Saves a copy of the current buffer under a new name. The buffer continues to be
3876associated with its original file.
3877<br><br>
3878<b>Default key mapping:</b> Ctrl Alt S
3879<br><br>
3880</dl><!--<hr>-->
3881
3882<a name="saveSession">saveSession</a><dl><dd>
3883<p>
3884Saves information about the current editing session in the active named
3885session file.
3886<p>
3887If no named session is active, you will be prompted for a name for the current
3888session.
3889<p>
3890<b>Default key mapping:</b> None
3891<p>
3892<b>See also:</b> <a href="sessions.html">Sessions</a>,
3893<a href="#loadSession">loadSession</a>,
3894<a href="preferences.html#autosaveNamedSessions">autosaveNamedSessions</a>
3895<br><br>
3896</dl><!--<hr>-->
3897
3898<a name="saveToRegister">saveToRegister</a><dl><dd>
3899<p>
3900Prompts for a register name and saves the selected region in the specified
3901register.
3902<p>
3903Register names must be lower case letters (a-z). The contents of registers
3904persist automatically from one j session to the next.
3905<p>
3906<b>Default key mapping:</b> None
3907<p>
3908<b>Abbreviation:</b> sr
3909<p>
3910<b>See also:</b> <a href="#clearRegister">clearRegister</a>,
3911<a href="#editRegister">editRegister</a>,
3912<a href="#insertRegister">insertRegister</a>
3913<a href="#listRegisters">listRegisters</a>
3914<br><br>
3915</dl><!--<hr>-->
3916
3917<a name="selectAll">selectAll</a><dl><dd>
3918<p>
3919Selects the entire buffer. The current location of the caret is first saved on
3920the marker stack as a temporary bookmark, so you can use
3921<a href="#popPosition">popPosition</a>, mapped by default to Shift F5, to get
3922back where you came from.
3923<p>
3924<b>Default key mapping:</b> Ctrl A
3925<br><br>
3926</dl><!--<hr>-->
3927
3928<a name="selectBob">selectBob</a><dl><dd>
3929<p>
3930Extends the selection to the beginning of the buffer.
3931<br><br>
3932<b>Default key mapping:</b> Ctrl Shift Home
3933<br><br>
3934</dl><!--<hr>-->
3935
3936<a name="selectDown">selectDown</a><dl><dd>
3937<p>
3938Extends the selection down one line.
3939<br><br>
3940<b>Default key mapping:</b> Shift down arrow
3941<br><br>
3942</dl><!--<hr>-->
3943
3944<a name="selectEnd">selectEnd</a><dl><dd>
3945<p>
3946Extends the selection to the end of the current line.
3947<br><br>
3948<b>Default key mapping:</b> Shift End
3949<br><br>
3950</dl><!--<hr>-->
3951
3952<a name="selectEob">selectEob</a><dl><dd>
3953<p>
3954Extends the selection to the end of the buffer.
3955<br><br>
3956<b>Default key mapping:</b> Ctrl Shift End
3957<br><br>
3958</dl><!--<hr>-->
3959
3960<a name="selectHome">selectHome</a><dl><dd>
3961<p>
3962Extends the selection to the beginning of the current line.
3963<br><br>
3964<b>Default key mapping:</b> Shift Home
3965<br><br>
3966</dl><!--<hr>-->
3967
3968<a name="selectLeft">selectLeft</a><dl><dd>
3969<p>
3970Extends the selection one character to the left.
3971<p>
3972<b>Default key mapping:</b> Shift Left
3973<br><br>
3974</dl><!--<hr>-->
3975
3976<a name="selectPageDown">selectPageDown</a><dl><dd>
3977<p>
3978Extends the selection down one full screen.
3979<p>
3980<b>Default key mapping:</b> Shift Page Down
3981<br><br>
3982</dl><!--<hr>-->
3983
3984<a name="selectPageUp">selectPageUp</a><dl><dd>
3985<p>
3986Extends the selection up one full screen.
3987<p>
3988<b>Default key mapping:</b> Shift Page Up
3989<br><br>
3990</dl><!--<hr>-->
3991
3992<a name="selectRight">selectRight</a><dl><dd>
3993<p>
3994Extends the selection one character to the right.
3995<p>
3996<b>Default key mapping:</b> Shift Right
3997<br><br>
3998</dl><!--<hr>-->
3999
4000<a name="selectSyntax">selectSyntax</a><dl><dd>
4001<p>
4002Selects the syntactic expression in the vicinity of the caret.
4003<p>
4004<b>Default key mapping:</b> Ctrl Shift M
4005<p>
4006<b>See also:</b> <a href="#lispSelectSyntax">lispSelectSyntax</a>
4007<br><br>
4008</dl><!--<hr>-->
4009
4010<a name="selectToMarker">selectToMarker</a><dl><dd>
4011<p>
4012Selects the region from the current location of the caret to the specified
4013marker (bookmark).
4014<p>
4015<b>Default key mapping:</b> None
4016<br><br>
4017</dl><!--<hr>-->
4018
4019<a name="selectUp">selectUp</a><dl><dd>
4020<p>
4021Extends the selection up one line.
4022<br><br>
4023<b>Default key mapping:</b> Shift up arrow
4024<br><br>
4025</dl><!--<hr>-->
4026
4027<a name="selectWord">selectWord</a><dl><dd>
4028<p>
4029Selects the word at the location of the caret or mouse click.
4030<p>
4031<b>Default key mapping:</b> Alt W or Double Mouse-1
4032<br><br>
4033</dl><!--<hr>-->
4034
4035<a name="selectWordLeft">selectWordLeft</a><dl><dd>
4036<p>
4037Extends the selection to the left by one word.
4038<br><br>
4039<b>Default key mapping:</b> Ctrl Shift Left
4040<br><br>
4041</dl><!--<hr>-->
4042
4043<a name="selectWordRight">selectWordRight</a><dl><dd>
4044<p>
4045Extends the selection to the right by one word.
4046<br><br>
4047<b>Default key mapping:</b> Ctrl Shift Right
4048<br><br>
4049</dl><!--<hr>-->
4050
4051<a name="send">send</a><dl><dd>
4052<p>
4053In a mail composition buffer, sends the current message.
4054<br><br>
4055<b>Default key mapping:</b> None.
4056<br><br>
4057<b>See also:</b> <a href="mail.html">Mail</a>
4058<br><br>
4059</dl><!--<hr>-->
4060
4061<a name="sendMailBackTab">sendMailBackTab</a><dl><dd>
4062<p>
4063Goes back to the previous field in the header area of a mail composition buffer.
4064<p>
4065<b>Default key mapping:</b> Shift Tab in mail composition buffers
4066<p>
4067<b>See also:</b> <a href="#sendMailTab">sendMailTab</a>, <a href="mail.html">Mail</a>
4068<br><br>
4069</dl><!--<hr>-->
4070
4071<a name="sendMailTab">sendMailTab</a><dl><dd>
4072<p>
4073Advances to the next field in the header area of a mail composition buffer.
4074<p>
4075<b>Default key mapping:</b> Tab in mail composition buffers
4076<p>
4077<b>See also:</b> <a href="#sendMailBackTab">sendMailBackTab</a>, <a href="mail.html">Mail</a>
4078<br><br>
4079</dl><!--<hr>-->
4080
4081<a name="setEncoding">setEncoding</a><dl><dd>
4082<p>
4083Sets the character encoding to be used when the current buffer is saved. The
4084encoding name that you specify (e.g. "ISO-8859-1", "UTF-8", "UTF-16",
4085"UnicodeBig", etc.) must be supported by the version of Java that you're
4086using; the string is not case-sensitive.
4087<p>
4088Java recognizes both canonical names and aliases for a variety of encodings,
4089and to make things more interesting, there are significant variations in this
4090area among the different versions of Java. More information from the
4091perspective of Java 1.4 is available here:
4092<pre>
4093        http://java.sun.com/j2se/1.4/docs/guide/intl/encoding.doc.html</pre>
4094<p>
4095<b>Default key mapping:</b> None
4096<br><br>
4097</dl><!--<hr>-->
4098
4099<a name="shellCommand">shellCommand</a><dl><dd>
4100<p>
4101Prompts for a shell command and then executes that command using /bin/sh. The
4102output of the command (if any) is presented in a transient output buffer.
4103<p>
4104The specified shell command is executed in the editor's current directory,
4105which is normally the parent directory of the file associated with the current
4106buffer, or the user's home directory if the current file is remote or if there
4107is no file associated with the current buffer.
4108<p>
4109<b>Default key mapping:</b> None
4110<br><br>
4111</dl><!--<hr>-->
4112
4113<a name="shellEscape">shellEscape</a><dl><dd>
4114<p>
4115In a shell buffer, if a selection is marked, clears it.  Otherwise, if the
4116caret is on the command line, clears any text past the end of the command
4117prompt and moves the caret to the end of the prompt.
4118<p>
4119<b>Default key mapping:</b> Escape in Shell mode
4120<br><br>
4121</dl><!--<hr>-->
4122
4123<a name="shellHome">shellHome</a><dl><dd>
4124<p>
4125In a shell buffer, if the current line begins with a prompt, and if the caret
4126is to the right of the prompt, moves the caret to the end of prompt.  Otherwise,
4127moves the caret to the beginning of the current line.
4128<p>
4129<b>Default key mapping:</b> Home in Shell mode
4130<br><br>
4131</dl><!--<hr>-->
4132
4133<a name="shellTab">shellTab</a><dl><dd>
4134<p>
4135Completes pending input.
4136<br><br>
4137<b>Default key mapping:</b> Tab in Shell mode
4138<br><br>
4139</dl><!--<hr>-->
4140
4141<a name="showMessage">showMessage</a><dl><dd>
4142<p>
4143Displays the current compiler or XML parser error message.
4144<br><br>
4145<b>Default key mapping:</b> Ctrl Alt M
4146<br><br>
4147<b>See also:</b> <a href="#xmlParseBuffer">xmlParseBuffer</a>,
4148<a href="#xmlValidateBuffer">xmlValidateBuffer</a>
4149<br><br>
4150</dl><!--<hr>-->
4151
4152<a name="sidebarListBuffers">sidebarListBuffers</a><dl><dd>
4153<p>
4154Displays (and sets keyboard focus to) the sidebar buffer list.
4155<br><br>
4156<b>Default key mapping:</b> Alt B
4157<br><br>
4158</dl><!--<hr>-->
4159
4160<a name="sidebarListTags">sidebarListTags</a><dl><dd>
4161<p>
4162Displays (and sets keyboard focus to) the sidebar tag list, if the current
4163buffer supports tags.
4164<br><br>
4165<b>Default key mapping:</b> Ctrl Shift T
4166<br><br>
4167</dl><!--<hr>-->
4168
4169<a name="slideIn">slideIn</a><dl><dd>
4170<p>
4171Moves all text in the marked region <code>indentSize</code> columns to the right.
4172<code>indentSize</code> is a buffer-specific setting and may be inspected and
4173modified in the Properties dialog (see <a href="#properties">properties</a>).
4174<br><br>
4175<b>Default key mapping:</b> Alt ]
4176<br><br>
4177</dl><!--<hr>-->
4178
4179<a name="slideOut">slideOut</a><dl><dd>
4180<p>
4181Moves all text in the marked region <code>indentSize</code> columns to the left.
4182<code>indentSize</code> is a buffer-specific setting and may be inspected and
4183modified in the Properties dialog (see <a href="#properties">properties</a>).
4184<br><br>
4185<b>Default key mapping:</b> Alt [
4186<br><br>
4187</dl><!--<hr>-->
4188
4189<a name="sortLines">sortLines</a><dl><dd>
4190<p>
4191Sorts the lines in the selected region in ascending lexicographic order, based
4192on the Unicode value of the characters in each line.
4193<br><br>
4194<b>Default key mapping:</b> None
4195<br><br>
4196</dl><!--<hr>-->
4197
4198<a name="source">source</a><dl><dd>
4199<p>
4200Finds the source of the Java class at the current location of the caret.
4201<p>
4202You can also use <a href="commands.html#executeCommand">executeCommand</a> and
4203specify the name of the class along with the command:
4204<pre>
4205        source javax.swing.JFrame</pre>
4206If the class is properly imported in the current buffer, the simple name is
4207enough:
4208<pre>
4209        source JFrame</pre>
4210<p>
4211For this command to work properly, you need to specify the location of the JDK
4212source on your system by adding a line like this to your
4213<a href="preferences.html">preferences</a> file:
4214<pre>
4215        jdkSourcePath = /home/peter/sun/j2sdk1.4.0/src</pre>
4216<b>Default key mapping:</b> Ctrl F1 in Java mode
4217<p>
4218<b>See also:</b> <a href="preferences.html#jdkSourcePath">jdkSourcePath</a>
4219<br><br>
4220</dl><!--<hr>-->
4221
4222<a name="splitWindow">splitWindow</a><dl><dd>
4223<p>
4224Splits the current window horizontally. Only one split per frame is currently
4225supported.
4226<p>
4227<b>Default key mapping:</b> F10
4228<br><br>
4229</dl><!--<hr>-->
4230
4231<a name="stamp">stamp</a><dl><dd>
4232<p>
4233Inserts the current date and time at the location of the caret.
4234<p>
4235The format of the inserted string is controlled by the
4236<a href="preferences.html#stampFormat">stampFormat</a> property.
4237<p>
4238<b>Default key mapping:</b> Shift F2
4239<br><br>
4240</dl><!--<hr>-->
4241
4242<a name="tab">tab</a><dl><dd>
4243<p>
4244If a multi-line region is selected, or if the property <a href="preferences.html#tabAlwaysIndent">tabAlwaysIndent</a>
4245is true, this command simply calls <a href="commands.html#indentLineOrRegion">indentLineOrRegion</a>.
4246<p>
4247Otherwise (i.e. no multi-line selection, <a href="preferences.html#tabAlwaysIndent">tabAlwaysIndent</a> is
4248false), the behavior depends on the location of the caret.
4249<p>
4250If the caret is at the very beginning of the text on the line, or in the
4251whitespace to the left of the text, <a href="commands.html#tab">tab</a> calls <a href="commands.html#indentLine">indentLine</a>.
4252If the caret is in the midst of the actual text on the line, <a href="commands.html#tab">tab</a>
4253inserts either a single tab character or the equivalent number of spaces,
4254depending on the setting of the <a href="preferences.html#useTabs">useTabs</a> property.
4255<p>
4256<b>Default key mapping:</b> Tab (in programming modes)
4257<p>
4258<b>See also:</b> <a href="#insertTab">insertTab</a>
4259<br><br>
4260</dl><!--<hr>-->
4261
4262<a name="thisError">thisError</a><dl><dd>
4263<p>
4264Jumps to the location in the source file that corresponds to the error message
4265at the current location in the compilation buffer.
4266<p>
4267<b>Default key mapping:</b> Enter, Ctrl Shift G, Double Mouse-1 or Mouse-2 in
4268compilation buffers
4269<p>
4270<b>See also:</b> <a href="#nextError">nextError</a>,
4271<a href="#previousError">previousError</a>,
4272<a href="compilation.html">Compilation Buffers</a>
4273<br><br>
4274</dl><!--<hr>-->
4275
4276<a name="toCenter">toCenter</a><dl><dd>
4277<p>
4278Moves the line containing the caret to the center of the window.
4279<br><br>
4280<b>Default key mapping:</b> Ctrl -
4281<br><br>
4282</dl><!--<hr>-->
4283
4284<a name="toggleGroupByThread">toggleGroupByThread</a><dl><dd>
4285<p>
4286Toggles the grouping of entries by thread in the current mailbox.
4287<p>
4288<b>Default key mapping:</b> None
4289<br><br>
4290</dl><!--<hr>-->
4291
4292<a name="toggleSidebar">toggleSidebar</a><dl><dd>
4293<p>
4294Toggles the sidebar.
4295<br><br>
4296<b>Default key mapping:</b> Alt =
4297<br><br>
4298</dl><!--<hr>-->
4299
4300<a name="toggleWrap">toggleWrap</a><dl><dd>
4301<p>
4302Toggles automatic word wrap in the current buffer. When automatic wrap is on,
4303j automatically wraps long lines as you type them, when your caret advances
4304past the wrap column.
4305<br><br>
4306<b>Default key mapping:</b> Ctrl F12
4307<br><br>
4308<b>See also:</b> <a href="preferences.html#wrapCol">wrapCol</a>,
4309<a href="#wrapParagraph">wrapParagraph</a>, <a href="#wrapRegion">wrapRegion</a>
4310<br><br>
4311</dl><!--<hr>-->
4312
4313<a name="top">top</a><dl><dd>
4314<p>
4315Moves the caret to the top line of the display, keeping it in the same column.
4316<br><br>
4317<b>Default key mapping:</b> Ctrl Page Up
4318<br><br>
4319</dl><!--<hr>-->
4320
4321<a name="toTop">toTop</a><dl><dd>
4322<p>
4323Moves the line containing the caret to the top of the window.
4324<br><br>
4325<b>Default key mapping:</b> Ctrl Shift -
4326<br><br>
4327</dl><!--<hr>-->
4328
4329<a name="uncommentRegion">uncommentRegion</a><dl><dd>
4330<p>
4331Uncomments each line in the selected region, or the current line if no region is selected.
4332<br><br>
4333<b>Default key mapping:</b> Shift F11
4334<br><br>
4335<b>See also:</b> <a href="#commentRegion">commentRegion</a>
4336<br><br>
4337</dl><!--<hr>-->
4338
4339<a name="undo">undo</a><dl><dd>
4340<p>
4341Undoes the last editing action or actions. Generally speaking, movement within
4342the buffer and simple edits on the same line are grouped for the purposes of
4343undo. All editing actions that modify text in the buffer are undoable except
4344for <a href="#entabRegion">entabRegion</a> and <a href="#detabRegion">detabRegion</a>.
4345<br><br>
4346If you undo through a save, the file saved on disk will not be affected by the
4347undo.
4348<br><br>
4349<b>Default key mapping:</b> Ctrl Z, Alt Backspace, NumPad *
4350<br><br>
4351<b>See also:</b> <a href="#redo">redo</a>
4352<br><br>
4353</dl><!--<hr>-->
4354
4355<a name="unfold">unfold</a><dl><dd>
4356<p>
4357Unfolds the current fold.
4358<br><br>
4359<b>Default key mapping:</b> Ctrl ] in Java, C, C++ and Perl modes
4360<br><br>
4361<b>See also:</b> <a href="#fold">fold</a>
4362<br><br>
4363</dl><!--<hr>-->
4364
4365<a name="unfoldAll">unfoldAll</a><dl><dd>
4366<p>
4367Unfolds all the folds in the current buffer.
4368<br><br>
4369<b>Default key mapping:</b> None
4370<br><br>
4371<b>See also:</b> <a href="#fold">fold</a>
4372<br><br>
4373</dl><!--<hr>-->
4374
4375<a name="unsplitWindow">unsplitWindow</a><dl><dd>
4376<p>
4377Makes the current window fill its frame, closing the other window in the
4378current frame.
4379<br><br>
4380<b>Default key mapping:</b> Shift F10
4381<br><br>
4382</dl><!--<hr>-->
4383
4384<a name="unwrapParagraph">unwrapParagraph</a><dl><dd>
4385<p>
4386Removes line breaks from the current paragraph, making it into one lone line.
4387<br><br>
4388<b>Default key mapping:</b> Shift F12
4389<br><br>
4390<b>See also:</b> <a href="#wrapParagraph">wrapParagraph</a>
4391<br><br>
4392</dl><!--<hr>-->
4393
4394<a name="up">up</a><dl><dd>
4395<p>
4396Moves the caret up one line.
4397<br><br>
4398<b>Default key mapping:</b> Up arrow
4399<br><br>
4400</dl><!--<hr>-->
4401
4402<a name="upperCaseRegion">upperCaseRegion</a><dl><dd>
4403<p>
4404Converts all upper case characters in the selected region to lower case.
4405<br><br>
4406<b>Default key mapping:</b> None
4407<br><br>
4408<b>See also:</b> <a href="#lowerCaseRegion">lowerCaseRegion</a>
4409<br><br>
4410</dl><!--<hr>-->
4411
4412<a name="visibleTabs">visibleTabs</a><dl><dd>
4413<p>
4414Toggles the visibility of tab characters in the buffer. By default, tabs are
4415not visible, and are displayed using the appropriate number of space
4416characters, as you would expect. When you turn on visible tabs, tab characters
4417are indicated by the character '^'.
4418<br><br>
4419<b>Default key mapping:</b> Ctrl Alt T
4420<br><br>
4421</dl><!--<hr>-->
4422
4423<a name="whatChar">whatChar</a><dl><dd>
4424<p>
4425Displays decimal, hex and character equivalents for the character at
4426the current location of the caret.
4427<br><br>
4428<b>Default key mapping:</b> None
4429<br><br>
4430</dl><!--<hr>-->
4431
4432<a name="whereIs">whereIs</a><dl><dd>
4433<p>
4434Displays information about the keys mapped to a particular command.
4435<br><br>
4436<b>Default key mapping:</b> None
4437<br><br>
4438</dl><!--<hr>-->
4439
4440<a name="windowDown">windowDown</a><dl><dd>
4441<p>
4442Moves the window down one line (so that the text seems to move up one line),
4443without changing the location of the caret.
4444<br><br>
4445<b>Default key mapping:</b> Ctrl Down
4446<br><br>
4447</dl><!--<hr>-->
4448
4449<a name="windowUp">windowUp</a><dl><dd>
4450<p>
4451Moves the window up one line (so that the text seems to move down one line),
4452without changing the location of the caret.
4453<br><br>
4454<b>Default key mapping:</b> Ctrl Up
4455<br><br>
4456</dl><!--<hr>-->
4457
4458<a name="wordLeft">wordLeft</a><dl><dd>
4459<p>
4460Moves the caret to the beginning of the current word, or, if the caret is
4461already at the beginning of the current word, to the beginning of the previous word.
4462<br><br>
4463<b>Default key mapping:</b> Ctrl Left
4464<br><br>
4465</dl><!--<hr>-->
4466
4467<a name="wordRight">wordRight</a><dl><dd>
4468<p>
4469Moves the caret to the beginning of the next word.
4470<br><br>
4471<b>Default key mapping:</b> Ctrl Right
4472<br><br>
4473</dl><!--<hr>-->
4474
4475<a name="wrapComment">wrapComment</a><dl><dd>
4476<p>
4477Wraps all the lines in the current multi-line comment at the wrap column,
4478which by default is column 80. The wrap column is controlled by the property
4479<a href="preferences.html#wrapCol">wrapCol</a>, which is a buffer-specific
4480setting that may be inspected and modified in the Properties dialog (see
4481<a href="#properties">properties</a>). You can set global and mode-specific
4482defaults for <a href="preferences.html#wrapCol">wrapCol</a> in your
4483<a href="preferences.html">preferences</a> file.
4484<br><br>
4485<b>Default key mapping:</b> F12 in Java, Lisp, C, C++ and Perl modes
4486<br><br>
4487<b>See also:</b> <a href="#wrapParagraph">wrapParagraph</a>,
4488<a href="#wrapRegion">wrapRegion</a>
4489<br><br>
4490</dl><!--<hr>-->
4491
4492<a name="wrapParagraph">wrapParagraph</a><dl><dd>
4493<p>
4494Wraps all the lines in the current paragraph at the wrap column, which by
4495default is column 80. The wrap column is controlled by the property
4496<a href="preferences.html#wrapCol">wrapCol</a>, which is a buffer-specific
4497setting that may be inspected and modified in the Properties dialog (see
4498<a href="#properties">properties</a>). You can set global and mode-specific
4499defaults for <a href="preferences.html#wrapCol">wrapCol</a> in your
4500<a href="preferences.html">preferences</a> file.
4501<br><br>
4502A paragraph is basically defined as a block of contiguous lines with blank
4503lines before and after it. To make the definition a bit more flexible,
4504a line starting with &lt;p&gt;, &lt;br&gt; or &lt;pre&gt; is recognized as the
4505first line of a paragraph, even if the line before it is not blank. Similarly,
4506a line ending with &lt;p&gt;, &lt;/p&gt;, &lt;br&gt; or
4507&lt;/pre&gt; is recognized as the last line of a paragraph, even if the line after it is not
4508blank.
4509<br><br>
4510This function does not move the caret, so you can reformat the
4511paragraph and immediately continue typing right where you left off.
4512<br><br>
4513<b>Default key mapping:</b> F12
4514<br><br>
4515<b>See also:</b> <a href="#unwrapParagraph">unwrapParagraph</a>,
4516<a href="#wrapComment">wrapComment</a>, <a href="#wrapRegion">wrapRegion</a>
4517<br><br>
4518</dl><!--<hr>-->
4519
4520<a name="wrapRegion">wrapRegion</a><dl><dd>
4521<p>
4522Wraps all the lines in the selected region at the wrap column, which by
4523default is column 80. The wrap column is controlled by the property
4524<a href="preferences.html#wrapCol">wrapCol</a>, which is a buffer-specific
4525setting that may be inspected and modified in the Properties dialog (see
4526<a href="#properties">properties</a>). You can set global and mode-specific
4527defaults for <a href="preferences.html#wrapCol">wrapCol</a> in your
4528<a href="preferences.html">preferences</a> file.
4529<br><br>
4530<b>Default key mapping:</b> None
4531<br><br>
4532<b>See also:</b> <a href="#wrapComment">wrapComment</a>,
4533<a href="#wrapParagraph">wrapParagraph</a>
4534<br><br>
4535</dl><!--<hr>-->
4536
4537<a name="writeGlobalKeyMap">writeGlobalKeyMap</a><dl><dd>
4538<p>
4539Prompts for a filename and writes out the current global key map to the
4540specifed file, in human-readable form.
4541<br><br>
4542<b>Default key mapping:</b> None
4543<br><br>
4544</dl><!--<hr>-->
4545
4546<a name="writeLocalKeyMap">writeLocalKeyMap</a><dl><dd>
4547<p>
4548Prompts for a filename and writes out the local key map for the current buffer
4549to the specifed file, in human-readable form. The local key map supplements
4550(and possible overrides) global key assignments, based on the mode (Java, HTML,
4551etc.) of the buffer.
4552<br><br>
4553<b>Default key mapping:</b> None
4554<br><br>
4555</dl><!--<hr>-->
4556
4557<a name="xmlElectricEquals">xmlElectricEquals</a><dl><dd>
4558<p>
4559Inserts '=' at the current location of the caret.
4560<br><br>
4561In XML mode, if the '=' immediately follows an attribute name, and if the
4562character following the '=' is either whitespace or '>', this command inserts
4563a pair of double quotation marks after the '=' and positions the caret between
4564the quotation marks.
4565<p>
4566The effect of this is to make it possible to enclose attribute values in
4567quotation marks without having to type the quotation marks themselves.
4568<p>
4569<b>Default key mapping:</b> '=' in XML mode
4570<p>
4571<b>See also:</b> <a href="#htmlElectricEquals">htmlElectricEquals</a>
4572<br><br>
4573</dl><!--<hr>-->
4574
4575<a name="xmlElectricSlash">xmlElectricSlash</a><dl><dd>
4576<p>
4577Inserts '/' at the current location of the caret.
4578<p>
4579In XML mode, if the '/' immediately follows '&lt;', and if there is an
4580unmatched start tag before the current location of the caret, the
4581corresponding end tag is automatically inserted. The line is then
4582automatically re-indented if
4583<a href="preferences.html#autoIndent">autoIndent</a> is true for the current
4584buffer.
4585<p>
4586<b>Default key mapping:</b> '/' in XML mode
4587<br><br>
4588</dl><!--<hr>-->
4589
4590<a name="xmlFindCurrentNode">xmlFindCurrentNode</a><dl><dd>
4591<p>
4592In XML mode, if XML parser support is available and the document tree is
4593displayed in the sidebar, forces the tree to expand all the way down to the
4594node corresponding to the location of the caret in the edit buffer.
4595<br><br>
4596<b>Default key mapping:</b> Ctrl = in XML mode
4597<br><br>
4598<b>See also:</b> <a href="xmlmode.html">XML Mode</a>
4599<br><br>
4600</dl><!--<hr>-->
4601
4602<a name="xmlFindMatch">xmlFindMatch</a><dl><dd>
4603<p>
4604Finds the match to the XML tag at the location of the caret.  Nested t