source: tags/0.12.0/j/doc/commands.html

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

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