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

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

selectToTemporaryMarker

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