1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1st February 2002), see www.w3.org">
<title>JSwat - Features List</title>
<link href="http://www.bluemarsh.com/style.css" rel="stylesheet" type="text/css">
</head>
<body>
<!-- body table -->
<table summary="formatting" valign="top" border="0" cellpadding="8"
cellspacing="0" width="100%">
<!-- start header -->
<tr>
<td colspan="2">
<!-- start title -->
<table summary="table" align="center" bgcolor="#000000"
border="0" cellpadding="1" cellspacing="0" width="100%">
<tr>
<td>
<table summary="table" bgcolor="#ffffff" border="0"
cellspacing="0" width="100%">
<tr>
<td width="10%" align="center">
<img src="http://www.bluemarsh.com/images/cattails.jpg" alt="cattails">
</td>
<td align="left">
<h1>Blue Marsh Softworks</h1>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- end title -->
</td>
</tr>
<!-- end header -->
<tr>
<!-- left column -->
<td valign="top" width="20%">
<!-- start sidebox -->
<table summary="table" bgcolor="#000000" border="0" cellpadding="0"
cellspacing="0" width="100%">
<tr>
<td>
<table summary="table" border="0" cellpadding="3" cellspacing="1"
width="100%">
<tr>
<td bgcolor="#CCCCCC"> <span class="title">Site
Index</span></td>
</tr>
<tr>
<td bgcolor="#ffffff"> <span class="small">o</span> <a
class="nav" href="http://www.bluemarsh.com/java/index.html">java projects</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.bluemarsh.com/personal/index.html">about me</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.bluemarsh.com/htdig/search.html">search</a><br>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- end sidebox -->
<br>
<!-- start links -->
<table summary="table" bgcolor="#000000" border="0" cellpadding="0"
cellspacing="0" width="100%">
<tr>
<td>
<table summary="table" border="0" cellpadding="3" cellspacing="1"
width="100%">
<tr>
<td bgcolor="#CCCCCC"> <span class="title">My Java
</span></td>
</tr>
<tr>
<td bgcolor="#ffffff"> <span class="small">o</span> <a
class="nav" href="http://www.bluemarsh.com/java/tips.html">java tips</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.bluemarsh.com/java/faq.html">java faq</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.bluemarsh.com/java/contrib.html">contributing</a><br>
</td>
</tr>
<tr>
<td bgcolor="#CCCCCC"> <span class="title">General
Java</span></td>
</tr>
<tr>
<td bgcolor="#ffffff"> <span class="small">o</span> <a
class="nav" href="http://java.sun.com/">JavaSoft</a><br>
<span class="small">o</span> <a class="nav" href=
"http://developer.java.sun.com/">Developer Connection</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.afu.com/javafaq.html">The Java FAQ</a><br>
<span class="small">o</span> <a class="nav" href=
"http://mindprod.com/jgloss.html">Java Glossary</a><br>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- end links -->
<br>
<!-- start links -->
<table summary="table" bgcolor="#000000" border="0" cellpadding="0"
cellspacing="0" width="100%">
<tr>
<td>
<table summary="table" border="0" cellpadding="3" cellspacing="1"
width="100%">
<tr>
<td bgcolor="#CCCCCC"> <span class="title">JSwat</span></td>
</tr>
<tr>
<td bgcolor="#ffffff"> <span class="small">o</span> <a
class="nav" href=
"http://sourceforge.net/project/showfiles.php?group_id=59085">
downloads</a> <span class="nav">[sf.net]</span></a><br>
<span class="small">o</span> <a class="nav" href=
"../download.html">other downloads</a><br>
<span class="small">o</span> <a class="nav" href=
"index.html">documentation</a><br>
<span class="small">o</span> <a class="nav" href=
"faq.html">faq</a><br>
<span class="small">o</span> <a class="nav" href=
"../mail-lists.html">mailing lists</a><br>
<span class="small">o</span> <a class="nav" href=
"../integrate.html">integrating</a><br>
<span class="small">o</span> <a class="nav" href=
"../contrib.html">contributing</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.bluemarsh.com/bugzilla/">bugs</a><br>
</td>
</tr>
<tr>
<td bgcolor="#CCCCCC"> <span class="title">Related
Software</span></td>
</tr>
<tr>
<td bgcolor="#ffffff">
<span class="small">o</span> <a class="nav" href=
"http://www.eclipse.org/">Eclipse</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.oops.demon.co.uk/jdbtool/">JDBTool</a><br>
<span class="small">o</span> <a class="nav" href=
"http://jdee.sunsite.dk/">JDEE</a><br>
<span class="small">o</span> <a class="nav" href=
"http://sourceforge.net/projects/jenus/">Jenus</a><br>
<span class="small">o</span> <a class="nav" href=
"http://jipe.sourceforge.net/">Jipe</a><br>
<span class="small">o</span> <a class="nav" href=
"http://java.sun.com/products/jpda/">JPDA</a><br>
<span class="small">o</span> <a class="nav" href=
"http://www.netbeans.org/">NetBeans</a><br>
</td>
</tr>
<tr>
<td bgcolor="#CCCCCC"> <span class="title">Related
Links</span></td>
</tr>
<tr>
<td bgcolor="#ffffff">
<span class="small">o</span> <a class="nav"
href="http://freshmeat.net/projects/jswat/">FreshMeat listing</a><br>
<span class="small">o</span> <a class="nav"
href="http://sourceforge.net/projects/jswat/">SourceForge page</a><br>
<span class="small">o</span> <a
class="nav" href="http://www.skylit.com/javamethods/nodebugger.html">
Top Ten Reasons Not to Use a Java Debugger in School</a><br>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- end links -->
</td>
<td valign="top" width="75%">
<table summary="formatting" border="0" cellpadding="0"
cellspacing="0" width="100%">
<tr>
<td valign="top" width="100%">
<!-- start content -->
<table summary="formatting" align="center" bgcolor=
"#000000" border="0" cellpadding="0" cellspacing="0"
width="100%">
<tr>
<td>
<table summary="formatting" border="0"
cellpadding="8" cellspacing="1" width="100%">
<tr>
<td bgcolor="#ffffff">
<h2>Comprehensive Features List</h2>
<h3>Textual Debugger</h3>
<dl>
<dt><span class="copy"><strong>Textual
commands</strong></span></dt>
<dd><span class="copy">User can invoke many JSwat commands
from the command input field. The textual commands are
powerful because of the number of options they support. The
commands are also extensible via command
aliases.</span></dd>
<dt><span class="copy"><strong>Command
history</strong></span></dt>
<dd><span class="copy">Commands are stored in a
"history chain" and can be invoked using the
<code>!<prefix></code> and <code>!!</code> operators.
Earlier commands can be recalled using the up and down
cursor keys (or Ctrl-p and Ctrl-n keys) to move backward
and forward through the command history. (Note, this
feature is not available in console mode.)</span></dd>
<dt><span class="copy"><strong>Aliases</strong></span></dt>
<dd><span class="copy">Commands can be aliased to other
names, offering users the ability to make their interface
more comfortable. A command and its parameters can be
aliased. The alias can be invoked by the alias name, and
may include additional parameters to the original
command.</span></dd>
<dt><span class="copy"><strong>Scripts</strong></span></dt>
<dd><span class="copy">Commands can be stored in a plain
text file and executed using the <code>read</code> command.
The script can contain any commands and aliases but cannot
use the <code>!</code> or <code>!!</code>
operators.</span></dd>
</dl>
<h3>Graphical Debugger</h3>
<dl>
<dt><span class="copy"><strong>Threads
display</strong></span></dt>
<dd><span class="copy">Table displays threads in the
debuggee VM, including the ID, name, and status of the
thread. Columns of the table can be resized and
reordered.</span></dd>
<dt><span class="copy"><strong>Classes
tree</strong></span></dt>
<dd><span class="copy">Tree displays all classes in the
debuggee VM, including inner classes. Double-clicking on a
class will attempt to find and display the corresponding
source file.</span></dd>
<dt><span class="copy"><strong>Local
variables</strong></span></dt>
<dd><span class="copy">A tree displays the local variables
by name, type and value. Variables are sorted by name in
alphabetical order. Object variables can be expanded to
show their field variables. Array variables can be expanded
to show the first five and last one of the array elements.
Double-clicking on the "..." entry of an array
will expand the list to show all array entries.</span></dd>
<dt><span class=
"copy"><strong>Watchpoints</strong></span></dt>
<dd><span class="copy">Table that displays watched
variables and their values. The values are updated in
real-time as the debuggee VM is running. The watch panel
can watch any field variable of any object.</span></dd>
<dt><span class="copy"><strong>Stack
frames</strong></span></dt>
<dd><span class="copy">Table that shows the list of stack
frames. Shows the frame number, the class and method
information, and the source file name and line number, if
known. Double-clicking on a row in the stack panel will set
the current stack frame and opens the source code and
scrolls to the appropriate line.</span></dd>
<dt><span class="copy"><strong>Source code
viewer</strong></span></dt>
<dd><span class="copy">Source files (any files for that
matter) may be opened into a text area and viewed.
Breakpoints may be set and altered using the popup menu in
the source viewer (usually by right-clicking on the mouse).
Source code viewer shows line numbers in the left column,
shows where breakpoints are located, and indicates the
currently executing line of code when single-stepping. The
view is automatically refreshed when the session is
restarted.</span></dd>
<dt><span class="copy"><strong>Breakpoints
display</strong></span></dt>
<dd><span class="copy">This panel displays breakpoints and
allows enabling, disabling, and deleting the breakpoints.
In addition buttons allow the user to create new
breakpoints and breakpoint groups. There are also buttons
to manage the breakpoint properties and display the source
code near the breakpoint.</span></dd>
<dt><span class="copy"><strong>Capture Debugger
Messages</strong></span></dt>
<dd><span class="copy">During a debugging session, JSwat
outputs numerous messages, usually the output of debugger
commands. Normally this output is printed to a text area
within the JSwat window. In addition to this text area, it
is possible to capture the messages to either the JSwat
standard output stream (the console that started JSwat) or
to a named file.</span></dd>
<dt><span class="copy"><strong>Keyboard
Shortcuts</strong></span></dt>
<dd><span class="copy">Several of the JSwat menu items have
keyboard shortcuts to provide another easy method of
invoking JSwat actions. For example, the single stepping
actions each have function key shortcuts. A single press of
the assigned function key and the single step action takes
place. On most systems the menu items will indicate the
assigned shortcut keys.</span></dd>
<dt><span class="copy"><strong>Toolbar</strong></span></dt>
<dd><span class="copy">A toolbar provides one-click access
to several key features in JSwat, including
single-stepping, starting and stopping the debuggee VM, and
setting breakpoints.</span></dd>
<dt><span class="copy"><strong>Look and
Feel</strong></span></dt>
<dd><span class="copy">Choose from the available look and
feel settings. Not all choices will be available on all
systems, especially the "Windows" and
"Macintosh" look and feels.</span></dd>
</dl>
<h3>Common Features</h3>
<dl>
<dt><span class="copy"><strong>Starting
JSwat</strong></span></dt>
<dd><span class="copy">When invoking JSwat from the command
line, it is possible to execute an arbitrary command
immediately. JSwat reads the command and its arguments
given on command line and carries out the operation as soon
as JSwat has finished loading.</span></dd>
<dt><span class="copy"><strong>Catch
exceptions</strong></span></dt>
<dd><span class="copy">Exceptions in the debuggee VM can be
caught by JSwat and displayed in the debugger. Exceptions
are handled just like breakpoints, and can have filters
applied to them.</span></dd>
<dt><span class="copy"><strong>Thread/stack
viewing</strong></span></dt>
<dd><span class="copy">At any time the debuggee VM is
suspended, JSwat can display the stack trace of any thread.
Local variables in any stack frame in any thread can also
be displayed in the message window.</span></dd>
<dt><span class="copy"><strong>User
Preferences</strong></span></dt>
<dd><span class="copy">Many of JSwat's optional or
otherwise configurable settings are managed by a
preferences dialog. This dialog provides a means for
setting options such as which keys activate certain
keyboard shortcuts. Changing any of the settings will take
effect immediately in JSwat. Some of the preferences can
also be managed with the '<code>options</code>'
command, which is useful when running the program in
console mode.</span></dd>
<dt><span class="copy"><strong>Start-up
Scripts</strong></span></dt>
<dd><span class="copy">JSwat supports the use of start-up
scripts, called "<code>.jswatrc</code>". These
files are simply command scripts (as described above, under
"Textual Debugger") that are executed by JSwat
when it is started. First, JSwat looks for a
<code>jswatrc</code> file in the <code>.jswat</code>
directory in the user's home directory. Next, JSwat
looks for additional <code>.jswatrc</code> files in the
current working directory and all parent directories. This
is useful for keeping user-specific settings in the home
directory, while keeping project-specific settings with the
project files.</span></dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- end content -->
</td>
</tr>
</table>
</td>
<!-- end right column -->
</tr>
<!-- start footer -->
<tr>
<td align="center" colspan="2">
<span class="footer">© Copyright 2000-2002 -
<a href="http://www.bluemarsh.com/index.html">Blue Marsh Softworks</a></span>
</td>
</tr>
<!-- end footer -->
</table>
</body>
</html>
|
